c143b67275
添加`DetailRecord`数据库模型、迁移脚本及完整的CRUD管理接口，将路线详情从玩法路线表解耦，实现独立存储。 在Admin UI的路线编辑器中集成详情配置面板，支持编辑详情文案、图片等展示内容。 完善MiniAPP路线详情页，新增导航函数、API调用及数据归一化逻辑，并添加对应单元测试。 更新所有相关文档，明确领域边界、联调流程及接口契约规范。 调整首页和玩法页的点击跳转逻辑，优先跳转路线详情页而非原需求页。 新增数值格式化工具函数优化内容展示效果。
WonderQ MiniAPP
WonderQ 移动端前台项目，使用 uni-app、Vue 3、TypeScript 和 TailwindCSS，目标端为 H5 与微信小程序。
后台 API 已分离到 D:\www\znkj\WonderQ-Admin，后台管理 UI 已分离到 D:\www\znkj\WonderQ-Admin-UI。当前仓库只维护移动端前台体验。
Scripts
yarn install安装依赖。yarn dev/yarn dev:h5启动 H5 开发服务，默认访问http://localhost:5173。yarn dev:mp-weixin生成微信小程序开发包。yarn build/yarn build:h5类型检查并构建 H5。yarn build:mp-weixin类型检查并构建微信小程序。yarn test运行共享数据和业务工具函数测试。npm run capture:source采集源站参考。npm run download:assets下载源站资源。
Runtime
- Node 需要满足 uni-app、TailwindCSS 和
weapp-tailwindcss的当前要求，建议使用 Node 20.19+ 或 22.12+。 - H5 仍通过
/api代理访问http://localhost:4000。 - uni-app 路由与小程序配置位于
src/pages.json和src/manifest.json。 - 微信小程序构建产物输出到
dist/build/mp-weixin，需用微信开发者工具打开验证。
Visual Conventions
- 移动端采用简约、内容优先的风格：白色和低饱和中性色为基础，绿色用于主操作和选中态。
- 卡片、输入框和按钮优先使用 8-12px 圆角、细边框和轻阴影；避免大面积渐变、装饰性光晕和重阴影。
- 顶部栏与底部导航保持扁平和固定，选中态使用颜色、细线或浅色底区分，不使用浮动徽章或会改变布局的缩放动画。
- 全局色彩和共享表面样式集中在
src/app.css，页面新增样式优先复用--wq-*变量和共享组件。
Backend And Admin
- API 服务：在
WonderQ-Admin中运行安装、开发和构建命令。 - 后台 UI：在
WonderQ-Admin-UI中运行安装、开发和构建命令。