docs(docs): 004 arch.db 二次校验 + 新增 v2 架构重设计 spec

004 修正 7 处与代码不符描述:

- proto 统计 / 包名 / core-edu gRPC service 数

- msg RPC 数 / data-ana RPC 数

- student-bff 模块数 / parent-bff 模块数

新增 v2 架构重设计 spec(996 行):

- Apollo Federation BFF 联邦

- DataScope @requires 运行时解析

- iam 拆分 config-service

- content CQRS / ai 无状态化

- SSE 优先 / Temporal 不引入

Spec 自审修复 6 处问题:

- apollo-router 端口冲突 4000→4011

- Kafka topic 命名一致性

- CDC/Outbox 投影器职责分工

- 改动点数字 / 服务数 / 容器数计算
This commit is contained in:
SpecialX
2026-07-14 21:25:37 +08:00
parent 594a4e65fe
commit 62682b9d61
2 changed files with 1023 additions and 4 deletions

View File

@@ -2,7 +2,7 @@
> 版本2.0
> 日期2026-07-14
> 状态:实施状态同步(基于代码现状校准)
> 状态:实施状态同步(基于代码现状 + arch.db 校准)
> 适用范围Edu 微服务架构DDD + EDA + CQRS
> 关联文档:
>
@@ -13,6 +13,8 @@
> - [P6 附录](./004-p6-addendum.md)
> **v2.0 变更摘要**:基于代码现状(截至 2026-07-14全面校准服务清单、模块边界、依赖关系、Kafka topic、可观测性栈、BFF 实现细节;新增 §15 实施状态索引。
>
> **arch.db 二次校验2026-07-14**:运行 `pnpm run arch:scan` 重建 arch.db22 模块 / 4715 符号 / 475 契约),据此修正 §11.1 proto 统计8 文件 / 23 service / 305 message / 139 RPC、§11.2 proto 包名(`next_edu_cloud.<domain>.v1`、§15.4 core-edu gRPC9 service / 43 RPC、§15.6 msg gRPC17 RPC、§15.7 data-ana gRPC18 RPC、§15.10 student-bff 模块8、§15.11 parent-bff 模块6
---
@@ -1469,9 +1471,7 @@ graph LR
### 15.11 parent-bffNestJS :3010 / GraphQL Yoga
- **模块**HealthModule + GraphqlModuleYoga /v1/graphql+ ClientsModuleiam + core-edu + data-ana + msg + push-http+ KafkaModulecache-invalidation + notification-push handler
- **聚合组件**AggregationModuleorchestrator + fallback-strategy + child-guard + response-mapper
- **DataLoader**dataloader.factory + loaders批量去重
- **模块6**HealthModule + GraphqlModuleYoga /v1/graphql+ ClientsModuleiam + core-edu + data-ana + msg + push-http+ KafkaModulecache-invalidation + notification-push handler+ AggregationModuleorchestrator + fallback-strategy + child-guard + response-mapper+ DataLoaderModuledataloader.factory + loaders 批量去重)
- **缓存**Redis + LRU cache + cache-key.builder
### 15.12 teacher-portalNext.js 15 :4000MF Shell