mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-07-07 18:42:49 +08:00
29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
## 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` 配置为准（不假设本机已安装相关工具）。
|
||
|