7ba92f3c5d
- 新增客片案例全流程功能，包含前台页面、管理端配置、后端API、数据库迁移与文档 - 新增团队共创详情页面与对应接口 - 重构玩法模块：将静态playData替换为动态API获取，拆分类型定义到playTypes.ts - 优化vite构建配置与环境变量处理，调整详情页操作栏文案 - 更新全量相关文档与配图，新增客片案例、团队共创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中运行安装、开发和构建命令。