# 模块边界与所有权

后端保持模块化单体、统一 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 客户端和两个前端必须作为一个发布单元回滚或上线。