cai
2026-06-05 9c703f14d916320bea60d5c9f3db000438fc0f91
common/project-doc/项目规范.md
@@ -44,6 +44,20 @@
9. 项目规范只记录项目特化内容,不重复抄写全局规范和体系规范。
10. 项目级管理动作必须有日志和审计入口。
11. 项目内具体事项必须能追到项目目标和启用体系。
12. 当 `mb-ms-doc` 作为工作区管理根目录时,工作区内的业务子项目目录应以 `project-` 开头;每个业务子项目应拥有独立 Git 仓库,不加入 `mb-ms-doc` 仓库管理。
### 2.1 业务子项目目录与 Git 边界
`mb-ms-doc` 仓库保存全局规范、体系模板、公共文档和管理根目录规则,不直接管理具体业务子项目的版本历史。
工作区内的业务子项目按以下口径管理:
1. 业务子项目目录建议统一使用 `project-<name>` 命名,便于管理根目录 `.gitignore` 排除和人工识别。
2. 每个业务子项目应在自身项目根目录内初始化独立 Git 仓库。
3. 业务子项目不得作为普通文件加入 `mb-ms-doc` 仓库提交。
4. `mb-ms-doc` 根仓库应排除 `project-*` 业务子项目目录。
5. 如果历史项目、示例项目或特殊项目暂时不满足 `project-*` 命名,应在项目总览、项目配置清单或项目变更记录中说明原因和 Git 管理边界。
6. 项目管理员创建新项目时,应同步确认项目目录名、独立 Git 仓库、远端地址、提交身份和管理根目录排除规则。
## 3. 核心流程