# Genarrative 项目共享概览

更新时间：`2026-05-15`

## 一句话定位

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
```

职责边界：

- `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、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的旧材料不再作为实现依据。