## 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` 配置为准（不假设本机已安装相关工具）。