# OARMS 全链路命名规范审查计划

## 目标

以命名映射规范（实体属性 → camelCase）为基准，对 gz-oarms 后端 + gz-oarms-web 前端进行全链路命名审查，发现并修复所有不一致的命名。

## 规范基准

| 层级 | 校验内容 | 规范要求 |
|------|---------|---------|
| 数据库 DDL | DM8 表名、字段名 | 表名 `bs_/lb_/mr_/am_/cw_` 前缀 + snake_case；DDL 中 COMMENT/INDEX 标识符大写 |
| 后端 Entity | Java 实体类属性名 + `@TableField` 注解 | camelCase，`@TableField("snake_case")` 显式映射 DB |
| 后端 VO/Query/Req | DTO 类属性名 | camelCase，与 Entity 属性名一致 |
| 后端 Controller | API 路径命名 | `/api/{kebab-case}`，方法路径 query/detail/save/update/remove |
| 前端 API 文件 | JS 请求参数/响应字段名 | camelCase，与后端 JSON 返回字段 100% 一致 |
| 前端页面 | 组件变量、表单字段绑定 | camelCase，与 API 字段一致 |

## 已知重大不一致（前置发现）

| 不一致项 | 前端现状 | 后端现状 | 影响 |
|---------|---------|---------|------|
| 参数字段命名 | snake_case（`screen_name`、`page_num`） | camelCase（`screenName`、`pageNum`） | 前后端字段无法映射 |
| API 路径风格 | `/api/recording-configs/query`（复数） | `/api/monitoring-clue/query`（单数） | 路径不匹配 |
| 域路径前缀 | `/api/cw/monitoring-clues/query` | `/api/monitoring-clue/query` | 路径不匹配 |

## 当前阶段

**状态**: 审查执行中
**当前阶段**: Phase 1

## 审查阶段（6 个 Phase）

### Phase 1：后端 DB→Entity→DTO 全链路审查（10 个模块）

逐模块检查：DDL 字段名 ↔ Entity `@TableField` ↔ Entity 属性名 ↔ VO/Query/Req 属性名

| 模块 | DDL 文件 | Entity 数 | VO/Query/Req 数 |
|------|---------|----------|----------------|
| BS-1 | V1.0.0__BS_screen_ddl.sql | 2 | 5 |
| LB-1 | V2.0.0__LB_law_ddl.sql | 1 | 3 |
| MR-1 | V6.0.0__MR_monitoring_rule_ddl.sql | 3 | 4 |
| AM-1 | V3.0.0__AM_recording_config_ddl.sql | 1 | 3 |
| AM-2 | V4.0.0__AM_recording_task_ddl.sql | 2 | 1 |
| AM-3 | V5.0.0__AM_monitor_record_ddl.sql | 1 | 3 |
| CW-1 | V7.0.0__CW_evidence_ddl.sql | 2 | 4 |
| CW-2 | V8.0.0__CW_evidence_rule_relation_ddl.sql | 1 | 2 |
| CW-3 | V9.0.0__CW_monitoring_clue_ddl.sql | 2 | 2 |
| CW-4 | V10.0.0__CW_clue_transfer_ddl.sql | 2 | 6 |

**校验规则**：
1. DDL 字段名 → `@TableField` 值：snake_case 完全匹配
2. Entity 属性名 → VO/Query/Req 属性名：camelCase 完全匹配
3. DDL 中 COMMENT ON / CREATE INDEX 标识符大写

### Phase 2：后端 Controller API 路径审查

检查 11 个 Controller 的 API 路径是否符合 `/api/{kebab-case}` 规范，方法路径是否使用 query/detail/save/update/remove 等动词。

### Phase 3：前端 API 文件审查（10 个 API 文件）

校验前端 API 参数名与后端 JSON 字段的 camelCase 一致性：
- BS-1 大屏管理 API
- LB-1 法律法规 API
- MR-1 监测规则 API
- AM-1/2/3 广告监控 API（3 个文件）
- CW-1/2/3/4 内容预警 API（4 个文件）

### Phase 4：前端页面组件审查（30+ 个 Vue 文件）

抽样检查表单字段绑定和组件变量命名是否为 camelCase。

### Phase 5：汇总 + 修复建议

1. 按模块分组输出全部审查结果
2. 标记不符合规范的命名，说明违反规则
3. 给出修正建议

### Phase 6：执行修复

根据 Phase 5 的建议逐模块修复命名不一致问题。

## 补充说明

- **Mapper XML**：项目中无 Mapper XML 文件，全部使用 MyBatis Plus 注解（`@TableField`、`@TableName`）。XML 审查项跳过，替换为 `@TableField` 注解审查。
- **前端项目位置**：`../gz-oarms-web/`
- **命名映射规范参考**：`D:\chinaweal\gz-atms\gz-atms-web\docs\rules\Youfool-LLM 命名映射规范.md`

## 修复决策

（审查过程中记录）