docs: git-workflow v1.1 与 CODEOWNERS 规范

- git-workflow.md v1.1: scope-enum 对齐实际服务名(identity→iam 等)
- git-workflow.md: 新增 §4.7 模块 Owner 与 CODEOWNERS 章节
- git-workflow.md: husky hooks 与实际文件对齐,新增 pre-push 说明
- .github/CODEOWNERS: 定义各模块 owner team 与 PR 合并职责
- .github/pull_request_template.md: PR 模板
This commit is contained in:
SpecialX
2026-07-08 12:53:18 +08:00
parent beedbaf686
commit b39095cbdd
3 changed files with 398 additions and 197 deletions

80
.github/CODEOWNERS vendored Normal file
View File

@@ -0,0 +1,80 @@
# Edu 平台 CODEOWNERS
# 格式:路径 @owner
# 作用GitHub/Gitea 自动为 PR 分配 reviewer
# 维护规则:
# 1. 新增服务/包时,必须同步更新本文件
# 2. owner 变更需开独立 PR由架构组审批
# 3. 与 docs/standards/git-workflow.md §4.7 保持同步
# Team handle 占位符:@edu-platform/* 需在 Organization 中创建对应 team 后替换
# ===== 架构与规则架构组2 人 review=====
/.trae/ @edu-platform/arch
/docs/architecture/ @edu-platform/arch
/docs/standards/ @edu-platform/arch
/scripts/arch-scan/ @edu-platform/arch
# ===== 根配置架构组2 人 review影响全局=====
/.commitlintrc.js @edu-platform/arch
/lint-staged.config.js @edu-platform/arch
/package.json @edu-platform/arch
/pnpm-workspace.yaml @edu-platform/arch
/go.work @edu-platform/arch
/pyproject.toml @edu-platform/arch
/tsconfig.base.json @edu-platform/arch
# ===== 共享包架构组2 人 review契约变更影响所有服务=====
/packages/shared-proto/ @edu-platform/arch
/packages/shared-ts/ @edu-platform/arch
/packages/shared-go/ @edu-platform/arch
/packages/shared-py/ @edu-platform/arch
/packages/shared-tokens/ @edu-platform/arch
# ===== 网关层Go=====
/services/api-gateway/ @edu-platform/gateway
/services/push-gateway/ @edu-platform/gateway
# ===== 业务微服务 =====
# IAM核心模块2 人 review
/services/iam/ @edu-platform/iam
# 教学核心
/services/core-edu/ @edu-platform/edu-core
/services/classes/ @edu-platform/edu-core
# 内容资源
/services/content/ @edu-platform/content
# 消息通知
/services/msg/ @edu-platform/messaging
# 数据分析Python
/services/data-ana/ @edu-platform/data
# AI 网关Python
/services/ai/ @edu-platform/ai
# ===== BFF 聚合层NestJS=====
/services/teacher-bff/ @edu-platform/edu-core
/services/student-bff/ @edu-platform/edu-core
/services/parent-bff/ @edu-platform/edu-core
# ===== 微前端Next.js=====
/apps/teacher-portal/ @edu-platform/frontend
/apps/student-portal/ @edu-platform/frontend
/apps/parent-portal/ @edu-platform/frontend
/apps/admin-portal/ @edu-platform/frontend
# ===== 基础设施SRE2 人 review生产环境变更强制=====
/infra/k8s/ @edu-platform/sre
/infra/backup/ @edu-platform/sre
/infra/security/ @edu-platform/sre
/infra/monitoring/ @edu-platform/sre
/infra/docker-compose*.yml @edu-platform/sre
# ===== CI/CDSRE=====
/.github/ @edu-platform/sre
/.husky/ @edu-platform/sre
# ===== 文档(架构组)=====
/docs/troubleshooting/ @edu-platform/arch
/MIGRATION_GUIDE.md @edu-platform/arch
/README.md @edu-platform/arch
/CHANGELOG.md @edu-platform/arch
# ===== 兜底(未匹配的文件由架构组 review=====
* @edu-platform/arch