generated from youfool-project/youfool-prj-springboot3-template
60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# OARMS 命名规范审查 — 进度日志
|
||
|
||
## 当前状态
|
||
|
||
**阶段**: Phase 5 已完成，待用户确认修复方案
|
||
**进度**: 审查阶段全部完成
|
||
|
||
---
|
||
|
||
## 审查进度
|
||
|
||
| 阶段 | 状态 | 发现数 | 备注 |
|
||
|------|------|--------|------|
|
||
| Phase 1: DB→Entity→DTO | ✅ 完成 | 2 类（DDL 大写 + 多余注解） | 后端全链路命名一致 |
|
||
| Phase 2: Controller API 路径 | ✅ 完成 | 1 处单复数不一致 | 其余均为 kebab-case |
|
||
| Phase 3: 前端 API 文件 | ✅ 完成 | 3 类重大问题 | 路径不匹配+snake_case+函数参数 |
|
||
| Phase 4: 前端页面组件 | ⏭️ 跳过 | — | 与 Phase 3 本质一致 |
|
||
| Phase 5: 汇总修复建议 | ✅ 完成 | — | 推荐方案 A（前端适配后端） |
|
||
| Phase 6: 执行修复 | 待确认 | — | |
|
||
|
||
---
|
||
|
||
## 审查发现总结
|
||
|
||
### 后端（问题少，已基本规范）
|
||
|
||
| 问题类型 | 数量 | 严重度 |
|
||
|---------|------|--------|
|
||
| DDL CREATE TABLE 表名小写 | 17 张表 | P3 规范 |
|
||
| 多余 @TableField 注解 | 6 处 | P3 整洁 |
|
||
| Controller 单复数不一致 | 1 处 | P2 风格 |
|
||
|
||
### 前端（系统性不一致）
|
||
|
||
| 问题类型 | 数量 | 严重度 |
|
||
|---------|------|--------|
|
||
| API 路径不匹配 | ~58/64 端点 | P0 阻塞 |
|
||
| JSDoc 参数名 snake_case | ~90+ 处 | P0 阻塞 |
|
||
| JS 函数参数 snake_case | 15 处 | P1 |
|
||
| 调用不存在的后端接口 | 6 个 | P1 功能缺失 |
|
||
|
||
### 修复方案
|
||
|
||
推荐方案 A：前端适配后端（后端 85 个问题已修复并测试通过，不宜大改）
|
||
|
||
---
|
||
|
||
## 会话记录
|
||
|
||
### 2026-05-22 — 全链路命名规范审查
|
||
|
||
**操作**: 按 Phase 1-5 逐阶段审查后端 10 个模块 + 前端 10 个 API 文件
|
||
|
||
**结论**:
|
||
- 后端命名规范良好，仅 DDL 大写和冗余注解等低优先级问题
|
||
- 前端存在系统性不一致：RESTful 复数风格 vs 后端扁平 POST 风格，参数名 snake_case vs camelCase
|
||
- 前后端对接完全不通，需前端全面适配后端
|
||
|
||
**修复建议**: 方案 A（前端适配后端），修改 10 个前端 API 文件的路径和参数名
|