fastadmin

# FastAdmin 开发 ## 执行边界 - 先定位 FastAdmin 项目根目录：必须包含 `think`、`application/`、`addons/`、`public/`。 - 所有框架路径均相对于当前项目根目录；不得写入本机模板绝对路径。 - 默认使用简体中文输出分析、执行结果和验证结论；代码、命令、路径、配置 key、错误信息保持原文。 - 新增功能默认落到 FastAdmin 原生目录；插件目录只允许明确修改原插件已有源文件或在原文件加方法。 - 不在 `addons/<plugin>` 下新增独立功能板块。 ## 必读规则 按任务触发读取，不一次性加载所有 `references/`： 1. 任何任务先读 `references/01-ownership.md`，确定原生新增、已有源文件修改或插件源文件修改。 2. 涉及新表、新字段、新索引、状态值、外键或 SQL，读 `references/02-database-design.md`。 3. 新增标准后台数据管理模块，读 `references/03-native-crud.md`。 4. 新增原生页面或修改后台视图/JS，读 `references/04-native-frontend.md`。 5. 修改已有控制器、模型、服务、验证器、JS、视图或插件源文件，读 `references/05-existing-source-change.md`。 ## 固定流程 1. 判定归属：新增一律原生；已有文件修改按当前文件；明确插件源文件修改才进入插件规则。 2. 判定项目根和当前项目实际命令：先检查 `php think`、`application/admin/command/Crud.php`、`application/admin/command/Menu.php`。 3. 涉及数据库时先完成字段设计，再决定是否执行 `php think crud`。 4. CRUD 前判断控制器层级、关联模型显示、字段识别、菜单路径；再构造最小必要命令。 5. CRUD 后生成菜单权限；菜单必须使用最终控制器路径。 6. 生成后复核 SQL、控制器、模型、验证器、视图、后台 JS、语言包、菜单权限、字段组件、关联显示。 ## 硬性约束 - `php think crud` 是生成标准原生管理模块的方式，不决定任务归属。 - CRUD 默认命令优先，特殊参数后置；`--controller` 只用于项目层级归属，不用于解决字段组件、`pid`、selectpage 或减少页面改造。 - 数据库字段设计必须参考当前项目 `application/admin/command/Crud.php` 的字段识别规则。 - 列表需要显示关联表字段时，CRUD 命令必须加入 `--relation`、`--relationmode`、`--relationforeignkey`、`--relationprimarykey`、`--relationfields`。 - 树形父级字段默认使用 `pid`，不改成本表名 `_id`。 - 菜单权限优先用 `--menu=1` 或 `php think menu --controller=<controller>`；多个控制器可重复传入 `--controller`。 ## 输出契约 - 实现前说明：任务归属、目标目录、是否需要数据库、是否适合 CRUD、是否需要关联模型、最终控制器路径、菜单生成方式。 - 实现后说明：实际执行命令、生成/修改的关键文件、菜单节点、验证结果、未验证项。