41 lines
2.2 KiB
Markdown
41 lines
2.2 KiB
Markdown
# 模块边界与所有权
|
||
|
||
后端保持模块化单体、统一 PostgreSQL、独立 API/Worker。目录是团队所有权边界，跨模块调用必须经过 `Tiku.Application` 合同。
|
||
|
||
## 依赖方向
|
||
|
||
```text
|
||
Platform Core: Tenancy / Auth / Security
|
||
Catalog -> QuestionBanks -> Content / Assets -> Learning
|
||
Commerce -> Points / Growth
|
||
TenantAdmin / PlatformAdmin -> Application contracts or dedicated read models
|
||
Jobs -> queue / processor / operations + module job handlers
|
||
```
|
||
|
||
- API Controller 不得引用 `Tiku.Infrastructure` 或 `TikuDbContext`。
|
||
- 一个模块不得引用另一个模块的 Infrastructure 类型。
|
||
- 跨模块查询使用 Application 查询合同；跨模块写入调用目标模块命令合同。
|
||
- `TikuDbContext` 仍是统一事务入口，但 DbSet 按模块拆在 `Persistence/Modules`。
|
||
- EF Migration 与模型快照串行合并，由 CODEOWNERS 默认负责人复核。
|
||
|
||
## 子模块目录
|
||
|
||
- TenantAdmin：Dashboard、Classes、Students、Supervision、StudentEngagement、MembersAndAccess、SiteSettings、DomainsAndEngagement。
|
||
- Content：Questions、Vocabulary、Handbook、EducationCatalog、Scorelines、Videos、OperationContent、Imports。
|
||
- Learning：Analytics、Answering、QuestionReview、WordLearning、PracticeSessions、Foundation。
|
||
- Commerce：Orders、Payments、Coupons、Refunds、Reconciliation、Adjustments、Points。
|
||
- PlatformAdmin：Dashboard、TenantProvisioning、TenantDomains、StaffAndAccess、AuditAndAlerts、Dunning、Operations。
|
||
|
||
Service 文件超过 500 行应在评审中说明原因，超过 800 行由架构测试阻止新增。现有聚合接口应逐步由子模块接口替代，不允许把新能力继续追加到聚合 Service。
|
||
|
||
## API audience
|
||
|
||
- `/api/platform/*`：平台控制面。
|
||
- `/api/tenant/*`：租户管理后台。
|
||
- `/api/student/*`：学生业务。
|
||
- `/api/public/*`：匿名公开读取。
|
||
- `/api/system/*`：健康与内部诊断。
|
||
- `/api/integrations/*`：外部系统回调。
|
||
|
||
旧的 platform-admin、backoffice、tenant-admin、tenant-content 和 tenant-commerce 路由不再提供兼容入口。后端、OpenAPI 客户端和两个前端必须作为一个发布单元回滚或上线。
|