feat(enum): 统一结构化枚举值传输与同步

docs/ARCHITECTURE.md

@@ -162,6 +162,19 @@
 - **后端测试**：围绕结构约束的单元测试（Mapper/Service/Controller 继承体系、实体字段注解、方法签名验证）。
 - **前端测试**：Vitest + @vue/test-utils，覆盖路由定义、布局组件、页面渲染、API 调用和 Long 类型解析。
 
+## 6.1 注释规范
+
+- 新增或修改核心业务代码时，需补充中文注释，优先说明类职责、方法目的、关键判断和扩展边界。
+- 每次提交代码时，需要同步检查本次改动是否已经补齐对应中文注释，避免后续阅读只能靠反推代码语义。
+- 注释应聚焦设计意图和边界，不建议堆砌“变量赋值”“循环遍历”这类低价值说明。
+
+## 6.2 结构化枚举规范
+
+- 长期固定的结构化文本字段，统一采用整型枚举值作为前后端传输协议，不再直接传递字符串名称。
+- 后端 Java 枚举类是这类结构化枚举的单一事实来源，前端常量和 `sys_enum` 数据都基于它同步。
+- 新增或修改结构化枚举时，需要通过统一的枚举初始化测试按 `catalog + type` 先删后全量重建写入 `sys_enum`。
+- 不同枚举组之间的 `catalog + type` 必须唯一，否则会破坏枚举组重建的确定性。
+
 ## 7. 当前不足
 
 - RAG 尚未进入"可检索链路"，当前完成上传与解析，但未完成切片、向量化和召回。