18 个服务与公共模块重复复制的 314 字符数据库访问约束改为指向后端根唯一定义,并给索引门禁增加防退化校验。 - 18 处重复段落合并为一句指针,规则正文只在后端根 AGENTS.md 维护 - 门禁新增路由表行宽上限(根/Admin/Client/后端根/海外 PDA),防止业务规则重新回流表格 - 同步包含此前未提交的链接与锚点、表格存在性校验 - 仅索引文档与门禁脚本,未改动业务代码
1.3 KiB
1.3 KiB
Platform BOM 模块指引
数据库访问与中文注释约束
- 强制继承
../AGENTS.md的“数据库访问与中文代码注释”全部规则;该节是分层、SQL 执行和方法/核心逻辑中文注释的唯一维护处,本模块不另设例外。
职责边界
- 本模块只通过
pom.xml的dependencyManagement发布baiyue-platform-bom,统一管理本仓公共制品版本。 - 不在这里放 Java 业务代码、服务配置或具体依赖实现;第三方技术栈版本仍优先由父
pom.xml管理。
快速索引
| 修改目标 | 文件位置 |
|---|---|
| BOM 坐标与版本 | pom.xml 顶部 artifactId、version |
| 公共组件版本 | pom.xml 的 dependencyManagement/dependencies |
| 当前纳管制品 | baiyue-common-core、common-web、common-security、common-openapi、common-audit、common-event-contract |
修改与验证
- 新增条目前先确认制品确实需要被其他仓库按固定版本消费;业务服务依赖不要放入 BOM。
- 版本变化会影响所有 BOM 消费者;按当前正式依赖基线同步本仓与尾程仓消费者,不为旧坐标或旧版本保留兼容分支。若已有不可变外部依赖,另行建立升级规则。
- 从父目录运行
mvn -pl platform-bom -am validate。