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:
@@ -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.db(22 模块 / 4715 符号 / 475 契约),据此修正 §11.1 proto 统计(8 文件 / 23 service / 305 message / 139 RPC)、§11.2 proto 包名(`next_edu_cloud.<domain>.v1`)、§15.4 core-edu gRPC(9 service / 43 RPC)、§15.6 msg gRPC(17 RPC)、§15.7 data-ana gRPC(18 RPC)、§15.10 student-bff 模块(8)、§15.11 parent-bff 模块(6)。
|
||||
|
||||
---
|
||||
|
||||
@@ -1469,9 +1471,7 @@ graph LR
|
||||
|
||||
### 15.11 parent-bff(NestJS :3010 / GraphQL Yoga)
|
||||
|
||||
- **模块**:HealthModule + GraphqlModule(Yoga /v1/graphql)+ ClientsModule(iam + core-edu + data-ana + msg + push-http)+ KafkaModule(cache-invalidation + notification-push handler)
|
||||
- **聚合组件**:AggregationModule(orchestrator + fallback-strategy + child-guard + response-mapper)
|
||||
- **DataLoader**:dataloader.factory + loaders(批量去重)
|
||||
- **模块(6)**:HealthModule + GraphqlModule(Yoga /v1/graphql)+ ClientsModule(iam + core-edu + data-ana + msg + push-http)+ KafkaModule(cache-invalidation + notification-push handler)+ AggregationModule(orchestrator + fallback-strategy + child-guard + response-mapper)+ DataLoaderModule(dataloader.factory + loaders 批量去重)
|
||||
- **缓存**:Redis + LRU cache + cache-key.builder
|
||||
|
||||
### 15.12 teacher-portal(Next.js 15 :4000,MF Shell)
|
||||
|
||||
1019
docs/superpowers/specs/2026-07-14-architecture-v2-redesign-design.md
Normal file
1019
docs/superpowers/specs/2026-07-14-architecture-v2-redesign-design.md
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user