diff --git a/系统使用说明.md b/系统使用说明.md new file mode 100644 index 0000000..7d13919 --- /dev/null +++ b/系统使用说明.md @@ -0,0 +1,342 @@ +# 蜜雪冰城企业管理系统 — 使用说明 + +> 本文档面向系统管理员及各部门工作人员,指导如何从零开始搭建和使用本系统。 + +--- + +## 一、系统总览 + +本系统用于蜜雪冰城总部管理加盟商、合同、员工、产品、供应商及售后事务。采用 **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. 总经理/财务登录,查看全局数据报表