4.9 KiB
VibeMake 管理后台
React 18 + TypeScript + Vite 6 + Ant Design 5 + React Router 6。对接 community-adminapi(/admin-api)。
环境
前端在 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 冲突需刷新重新确认)
- 文件:目录浏览、预览(文本/图片)、在线编辑提交、新建文件/目录、删除文件、多文件/文件夹上传(单次合计 ≤ 1 GiB,含选择、限额与路径预检、进度反馈)、鉴权下载
- 提交历史,并可只读浏览任一历史版本
- URDF 目录上传绑定(签名 → 并发 OSS 直传 → 确认)与移除;项目详情和迁移页均按扩展名保留 URDF、模型、材质、贴图及模型数据,过滤代码、文档、配置、隐藏文件和依赖目录,数量/大小限制仅计算待上传资源
- 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、网络异常、安全清理提示、页面离开停止轮询,以及重复来源和创建结果不明时的提交保护。