feat: 添加部门管理功能、主题切换和多语言支持

refactor(dashboard): 重构用户管理页面和路由结构

feat(server): 实现部门管理API和RBAC增强功能

docs: 更新用户手册和管理员指南文档

style: 统一图标使用和组件命名规范

test: 添加部门服务和数据隔离测试用例

chore: 更新依赖和配置文件
This commit is contained in:
2026-03-28 22:52:12 +08:00
parent 22308fe042
commit d327706087
87 changed files with 21372 additions and 4806 deletions

200
docs/User_Manual.md Normal file
View File

@@ -0,0 +1,200 @@
# 用户手册
## 1. 系统概述
Crawlful Hub 是一个多平台电商管理系统,支持多租户、多店铺管理,提供商品、订单、财务、营销等核心功能。本手册将帮助您快速了解和使用系统的各项功能。
## 2. 登录与导航
### 2.1 登录系统
1. 打开浏览器输入系统地址http://localhost:8000
2. 输入您的邮箱和密码
3. 点击"登录"按钮
4. 成功登录后,系统会自动跳转到仪表盘页面
### 2.2 导航菜单
系统顶部导航栏包含以下主要模块:
- **仪表盘**:系统概览和关键指标
- **商品管理**:商品列表、创建、编辑等操作
- **订单管理**:订单列表、详情、处理等操作
- **财务中心**:财务报表、结算等操作
- **营销中心**:广告管理、促销活动等操作
- **库存管理**:库存查询、预警等操作
- **系统设置**:用户管理、权限设置、系统配置等操作
## 3. 核心功能
### 3.1 商品管理
#### 3.1.1 查看商品列表
1. 点击左侧导航栏中的"商品管理"
2. 在商品列表页面,您可以查看所有商品的基本信息
3. 使用搜索框和筛选条件快速找到目标商品
#### 3.1.2 创建新商品
1. 点击"创建商品"按钮
2. 填写商品基本信息,如名称、价格、库存等
3. 上传商品图片
4. 点击"保存"按钮
#### 3.1.3 编辑商品
1. 在商品列表中找到需要编辑的商品
2. 点击"编辑"按钮
3. 修改商品信息
4. 点击"保存"按钮
### 3.2 订单管理
#### 3.2.1 查看订单列表
1. 点击左侧导航栏中的"订单管理"
2. 在订单列表页面,您可以查看所有订单的基本信息
3. 使用搜索框和筛选条件快速找到目标订单
#### 3.2.2 处理订单
1. 在订单列表中找到需要处理的订单
2. 点击"查看"按钮进入订单详情页
3. 根据订单状态进行相应操作,如发货、退款等
### 3.3 财务中心
#### 3.3.1 查看财务报表
1. 点击左侧导航栏中的"财务中心"
2. 在财务报表页面,您可以查看系统生成的财务报表
3. 选择时间范围查看不同时期的财务数据
#### 3.3.2 结算管理
1. 在财务中心页面,点击"结算管理"
2. 查看待结算和已结算的记录
3. 点击"发起结算"按钮进行结算操作
### 3.4 营销中心
#### 3.4.1 广告管理
1. 点击左侧导航栏中的"营销中心"
2. 在广告管理页面,您可以创建和管理广告活动
3. 点击"创建广告"按钮开始创建新的广告活动
#### 3.4.2 促销活动
1. 在营销中心页面,点击"促销活动"
2. 创建和管理促销活动,如折扣、满减等
3. 设置活动规则和时间范围
### 3.5 库存管理
#### 3.5.1 查看库存
1. 点击左侧导航栏中的"库存管理"
2. 在库存列表页面,您可以查看所有商品的库存状态
3. 使用搜索框和筛选条件快速找到目标商品
#### 3.5.2 库存预警
1. 在库存管理页面,系统会自动标记库存不足的商品
2. 点击"库存预警"查看所有库存不足的商品
3. 及时补货以避免缺货
## 4. 系统设置
### 4.1 用户管理
#### 4.1.1 查看用户列表
1. 点击左侧导航栏中的"系统设置"
2. 在系统设置页面,点击"用户管理"
3. 查看所有用户的基本信息
#### 4.1.2 添加用户
1. 在用户管理页面,点击"添加用户"按钮
2. 填写用户基本信息,如姓名、邮箱、角色等
3. 点击"保存"按钮
#### 4.1.3 编辑用户
1. 在用户列表中找到需要编辑的用户
2. 点击"编辑"按钮
3. 修改用户信息
4. 点击"保存"按钮
### 4.2 权限管理
#### 4.2.1 角色管理
1. 在系统设置页面,点击"权限管理"
2. 查看和管理系统角色
3. 点击"创建角色"按钮创建新角色
4. 为角色分配相应的权限
#### 4.2.2 权限分配
1. 在权限管理页面,选择一个角色
2. 为角色分配具体的权限
3. 点击"保存"按钮
### 4.3 系统配置
#### 4.3.1 基本配置
1. 在系统设置页面,点击"系统配置"
2. 修改系统的基本设置如系统名称、Logo等
3. 点击"保存"按钮
#### 4.3.2 通知设置
1. 在系统配置页面,点击"通知设置"
2. 设置系统通知的相关参数
3. 点击"保存"按钮
## 5. 平台授权
### 5.1 平台开发者配置
1. 点击左侧导航栏中的"系统设置"
2. 在系统设置页面,点击"平台开发者配置"
3. 点击"添加平台"按钮
4. 填写平台的App ID和App Secret
5. 点击"保存"按钮
### 5.2 店铺授权
1. 点击左侧导航栏中的"系统设置"
2. 在系统设置页面,点击"店铺授权"
3. 点击"添加店铺"按钮
4. 选择平台,并按照提示完成授权流程
5. 授权成功后,店铺会显示在店铺列表中
## 6. 部门管理
### 6.1 查看部门列表
1. 点击左侧导航栏中的"系统设置"
2. 在系统设置页面,点击"部门管理"
3. 查看所有部门的基本信息
### 6.2 创建部门
1. 在部门管理页面,点击"添加部门"按钮
2. 填写部门名称和上级部门
3. 点击"保存"按钮
### 6.3 设置部门负责人
1. 在部门列表中找到需要设置负责人的部门
2. 点击"负责人"按钮
3. 选择部门负责人
4. 点击"保存"按钮
## 7. 常见问题
### 7.1 登录问题
- **忘记密码**:点击登录页面的"忘记密码"链接,按照提示重置密码
- **账号被锁定**:联系系统管理员解锁账号
### 7.2 功能问题
- **无法创建商品**:检查必填字段是否填写完整
- **订单状态不更新**:联系系统管理员检查订单处理流程
### 7.3 技术问题
- **系统卡顿**:清除浏览器缓存,或联系系统管理员
- **页面报错**:截图保存错误信息,联系系统管理员
## 8. 联系支持
如果您在使用过程中遇到任何问题,可以通过以下方式联系支持:
- **在线客服**:系统右下角的在线客服按钮
- **邮件支持**support@crawlful.com
- **电话支持**400-123-4567
---
本手册会定期更新,以反映系统的最新功能和变化。