# 自习室管理端

**Repository Path**: TangDiSiCong/self-study-room-admin

## Basic Information

- **Project Name**: 自习室管理端
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-28
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小院自习室 - 后台管理系统

## 项目简介

这是小院自习室小程序配套的后台管理系统，使用 Vue 3 + Vite + Element Plus + Pinia 技术栈开发。

## 技术栈

- Vue 3 (Composition API)
- Vite 5
- Element Plus
- Vue Router 4
- Pinia
- Axios
- ECharts

## 项目结构

```
admin/
├── src/
│   ├── api/              # API 接口
│   ├── assets/           # 静态资源
│   ├── components/       # 公共组件
│   ├── layout/           # 布局组件
│   ├── router/           # 路由配置
│   ├── stores/           # Pinia 状态管理
│   ├── mock/             # Mock 数据
│   ├── utils/            # 工具函数
│   ├── views/            # 页面组件
│   │   ├── dashboard/    # 工作台
│   │   ├── stores/       # 门店管理
│   │   ├── seats/        # 座位管理
│   │   ├── cards/        # 卡券管理
│   │   ├── orders/       # 订单管理
│   │   ├── users/        # 用户管理
│   │   ├── notices/      # 公告管理
│   │   ├── supplier-leads/ # 供应商线索
│   │   └── system/       # 系统设置
│   ├── App.vue
│   └── main.ts
├── .env
├── package.json
├── vite.config.ts
├── tsconfig.json
└── README.md
```

## 功能模块

### 1. 工作台 (Dashboard)
- 数据卡片：今日订单、今日预约、进行中、总用户
- 近7天订单趋势图
- 快捷入口：发布公告、创建卡券、查看线索
- 待处理事项：待支付订单、待跟进线索

### 2. 门店管理
- 门店列表查询
- 新增/编辑门店
- 启用/停用门店
- 删除门店

### 3. 座位管理
- 按门店查看座位
- 座位平面图展示
- 座位状态变更
- 批量导入座位

### 4. 卡券管理
- 卡券列表查询
- 新增/编辑卡券
- 上架/下架卡券
- 删除卡券

### 5. 订单管理
- 订单列表查询（支持多条件筛选）
- 订单详情查看
- 订单取消/完成
- 订单导出

### 6. 用户管理
- 用户列表查询
- 用户详情查看（含卡券、订单）
- 编辑用户信息
- 禁用/启用用户

### 7. 公告管理
- 公告列表
- 新增/编辑公告
- 发布/下线公告
- 公告置顶

### 8. 供应商线索
- 线索列表查询
- 线索状态流转
- 跟进记录添加
- 负责人分配

### 9. 系统设置
- 账号管理：新增账号、重置密码、禁用/启用
- 角色管理：角色配置、权限配置
- 字典管理：区域、订单状态、标签配置

## 快速开始

### 安装依赖

```bash
cd admin
npm install
```

### 开发运行

```bash
npm run dev
```

访问 http://localhost:3000

### 登录账号

默认测试账号：
- 用户名: `admin`
- 密码: `123456`

### 生产构建

```bash
npm run build
```

## 环境变量配置

在 `.env` 文件中配置：

```env
# API 基础路径
VITE_API_BASE_URL=/admin-api

# 是否使用 Mock 数据 (true/false)
VITE_USE_MOCK=true
```

## API 接口约定

### 认证接口
- `POST /auth/login` - 登录
- `POST /auth/logout` - 登出
- `GET /auth/me` - 获取当前用户信息

### 门店接口
- `GET /stores` - 获取门店列表
- `POST /stores` - 新增门店
- `PUT /stores/:id` - 更新门店
- `PATCH /stores/:id/status` - 更新门店状态
- `DELETE /stores/:id` - 删除门店

### 座位接口
- `GET /seats` - 获取座位列表
- `POST /seats/batch` - 批量导入座位
- `PUT /seats/:id` - 更新座位
- `PATCH /seats/:id/status` - 更新座位状态

### 卡券接口
- `GET /cards` - 获取卡券列表
- `POST /cards` - 新增卡券
- `PUT /cards/:id` - 更新卡券
- `PATCH /cards/:id/status` - 上架/下架
- `DELETE /cards/:id` - 删除卡券

### 订单接口
- `GET /orders` - 获取订单列表
- `GET /orders/:id` - 获取订单详情
- `PATCH /orders/:id/cancel` - 取消订单
- `PATCH /orders/:id/finish` - 完成订单
- `GET /orders/export` - 导出订单

### 用户接口
- `GET /users` - 获取用户列表
- `GET /users/:id` - 获取用户详情
- `PUT /users/:id` - 更新用户
- `PATCH /users/:id/status` - 更新用户状态

### 公告接口
- `GET /notices` - 获取公告列表
- `POST /notices` - 新增公告
- `PUT /notices/:id` - 更新公告
- `PATCH /notices/:id/status` - 发布/下线
- `DELETE /notices/:id` - 删除公告

### 线索接口
- `GET /supplier-leads` - 获取线索列表
- `POST /supplier-leads` - 新增线索
- `PUT /supplier-leads/:id` - 更新线索
- `PATCH /supplier-leads/:id/status` - 更新状态

## Mock 模式说明

项目默认启用 Mock 模式（`VITE_USE_MOCK=true`），所有数据均来自本地 mock 数据，无需后端服务即可预览功能。

如需对接真实后端，修改 `.env` 文件：

```env
VITE_USE_MOCK=false
VITE_API_BASE_URL=http://your-backend-api.com/admin-api
```

## 开发说明

### 权限控制
- 路由级权限：通过路由守卫控制页面访问
- 按钮级权限：通过 `userStore.hasPermission()` 控制

### 状态管理
- `userStore`：用户信息、token、权限

### 请求封装
- `utils/request.ts`：统一的 axios 实例，包含拦截器
- `utils/mock.ts`：Mock 数据处理

## License

MIT