JenkenB
dfd567fe2c
Introduce a new detailed Agent handbook (docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md) and refactor AGENTS.md to be an entry-only navigation page. Update documentation cross-references (docs/README.md, project-memory README, document-map, team-conventions, development-workflow, decision-log and project-overview) to point to the new file and clarify reading/order rules, submission/validation constraints, and SpacetimeDB/back-end wording. Also adjust image canvas generation placement rules in the frontend doc and apply related changes to image-editor hooks/tests (src/components/image-editor/*). Purpose: separate high-level entry rules from complex execution details to reduce startup cost for complex tasks and centralize execution practices in a single guideline document.
3.0 KiB
3.0 KiB
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：推荐 / 发现 / 我的。桌面端导航保留 创作 并新增 项目，其中 /creation 是独立创作工具主页，/project 是画布项目入口。
当前后端路线
唯一有效后端路线：
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.mddocs/【协作规范】Agent工作入口与执行准则-2026-06-22.mddocs/【项目基线】当前产品与工程约束-2026-05-15.mddocs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.mddocs/【玩法创作】平台入口与玩法链路-2026-05-15.mddocs/【开发运维】本地开发验证与生产运维-2026-05-15.md
旧 PRD、设计、审计、阶段计划和技术流水账已融合进上述文档；没有融合的旧材料不再作为实现依据。