WonderQ-Project/WonderQ-MiniAPP/README.md

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 中运行安装、开发和构建命令。