ulthon_admin/.trae/rules/project_rules.md

Ulthon Admin（ThinkPHP 8）项目级规则（Agent 必须遵守）

核心红线

• 严禁修改 extend/base/ 下任何文件。
• 所有业务逻辑必须放在 app/ 下（优先 app/admin/），通过继承与重写扩展框架能力。
• 即使是框架层能力，也必须从 app/ 下入口类调用（业务类继承 base 层基础类），不得直接从 extend/base/ 调用。

环境与配置

• 不自行安装/变更基础环境（Docker、MySQL、Redis 等），除非用户明确要求。
• 不修改环境配置文件（如 .env）；发现配置缺失或不合理时，仅提示需要由开发者补齐。
• 不主动启动或常驻运行项目（由开发者提前运行以便调试）；仅在用户明确要求时执行相关命令。

数据库与结构

• 设计表结构优先采用 Scheme 机制（app/admin/scheme/），确保 Code 与 DB 一致后再生成 CURD。
• 一般不要使用枚举类型（ENUM）；优先使用 tinyint/int + 注释/字典表等方式表达状态。
• 调试数据库数据可以使用内置 tools:db 命令，但不要用它来“设计表结构”（临时调试改动需注意还原）。

前端与视图组织

• 遵循视图与脚本同名配对：每个视图 *.html 配套同名 *.js，并按模块维护 _common.js。

代码风格与命名

• 严格遵循项目命名规范与 PSR 风格；需要格式化时以仓库根目录的 .php-cs-fixer.php 配置为准（不假设本机已安装相关工具）。