xk-docs/docs/projects/xk-admin/overview.md

xk-admin 概览

xk-admin 是 XK 系统的管理后台前端，基于 Vben Admin Pro v5.5.1 构建。

基本信息

项	值
框架	Vue 3 + Vben Admin Pro v5.5.1
UI 库	Ant Design Vue
包管理	pnpm 10.2.0 (Monorepo)
构建	Vite + Turborepo
语言	TypeScript
Node	>= 20.10.0

目录结构

xk-admin/
├── apps/
│   └── web-antd/          # 主应用
│       └── src/
│           ├── adapter/       # API 适配器
│           ├── api/           # API 调用定义
│           ├── components/    # 共享组件
│           ├── composables/   # Vue Composables
│           ├── layouts/       # 布局组件
│           ├── locales/       # 国际化
│           ├── router/        # 路由配置
│           ├── store/         # Pinia Store
│           ├── views/         # 页面视图
│           └── utils/         # 工具函数
├── internal/              # 内部共享包
├── packages/              # 共享工作区包
├── playground/            # 开发调试
├── scripts/               # 构建脚本
├── turbo.json             # Turborepo 配置
└── pnpm-workspace.yaml    # 工作区配置

多角色支持

管理后台支持多种角色登录，不同角色看到不同的菜单和功能：

角色	说明	主要功能
超级管理员	全局管理	所有功能
管理员	普通管理	日常管理操作
省经理	省级管理	区域门店管理
市经理	市级管理	区域门店管理
区经理	区级管理	区域门店管理
供应商	药品供应	药品管理
门店管理员	门店运营	门店端功能
总部财务	财务管理	财务功能

权限控制

使用 v-access:code 指令控制按钮级权限：

<template>
  <a-button v-access:code="'admin:create'">创建管理员</a-button>
</template>