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-Admin-UI
独立的 WonderQ 后台管理前端，基于 Vite、React、TypeScript、Tailwind CSS 4 和 shadcn/ui 风格组件。
本地启动
- 安装依赖：
yarn install
本项目使用 Yarn 1 锁文件。Windows 环境下，Vite 8、Tailwind CSS 4、lightningcss 依赖 native binding，package.json 中已固定对应的 Windows 构建包，避免 Yarn 1 漏装 optional dependency 导致构建失败。
-
确认后端 API 运行在
http://localhost:4000。 -
启动后台 UI：
yarn dev
局域网访问可使用本机 IP，例如 http://192.168.1.23:5602/。该地址由 Vite dev server 提供，支持样式和组件热更新。
默认后台账号由 WonderQ-Admin 提供：admin@example.com / ChangeMe123!。
目录说明
src/App.tsx：后台管理主界面和业务交互。src/api.ts：Admin API 类型、Token 管理和请求封装。src/components/ui/：本地 shadcn/ui 风格基础组件，包括 Button、Card、Input、Textarea、Badge、Alert、Switch 等。src/lib/utils.ts：组件 className 合并工具。src/styles.css：Tailwind 入口、设计变量、后台布局和响应式样式。public/assets/：后台预览所需静态资源，保留/assets/...引用方式。components.json：shadcn/ui 组件配置。vite.config.ts：开发环境将/api代理到http://localhost:4000，dev server 固定运行在5602并支持 HMR；生产构建预览运行在5603。
本仓库已经独立，不再依赖 WonderQ-MiniAPP 的相对路径。