backmanagerweb/系统使用说明.md

# 蜜雪冰城企业管理系统 — 使用说明

> 本文档面向系统管理员及各部门工作人员，指导如何从零开始搭建和使用本系统。

---

## 一、系统总览

本系统用于蜜雪冰城总部管理加盟商、合同、员工、产品、供应商及售后事务。采用 **RBAC 权限模型**，不同角色拥有不同的菜单可见性和数据操作范围。

### 角色一览

| 角色 | 负责人 | 核心职责 |
|------|--------|---------|
| 系统管理员 | 信息技术部 | 系统搭建、账号管理、数据全权管理 |
| 总经理 | 总经理办公室 | 全局查看所有业务数据 |
| 招商经理 | 招商部 | 管理加盟商、创建加盟合同 |
| 运营经理 | 运营部 | 维护加盟商信息、处理售后 |
| 采购经理 | 采购部 | 管理产品、供应商、创建采购合同 |
| 财务人员 | 财务部 | 只读查看业务数据 |

---

## 二、从第一个人开始 — 系统管理员首次登录

系统首次启动后，数据库中已预置了一个管理员账号：

| 用户名 | 密码 | 角色 |
|--------|------|------|
| `admin` | `123456` | 系统管理员 |

### 第一步：登录系统

1. 打开浏览器，访问系统地址（如 `http://localhost:5173`）
2. 输入用户名 `admin`，密码 `123456`
3. 点击「登录」进入系统

### 第二步：认识系统界面

登录后进入主面板，左侧为导航菜单：

- **首页** — 系统概览
- **加盟商管理** — 管理所有加盟商信息
- **合同管理** — 管理所有合同
- **售后管理** — 管理售后记录
- **产品管理** — 管理产品原料信息
- **供应商管理** — 管理供应商信息
- **员工管理** — 管理所有员工
- **用户管理** — 管理系统登录账号

> 管理员拥有所有菜单和全部数据的访问权限。

---

## 三、搭建组织架构 — 逐步添加员工和用户

系统搭建的正确顺序是：**先建员工 → 再建用户账号**。因为用户账号需要关联一个已存在的员工。

### 第一步：添加员工

1. 点击左侧菜单「员工管理」
2. 点击「新增员工」按钮
3. 填写员工信息：
   - **姓名**（必填）：如「张超」
   - **部门**：如「总经理办公室」
   - **职务**：如「总经理」
   - 其他信息：性别、年龄、学历、入职日期、电话等
4. 点击「保存」

按此方式，将所有员工逐一录入系统：

| 姓名 | 部门 | 职务 | 后续分配角色 |
|------|------|------|-------------|
| 张超 | 总经理办公室 | 总经理 | 总经理 |
| 李明 | 招商部 | 招商经理 | 招商经理 |
| 王丽 | 运营部 | 运营经理 | 运营经理 |
| 赵强 | 采购部 | 采购经理 | 采购经理 |
| 陈芳 | 财务部 | 财务主管 | 财务人员 |

### 第二步：为员工创建用户账号

1. 点击左侧菜单「用户管理」
2. 点击「新增用户」按钮
3. 填写用户信息：
   - **用户名**（必填）：如 `zhangchao`
   - **密码**（必填）：如 `123456`（至少 6 位）
   - **角色**：选择对应角色，如「总经理」
   - **关联员工**：选择对应的员工，如「张超」
4. 点击「保存」

系统会自动将员工的部门信息同步到用户账号中。

> **也可以在员工管理中直接创建用户**：在员工列表中点击某行的「创建用户」按钮，系统会自动关联该员工并创建用户账号。

### 预置账号速查

系统首次启动时已自动创建以下账号，密码均为 `123456`：

| 用户名 | 姓名 | 角色 | 部门 |
|--------|------|------|------|
| `admin` | 系统管理员 | 系统管理员 | 信息技术部 |
| `zhangchao` | 张超 | 总经理 | 总经理办公室 |
| `liming` | 李明 | 招商经理 | 招商部 |
| `wangli` | 王丽 | 运营经理 | 运营部 |
| `zhaoqiang` | 赵强 | 采购经理 | 采购部 |
| `chenfang` | 陈芳 | 财务人员 | 财务部 |

---

## 四、各角色的工作流程

### 4.1 系统管理员（admin）

**日常职责：** 系统维护、账号管理、数据全权管理

