# 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`。