Files
vibemake-admin/README.md
T
2026-10-27 14:07:44 +08:00

4.6 KiB
Raw Blame History

VibeMake 管理后台

React 18 + TypeScript + Vite 6 + Ant Design 5 + React Router 6。对接 community-adminapi(/admin-api)。

环境

环境 前端 后端
本地开发 http://localhost:5188 代理到测试环境后端
测试 https://dev-vibemake-admin.robotquan.com https://dev-vibemake-api.robotquan.com
线上 https://vibemake-admin.robotquan.com https://vibemake-api.robotquan.com

前端在 src/config/environment.ts 按访问域名自动选择接口地址,已知部署域名优先于构建默认值:

  • 本地开发:请求同源 /admin-api,由 Vite dev server 代理(vite.config.ts,目标取 .env.* 中的 VITE_PROXY_TARGET)。
  • dev 网站:dev-vibemake-admin.robotquan.com 请求 https://dev-vibemake-api.robotquan.com/admin-api。
  • 线上网站:vibemake-admin.robotquan.com 请求 https://vibemake-api.robotquan.com/admin-api。
  • 其他部署域名:使用当前构建的 VITE_API_BASE 默认值。

界面环境标记也按网站域名选择,避免同一份静态文件部署到不同域名后显示错误的环境。localhost 本地开发和预览继续请求 /admin-api,使用 Vite 的环境代理。

注意:测试后端 http 会 301 到 https,代理目标必须写 https。

命令

npm install
npm run dev          # 本地开发,代理测试环境后端
npm run dev:prod     # 本地开发,代理线上后端(谨慎)
npm run build:dev    # 构建 dev 服务器静态包,内置 dev 后端地址 -> dist/
npm run build:test   # 构建测试环境包 -> dist/
npm run build:prod   # 构建线上包 -> dist/
npm run preview      # 本地预览构建产物
npm run preview:dev  # 按 dev 配置预览
npm run preview:prod # 按线上配置预览,代理目标为线上后端

部署

dev 更新:执行 npm run build:dev(与 build:test 相同),将 dist/ 内的文件覆盖上传到现有 dev 网站根目录即可。构建产物已内置 dev 后端地址,后端已放行 dev 前端域名的跨域访问,无需新增接口代理。本地开发请使用 npm run dev。

线上更新:执行 npm run build:prod,将 dist/ 内的文件覆盖上传到线上网站根目录。前端会根据线上域名访问线上后端,不需要在前端站点增加 API 反向代理。线上后端需要允许 https://vibemake-admin.robotquan.com 跨域访问(包括 Authorization、Content-Type 及各业务 HTTP 方法);目前实测该来源的预检被后端返回 403 Invalid CORS request,该后端限制不由前端打包控制。

DevTools 中 preflight 是浏览器发送的 OPTIONS 跨域预检,fetch 才是业务请求;它们不是业务执行两次。已知部署域名均直接访问对应后端,正常保留浏览器预检。deploy/ 中的 Nginx API 代理文件仅作为同源部署方式的备用示例,当前域名自动选择方案不需要启用它们。

功能

  • 登录 / 退出 / 修改密码(401 自动回登录页并保留返回路径)
  • 用户管理:列表筛选、详情、名下项目、编辑昵称、启用/禁用(不可禁用自己与官方账号)
  • 项目管理:列表筛选、新建(封面 OSS 直传、归属官方或普通用户)、编辑、删除
  • 发布 / 更新发布 / 撤回 / 下架 / 解除下架(发布前确认当前 main SHA,409 冲突需刷新重新确认)
  • 文件:目录浏览、预览(文本/图片)、在线编辑提交、新建文件/目录、删除文件、多文件/文件夹上传(含限额与路径预检)、鉴权下载
  • 提交历史,并可只读浏览任一历史版本
  • URDF 目录上传绑定(签名 → 并发 OSS 直传 → 确认)与移除
  • GitHub 迁移:预检 → 补充信息(可选上传封面、URDF)→ 创建任务并绑定资源 → 3 秒串行轮询阶段 → 检查后手动发布;重复来源跳转已有项目
  • 迁移重试:FAILED、REVIEW 始终提供手动重试入口,不按 canRetry 隐藏;列表点击重试即进入任务确认框,展示 retryMessage,由重试接口判断是否受理;支持 CLEANING 清理阶段,409 后刷新状态,网络异常时先查询确认结果

迁移功能回归

npx playwright install chromium # 首次运行时安装测试浏览器
npm run test:imports
# 或使用本机已安装的 Chrome
PLAYWRIGHT_CHANNEL=chrome npm run test:imports

测试会启动独立的本地 Vite 服务并拦截全部管理 API,不向实际后端发起迁移、清理或发布操作。覆盖重试资格、确认说明、202 轮询恢复、409、网络异常、安全清理提示、页面离开停止轮询,以及重复来源和创建结果不明时的提交保护。