efab6d1398
修复Vue Admin布局中RouterView未绑定唯一key的问题，解决RBAC系统资源页面切换后内容不刷新的ISSUE-001故障，新增routeViewKey工具函数区分路由实例 完善路由配置，新增admin空路径路由，修复路由命名空路径告警 新增媒体管理、运维发布/重置页面，补全全站路由注册与动态路由过滤逻辑 新增玩法、线索、管家、系统资源管理的全套工具函数、业务组件及单元测试用例 修复后端app/seed.py中媒体资源重复检测未考虑会话内pending资源的bug，新增对应测试验证修复逻辑 修正alembic迁移版本0015的依赖关系，删除废弃的旧迁移文件 优化后端系统接口的字典序列化逻辑，简化重复代码 添加QA验收报告与相关测试截图，完善项目测试覆盖
WonderQ 文档索引
本目录只保留当前有效文档，用于支撑 WonderQ-Admin、WonderQ-Admin-UI、WonderQ-MiniAPP 三端并行开发和联调。非当前技术路径不放在当前文档集中。
推荐阅读路径
后端开发：
api-response-contract.mdadmin-api-requirements.mdhome-api.mdwanfa-api.mdconcierge-api.mddetail-api.mdteam-building-api.mdpublic-api.md
管理前端开发：
api-response-contract.mdintegration-workflow.mdadmin-api-requirements.mdhome-api.mdwanfa-api.mdconcierge-api.mddetail-api.mdteam-building-api.mdmodule-config-api.md（用车服务配置与需求线索）
MiniAPP 前台开发：
api-response-contract.mdintegration-workflow.mdwanfa-api.mddetail-api.mdteam-building-api.mdpublic-api.mddevelopment-status.md
文档清单
| 文档 | 作用 | 主要读者 |
|---|---|---|
api-response-contract.md |
三端统一 JSON 响应包裹、错误和客户端解包规则 | 全部 |
integration-workflow.md |
三端本地启动、联调顺序、接口变更流程和验证命令 | 全部 |
development-status.md |
三端能力对接状态矩阵和优先联调路径 | 全部 |
admin-business-function-matrix.md |
Admin A+B 重构业务覆盖、隐藏接口和删除闸门矩阵 | 全部 |
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和生产配置不进入文档目录。- 涉及重置数据、发布、回滚、迁移或生产操作的文档，需要明确风险和验证方式。