GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 22 Pull Requests 6 Actions Packages Projects 1 Releases Wiki Activity

补齐定价文档里漏掉的版本比对：技术方案与决策记录同步为整段覆盖

Browse Source 
- docs/technical Tripo 集成方案：删掉「后台保存携带定价版本做事务内比对、不一致 409」这句，改成整段覆盖、不做版本比对
- docs/project-memory 决策记录：在 2026-09-23 那条设计决策末尾追加 2026-09-24 的修订说明，指向同日「模型定价保存去掉版本比对」
This commit is contained in:
王德宇
2026-09-24 19:51:19 +08:00
parent ad2b37c6d3
commit a61725003e
2 changed files with 2 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/project-memory/shared-memory/decision-log.md
+1
View File
@@ -9389,6 +9389,7 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
- 代价与取舍：必须做加载期归一化，否则发布新增模型版本时表内缺键会让整段读取失败，且失败点同时打掉后台定价页，形成「进程起不来、后台也补不了价」的死锁；加价项目前按端点各留一份，用少量冗余换未来按端点差异化加价的空间。公开读取保持旧投影，代价是存储形状与公开形状短期内不一致。
- 验证方式：文档先行阶段（ADR 0005、主规范、里程碑与实施计划、`CONTEXT.md` 术语）；实现与验收证据见 [`【实施计划】3D生成定价后台可编辑-2026-09-23.md`](../plans/【实施计划】3D生成定价后台可编辑-2026-09-23.md)。
- 关联文档：[ADR 0005](../../adr/【ADR】0005-3D生成定价迁入SpacetimeDB与后台编辑-2026-09-23.md)、[编辑器模型定价配置管理方案](../../【编辑器】模型定价配置管理方案-2026-06-22.md)、[技术方案 Tripo 3D生成API集成](../../technical/【技术方案】Tripo 3D生成API集成-2026-09-21.md)。
- 后续修订（2026-09-24）：本条决心里后台保存的「携带定价版本做事务内 CAS、不一致返回 409」已整体删除，保存改为整段覆盖，见同日决策「模型定价保存去掉版本比对」。
## 2026-09-23 3D 定价后台可编辑的实现口径：公开投影取文生加价项、CAS 复用行内 updated_at、覆盖文件缺段按默认补齐
docs/technical/【技术方案】Tripo 3D生成API集成-2026-09-21.md
+1 -1
View File
@@ -142,7 +142,7 @@ price = <端点段>.versionPrices[modelVersion][texture ? "texture" : "noTexture
`model3d` 段缺失仍是合法形态：缺失即 3D 定价未配置，提交被拒绝（fail closed），既不扣费也不调用 provider；段存在时走上面的强校验路径。
2026-09-23 起这两段的事实源是 SpacetimeDB `editor_generation_pricing_config` 的两段强类型列，后台「模型定价」页面直接编辑，保存与 `models` 段在同一事务内生效，改价不再需要改文件或重启进程。读取方向按契约归一化：表内缺键用默认 JSON / 覆盖文件同段值补齐，契约之外的遗留键剔除并告警；写入方向要求两段完整合法。后台保存携带读取时拿到的定价版本，procedure 在事务内比对，不一致返回 409 并要求重新读取。公开读模型 `GET /api/editor/generation-pricing` 的 3D 段形状保持不变，画布 3D 入口的价格真相与前端零兜底口径不变。详见 [ADR 0005](../adr/【ADR】0005-3D生成定价迁入SpacetimeDB与后台编辑-2026-09-23.md) 与 [编辑器模型定价配置管理方案](../【编辑器】模型定价配置管理方案-2026-06-22.md)。
2026-09-23 起这两段的事实源是 SpacetimeDB `editor_generation_pricing_config` 的两段强类型列，后台「模型定价」页面直接编辑，保存与 `models` 段在同一事务内生效，改价不再需要改文件或重启进程。读取方向按契约归一化：表内缺键用默认 JSON / 覆盖文件同段值补齐，契约之外的遗留键剔除并告警；写入方向要求两段完整合法。后台保存是整段覆盖、不做版本比对（后台同时只有一个管理员在操作，2026-09-24 起删除版本号与 409）。公开读模型 `GET /api/editor/generation-pricing` 的 3D 段形状保持不变，画布 3D 入口的价格真相与前端零兜底口径不变。详见 [ADR 0005](../adr/【ADR】0005-3D生成定价迁入SpacetimeDB与后台编辑-2026-09-23.md) 与 [编辑器模型定价配置管理方案](../【编辑器】模型定价配置管理方案-2026-06-22.md)。
扣费依据固定为**提交时定价**：用户在提交前就能得到确定价格，失败退款是单次冲正，不需要按实际消耗退差额。provider 返回的实际消耗只写日志用于成本对账，不进入契约、不进 API 响应、不进资源行。