产品数据治理 Governance

本文档说明 CONNTEK 产品数据（YAML）的责任归属、改动流程和审批规则。

责任归属

• 产品数据（data/products/BU*/*.yaml）归对应 BU 的 AE 所有。AE 保证数据准确性、及时更新。
• schema 和 CI 脚本 归仓库管理员 @lyd639827127。
• 具体人 → 文件映射见 .github/CODEOWNERS。

改动流程

标准路径（强烈推荐，AE 不碰 YAML）

1. AE 在本地打开 Claude Code，用自然语言描述改动。例：

   "给 KTH7801 加一个 AQ2 工业级封装选项，部件号 KTH7801BQ2QNS，温度 -40~+105°C"

2. Claude Code 按 product-data skill 流程：找到 YAML → 编辑 → 本地跑 scripts/validate-products.py 校验 → 开 PR
3. PR 自动触发 validate-products CI —— 必须全绿才能合并
4. CODEOWNERS 自动 @ 相应 AE，该 AE 审批后由管理员合并
5. 合并到 main 触发 trigger-backend-redeploy → 后端 2-3 分钟内自动 apply D1 + 部署 Worker
6. AI Chat 立即用上新数据

紧急手动路径（极少用）

在审签延迟影响生产的情况下，管理员 @lyd639827127 可以直接合并自己发的 PR（CODEOWNERS 允许管理员自批）。事后需要补通知对应 AE。

分支保护（需在 GitHub Settings 启用一次）

管理员请去 https://github.com/conntek-liyandong/conntek_design_center_BU1/settings/branches 配置 main 分支的保护规则：

1. 点击 Add branch protection rule
2. Branch name pattern: main
3. 勾选：
   • [x] Require a pull request before merging
     • [x] Require approvals（数量 1）
     • [x] Dismiss stale pull request approvals when new commits are pushed
     • [x] Require review from Code Owners ← 关键项
   • [x] Require status checks to pass before merging
     • [x] Require branches to be up to date before merging
     • 搜索并勾选这些必过检查：
       • Schema + cross-ref check（YAML 校验）
       • Build & Check（VitePress 构建）
       • （可选）Cloudflare Pages: conntek-design-center-bu1
   • [x] Do not allow bypassing the above settings（包括管理员）—— 或 允许（若要保留紧急手动路径）
4. Save changes

成为 BU 的 CODEOWNER

新 AE 入职后：

1. 向管理员提供 GitHub 用户名
2. 管理员把 .github/CODEOWNERS 里对应 BU/产品条目加上该用户名
3. 通过 PR 生效

附录：常见问题

Q: CI 红了但我看不懂？ A: 点红叉 → "Details" → 看 Annotations 区域，标出具体哪一行/哪一个字段的问题。若仍不懂，@ 管理员。

Q: 我想先本地试一下再提交怎么办？ A: python3 scripts/validate-products.py --files data/products/BUx/YOUR_FILE.yaml 即可本地预检。

Q: 所有权变更？ A: 发 issue @lyd639827127 说明即可。