Files
ouyangxq 19745e46c1 docs(agents): pointerize duplicated DB rules and add index width guard
18 个服务与公共模块重复复制的 314 字符数据库访问约束改为指向后端根唯一定义,并给索引门禁增加防退化校验。

- 18 处重复段落合并为一句指针,规则正文只在后端根 AGENTS.md 维护
- 门禁新增路由表行宽上限(根/Admin/Client/后端根/海外 PDA),防止业务规则重新回流表格
- 同步包含此前未提交的链接与锚点、表格存在性校验
- 仅索引文档与门禁脚本,未改动业务代码
2026-10-20 12:45:41 +08:00

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。