Project 模块架构 适用场景 - 创建、更新或迁移项目 - 处理项目属性、标签、渠道、审批状态 - 排查成员、权限、项目资源边界 - 判断其他模块里 的真实含义 - 处理项目分片、路由、项目级基础配置 不适用场景 - 只是某个流水线、代码库或制品本身的业务逻辑 - 只是普通权限模型设计，不涉及项目这个资源域 - 只是数据库脚本设计，不涉及项目模块语义 快速指导 1. 先确认问题属于哪条主线： - 项目基础心智：看 - 项目属性、权限、分片与扩展：看 2. BK-CI 里绝大多数业务接口说的 ，实际都更接近 ，不是数据库里的 UUID 主键字段。 3. 是基础模块，很多问题看起来发生在别的模块，但根源是项目属性、项目启停状态、项目边界或项目权限没对齐。 4. 只要改项目字段、项目属性或项目路由逻辑，就要同时考虑对其他模块的影响。 高信号规则 - 项目是 BK-CI 资源隔离的基础边界 - 其他模块依赖 ，但不应该绕过它自行定义项目语义 - 项目属性常常决定后续流水线、代码库、权限和 PAC 行为 - 项目分片和路由属于基础设施能力，不是普通业务字段 关键陷阱 - 把 和业务里的 混用 - 只改项目表，不同步看项目属性和下游依赖模块 - 把项目问题误判为权限问题，或把权限问题误判为项目不存在 - 忽略项目分片、渠道和审批状态对整体行为的影响 延伸阅读 - 项目基础： - 项目属…