From 60f25f3aa50d90ce1c262e421cdf27ef8427a9a0 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Tue, 21 Apr 2026 00:43:15 +0800
Subject: [PATCH] docs: add auth module package placeholder

---
 .../01_M0_M2_FOUNDATION_AND_AUTH.md           |  3 +-
 server-rs/README.md                           | 44 +++++++++----------
 server-rs/packages/module-auth/README.md      | 29 ++++++++++++
 3 files changed, 53 insertions(+), 23 deletions(-)
 create mode 100644 server-rs/packages/module-auth/README.md

diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
index b066d9b9..54ca0ddd 100644
--- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
+++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
@@ -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`
diff --git a/server-rs/README.md b/server-rs/README.md
index a3f48b3b..2b011934 100644
--- a/server-rs/README.md
+++ b/server-rs/README.md
@@ -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. 已冻结边界
 
diff --git a/server-rs/packages/module-auth/README.md b/server-rs/packages/module-auth/README.md
new file mode 100644
index 00000000..8ba82c89
--- /dev/null
+++ b/server-rs/packages/module-auth/README.md
@@ -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` 暴露。