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