| 操作 | 说明 |
|------|------|
| 管理员工 | 新增、编辑、删除员工信息 |
| 管理用户 | 创建、禁用、删除用户账号，分配角色 |
| 管理加盟商 | 新增、编辑、删除加盟商，指派负责人 |
| 管理合同 | 新增、编辑、删除所有合同 |
| 管理售后 | 新增、编辑、删除所有售后记录 |
| 管理产品 | 新增、编辑、删除产品信息 |
| 管理供应商 | 新增、编辑、删除供应商信息 |

**管理员独有操作：**
- 可以修改任何记录的「负责人」字段
- 不能删除自己、不能禁用自己、不能修改自己的角色
- 不能删除最后一个管理员账号

---

### 4.2 总经理（general_manager）

**日常职责：** 全局查看所有业务数据

| 操作 | 权限 |
|------|------|
| 查看加盟商 | ✅ 全部数据 |
| 查看合同 | ✅ 全部数据 |
| 查看售后 | ✅ 全部数据 |
| 查看员工 | ✅ 全部数据 |
| 新增/编辑/删除 | ❌ 无任何写入权限 |

> 总经理拥有全局只读权限，可以查看所有部门的所有数据，但不能进行任何增删改操作。

---

### 4.3 招商经理（franchise_manager）

**日常职责：** 开发加盟商、签订加盟合同

| 操作 | 权限 |
|------|------|
| 管理加盟商 | ✅ 新增、编辑自己负责的加盟商 |
| 管理加盟合同 | ✅ 新增、编辑自己负责的加盟合同 |
| 管理员工 | ✅ 查看本部门员工 |
| 创建采购合同 | ❌ 只能创建加盟合同 |

**工作流程：**

1. **新增加盟商**：在「加盟商管理」中录入新加盟商信息，系统自动将负责人设为当前用户
2. **签订加盟合同**：在「合同管理」中点击「新增合同」
   - 合同类型自动设为「加盟合同」
   - 必须选择关联客户
   - 只能看到和编辑自己负责的加盟合同
3. **查看数据范围**：只能看到自己负责的加盟商和加盟合同

---

### 4.4 运营经理（operations_manager）

**日常职责：** 维护加盟商信息、处理售后

| 操作 | 权限 |
|------|------|
| 管理加盟商 | ✅ 编辑自己负责的加盟商 |
| 管理售后 | ✅ 新增、编辑自己负责的售后记录 |
| 管理合同 | ✅ 查看和编辑自己负责的加盟合同 |
| 管理员工 | ✅ 查本部门员工 |

**工作流程：**

1. **维护加盟商信息**：编辑加盟商的联系方式、地址等信息
2. **处理售后**：
   - 在「售后管理」中点击「新增售后」
   - 选择客户、填写反馈内容
   - 将状态从「待处理」改为「处理中」后，选择处理业务员（仅限运营部员工）
   - 填写处理方式，完成后将状态改为「已完成」
3. **查看数据范围**：只能看到自己负责的加盟商、售后记录和加盟合同

---

### 4.5 采购经理（procurement_manager）

**日常职责：** 管理产品原料、供应商、签订采购合同

| 操作 | 权限 |
|------|------|
| 管理产品 | ✅ 新增、编辑、删除所有产品 |
| 管理供应商 | ✅ 新增、编辑、删除所有供应商 |
| 管理采购合同 | ✅ 新增、编辑自己负责的采购合同 |
| 创建加盟合同 | ❌ 只能创建采购合同 |

**工作流程：**

1. **管理供应商**：在「供应商管理」中录入供应商信息
2. **管理产品**：在「产品管理」中录入产品信息，选择关联供应商
3. **签订采购合同**：
   - 在「合同管理」中点击「新增合同」
   - 合同类型自动设为「采购合同」
   - 必须选择关联供应商
   - 只能看到和编辑自己负责的采购合同

---

### 4.6 财务人员（finance）

**日常职责：** 只读查看业务数据

| 操作 | 权限 |
|------|------|
| 查看加盟商 | ✅ 全部数据 |
| 查看合同 | ✅ 全部数据 |
| 查看售后 | ✅ 全部数据 |
| 查看员工 | ✅ 全部数据 |
| 新增/编辑/删除 | ❌ 无任何写入权限 |

> 财务人员与总经理类似，拥有全局只读权限，用于财务审核和数据核对。

---

## 五、核心业务操作详解

