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. 总经理/财务登录，查看全局数据报表