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 18fae868..f6fbf532 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -77,7 +77,8 @@ 交付物:[../server-rs/packages/module-ai/README.md](../server-rs/packages/module-ai/README.md) - [x] 创建 `packages/shared-contracts` 交付物:[../server-rs/packages/shared-contracts/README.md](../server-rs/packages/shared-contracts/README.md) -- [ ] 创建 `packages/shared-kernel` +- [x] 创建 `packages/shared-kernel` + 交付物:[../server-rs/packages/shared-kernel/README.md](../server-rs/packages/shared-kernel/README.md) - [ ] 创建 `packages/platform-auth` - [ ] 创建 `packages/platform-oss` - [ ] 创建 `packages/platform-llm` diff --git a/server-rs/README.md b/server-rs/README.md index 67e7bc95..09ed5773 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下十九项初始化: +当前目录已经完成以下二十项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -35,16 +35,16 @@ 17. 创建 `packages/module-editor/` 目录占位,固定编辑器读写模块 package 落位。 18. 创建 `packages/module-ai/` 目录占位,固定 AI 编排模块 package 落位。 19. 创建 `packages/shared-contracts/` 目录占位,固定前后端兼容 contract 共享 package 落位。 +20. 创建 `packages/shared-kernel/` 目录占位,固定跨模块共享领域内核 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/shared-kernel` -2. `packages/platform-auth` -3. `packages/platform-oss` -4. `packages/platform-llm` -5. `packages/spacetime-client` -6. `packages/tests-support` -7. `scripts/*` +1. `packages/platform-auth` +2. `packages/platform-oss` +3. `packages/platform-llm` +4. `packages/spacetime-client` +5. `packages/tests-support` +6. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/shared-kernel/README.md b/server-rs/packages/shared-kernel/README.md new file mode 100644 index 00000000..43844c0d --- /dev/null +++ b/server-rs/packages/shared-kernel/README.md @@ -0,0 +1,28 @@ +# shared-kernel 共享 package 占位说明 + +日期:`2026-04-20` + +## 1. package 职责 + +`shared-kernel` 是跨模块共享领域内核 package,后续负责: + +1. 共享 ID、值对象、枚举与基础领域类型 +2. 共享时间、状态、版本、通用校验等基础规则 +3. 供各模块 package 复用的最小领域内核 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位,不提前进入具体共享类型与基础规则实现。 + +后续与本 package 直接相关的任务包括: + +1. 统一用户、会话、世界、角色、资产等核心 ID 类型 +2. 统一时间戳、版本号、状态枚举等共享结构 +3. 抽取真正跨模块复用的最小领域规则 +4. 避免把模块私有规则错误上提到共享内核 + +## 3. 边界约束 + +1. `shared-kernel` 只放跨模块最小共享内核,不承接具体业务模块的私有规则。 +2. 任何进入本 package 的类型都必须证明至少被多个模块稳定复用。 +3. 不能把主模块实现重新堆进共享内核,避免形成新的“大公共垃圾桶”。