# wisdom-admin

**Repository Path**: saulCode/wisdom-admin

## Basic Information

- **Project Name**: wisdom-admin
- **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-03-27
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧餐饮系统 - 商家管理端

> 融合AI用户画像与智能库存预警的餐饮管理系统

## 项目简介

本项目是一个餐饮系统的商家管理端，支持超级管理员、董事长、总部运营、门店管理员、门店收银员等多角色管理，提供从系统权限管控、用户管理到数据运营的全链路能力。

## 技术栈

- **前端框架**: Vue 3.5+
- **构建工具**: Vite 7.3+
- **UI组件库**: Element Plus 2.9+
- **状态管理**: Pinia 2.2+
- **路由管理**: Vue Router 4.5+
- **HTTP请求**: Axios 1.7+
- **图标库**: @element-plus/icons-vue

## 项目结构

```
wisdom-admin/
├── public/                 # 静态资源
├── src/
│   ├── api/               # API接口
│   │   ├── auth.js        # 认证相关接口
│   │   ├── user.js        # 用户管理接口
│   │   └── role.js        # 角色管理接口
│   ├── assets/            # 资源文件
│   │   └── main.css       # 全局样式
│   ├── components/        # 公共组件
│   ├── layout/            # 布局组件
│   │   └── MainLayout.vue # 主布局
│   ├── router/            # 路由配置
│   │   └── index.js
│   ├── stores/            # 状态管理
│   │   └── user.js        # 用户状态
│   ├── utils/             # 工具类
│   │   └── request.js     # Axios封装
│   ├── views/             # 页面组件
│   │   ├── Dashboard.vue  # 工作台
│   │   ├── Login.vue      # 登录页
│   │   ├── Register.vue   # 注册页
│   │   ├── Profile.vue    # 个人中心
│   │   ├── user/          # 用户管理
│   │   │   └── UserList.vue
│   │   └── role/          # 角色管理
│   │       └── RoleList.vue
│   ├── App.vue            # 根组件
│   └── main.js            # 入口文件
├── .env                   # 环境变量
├── index.html             # HTML模板
├── package.json           # 依赖配置
├── vite.config.js         # Vite配置
└── README.md              # 项目说明
```

## 快速开始

### 环境要求

- Node.js >= 20.19.0 或 >= 22.12.0
- npm 或 pnpm 或 yarn

### 安装依赖

```bash
npm install
# 或
pnpm install
# 或
yarn install
```

### 启动开发服务器

```bash
npm run dev
```

项目将在 `http://localhost:5173` 启动

### 构建生产版本

```bash
npm run build
```

### 预览生产版本

```bash
npm run preview
```

## 功能特性

### 阶段一功能

#### 1. 认证模块
- ✅ 用户登录（双Token机制）
- ✅ 用户注册（仅门店管理员）
- ✅ Token刷新
- ✅ 用户登出
- ✅ 获取当前用户信息

#### 2. 用户模块
- ✅ 创建用户
- ✅ 更新用户信息
- ✅ 删除用户
- ✅ 获取用户详情
- ✅ 分页查询用户
- ✅ 修改密码
- ✅ 上传头像

#### 3. 角色模块
- ✅ 获取所有角色列表
- ✅ 角色权限说明展示

#### 4. 系统功能
- ✅ 工作台首页
- ✅ 侧边栏导航
- ✅ 个人中心
- ✅ 响应式布局

## 角色说明

| 角色编码 | 角色名称 | 说明 | 可创建用户 |
|----------|----------|------|------------|
| SUPER_ADMIN | 超级管理员 | 系统最高权限 | 所有角色 |
| CHAIRMAN | 董事长 | 公司最高决策者 | 除超级管理员外 |
| HQ_OPERATOR | 总部运营 | 总部运营管理 | 门店相关角色 |
| STORE_ADMIN | 门店管理员 | 可自主注册 | 门店收银员 |
| STORE_CASHIER | 门店收银员 | 门店收银操作 | 无 |
| MINIAPP_USER | 小程序用户 | 小程序端用户 | 无 |

## 接口文档

后端接口基础信息：
- **Base URL**: `http://localhost:8080/api`
- **认证方式**: Bearer Token
- **Content-Type**: `application/json`

详细接口文档请参考项目根目录下的 `接口文档_阶段一.md` 文件。

## 设计规范

### 颜色规范
- 主色：`#667eea`（紫色）
- 成功色：`#67c23a`
- 警告色：`#e6a23c`
- 危险色：`#f56c6c`
- 信息色：`#909399`
- 背景色：`#f5f7fa`

### 设计原则
- 无渐变色设计
- 扁平化风格
- 简洁清晰的交互
- 响应式布局

## 开发计划

### 阶段一 ✅（已完成）
- 认证模块
- 用户管理
- 角色管理
- 基础布局

### 阶段二（待开发）
- 门店管理
- 菜品管理
- 分类管理

### 阶段三（待开发）
- 订单管理
- 交易记录
- 财务统计

### 阶段四（待开发）
- 数据运营分析
- 报表统计
- AI用户画像

## 注意事项

1. 确保后端服务已启动并运行在 `http://localhost:8080`
2. 首次使用需要注册门店管理员账号或使用超级管理员账号登录
3. Token 有效期为 2 小时，过期会自动跳转登录页
4. 上传头像大小限制为 2MB

## 联系方式

如有问题或建议，请联系开发团队。