完成首页数据模型的统一重构,具体变更如下: 1. 重构公共首页API接口,移除`playRecommendations`字段,将玩法推荐数据统一放入`experiences`字段 2. 更新前后端类型定义、序列化逻辑与前端页面组件,适配新的API响应结构 3. 为微信登录相关接口添加`trust_env=True`配置,支持企业代理环境并新增`socksio`依赖 4. 新增图片画廊上传组件,重构SingleImageUploader组件支持自定义宽高比 5. 重构Toast与Select组件的实现与样式,统一后台UI设计系统 6. 移除个人中心页面不必要的返回事件与顶部标题组件,优化详情卡片布局 7. 新增微信接口单元测试,更新官方文档与测试用例适配变更 8. 删除过期的文档图片资源
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 的相对路径。