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