docs: add shared kernel package placeholder

This commit is contained in:
2026-04-21 00:53:45 +08:00
parent 7c790377ab
commit 6d26cfdc94
3 changed files with 38 additions and 9 deletions

View File

@@ -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. 不能把主模块实现重新堆进共享内核,避免形成新的“大公共垃圾桶”。