基本介绍
lina-vben是LinaPro内置的默认管理工作台，基于Vue 3 + Vben5 + Ant Design Vue + TypeScript构建。它不是业务逻辑的定义者，而是lina-core主框架API和所有已启用插件API的标准UI表达层。
开发者可以直接基于它构建业务应用，也可以替换为自定义前端。只要新的前端遵循主框架公开的RESTful API和权限模型，就能接入同一套后端能力。
默认管理工作台的本地开发入口是http://localhost:5666/admin。其中/admin来自公开前端配置workspace.basePath，用于确定工作台Vue Router基准路径和资源解析边界；主框架接口默认监听http://localhost:9120，不要把主框架接口地址加上/admin当作默认工作台地址。
技术栈
| 技术 | 说明 |
|---|---|
Vue 3 | 前端框架 |
Vben5 | 企业级管理工作台基础框架 |
Ant Design Vue | 后台管理界面组件库 |
TypeScript | 类型约束和前端工程质量保障 |
Vite | 前端构建工具 |
Pinia | 前端状态管理 |
TailwindCSS | 样式工具链 |
设计边界
工作台消费契约，不定义契约
工作台从主框架读取菜单、权限、用户、角色、配置、任务、插件状态和接口文档等数据。接口行为由后端API契约定义，工作台只负责组织交互体验。
菜单来自主框架治理数据
侧边栏不是纯前端硬编码结果。主框架返回菜单树时会合并内置菜单和已启用插件声明的菜单，并根据当前用户权限过滤。插件禁用后，菜单和路由入口会自动消失。
插件页面通过动态页壳加载
源码插件和动态插件都可以声明前端页面。工作台通过system/plugin/dynamic-page页壳承载插件页面，减少插件接入时对工作台代码的侵入。
动态插件的运行时前端入口通常来自/x-assets/{plugin-id}/{version}/...公开资产，并通过菜单query.pluginAccessMode: embedded-mount声明内嵌挂载模式。源码插件页面通常在工作台构建阶段编译进前端产物，也可以使用public_assets托管明确适合匿名访问的静态资源。
功能模块
工作台提供的是主框架和插件能力的可视化入口。不同模块的后端归属不同，但用户在界面中获得统一体验。
| 模块 | 主要能力 | 来源 |
|---|---|---|
| 权限管理 | 用户、角色、菜单、按钮权限、权限分配 | 主框架 |
| 系统设置 | 字典、参数、文件管理、运行配置 | 主框架 |
| 任务调度 | 任务、分组、执行日志、手动触发 | 主框架 |
| 多租户管理 | 租户、成员、租户切换、租户插件治理 | multi-tenant插件 |
| 组织管理 | 部门、岗位 | org-center插件 |
| 内容管理 | 通知公告 | content-notice插件 |
| 系统监控 | 在线用户、服务监控、操作日志、登录日志 | monitor-*插件 |
| 扩展中心 | 插件发现、安装、启用、禁用、升级、卸载 | 主框架与插件系统 |
| 开发中心 | 接口文档、系统信息 | 主框架 |
权限管理体验
权限管理围绕RBAC模型展开：
用户管理、角色管理和菜单管理分别承担账号、授权集合和权限树维护。角色勾选菜单或按钮权限后，权限拓扑会快速生效；在集群模式下，主框架通过缓存修订机制通知其他节点刷新。
插件菜单动态注入
插件菜单的注入链路如下：
这种设计让插件启用、禁用和权限变更都能通过主框架治理数据驱动，工作台无需为每个插件单独改代码。
扩展中心
扩展中心是插件运行时治理的主要界面。它展示插件类型、版本、状态、运行时升级状态、依赖关系和可用操作。
常见操作包括：
| 操作 | 说明 |
|---|---|
| 安装 | 执行依赖检查、安装SQL并写入治理记录 |
| 启用 | 注册菜单、路由、钩子、定时任务并激活业务入口 |
| 禁用 | 隐藏菜单和路由，保留插件数据 |
| 卸载 | 清理治理记录，并按用户选择决定是否清理插件自有数据 |
| 升级 | 对pending_upgrade或upgrade_failed插件执行显式运行时升级 |
| 上传动态插件 | 上传.wasm产物，进入动态插件发现和治理流程 |
插件列表读取的是后端完整投影缓存。打开列表不会隐式触发插件同步写入；显式同步、上传、安装、启用、禁用、卸载和升级等操作会刷新缓存。界面中的插件类型显示为“源码插件”或“动态插件”，动态插件底层即使是WASM产物，也仍归入“动态插件”治理类型。
开发中心
开发中心聚合主框架和插件接口文档，开发者可以查看OpenAPI文档、请求参数、响应结构和权限标识，并直接发起调试请求。在线调试会使用当前登录用户的认证状态，写操作会产生真实数据变更，应在测试环境谨慎使用。
默认账号
本地演示环境通常使用以下默认账号：
| 字段 | 值 |
|---|---|
| 用户名 | admin |
| 密码 | admin123 |
| 默认工作台地址 | http://localhost:5666/admin |
| 前端开发服务器 | http://localhost:5666 |
生产环境应在初始化后立即修改默认密码，并按组织安全策略配置角色和权限。
扩展建议
如果要在默认工作台上扩展业务功能，优先通过插件声明菜单、页面和API，而不是直接改工作台内部模块。只有当你要调整全局布局、主题、登录页或通用交互规范时，才需要修改lina-vben自身。