a-share-analysis/docs/adr/ADR-0001-monorepo-independent-deploy.md

ADR-0001：采用单仓库、双项目、独立部署

• 状态：已接受
• 日期：2026-08-12

背景

市场概览功能会同时影响前端、API、规则、消息契约和部署配置，需要完整版本关联；API、Scheduler和Worker又必须能够独立运行。

方案

1. 前后端完全分仓：隔离强，但跨仓版本关联和整体回退复杂。
2. 单仓库双项目：统一历史与图谱，同时独立构建部署。
3. 单体应用：初期简单，但定时任务和请求链耦合。

决定

采用方案二。前端和后端拥有独立依赖、测试、构建及镜像，但共享 Git 历史、契约、文档和 GitNexus 图谱。

代价

需要维护根目录工作区和跨项目验证脚本；仓库增长后需控制索引与 CI 范围。