lhk229
aaa52c2b34
新增独立设计会话、工作区工具和随包资源 platform-llm 支持 Responses 原生 input 续轮 无旧 V2 会话的策划入口切换到新设计 Agent 增加阶段审批、澄清卡和工作区文件浏览 同步迁移方案与决策记录
3.9 KiB
3.9 KiB
C3 03_数据与配表/模板.md（→ templates/tdd-data.md）
数据与配表：《游戏名》
状态：{structuring / filling / accepted} | 基于：各系统交接节汇总 | 验收：check@{id} 最新结论 __
数据表总清单
| 表格组 | 建议表名 | 主要维护系统 |
|---|---|---|
| __ | __ | __ |
（表格拆分是生产组织方式，不改变主数据归属。）
字段字典与 ID 命名规范
- ID 命名：小写 snake_case，
对象类型_名称_必要时加阶段（如item_turnip）；全局唯一、废弃不复用。 - 通用字段：
*_id/display_name_text_id/description_text_id/condition_id/enabled_state（active·draft·disabled·deprecated）/sort_order/designer_note/unit（数值字段必填：time_slice·game_day·currency·stamina·exp）。 - 常用后缀：
_amount（配单位）/_cost/_rule_id/_condition/_time/_duration/_state/_text_id。 - 类型与空值：数值栏禁"约/无/待定"；空值=不适用≠0≠无限；布尔 true/false；多值一律关系子表。
- 引用完整性：
item_id→物品表；location_id→区域表；npc_id→NPC表；quest_id→任务表；recipe_id→配方表；condition_id→条件表；text_id→文本表。删除先置deprecated并查引用。
公共条件表
| condition_id | condition_type | target_id | operator | required_value | enabled_state | 备注 |
|---|---|---|---|---|---|---|
| __ | date_day / progress_flag / skill_level / schedule_open / quest_completed / __ | __ | __ | __ | active | __ |
（复杂条件拆条件组+条件行；全项目只此一个条件入口，程序实现一次 check(condition_id)。）
工作簿组织与建表顺序
| 工作簿 | 工作表 |
|---|---|
__ .xlsx |
__ |
建表顺序：①物品表（公共 item_id）→ ②__ → ③__ → ④__ → ⑤__ → ⑥__ → ⑦__ → ⑧__。 每完成一组查三件事：引用 ID 存在 / 条件有负责系统 / 同一数值只有一个系统维护。
表格-程序契约
- 加载顺序按引用拓扑：主数据 → 关系 → 条件 → 文本（最后）。
- 启动期全量校验（外键/枚举/单位）；运行期全部 id→对象字典 O(1) 查找。
- 条件求值统一
check(condition_id)，全部系统复用。 - enabled_state 生命周期：active 加载；draft 调试可见；disabled 不加载；deprecated 不加载但留 ID 占位。
- 单位类型化（time_slice/game_day/currency/stamina/exp 进类型系统，同列禁混单位）。
- 多值一律关系子表；运行期无"解析逗号拼接"代码路径。
- 改表 → 验收过检（blocker=CI 红灯）→ 进包；
data_version为迁移依据。
数值填充与验算
- 填充代决台账：
| 表 | 字段 | 默认值 | 依据 | 推翻条件 |
|---|---|---|---|---|
| __ | __ | __ | T__ / 台账 id | __ |
- 前五日闭环验算：
| 日期 | 主目标 | 关键行动 | 主要成本 | 主要获得 | 结果 |
|---|---|---|---|---|---|
| 第 1 日 | __ | __ | __ | __ | __ |
- 收益链校验：
__ → __ → __ → __ → __（逐环引 ID）。
验收
- 验收记录：check_id / workbook / sheet / data_version / check_type（primary_key·reference·enum·unit·range·business_rule·duplicate_ownership）/ severity（blocker·warning·note）/ result / issue / owner / resolution。
- 五查必过：主键唯一不空；外键存在且目标非弃用；枚举有清单；单位可判且同列不混；无违规负数、
duration=0仅即时。 - 两查复核：业务规则（季节窗口相容、目标有验证系统、奖励一次、配方输入可达）；重复归属（身份/价格/成本/奖励/位置各只有一个写权）。
- 三级处置：blocker 禁止扩内容；warning 记负责人与计划；note 不阻断。
- 最近验收结论：__（结构、规则或字段语义一变，受影响链路全部重验。）