e082bd2d98
- 新增`api_response.py`统一响应封装工具类，提供标准成功/错误响应构造方法 - 重构WonderQ-Admin全局异常处理器，将所有异常转换为标准响应格式 - 修改所有公共和管理端接口的返回逻辑，统一使用`code`（与HTTP状态码一致）、`msg`和`data`的三层结构 - 新增`api-response-contract.md`文档，定义完整的三端统一JSON响应规范 - 更新所有领域API文档，明确业务数据需位于`data`字段内，补充响应格式说明 - 为WonderQ-MiniAPP和WonderQ-Admin-UI新增响应解析逻辑和类型定义，自动完成协议校验和错误处理 - 更新所有测试用例，适配新的响应结构确保接口符合契约要求 - 新增`module-config-api.md`模块配置API文档，补充站点模块配置的接口约定 - 更新项目README文档，调整文档分类顺序将响应契约置于首位
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中运行安装、开发和构建命令。