人生资源、能力与资产

自我与身份技术代码 resource

管理时间、精力、技能、财务边界、人脉和可投入资源。

模块职责

管理时间、精力、技能、财务边界、人脉和可投入资源。
维护“人生资源、能力与资产”内部对象的生命周期与隐私边界。
通过稳定公共接口与其他模块协作，禁止跨模块直接修改数据表。

明确不负责

不直接处理其他模块的领域规则。
不把用户原文静默替换为AI生成内容。
不在浏览器或移动端复制服务端权限判断。

RES-001 至 RES-008 Resource typed 后端切片（Catalog 仍保持 partial）

0056_resource_vertical_slice.sql 建立 resource_account、root revision、时间/精力/技能事实、财务边界和 Relationship link 共九张 typed 表；所有 owner/module/record 关系使用复合 FK，数值固定为 numeric(20,6)（最多 14 位整数、6 位小数）。
RES-001 至 RES-006 使用 owner-scoped 专用 v2 路由、expectedRevision、Idempotency-Key、root 行锁和 append-only revision；generic Record Kernel 写入与旧 v1 写入分别以 Resource 专用 501/410 失败关闭，不把任意 payload 伪装为领域事实。
RES-007 使用 RESOURCE_OVERLOAD_V1 定点比较，TIME 的 20% 为 WATCH、50% 为 NORMAL，容量为零或输入缺失为 UNKNOWN；RES-008 只读导出 resource-export-v1，默认排除 SECRET，50,000 行和 33,554,432 字节任一超限均返回 413 且不截断。
MONEY 至少 PRIVATE，并要求财务权限和 step-up；RES-006 只经 Relationship typed public port 固定来源 revision/hash，来源变化映射 STALE，不覆盖本地链接。RES-007/008 不写 revision、execution、audit、idempotency 或 outbox。
Resource 错误状态/details 单测、pg-mem HTTP 测试和 PostgreSQL 16 Testcontainer 约束测试已登记；当前页面、Catalog 和真实运行态证据仍需独立验收，不能据后端代码标记八项 completed。

结构化字段

字段	中文名	编辑类型	必填	敏感性	业务说明
`resourceType`	资源类型	select	是	普通	用于记录“资源类型”的业务值。
`name`	资源名称	text	是	普通	用于记录“资源名称”的业务值。
`amount`	数量或水平	number	否	普通	用于记录“数量或水平”的业务值。
`unit`	单位	text	否	普通	用于记录“单位”的业务值。
`capacity`	最大容量	number	否	普通	用于记录“最大容量”的业务值。
`available`	当前可用	number	否	普通	用于记录“当前可用”的业务值。
`level`	能力等级	number	否	普通	用于记录“能力等级”的业务值。
`notes`	资源说明	textarea	否	普通	用于记录“资源说明”的业务值。

八项可执行功能

编号	功能	规划版本	完成状态	独立外部边界	执行策略
`RES-001`	个人资源账户	V1.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-002`	时间容量	V1.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-003`	精力快照	V1.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-004`	技能资产档案	V1.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-005`	财务资源边界	V2.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-006`	人脉资源视图	V2.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	record
`RES-007`	资源超载预警	V2.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	analyze
`RES-008`	资源快照导出	V3.0	部分实现：领域闭环尚未完成，功能入口失败关闭	无独立外部边界注记	export

本模块状态：partial 8。状态由专用规则、聚合持久化、PC/移动行为和自动测试共同决定；外部 blocker 与历史 Provider 记录只作独立注记，不提升完成度。

HTTP 与数据生命周期

Resource typed 读写必须经 /api/v2/resource/... 专用 API；通用 Record Kernel 仅保留非 typed 记录只读兼容，Resource generic/v1 写入均失败关闭。统一提供创建、列表、详情、修改、归档、恢复、修订历史、执行历史和功能入口；POST/GET /api/v2/records/:moduleCode、GET/PATCH /api/v2/records/:moduleCode/:recordId、POST /archive、POST /restore、GET /revisions、GET /executions、POST /features/:featureId；共 9 条获批路由，无 DELETE。Identity typed 快照的通用写入失败关闭，typed 读取也必须使用 v2 专用接口；非 typed legacy core 仅保留只读兼容。 v2 不提供永久销毁，旧 v1 兼容链不从新页面调用。创建和更新先经 SystemRecordPolicyPort，由内核外的 SystemRecordPolicyRegistry 依次执行专用规范化、跨字段规则和 Catalog 字段规则；带键 cache miss 先取得事务内幂等预占，再执行无副作用策略；策略失败会让预占与数据库、审计副作用共同回滚，成功 cache hit 则直接精确恢复首次 revision。功能地址会先校验目录归属；partial 功能统一返回 HTTP 501 FEATURE_NOT_IMPLEMENTED，且不新增修订、执行、审计或幂等记录。迁移维护 active 时普通写返回 HTTP 503 SYSTEM_MAINTENANCE，读接口继续可用。MEM-001 至 MEM-008 的通用功能地址均返回对应专用地址错误，必须改用各自的 /api/v2/memory/... 专用入口。

参数化代码入口

apps/api/src/kernel/recordsapps/api/src/record-policiesapps/api/src/feature-registryapps/web/app/pages/modules/[moduleCode]apps/web/app/composables/useRecordKernel.tsapps/mobile/src/pages/module/index.vueapps/mobile/src/pages/recorddocs-site/modules/resource.html

Mobile 使用 /pages/module/index?module=... 与 /pages/record/* query 容器；MEM-001 使用 /pages/memory/text/create，MEM-002 至 MEM-008 使用 /pages/memory/text/detail 专用治理详情，TAX-001 至 TAX-008 共用 /pages/taxonomy/tags/index 的标签、分类、合并、编号、标题、AI 候选和审计专用交互。旧 24×5 包装页和 descriptor 副本不属于当前架构。

设计原因

模块目录提供稳定业务语义和白名单；RecordAggregate 只负责公共记录生命周期，不解释 payload。SystemRecordPolicyRegistry 在内核外精确覆盖 Catalog 24 个模块，保留 Routine、Decision、Memory、Interview 的专用规范化，并拒绝未登记模块。Batch 003 固定规范大写 ULID、标题 200/摘要 1000 字符合同、payload 顶层覆盖与 payloadRemove 删除语义、受控 JSON 资源上限、递归敏感字段治理、幂等最小引用和精确 revision/execution 回放。0009 只追加 summary CHECK 与 owner/module[/status] + id DESC 匹配索引。该等价层与公共加固仅保持普通记录合同，不代表领域功能完成；领域完成仍必须由专用规则、类型化持久化、PC/Mobile 行为和当前自动测试共同证明。