kdletters
f3ab2f2ec0
按新版创作页原布局恢复泥点入口与账号身份胶囊。 在桌面侧栏补回我的页签及游客、登录态个人页面。 个人页面只复用账号、钱包、统计、设置和法律信息等平台能力。 补充壳层与个人页面回归测试并更新退役边界文档。
60 lines
3.4 KiB
Markdown
60 lines
3.4 KiB
Markdown
# Genarrative 项目共享概览
|
||
|
||
更新时间：`2026-07-17`
|
||
|
||
## 一句话定位
|
||
|
||
Genarrative / 陶泥儿是一个 AI 原生互动内容与小游戏平台，把 AI 创作、作品草稿、公开分发、运行态、用户账号、钱包任务、后台管理和小程序外壳收在同一套工程中。
|
||
|
||
产品 IP / 产品形象统一为 `public/branding/taonier-product-ip.png`：陶罐中探出的橙色耳朵形象。后续提到“产品 IP”“产品形象”或左上角品牌旁形象时默认指该资产。
|
||
|
||
## 当前主要能力
|
||
|
||
- 图片画布编辑器、项目与资产管理。
|
||
- 账号、短信 / 密码 / 微信登录、个人资料、任务、钱包、邀请码、充值、反馈、法律信息和后台管理。
|
||
|
||
## 当前入口
|
||
|
||
- 主站：`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：`推荐 / 发现 / 我的`。桌面端导航保留 `创作 / 项目 / 我的`，其中 `/creation` 是独立创作工具主页，`/project` 是画布项目入口，“我的”继续承载账号、钱包、统计和通用设置等平台公共能力。
|
||
|
||
## 当前后端路线
|
||
|
||
唯一有效后端路线：
|
||
|
||
```text
|
||
server-rs + Axum + SpacetimeDB
|
||
```
|
||
|
||
当前 SpacetimeDB crate、SDK、CLI / standalone、生成 bindings 和容器压测镜像统一按 `2.6.1` 对齐；遇到版本不匹配时先升级到 `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、公开契约和跨页面复用的无业务真相 TypeScript 代码；`packages/shared` 可承载共享 UI 组件与纯工具，但不承载领域规则、后端副作用或正式状态。
|
||
- 前端：表现、交互、临时 UI 状态和后端结果渲染。
|
||
|
||
明确废弃：旧 `server-node`、Express、PostgreSQL、Go 服务端、`maincloud`、人工 `spacetime --root-dir` 口径，以及前端承接正式业务真相的路线。
|
||
|
||
全部旧创作模板及其创作、生成、发布、公开业务详情与专属运行态已于 2026-07-17 退役。相关历史持久化表只以最小 schema 数据壳继续参与 `spacetime-module` 编译，迁移白名单与历史数据保持不变；旧前端、API、worker、procedure/reducer 和纯业务 crate 源码仅供追溯，不属于当前编译或运行能力。
|
||
|
||
## 当前文档入口
|
||
|
||
- `docs/README.md`
|
||
- `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.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、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的旧材料不再作为实现依据。
|