### 5.1 加盟商管理

**新增加盟商：**
1. 点击「加盟商管理」→「新增加盟商」
2. 填写姓名（必填）、电话、地区、地址等信息
3. 管理员可指定负责人，其他角色自动设为当前用户
4. 保存后加盟商出现在列表中

**搜索加盟商：**
- 支持按姓名、电话、省份、城市搜索
- 支持按 ID 精确搜索

### 5.2 合同管理

**新增合同：**
1. 点击「合同管理」→「新增合同」
2. 选择合同类型（系统根据角色自动限制）
3. 加盟合同必须选择客户，采购合同必须选择供应商
4. 填写合同名称、金额、日期等信息
5. 保存合同

**合同状态流转：**
```
待审批 → 生效中 → 已完成
                  → 已终止
                  → 已到期（自动）
```

**搜索合同：**
- 支持按编号、名称、客户名、业务员名搜索
- 支持按生效日期范围筛选

### 5.3 售后管理

**新增售后：**
1. 点击「售后管理」→「新增售后」
2. 选择客户、填写反馈内容
3. 保存后状态默认为「待处理」

**处理售后：**
1. 将状态从「待处理」改为「处理中」
2. 选择处理业务员（仅限运营部员工）
3. 填写处理方式/解决方案
4. 完成后将状态改为「已完成」

### 5.4 产品与供应商管理

**管理供应商：** 录入供应商名称、联系人、电话、地址、类型等信息

**管理产品：** 录入产品名称、类型、数量、单价、规格，选择关联供应商

---

## 六、常见问题

### Q：为什么我看不到某些菜单？
A：您的角色没有对应权限。请联系管理员确认角色分配。

### Q：为什么我看不到某些数据？
A：系统有数据范围隔离。例如招商经理只能看到自己负责的加盟商和合同，看不到其他人的数据。

### Q：为什么合同的「客户」和「供应商」只能选一个？
A：合同分为「加盟合同」和「采购合同」两种类型。加盟合同关联客户，采购合同关联供应商，由合同类型决定。

### Q：为什么售后的「处理业务员」下拉是空的？
A：请先将售后状态从「待处理」改为「处理中」，业务员下拉才会启用。且只能选择运营部的员工。

### Q：如何修改其他人的负责人？
A：只有系统管理员可以在新增/编辑时修改「负责人」字段。其他角色的负责人在创建时自动设为当前用户，不可更改。

### Q：如何禁用一个用户？
A：管理员在「用户管理」中编辑用户，将状态改为「禁用」。该用户将无法登录系统，但已发出的 Token 在过期前仍有效。

### Q：如何删除员工？
A：在「员工管理」中点击删除。系统会同步删除该员工关联的用户账号。注意：不能删除自己关联的员工。

---

## 七、数据范围速查表

| 资源 | 管理员 | 总经理 | 招商经理 | 运营经理 | 采购经理 | 财务 |
|------|:------:|:------:|:--------:|:--------:|:--------:|:----:|
| 加盟商 | 全部 | 全部 | 自己负责 | 自己负责 | — | 全部 |
| 合同 | 全部 | 全部 | 自己的加盟合同 | 自己的加盟合同 | 自己的采购合同 | 全部 |
| 售后 | 全部 | 全部 | — | 自己负责 | — | 全部 |
| 员工 | 全部 | 全部 | 本部门 | 本部门 | 本部门 | 全部 |
| 产品 | 全部 | 全部 | — | — | 全部 | — |
| 供应商 | 全部 | 全部 | — | — | 全部 | — |
| 用户 | 全部 | — | — | — | — | — |

> **"—"** 表示该角色无权访问此资源。

---

## 八、快速上手清单

按以下步骤，10 分钟内完成系统搭建：

- [ ] 1. 管理员登录系统（`admin` / `123456`）
- [ ] 2. 确认员工已预置（或手动添加缺失的员工）
- [ ] 3. 确认用户账号已预置（或为每个员工创建用户账号）
- [ ] 4. 采购经理登录，添加供应商信息
- [ ] 5. 采购经理登录，添加产品信息
- [ ] 6. 招商经理登录，添加加盟商信息
- [ ] 7. 招商经理登录，创建加盟合同
- [ ] 8. 采购经理登录，创建采购合同
- [ ] 9. 运营经理登录，添加售后记录并处理
- [ ] 10. 总经理/财务登录，查看全局数据报表