跳到主要内容

ADR 0001: 核心仓库职责冻结与收敛

状态​

已接受 (2026-03-06)

背景​

随项目演进，出现多仓功能重叠、文档滞后及前端实现分裂等问题，极大推高了维护与回归成本。亟需明确各仓的唯一职责边界，消除冗余。

决策​

自即日起冻结以下 8 个核心仓库的“主实现”地位，任何跨仓/重叠实现必须停止，并逐步迁移回主仓：

  1. sayclaw-backend：核心业务后端（Admin API + Portal API）。这是唯一合法的后端主仓库（有利于商业化阶段统一配置、鉴权和共享DB模型）。
  2. sayclaw-admin：后台前端主实现（基于 Soybean Admin）。
  3. sayclaw-app：Portal 员工前端（短期保留，后续规划向工程化迁移）。
  4. sayclaw-docs：唯一架构与规范事实源。
  5. sayclaw-infra：基础设施配置（Terraform/GCP）主实现。
  6. sayclaw-ops：全局运维与部署脚本库。
  7. sayclaw-portal：降级为废弃仓，禁止新增业务逻辑（因其与 backend 仓重叠，为降本增效予以下线）。
  8. sayclaw：总控与索引仓，不承载具体业务代码。

约束​

  • 一个能力只能在 一个 仓库实现。
  • 跨仓架构变动必须提 ADR 评审。
  • AI Agent 必须切入 wangcai 分支开发，严禁直推 main。