Files
WonderQ-Project/WonderQ-Admin-UI-Vue
duanshuwen 4e04feda5b feat(admin, miniapp): 优化数据库迁移逻辑与小程序图片资源处理
- 为后端Admin新增migration_compat工具,支持离线迁移时的基线资源检查,重构全部alembic迁移脚本适配离线模式,避免重复创建已存在的数据库表和字段
- 完善初始数据库迁移脚本,添加默认部门种子数据,新增ConciergeAdvisor详情字段从JSON到JSONB的类型转换迁移
- 小程序端新增图片资源解析工具resolveNetworkImage,实现本地静态资源到CDN的自动映射,添加图片加载容错降级机制
- 完善HeroSlide类型定义,新增actionLabel字段,优化首页轮播组件的文本渲染与错误处理逻辑
- 新增对应测试用例验证迁移路径正确性与前端数据处理逻辑
- 新增临时 brainstorm UI对比草稿与开发临时状态文件
2026-08-27 11:37:03 +08:00
..
2026-08-25 22:48:10 +08:00

WonderQ Admin UI Vue

WonderQ 管理端 Vue3 迁移端,采用 Vue 3、Element Plus、TypeScript、Pinia 和 Vue Router 4。

启动

yarn install
yarn dev

开发地址:http://localhost:5604/admin/

默认通过 Vite /api 代理访问 http://localhost:4000,可使用 VITE_API_PROXY_TARGET 覆盖。生产构建使用 yarn build,静态产物由反向代理挂载到 /admin。

管理端会将后端返回的本地兜底图片 /assets/... 映射到管理端静态资源 /admin/assets/...;首页配置所需的本地兜底图片已随管理端构建提供。OSS 图片仍使用后端返回的临时可访问 URL。

认证约定

  • Access Token 只保存在运行时内存,不写入 localStorage。
  • Refresh Token 由后端以 HttpOnly Cookie 保存。
  • 401 会自动调用 /api/admin/auth/refresh 并重试一次;刷新失败后返回登录页。
  • 菜单和按钮权限来自 /api/admin/system/profile,前端只加载预注册组件。
  • 管理端界面图标统一使用 @element-plus/icons-vue;菜单图标通过 src/components/layout/LayoutIcon.vue 的白名单适配器映射,未知图标回退为默认图标。
  • 菜单管理按 RuoYi 风格提供目录、页面、按钮三类编辑字段;父级菜单使用服务端树,排除按钮和当前编辑分支,图标选择器支持搜索、清空和 Element Plus 图标网格。
  • ConciergeDetail.icon 等接口字段是业务内容数据,不属于 UI 图标,不在图标迁移范围内。

验证

yarn test
yarn build