Merge branch 'master' of https://git.genarrative.world/GenarrativeAI/Genarrative

.hermes/shared-memory/decision-log.md

@@ -32,6 +32,14 @@
 - 验证方式：执行 `cargo test -p api-server match3d --manifest-path server-rs\Cargo.toml`、`cargo test -p shared-contracts match3d --manifest-path server-rs\Cargo.toml`、`npm run typecheck`、`npm run check:encoding`，并定向跑 `Match3DRuntimeShell.test.tsx` 中尺寸和生成图片相关用例。
 - 关联文档：`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
 
+## 2026-05-15 充值商品配置入库且首充按档位独立计算
+
+- 背景：泥点充值原来依赖代码中的固定商品目录，首充双倍也按账号是否买过任一泥点统一隐藏，导致用户买过 `points_60` 后其它未购买档位也失去首充展示。
+- 决策：新增 `profile_recharge_product_config` 作为泥点和会员商品配置真相源，默认商品只在空库时播种；后台通过“充值商品”页维护配置。泥点首充资格按 `user_id + product_id` 的历史 `paid` 订单独立判断，`hasPointsRecharged` 仅保留为账号是否发生过任一泥点充值的兼容字段，不再驱动所有商品展示或结算。
+- 影响范围：`module-runtime` 充值领域输入、`spacetime-module` 充值表与 procedure、`spacetime-client` bindings/facade、`api-server` `/admin/api/profile/recharge-products`、`apps/admin-web` 充值商品页、主站充值弹窗。
+- 验证方式：执行 `cargo test -p module-runtime recharge --manifest-path server-rs/Cargo.toml`、`cargo check -p api-server --manifest-path server-rs/Cargo.toml`、`npm run test -- src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx`、`npm run admin-web:typecheck`、`npm run check:spacetime-schema`。
+- 关联文档：`docs/【项目基线】当前产品与工程约束-2026-05-15.md`、`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`。
+
 ## 2026-05-14 创作页图像输入统一封装为图像组件
 
 - 背景：拼图创作页已经具备“画面描述生图 / 多参考图生图 / 上传主图后 AI 重绘 / 上传主图后不重绘”四条路径，抓大鹅封面和后续创作页也会复用同一套交互；继续在页面内复制会导致参考图、预览、删除确认和重绘开关漂移。

.hermes/shared-memory/pitfalls.md

@@ -286,6 +286,14 @@
 - 验证：发布前运行 `npm run check:spacetime-schema`，完成 schema 检查、bindings 生成、表目录更新和相关 smoke。
 - 关联：`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`、`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`。
 
+## SpacetimeDB schema guard 新增表应校验 sidecar，不应把新增本身当失败
+
+- 现象：新增 SpacetimeDB 表后，schema guard 只要看到新 table accessor 就直接报错，哪怕 `migration.rs`、表目录和生成绑定都已同步。
+- 原因：守卫脚本把“发现新增表”本身当成失败，而不是把它当成需要校验 sidecar 的信号。
+- 处理：新增表只应触发 `migration.rs`、`SPACETIMEDB_TABLE_CATALOG.md` 和 bindings 的一致性检查；当 sidecar 都已同步时，新增表应允许通过。不要把“合法新增表”本身判成失败。
+- 验证：`npm run check:spacetime-schema` 在新增表、迁移、目录和绑定都同步后应通过。
+- 关联：`scripts/check-spacetime-schema-guard.mjs`、`server-rs/crates/spacetime-module/src/migration.rs`、`docs/technical/SPACETIMEDB_TABLE_CATALOG.md`。
+
 ## SpacetimeDB publish 报 wasm-bindgen 时先查 shared-contracts feature
 
 - 现象：发布 `spacetime-module` 时报 `wasm-bindgen detected`，提示 `wasm-bindgen is only for webassembly modules that target the web platform`。