ljwx-children/ORGANIZATION-PROJECT-SETUP.md

组织项目配置完成记录

✅ 配置成功

配置时间： 2024-12-30

📊 项目信息

• 组织名称： BrunoGaoSZ
• 项目名称： SDLC Management - Gold Template
• 项目编号： #2
• 项目 ID： PVT_kwDOAgn-Q84BLjWg
• 项目 URL： https://github.com/orgs/BrunoGaoSZ/projects/2
• 项目类型： 组织级别（Organization-level）

🎯 已配置字段（7 个自定义字段）

1. Phase - SDLC 阶段

• 类型： 单选 (SINGLE_SELECT)
• 选项数量： 6 个
• 选项列表：
  • Requirements (BLUE) - 需求分析阶段
  • Design (BLUE) - 设计阶段
  • Development (BLUE) - 开发阶段
  • Testing (BLUE) - 测试阶段
  • Deployment (BLUE) - 部署阶段
  • Operations (BLUE) - 运维阶段

2. Doc Type - 文档类型

• 类型： 单选 (SINGLE_SELECT)
• 选项数量： 8 个
• 选项列表：
  • BRD (PURPLE) - 业务需求文档
  • PRD (PURPLE) - 产品需求文档
  • Design (PURPLE) - 设计文档
  • API (PURPLE) - API 文档
  • Test Case (PURPLE) - 测试用例
  • Test Report (PURPLE) - 测试报告
  • Deployment (PURPLE) - 部署文档
  • Operations (PURPLE) - 运维文档

3. Document Priority - 文档优先级

• 类型： 单选 (SINGLE_SELECT)
• 选项数量： 4 个
• 选项列表：
  • P0 - Critical (RED) - 关键优先级，必须立即处理
  • P1 - High (ORANGE) - 高优先级，尽快处理
  • P2 - Medium (YELLOW) - 中优先级，正常处理
  • P3 - Low (GREEN) - 低优先级，可延后处理

4. Document Status - 文档状态

• 类型： 单选 (SINGLE_SELECT)
• 选项数量： 5 个
• 选项列表：
  • Draft (GRAY) - 草稿状态，正在编写中
  • Review (YELLOW) - 审查中，等待审批
  • Approved (GREEN) - 已批准，可以实施
  • Implemented (GREEN) - 已实施完成
  • Archived (GRAY) - 已归档，不再活跃

5. Progress - 完成进度

• 类型： 数字 (NUMBER)
• 说明： 完成进度 (0-100)

6. Blocking - 阻塞因素

• 类型： 文本 (TEXT)
• 说明： 阻塞因素描述

7. Dependencies - 依赖关系

• 类型： 文本 (TEXT)
• 说明： 依赖的 Issue 编号（如 #1, #2）

📋 已添加的 Issues（3 个）

1. #1 - BRD-001 用户认证系统需求文档
2. #2 - ARCH-001 系统架构设计文档
3. #3 - TC-001 用户登录功能测试用例

🔗 相关链接

• 项目看板： https://github.com/orgs/BrunoGaoSZ/projects/2
• 仓库： https://github.com/BrunoGaoSZ/gold-template
• 配置脚本： scripts/setup-project-fields.py
• 配置模板： config/project-fields-template.yml

🚀 使用指南

为 Issue 设置字段值

1. 访问项目看板：https://github.com/orgs/BrunoGaoSZ/projects/2
2. 点击任意 Issue 卡片
3. 在右侧面板中设置自定义字段值

按字段分组查看

1. 在项目看板页面，点击顶部的 "Group by" 按钮
2. 选择要分组的字段：
   • Phase - 按 SDLC 阶段分组
   • Doc Type - 按文档类型分组
   • Document Status - 按文档状态分组
   • Document Priority - 按优先级分组

添加更多 Issues

# 方式 1：使用 GitHub CLI
gh project item-add 2 --owner BrunoGaoSZ --url <issue-url>

# 方式 2：在项目看板页面点击 "Add item" 按钮

添加来自其他仓库的 Issues

# 可以添加任何仓库的 Issues（只要你有权限访问）
gh project item-add 2 --owner BrunoGaoSZ \
  --url https://github.com/other-org/other-repo/issues/5

💡 重要特性

✅ 跨仓库通用

这个组织项目的字段配置对所有添加到项目中的 Issues 都适用，无论它们来自哪个仓库：

BrunoGaoSZ Organization Project #2
├── gold-template/issues/1      ✅ 可以使用所有 7 个自定义字段
├── gold-template/issues/2      ✅ 可以使用所有 7 个自定义字段
├── gold-template/issues/3      ✅ 可以使用所有 7 个自定义字段
├── another-repo/issues/10      ✅ 可以使用所有 7 个自定义字段
└── third-repo/issues/20        ✅ 可以使用所有 7 个自定义字段

✅ 组织级别可见性

• 组织成员都可以访问此项目
• 可以设置不同的权限级别
• 适合团队协作

✅ 标准化文档管理

• 统一的字段配置确保团队使用相同的标准
• 便于跨项目、跨仓库的文档管理
• 支持 SDLC 全生命周期追踪

🔄 复制配置到其他项目

如果需要为其他项目创建相同的字段配置：

# 1. 创建新项目
gh project create --owner BrunoGaoSZ --title "New Project"

# 2. 获取新项目 ID
gh project list --owner BrunoGaoSZ --format json | jq -r '.projects[] | select(.title=="New Project") | .id'

# 3. 应用相同的字段配置
export GITHUB_TOKEN="your_token"
python3 scripts/setup-project-fields.py --project-id <NEW_PROJECT_ID>

📊 项目统计

• 总字段数： 17 个
  • 内置字段：10 个
  • 自定义字段：7 个 ✅
• 已添加 Issues： 3 个
• 配置耗时： < 2 分钟（使用自动化脚本）

🎉 下一步建议

1. 为现有 Issues 设置字段值

   • 为 Issue #1 设置 Phase=Requirements, Doc Type=BRD, Status=Draft
   • 为 Issue #2 设置 Phase=Design, Doc Type=Design, Status=Draft
   • 为 Issue #3 设置 Phase=Testing, Doc Type=Test Case, Status=Draft

2. 尝试分组视图

   • 按 Phase 分组，查看各阶段文档分布
   • 按 Status 分组，查看文档审批进度

3. 创建更多文档 Issues

   • 使用文档模板创建各阶段的文档
   • 设置合适的优先级和依赖关系

4. 配置自动化工作流

   • 新 Issue 自动设置默认 Status
   • 状态变更时自动通知相关人员

---

配置者： Claude Code 配置方式： 自动化脚本 scripts/setup-project-fields.py 文档版本： 1.0.0 最后更新： 2024-12-30