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

WonderQ-Admin-UI

独立的 WonderQ 后台管理前端,基于 Vite、React、TypeScript、Tailwind CSS 4 和 shadcn/ui 风格组件。

本地启动

  1. 安装依赖:
yarn install

本项目使用 Yarn 1 锁文件。Windows 环境下,Vite 8、Tailwind CSS 4、lightningcss 依赖 native binding,package.json 中已固定对应的 Windows 构建包,避免 Yarn 1 漏装 optional dependency 导致构建失败。

  1. 确认后端 API 运行在 http://localhost:4000。

  2. 启动后台 UI:

yarn dev

访问:http://localhost:5602

局域网访问可使用本机 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 的相对路径。