docs: add auth module package placeholder
This commit is contained in:
@@ -49,7 +49,8 @@
|
||||
交付物:[../server-rs/apps/api-server/README.md](../server-rs/apps/api-server/README.md)
|
||||
- [x] 创建 `apps/spacetime-module`
|
||||
交付物:[../server-rs/apps/spacetime-module/README.md](../server-rs/apps/spacetime-module/README.md)
|
||||
- [ ] 创建 `packages/module-auth`
|
||||
- [x] 创建 `packages/module-auth`
|
||||
交付物:[../server-rs/packages/module-auth/README.md](../server-rs/packages/module-auth/README.md)
|
||||
- [ ] 创建 `packages/module-runtime`
|
||||
- [ ] 创建 `packages/module-story`
|
||||
- [ ] 创建 `packages/module-combat`
|
||||
|
||||
@@ -14,37 +14,37 @@
|
||||
|
||||
## 2. 当前阶段说明
|
||||
|
||||
当前目录已经完成以下五项初始化:
|
||||
当前目录已经完成以下六项初始化:
|
||||
|
||||
1. 为新后端预留正式目录并把路径固定到仓库结构中。
|
||||
2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。
|
||||
3. 明确内部采用“`apps/*` 主工程 + `packages/*` 独立模块包”的多 package 组织方式。
|
||||
4. 创建 `apps/api-server/` 目录占位,固定 Axum 主工程落位。
|
||||
5. 创建 `apps/spacetime-module/` 目录占位,固定 SpacetimeDB 主工程落位。
|
||||
6. 创建 `packages/module-auth/` 目录占位,固定鉴权模块 package 落位。
|
||||
|
||||
后续任务会继续在本目录内按顺序补齐:
|
||||
|
||||
1. `packages/module-auth`
|
||||
2. `packages/module-runtime`
|
||||
3. `packages/module-story`
|
||||
4. `packages/module-combat`
|
||||
5. `packages/module-inventory`
|
||||
6. `packages/module-npc`
|
||||
7. `packages/module-progression`
|
||||
8. `packages/module-quest`
|
||||
9. `packages/module-runtime-item`
|
||||
10. `packages/module-custom-world`
|
||||
11. `packages/module-assets`
|
||||
12. `packages/module-editor`
|
||||
13. `packages/module-ai`
|
||||
14. `packages/shared-contracts`
|
||||
15. `packages/shared-kernel`
|
||||
16. `packages/platform-auth`
|
||||
17. `packages/platform-oss`
|
||||
18. `packages/platform-llm`
|
||||
19. `packages/spacetime-client`
|
||||
20. `packages/tests-support`
|
||||
21. `scripts/*`
|
||||
1. `packages/module-runtime`
|
||||
2. `packages/module-story`
|
||||
3. `packages/module-combat`
|
||||
4. `packages/module-inventory`
|
||||
5. `packages/module-npc`
|
||||
6. `packages/module-progression`
|
||||
7. `packages/module-quest`
|
||||
8. `packages/module-runtime-item`
|
||||
9. `packages/module-custom-world`
|
||||
10. `packages/module-assets`
|
||||
11. `packages/module-editor`
|
||||
12. `packages/module-ai`
|
||||
13. `packages/shared-contracts`
|
||||
14. `packages/shared-kernel`
|
||||
15. `packages/platform-auth`
|
||||
16. `packages/platform-oss`
|
||||
17. `packages/platform-llm`
|
||||
18. `packages/spacetime-client`
|
||||
19. `packages/tests-support`
|
||||
20. `scripts/*`
|
||||
|
||||
## 3. 已冻结边界
|
||||
|
||||
|
||||
29
server-rs/packages/module-auth/README.md
Normal file
29
server-rs/packages/module-auth/README.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# module-auth 独立模块 package 占位说明
|
||||
|
||||
日期:`2026-04-20`
|
||||
|
||||
## 1. package 职责
|
||||
|
||||
`module-auth` 是鉴权与会话模块 package,后续负责:
|
||||
|
||||
1. 用户身份、会话、风控、审计相关领域模型
|
||||
2. 手机验证码、微信登录、密码登录的模块内用例编排
|
||||
3. 与 `apps/api-server` 的鉴权接口装配对接
|
||||
4. 与 `apps/spacetime-module` 的身份表、会话表聚合对接
|
||||
|
||||
## 2. 当前阶段说明
|
||||
|
||||
当前提交仅完成目录占位,不提前进入接口、表结构与 token 细节实现。
|
||||
|
||||
后续与本 package 直接相关的任务包括:
|
||||
|
||||
1. 设计 `user_account`、`auth_identity`、`refresh_session`
|
||||
2. 设计 `auth_audit_log`、`auth_risk_block`
|
||||
3. 设计 `sms_auth_event`、`wechat_auth_state`
|
||||
4. 落地 JWT claims、refresh cookie 与旧接口兼容
|
||||
|
||||
## 3. 边界约束
|
||||
|
||||
1. `module-auth` 负责鉴权领域规则与模块级编排,不直接把供应商 SDK 逻辑写进主工程。
|
||||
2. 短信、微信、JWT、Cookie 等平台适配优先通过 `packages/platform-auth` 承接。
|
||||
3. 身份与会话状态最终由 `apps/spacetime-module` 聚合,前端接口由 `apps/api-server` 暴露。
|
||||
Reference in New Issue
Block a user