# admin-RBAC

**Repository Path**: young-yanjun_admin/admin-rbac

## Basic Information

- **Project Name**: admin-RBAC
- **Description**: 本系统提供完整的角色权限管理功能，包括角色的增删改查、权限分配等。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-29
- **Last Updated**: 2025-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RBAC Admin

基于 Vue 3 + TypeScript + Ant Design Vue 的 RBAC 权限管理系统前端项目。

## 技术栈

- **核心框架**: Vue 3.x
- **类型系统**: TypeScript 5.x
- **UI组件库**: Ant Design Vue 3.x
- **状态管理**: Pinia
- **路由管理**: Vue Router 4.x
- **HTTP请求**: Axios
- **构建工具**: Vite
- **代码规范**: ESLint + Prettier
- **CSS预处理器**: Less
- **包管理工具**: pnpm

## 功能特性

### 1. 用户认证
- 登录/登出功能
- 记住密码
- 修改密码
- 个人中心
  - 基本信息修改
  - 头像上传
  - 密码修改

### 2. 权限管理
- 基于 RBAC 模型的权限控制
- 动态路由生成
- 菜单权限控制
- 按钮权限控制
- API 权限控制

### 3. 系统管理
- 用户管理
  - 用户列表
  - 用户创建/编辑/删除
  - 用户状态管理
  - 角色分配
  - 密码重置
- 角色管理
  - 角色列表
  - 角色创建/编辑/删除
  - 权限分配
  - 用户分配
- 菜单管理
  - 菜单树形结构
  - 菜单创建/编辑/删除
  - 权限标识配置
  - 路由配置
- 部门管理
  - 部门树形结构
  - 部门创建/编辑/删除
  - 部门人员管理

### 4. 系统监控
- 登录日志
  - 登录记录查询
  - 登录状态统计
  - 日志导出
  - 日志清理
- 操作日志
  - 操作记录查询
  - 操作类型统计

## 项目结构

```
src/
├── api/              // API接口定义
├── assets/           // 静态资源
│   ├── icons/        // 图标
│   ├── images/       // 图片
│   └── styles/       // 全局样式
├── components/       // 公共组件
│   ├── common/       // 通用组件
│   └── business/     // 业务组件
├── composables/      // 组合式函数
├── config/           // 配置文件
├── directives/       // 自定义指令
├── enums/            // 枚举定义
├── hooks/            // 自定义hooks
├── layouts/          // 布局组件
├── router/           // 路由配置
├── store/            // 状态管理
├── types/            // 类型定义
├── utils/            // 工具函数
└── views/            // 页面组件
    ├── dashboard/    // 仪表盘
    ├── system/       // 系统管理
    ├── user/         // 用户管理
    └── role/         // 角色管理
```

## 开发规范

### 1. 命名规范
- **组件文件**: 使用 PascalCase 命名，如 `UserList.vue`、`RoleForm.vue`
- **工具/API文件**: 使用 kebab-case 命名，如 `auth-api.ts`、`date-utils.ts`
- **类型定义文件**: 使用 kebab-case 命名，后缀为 `.d.ts` 或 `.type.ts`
- **变量命名**: 使用 camelCase 命名，如 `userName`、`roleList`
- **常量**: 使用 UPPER_SNAKE_CASE 命名，如 `API_BASE_URL`

### 2. 组件规范
- 使用 `<script setup lang="ts">` 语法
- 组件属性使用 `defineProps` 和 `defineEmits` 定义
- 组件内部状态使用 `ref`、`reactive` 等响应式 API 管理
- 使用 scoped 或 CSS Modules 隔离组件样式

### 3. 状态管理
- 按模块划分 store，如 `useUserStore`、`useAuthStore`
- 明确定义 state 类型
- 使用 actions 处理异步操作
- 使用 getters 计算派生状态

### 4. API 请求规范
- 按模块划分 API 文件
- 使用 TypeScript 定义请求参数和响应类型
- 统一处理请求错误和响应格式

### 5. Git 提交规范
- feat: 新功能
- fix: 修复 bug
- docs: 文档更新
- style: 代码格式
- refactor: 重构
- test: 测试
- chore: 构建过程或辅助工具的变动

## 开发环境要求

- Node.js >= 16
- pnpm >= 8

## 快速开始

1. 克隆项目
```bash
git clone [项目地址]
cd admin-RBAC
```

2. 安装依赖
```bash
pnpm install
```

3. 启动开发服务器
```bash
pnpm dev
```

4. 构建生产版本
```bash
pnpm build
```

5. 代码检查
```bash
pnpm lint
```

## 浏览器支持

- Chrome >= 87
- Firefox >= 78
- Safari >= 14
- Edge >= 88

## 贡献指南

1. Fork 本仓库
2. 创建特性分支
3. 提交代码
4. 创建 Pull Request

## 许可证

MIT License

# 角色权限管理系统

## 功能说明
本系统提供完整的角色权限管理功能，包括角色的增删改查、权限分配等。

## API 文档

### 角色权限管理

#### 获取角色权限列表
- 接口路径：`/api/system/roles/permissions/{roleId}`
- 请求方式：GET
- 功能说明：获取指定角色的权限列表
- 请求参数：
  - roleId: number (路径参数) - 角色ID
- 返回数据：
```json
{
  "code": 200,
  "msg": "success",
  "data": [3]  // 权限ID数组
}
```

#### 更新角色权限
- 接口路径：`/api/system/roles/permissions/{roleId}`
- 请求方式：PUT
- 功能说明：更新指定角色的权限列表
- 请求参数：
  - roleId: number (路径参数) - 角色ID
  - permissionIds: number[] (请求体) - 权限ID数组
- 返回数据：
```json
{
  "code": 200,
  "msg": "success",
  "data": null
}
```

## 使用示例

### 获取角色权限
```typescript
import { getRolePermissions } from '@/api/role'

// 获取角色ID为1的权限列表
const roleId = 1
const permissions = await getRolePermissions(roleId)
```

### 更新角色权限
```typescript
import { updateRolePermissions } from '@/api/role'

// 更新角色ID为1的权限列表
const roleId = 1
const permissionIds = [1, 2, 3]
await updateRolePermissions(roleId, permissionIds)
```

## 注意事项
1. 权限ID必须是有效的权限ID
2. 更新权限时会完全覆盖原有的权限列表
3. 建议在更新权限前先获取当前权限列表，避免误操作