kdletters
660abff773
将SpacetimeDB相关Rust依赖精确锁定到2.5.0 同步本地CLI校验、生成绑定、容器与服务器provision默认版本 在文档和团队共享记忆中补充版本不匹配先升级再重试提醒 补齐拼消消生成中状态常量以恢复模块生成
60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
# Genarrative 项目共享概览
|
||
|
||
更新时间：`2026-06-12`
|
||
|
||
## 一句话定位
|
||
|
||
Genarrative / 陶泥儿是一个 AI 原生互动内容与小游戏平台，把 AI 创作、作品草稿、公开分发、运行态、用户账号、钱包任务、后台管理和小程序外壳收在同一套工程中。
|
||
|
||
## 当前主要能力
|
||
|
||
- RPG / 自定义世界创作与运行时。
|
||
- 拼图玩法创作、草稿、发布、运行态和排行榜。
|
||
- 拼消消玩法创作、素材图集生成、结果页、发布、统一作品详情、正式运行态和基础统计。
|
||
- 敲木鱼玩法创作、草稿、发布、运行态、公开详情和分享码。
|
||
- 抓大鹅 Match3D 创作、2D 多视角素材生成、发布和运行态。
|
||
- 大鱼吃小鱼、方洞挑战、视觉小说、汪汪声浪和儿童向寓教于乐玩法。
|
||
- 账号、短信 / 密码 / 微信登录、个人资料、任务、钱包、邀请码、充值、反馈、法律信息和后台管理。
|
||
|
||
## 当前入口
|
||
|
||
- 主站：`http://127.0.0.1:3000`。
|
||
- 后台：`http://127.0.0.1:3000/admin/` 或 `http://127.0.0.1:3102`。
|
||
- 后台前端工程：`apps/admin-web`。
|
||
- 小程序 WebView 外壳：`miniprogram/`。
|
||
- 法律文本：`media/files/user_agreement.md`、`media/files/privacy_policy.md`、`media/files/disclaimer.md`。
|
||
|
||
移动端一级 Tab：`推荐 / 发现 / 创作 / 草稿 / 我的`。
|
||
|
||
## 当前后端路线
|
||
|
||
唯一有效后端路线：
|
||
|
||
```text
|
||
server-rs + Axum + SpacetimeDB
|
||
```
|
||
|
||
当前 SpacetimeDB crate、SDK、CLI / standalone、生成 bindings 和容器压测镜像统一按 `2.5.0` 对齐；遇到版本不匹配时先升级到 `server-rs/Cargo.toml` 锁定版本，升级后重启对应 SpacetimeDB 进程再重试。
|
||
|
||
职责边界：
|
||
|
||
- `api-server`：HTTP / SSE / BFF 门面和外部副作用编排。
|
||
- `spacetime-module`：SpacetimeDB 表、reducer、procedure、事务 adapter 和 row mapper。
|
||
- `spacetime-client`：后端访问 SpacetimeDB 的 typed facade。
|
||
- `module-*`：纯领域模型、命令、应用规则、领域事件和领域错误。
|
||
- `platform-*`：OSS、LLM、认证、语音等外部平台能力。
|
||
- `shared-contracts` / `packages/shared`：前后端 DTO 和公开契约。
|
||
- 前端：表现、交互、临时 UI 状态和后端结果渲染。
|
||
|
||
明确废弃：旧 `server-node`、Express、PostgreSQL、Go 服务端、`maincloud`、人工 `spacetime --root-dir` 口径，以及前端承接正式业务真相的路线。
|
||
|
||
## 当前文档入口
|
||
|
||
- `docs/README.md`
|
||
- `docs/【项目基线】当前产品与工程约束-2026-05-15.md`
|
||
- `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`
|
||
- `docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`
|
||
- `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
|
||
旧 PRD、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的旧材料不再作为实现依据。
|