3.5 KiB
DDD是什么
这里的 DDD 指领域规则写在领域对象上，再用分层规定代码放在哪一层。本仓库用它来规定功能模块的写法。
目录
四层
一个功能模块在 src/features/<name>/ 下按层分目录。
| 层 | 放什么 | 不放什么 |
|---|---|---|
domain |
聚合根、值对象、领域方法、端口 | React、src/app、本地或远程的说法 |
application |
用例。一次业务动作，例如登录、按 store 保存项目 |
页面状态、axios、IndexedDB |
infra |
端口的实现。访问网络或本地库，并把接口数据收成领域对象 | 页面和 ViewModel |
presentation |
页面和 ViewModel | 领域规则，例如笔画长短、撤销栈 |
没有内容的层不建空目录。首页只有 presentation，因为它不持有自己的用例，列表和新建都调用 ProjectApplication。
用例是模块的业务。SecurityApplication.login 负责登录，并把 LoginResult 里的访问凭证写入会话。ViewModel 是页面的业务，只保存当前页的表单、错误和加载状态，再调用用例。
聚合
Project 是项目聚合的根。文件：src/features/project/domain/entities/project.ts。外部通过它的方法改文档：
| 方法 | 作用 |
|---|---|
Project.create(name) |
新建一个项目 |
addShape(shape) |
位移小于 2 时拒绝；接受后把当前 Document 快照记进聚合，再加入图形 |
undo() / redo() |
在聚合内部的 past、future 之间恢复 Document |
touch() |
更新 updatedAt。保存前由用例调用 |
Document.addShape 只由 Project 调用。past 和 future 是聚合上的普通字段，不是 tProp，所以 getSnapshot(project) 不会把撤销栈写进本地库或接口。
安全模块的领域对象是 AuthCredentials、RegisterCredentials、User 和 LoginResult。用户名不少于 3 个字符，密码不少于 6 个字符，注册时两次密码相同。User.hasPermission 判断角色。LoginResult 持有 User 和 accessToken。
AUTH_CHANGED 由 src/app/session 在凭证写入或清除后通知界面。它属于会话，不属于领域对象。
端口
domain 里的端口是抽象类。方法名只表达业务，不写 local 或 remote。
ISecurityRepository.login 返回 LoginResult，register 接收 RegisterCredentials。SecurityRepository 用 Http 访问接口，再把响应收成 User 和 LoginResult。
IProjectRepository 声明 list、get、save。LocalProjectRepository 和 RemoteProjectRepository 都实现这一个端口。存在哪一侧由领域枚举 ProjectStore 决定，Project 上没有这个字段。
本仓库里怎么落
登录：
presentation/security_view_model.ts 校验表单，调用 login
application/security_application.ts 调用端口，把 accessToken 交给 TokenStore
domain/i_security_repository.ts 声明 login，返回 LoginResult
infra/security_repository.ts 用 Http 访问 /auth/login，收成 LoginResult
绘制：
presentation/editor_view_model.ts 记录草稿，调用 Project.addShape
domain/entities/project.ts 判定笔画，维护撤销栈
application/project_application.ts 按 store 调用 save
infra/..._project_repository.ts 把项目快照写入 IndexedDB 或 Http
TokenStore、Http、Database 属于 src/app，是全库能力，不是功能模块的领域规则。