VomeAdmin

主题

Admin 快速开始 ​

Vome Admin 是基于 Vue 3 + Vite 的后台管理端，CRUD 能力与布局组件来自 npm 包 vome-core，业务页面写在 admin/src/modules/。

前置条件 ​

依赖说明
Service后端 API 必须先启动（默认 http://127.0.0.1:3000，以 service 配置 system.port 为准）
vome-core通过 npm 安装（"vome-core": "latest"），提供 CRUD 组件、路由守卫、EPS、Excel 导出等
Bun推荐用 Bun 安装依赖与启动

启动 ​

bash
cd admin
bun install
bun run dev

独立仓库 Clone / ZIP 见 源码下载。

开发服务器默认监听 9000 端口（vite.config.ts 中 server.port: 9000），浏览器访问：

http://localhost:9000

请求经 Vite 代理转发到 Service（src/config/dev.ts 中 baseUrl: '/dev'）。

登录 ​

使用 Service 种子数据中的管理员账号登录。登录成功后进入布局页，侧栏菜单由后端 base.menu 动态下发。

与 Service 的关系 ​

  • Admin 不内嵌 Service 代码；通过 EPS 自动生成 service.base.* 等 API 客户端
  • 菜单 viewPath 对应 admin/src/modules/*/views/**/*.vue，由 views-registry.ts 注册
  • 权限码与 Service RBAC 对齐，按钮级控制用 v-perm 指令

对象存储路径 ​

用途Key 前缀说明
公开资源app/public/**vm-upload 默认；子目录如 app/public/avatar
插件包app/plugin/**须显式 prefixPath: 'app/plugin'；私有，登录后一次性链接代传

桶策略只开放 app/public/*。详见 vm-upload、一次性 Token。

标准 CRUD 页清单 ​

  1. views-registry 能扫到页面；菜单 viewPath 正确
  2. 模板含 <vm-search />（否则无自动筛选与工具栏搜索/重置）
  3. useCrud({ service: service.xxx }) + useTable / useUpsert
  4. 自定义按钮加 防连点 与 v-perm
  5. Service 已启动，EPS createEps 成功（见 EPS）

IDE（Snippets / Tasks） ​

与 Service 相同：用 IDE 打开项目根，使用根目录 .vscode/ 中的 snippet 与 Tasks。详见 Service · 目录结构。

下一步 ​