Files

duanshuwen 7ba92f3c5d feat: 新增客片案例与团队共创模块，重构玩法与配置

- 新增客片案例全流程功能，包含前台页面、管理端配置、后端API、数据库迁移与文档
- 新增团队共创详情页面与对应接口
- 重构玩法模块：将静态playData替换为动态API获取，拆分类型定义到playTypes.ts
- 优化vite构建配置与环境变量处理，调整详情页操作栏文案
- 更新全量相关文档与配图，新增客片案例、团队共创API文档
- 新增测试用例，完善数据归一化逻辑
- 调整路由配置与环境变量示例文件

2026-08-19 20:23:04 +08:00

3.7 KiB

Raw Blame History

WonderQ 文档索引

本目录只保留当前有效文档，用于支撑 WonderQ-Admin、WonderQ-Admin-UI、WonderQ-MiniAPP 三端并行开发和联调。非当前技术路径不放在当前文档集中。

文档清单

文档	作用	主要读者
`integration-workflow.md`	三端本地启动、联调顺序、接口变更流程和验证命令	全部
`development-status.md`	三端能力对接状态矩阵和优先联调路径	全部
`decisions.md`	当前有效技术和文档决策	全部
`backend-api-service.md`	后端 API 服务运行与前端联调说明	后端
`backend-plan.md`	当前 FastAPI 后端定位、业务模块、近期优先级和安全部署原则	后端
`admin-api-requirements.md`	Admin UI 必需的 Admin API 主契约	后端、管理前端
`module-config-api.md`	页面模块配置 CRUD 的唯一细节契约	后端、管理前端
`home-api.md`	首页内容和玩法推荐关联的 Admin API 补充契约	后端、管理前端
`wild-archives-api.md`	客片案例列表、详情和图片字段契约	三端
`wanfa-api.md`	玩法分类和路线管理 API 的补充契约	后端、管理前端
`concierge-api.md`	管家顾问资料管理 API 的补充契约	后端、管理前端
`detail-api.md`	详情展示内容管理 API 的补充契约	后端、管理前端
`team-building-api.md`	团队共创详情字段、CRUD 与 Public 详情接口契约	三端
`public-api.md`	MiniAPP 对接后端的 Public API 契约	后端、MiniAPP

文档边界

public-api.md 是 MiniAPP 对接后端的唯一 Public API 契约。
admin-api-requirements.md 是 Admin UI 对接后端的主契约。
home-api.md 是首页内容管理的 Admin API 补充契约。
wanfa-api.md 是玩法分类和路线管理的 Admin API 补充契约。
concierge-api.md 是管家顾问资料管理的 Admin API 补充契约。
detail-api.md 是详情展示内容管理的 Admin API 补充契约。
module-config-api.md 是页面模块 CRUD 细节的唯一权威文档。
integration-workflow.md 只写联调流程，不重复接口字段。
development-status.md 只记录当前状态，不替代测试结果。
decisions.md 只记录当前有效决策。

安全约束

文档示例不得写入真实 Token、JWT secret、客服链接、企业 ID、手机号或生产环境变量值。
.env、.env.local 和生产配置不进入文档目录。
涉及重置数据、发布、回滚、迁移或生产操作的文档，需要明确风险和验证方式。

3.7 KiB Raw Blame History

WonderQ 文档索引

推荐阅读路径

文档清单

文档边界

安全约束

3.7 KiB

Raw Blame History