docs(GOV-001): 建立工程治理与追溯规范

2026-08-12 18:18:55 +08:00
parent 7cc2ba06a6
commit efdfb331bb
46 changed files with 1030 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 系统架构
+
+## 1. 仓库结构
+
+项目采用单 Git 仓库、前后端独立项目和独立部署：
+
+```text
+web/        Vue 3 前端
+server/     NestJS API、Scheduler 与 Worker
+contracts/  HTTP 与 RabbitMQ 版本化契约
+deploy/     MySQL、Redis、RabbitMQ 和运行配置
+docs/       规范、架构、ADR 与功能档案
+tools/      可重复执行的治理和开发工具
+```
+
+选择单仓库是为了让跨前端、后端、消息和部署的同一功能处于一个原子 Git 版本及一张 GitNexus 图谱中；保持独立项目是为了允许单独构建、部署和扩容。
+
+## 2. 运行边界
+
+```text
+免费数据源
+  → Scheduler 定时投递
+  → RabbitMQ
+  → 行情采集 Worker
+  → 指标计算 Worker
+  → 规则 / AI / 混合分析
+  → MySQL 历史事实 + Redis 当前快照
+  → NestJS API
+  → Vue 3 前端
+```
+
+- Scheduler只负责触发时间。
+- RabbitMQ只负责任务传递、确认、重试和死信。
+- Worker负责采集、标准化、计算和分析。
+- MySQL保存可追溯事实与历史报告。
+- Redis保存最新快照、缓存、锁和限流状态。
+- Vue前端只读后端 API，不直接接触外部数据源和密钥。
+
+## 3. 当前实施顺序
+
+第一阶段先实现可交互的市场综合概览和稳定数据契约，再接入正式行情采集链路。用户、邀请、权限、会员和支付后置，不进入当前核心架构。