📦 框架核心工程师 ORM与数据模型

角色 本技能拥有 Weline ORM 行为、模式声明规则、查询执行约定和跨模块查询提供者合同。它保护数据模型的正确性并保持数据库逻辑与框架标准一致。 何时使用 用于模型更改、模式注释、查询链、分页、查询提供者和跨模块数据访问。用于诸如 ORM、模型、#[Col]、#[Table]、fetch()、分页、查询提供者和 w_query 等关键字。 当模式或数据模型更改影响一个功能分支以外的框架约定时使用。 源材料 AI-ENTRY.md CLAUDE.md dev/ai/skills/database-model-standards/SKILL.md dev/ai/skills/unified-query-provider/SKILL.md dev/ai/skills/code-generation-standards/SKILL.md dev/ai/skills/community-module/SKILLS-CONSOLIDATED.md 职责 通过模型注释和框架升级流程定义或修改模式。保持 ORM 查询链正确并显式执行。将查询提供者使用与基于事件的通知使用分开。防止业务代码引入特定于方言的 SQL 或跨模块紧密耦合。 工作流 阅读框架入门指南并确认受影响的模型或提供者边界。确定任务是模式更改、查询行为更改还是跨模块数据合同更改。在拥有框架路径中更新模型注释、索引、提供者或查询流。确保每个 select、insert、update 或 delete 流都使用正确的 ORM 终端调用执行。模式声明更改时使用 setup:upgrade。添加回归测试或有针对性的检查以证明数据路径有效。报告对下游模块的任何兼容性影响。 Weline 规则 使用 #[Col]、#[Table] 和相关模型注释进行模式更改。不要在 Setup/Upgrade.php 中执行字段 CRUD。ORM 链必须以 fetch() 或 fetchArray() 结尾，当需要执行时。使用 w_query() 和查询提供者进行跨模块数据访问。不要仅为了从另一个模块读取数据而创建事件。 所需输入 受影响的模型、表或提供者。预期的读/写行为和任何模式增量。依赖于数据合同的调用模块或消费者。验证期望，例如设置、单元测试或 HTTP 检查。 预期输出 与框架规则一致的更新模型或查询提供者代码。模式同步或查询正确性的验证证据。如果存在任何跨模块合同，请附上一份简短的说明。 验证 模式注释更改时运行 php bin/w setup:upgrade。运行专注的测试或命令以执行受影响的查询流。确认 ORM 执行调用存在于变异或获取链上。确认没有业务层方言 SQL 泄漏到框架消费者中。 约束 不要在业务流中硬编码原始 SQL，当 ORM 或提供者已经满足需求时。不要使用直接升级脚本字段突变绕过模型注释。不要通过直接构造另一个模块的模型来共享查询来耦合模块。不要使用事件进行读取样式查询流量。