№ · 任务清单
CH.07.04
2026-07-03-item-data-source-alignment
⟦tag:v2|task|2026-07-03-item-data-source-alignment⟧
kind: task
id: 2026-07-03-item-data-source-alignment
objective: 在 道具模块 owner 下,先完成 道具-数据真源整理 这条最小短工 lane,锁清当前 item 数据层真源、兼容字段与废弃字段边界,不扩到运行时和 UI 接线。
scope: docs/plans/active/2026-07-03-5day-demand-owner-board-v1.md, docs/handoff/tasks/2026-07-03-item-module-owner.md, docs/handoff/sessions/2026-07-03-item-module-owner-01.md, src/data/items/**, src/types.ts
acceptance:
- 道具数据结构、品质、词条池、掉落/生成输入字段有单一真源说明
- 明确哪些旧字段仍保留兼容,哪些已废弃或只作历史兼容
- 不新增跨层污染;数据层只保留类型 / 常量,不塞函数
- 不扩到
src/utils/items/**的运行时重构,不扩到src/components/**的展示接线 - 回 summary package,默认不输出整段
git diffcurrent state: verified blockers: none next action: 本卡已完成最小 data truth 收口;item 模块后续如需继续,一律先回到当前 live owner board⟦tag:v2|task|2026-07-03-item-module-owner⟧与docs/handoff/current-dispatch-shortlist.md。只有出现新的 direct truth source 且正式替换当前 owner board 时,才按新 truth source 改判是否重开道具-数据/运行时拆层 truth lane或其它 item follow-up。 summary: - 这条 lane 直接来自
道具模块owner 第一轮 intake。 - 当前优先级是先锁 data truth,再决定后续
生成与词条运行时/背包与展示接线。 - 该 lane 只做 item 数据面,不借机扩成整模块实现。
- 当前 formal callback 已吸收:
src/data/items/types.ts被确认是 schema 真源,src/data/items/index.ts仅保留聚合出口职责,重复ItemDropConfig已收敛到单一定义;旧src/types.tsitem 结构当前仍按兼容桥保留。 - 当前 lane 同时识别到既有跨层污染风险:
src/data/items/index.ts仍承载查询 / 类型守卫 / 效果应用 / 随机掉落函数,但该风险属于后续 truth lane,不阻塞本卡最小 data truth 验收。 - 当前最新监督结论:当前 live item owner board 是
⟦tag:v2|task|2026-07-03-item-module-owner⟧;旧的⟦tag:v2|task|2026-07-04-phase1-closeout-owner⟧只保留为历史 prep/gate 证据,不再作为当前 live owner board。