# 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` 指令控制按钮级权限：

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