# 任务：排查"{{metamodelName}}"相关 Bug

## 实体信息
- 实体名称：{{metamodelName}}
- 实体代号：{{metamodelCode}}
- 所属模块：{{moduleName}}（{{moduleCode}}）
- 数据库表：{{tableName}}

## 已有字段
{{fieldSummary}}

## 已有行为
{{behaviorSummary}}

## 排查步骤

请按以下步骤排查问题：

### 第一步：定位问题范围
1. 读取 Controller 文件：`{{moduleCode}}/{{metamodelCode}}/controllers/{{metamodelCode}}Controller.php`
2. 读取 Model 文件：`{{moduleCode}}/{{metamodelCode}}/models/{{metamodelCode}}.php`
3. 读取 Service 文件（如存在）：`{{moduleCode}}/{{metamodelCode}}/services/{{metamodelCode}}Service.php`
4. 检查相关视图文件

### 第二步：检查常见问题
- **404 错误**：路由配置是否正确？Controller 命名空间是否匹配目录？
- **数据不显示**：Behavior 是否已配置？browse 行为中 displayConfig 是否包含该字段？
- **表单提交失败**：Model 的 rules() 验证规则是否过严？JSON 提交格式是否正确？
- **权限拒绝**：检查 L0-L5 权限配置，检查 Menu 权限分配
- **关联数据异常**：外键字段值是否正确？Relation 配置中 mainField/subField 是否匹配？

### 第三步：检查日志
- 应用日志：`runtime/logs/app.log`
- 查看最近的 ERROR 和 WARNING 级别记录

### 第四步：数据库验证
- 确认表 {{tableName}} 存在
- 确认字段结构与 Model 定义一致
- 检查数据完整性（外键引用是否有效）

## 输出要求
1. 明确指出问题原因
2. 给出修复代码（可直接应用）
3. 说明如何验证修复是否生效