refactor: 优化代码结构和类型定义

feat(types): 添加express.d.ts类型引用
style: 格式化express.d.ts中的接口定义
refactor: 移除未使用的AntFC类型导入
chore: 删除自动生成的.umi-production文件
feat: 添加店铺管理相关表和初始化脚本
docs: 更新安全规则和交互指南文档
refactor: 统一使用FC类型替代React.FC
perf: 优化图表组件导入方式
style: 添加.prettierrc配置文件
refactor: 调整组件导入顺序和结构
feat: 添加平台库存管理路由
fix: 修复订单同步时的库存检查逻辑
docs: 更新RBAC设计和租户管理文档
refactor: 优化部门控制器代码
This commit is contained in:
2026-03-30 01:20:57 +08:00
parent d327706087
commit 1b14947e7b
106 changed files with 11251 additions and 38565 deletions

View File

@@ -338,7 +338,28 @@ export class RBACEngine {
## 3. 租户管理
### 3.1 租户模型
### 3.1 租户生命周期管理
- **租户创建**支持用户升级时创建正式租户支持SAAS、ENTERPRISE、TRIAL类型
- **租户信息管理**租户名称、logo、联系方式等信息的设置
- **租户状态管理**:激活、暂停、删除等状态控制
- **租户数据备份**:定期备份租户数据
### 3.2 订阅与计费
- **套餐管理**:不同租户套餐的配置和管理,包含免费版、基础版、专业版、企业版
- **计费系统集成**:对接支付网关,实现自动计费
- **账单管理**:租户账单查看和管理
- **订阅状态提醒**:到期提醒、自动续费等
### 3.3 多租户隔离
- **数据库隔离**确保不同租户数据严格隔离所有业务表包含tenant_id字段
- **缓存隔离**Redis缓存的租户隔离使用generateTenantKey方法
- **日志隔离**:租户操作日志的独立存储
- **API隔离**API调用的租户身份验证
### 3.4 租户模型
```typescript
export interface Tenant {
@@ -382,7 +403,7 @@ export interface Tenant {
}
```
### 3.2 租户隔离
### 3.5 租户隔离实现
```typescript
export class DataIsolationService {
@@ -439,7 +460,7 @@ export class DataIsolationService {
}
```
### 3.3 配额管理
### 3.6 配额管理
```typescript
export class QuotaGovernanceService {

View File

@@ -312,6 +312,10 @@ async updateProduct(productId: string, updates: Partial<Product>, userId: string
- **修改角色**:修改角色的权限
- **删除角色**:删除不需要的角色
- **分配角色**:为用户分配角色
- **自定义角色**:允许租户管理员创建自定义角色和权限组合
- **权限细粒度控制**:更细致的功能权限划分
- **权限继承可视化**:清晰展示权限继承关系
- **权限审计**:记录权限变更历史
### 5.2 权限管理
@@ -325,6 +329,14 @@ async updateProduct(productId: string, updates: Partial<Product>, userId: string
- **修改用户**:修改用户的角色和权限
- **删除用户**:删除用户
- **禁用用户**:暂时禁用用户
- **批量操作支持**:批量添加、更新用户
### 5.4 部门管理
- **部门层级管理**:支持多级部门结构的创建和管理
- **部门负责人设置**:自动为部门负责人分配管理权限
- **部门转移**:支持用户在不同部门间的转移
- **部门统计**:按部门统计用户和店铺数量
---

View File

@@ -233,6 +233,22 @@ loading → success / error
- 数据缓存
- 防抖和节流
## 5. 用户体验优化
### 5.1 界面优化
- **响应式设计**:适配不同设备屏幕
- **操作流程简化**:减少用户操作步骤
- **批量操作界面**:支持多选和批量操作
- **拖拽排序**:部门和用户的拖拽排序
### 5.2 通知与提醒
- **系统通知**:重要操作的系统通知
- **邮件提醒**:权限变更、邀请等邮件提醒
- **站内信**:系统内部消息通知
- **操作确认**:重要操作的二次确认
---
## 📋 验收标准

View File

@@ -0,0 +1,79 @@
# 前端用户体验优化清单
> **来源**: 从 Frontend_Missing_Features.md 拆解
> **状态**: 可选优化项
> **优先级**: 低
> **最后更新**: 2026-03-29
---
## 可选优化功能
### 1. 动画效果
- [ ] **页面过渡动画**
- 路由切换动画
- 页面加载动画
- 内容淡入淡出效果
- [ ] **交互动画**
- 按钮点击反馈
- 表单输入动画
- 列表项展开/收起动画
- 模态框弹出动画
- [ ] **数据可视化动画**
- 图表数据更新动画
- 数字滚动效果
- 进度条动画
### 2. 移动端适配
- [ ] **响应式优化**
- 移动端布局适配
- 触摸交互优化
- 移动端导航优化
- 横竖屏适配
- [ ] **性能优化**
- 移动端资源加载优化
- 图片懒加载
- 无限滚动优化
### 3. 表单验证
- [ ] **复杂表单验证**
- 实时验证反馈
- 跨字段验证
- 异步验证(如用户名唯一性检查)
- 表单提交前完整验证
- [ ] **验证体验优化**
- 错误提示样式优化
- 验证规则可视化
- 自动纠错建议
---
## 实现建议
### 动画库推荐
- **Framer Motion** - React 动画库API 友好
- **React Spring** - 物理动画效果
- **GSAP** - 专业级动画库
- **Ant Design Motion** - 与 Ant Design 集成
### 移动端适配方案
- **Responsive Design** - 响应式设计
- **Mobile-First** - 移动优先策略
- **PWA** - 渐进式 Web 应用
### 表单验证方案
- **React Hook Form** - 性能优秀的表单库
- **Yup/Zod** - 表单验证 Schema
- **Ant Design Form** - 内置验证功能
---
## 相关文档
- [01_Design.md](./01_Design.md) - 前端设计规范
- [04_Interaction_Guidelines.md](./04_Interaction_Guidelines.md) - 交互规范
- [05_UI_Components.md](./05_UI_Components.md) - UI 组件规范

View File

@@ -66,8 +66,16 @@
| **库存预警与自动补货** | ✅ 已完成 | 2026-03-22 |
| **合规风险评估与黑名单管理** | ✅ 已完成 | 2026-03-22 |
| **业务闭环完善** | ✅ 已完成 | 2026-03-22 |
| **1688/广告适配器** | 📝 待开始 | - |
| **AI选品评分与套利识别** | 📝 待开始 | - |
| **1688/广告适配器** | ✅ 已完成 | 2026-03-22 |
| **AI选品评分与套利识别** | ✅ 已完成 | 2026-03-22 |
| **前端核心功能完善** | ✅ 已完成 | 2026-03-29 |
| **实时数据同步系统** | ✅ 已完成 | 2026-03-29 |
| **数据导出功能** | ✅ 已完成 | 2026-03-29 |
| **权限粒度控制** | ✅ 已完成 | 2026-03-29 |
| **操作日志记录** | ✅ 已完成 | 2026-03-29 |
| **系统通知系统** | ✅ 已完成 | 2026-03-29 |
| **代码质量与规范** | ✅ 已完成 | 2026-03-29 |
| **监控和可观测性** | ✅ 已完成 | 2026-03-29 |
---
@@ -97,6 +105,15 @@
-**类型版本管理version.ts**
-**Zod-to-OpenAPI转换工具**
### 前端核心功能实现
-**实时数据同步** - WebSocket服务端完整实现server/src/runtime/ws/
-**数据导出功能** - 多页面支持CSV/Excel/PDF导出OperationLogs、AnalyticsDashboard等
-**权限粒度控制** - 细粒度权限管理RoleManagement.tsx支持权限树配置
-**操作日志记录** - 完整操作日志记录和查询OperationLogs/index.tsx
-**系统通知系统** - 站内通知和多渠道通知服务NotificationCenter + notificationService.ts
-**代码质量与规范** - TypeScript类型定义、ESLint/Prettier配置、错误边界、懒加载
-**监控和可观测性** - 性能监控、错误监控、用户行为分析、系统状态监控
### 业务功能模块
- ✅ 多商户收益排行榜系统(信任引擎)
- ✅ 策略市场Strategy Marketplace

View File

@@ -0,0 +1,326 @@
# 管理员指南
## 1. 管理员概述
作为租户管理员,您拥有管理整个租户的权限,包括用户管理、权限配置、系统设置、店铺管理等。本指南将帮助您了解和使用管理员的各项功能。
## 2. 登录与权限
### 2.1 管理员登录
1. 打开浏览器输入系统地址http://localhost:8000
2. 输入您的管理员邮箱和密码
3. 点击"登录"按钮
4. 成功登录后,系统会自动跳转到管理员仪表盘页面
### 2.2 管理员权限
作为租户管理员,您拥有以下权限:
- **用户管理**:添加、编辑、删除用户,分配角色
- **权限管理**:创建和管理角色,分配权限
- **系统设置**:修改系统配置,设置通知规则
- **店铺管理**:添加、编辑、删除店铺,管理店铺授权
- **部门管理**:创建和管理部门,设置部门负责人
- **订阅管理**:管理租户订阅,查看使用量统计
## 3. 用户管理
### 3.1 查看用户列表
1. 点击左侧导航栏中的"系统设置"
2. 在系统设置页面,点击"用户管理"
3. 查看所有用户的基本信息,包括姓名、邮箱、角色、状态等
4. 使用搜索框和筛选条件快速找到目标用户
### 3.2 添加用户
1. 在用户管理页面,点击"添加用户"按钮
2. 填写用户基本信息:
- 姓名
- 邮箱(必须唯一)
- 密码
- 角色(选择用户的角色)
- 部门(选择用户所属部门)
- 状态(启用或禁用)
3. 点击"保存"按钮
### 3.3 编辑用户
1. 在用户列表中找到需要编辑的用户
2. 点击"编辑"按钮
3. 修改用户信息
4. 点击"保存"按钮
### 3.4 删除用户
1. 在用户列表中找到需要删除的用户
2. 点击"删除"按钮
3. 在确认对话框中点击"确定"按钮
### 3.5 批量操作
1. 在用户列表中,勾选多个用户
2. 点击"批量操作"按钮
3. 选择要执行的操作,如批量启用、批量禁用、批量删除等
4. 点击"执行"按钮
## 4. 权限管理
### 4.1 角色管理
#### 4.1.1 查看角色列表
1. 在系统设置页面,点击"权限管理"
2. 查看所有角色的基本信息,包括角色名称、描述、创建时间等
#### 4.1.2 创建角色
1. 在权限管理页面,点击"创建角色"按钮
2. 填写角色基本信息:
- 角色名称
- 角色描述
3. 为角色分配权限:
- 选择模块权限
- 选择操作权限
4. 点击"保存"按钮
#### 4.1.3 编辑角色
1. 在角色列表中找到需要编辑的角色
2. 点击"编辑"按钮
3. 修改角色信息和权限
4. 点击"保存"按钮
#### 4.1.4 删除角色
1. 在角色列表中找到需要删除的角色
2. 点击"删除"按钮
3. 在确认对话框中点击"确定"按钮
### 4.2 权限分配
#### 4.2.1 为用户分配角色
1. 在用户管理页面,找到需要分配角色的用户
2. 点击"编辑"按钮
3. 在"角色"下拉菜单中选择角色
4. 点击"保存"按钮
#### 4.2.2 为部门分配权限
1. 在系统设置页面,点击"部门管理"
2. 找到需要分配权限的部门
3. 点击"权限"按钮
4. 为部门分配权限
5. 点击"保存"按钮
## 5. 系统设置
### 5.1 基本配置
1. 在系统设置页面,点击"系统配置"
2. 修改系统的基本设置:
- 系统名称
- 系统Logo
- 系统描述
- 时区设置
- 语言设置
3. 点击"保存"按钮
### 5.2 通知设置
1. 在系统配置页面,点击"通知设置"
2. 设置系统通知的相关参数:
- 邮件通知开关
- 短信通知开关
- 系统内通知开关
- 通知模板
3. 点击"保存"按钮
### 5.3 安全设置
1. 在系统配置页面,点击"安全设置"
2. 设置系统安全的相关参数:
- 密码策略(长度、复杂度要求)
- 登录失败次数限制
- 会话超时时间
- 双因素认证开关
3. 点击"保存"按钮
## 6. 店铺管理
### 6.1 平台开发者配置
1. 在系统设置页面,点击"平台开发者配置"
2. 点击"添加平台"按钮
3. 填写平台的基本信息:
- 平台名称
- App ID
- App Secret
- 回调地址
4. 点击"保存"按钮
### 6.2 店铺授权
1. 在系统设置页面,点击"店铺授权"
2. 点击"添加店铺"按钮
3. 选择平台,并按照提示完成授权流程
4. 授权成功后,店铺会显示在店铺列表中
### 6.3 店铺管理
1. 在店铺授权页面,查看所有已授权的店铺
2. 点击"编辑"按钮修改店铺信息
3. 点击"删除"按钮删除店铺
4. 点击"重新授权"按钮重新授权店铺
## 7. 部门管理
### 7.1 查看部门列表
1. 在系统设置页面,点击"部门管理"
2. 查看所有部门的基本信息,包括部门名称、负责人、用户数等
3. 使用搜索框快速找到目标部门
### 7.2 创建部门
1. 在部门管理页面,点击"添加部门"按钮
2. 填写部门基本信息:
- 部门名称
- 上级部门(可选)
- 部门描述
3. 点击"保存"按钮
### 7.3 编辑部门
1. 在部门列表中找到需要编辑的部门
2. 点击"编辑"按钮
3. 修改部门信息
4. 点击"保存"按钮
### 7.4 删除部门
1. 在部门列表中找到需要删除的部门
2. 点击"删除"按钮
3. 在确认对话框中点击"确定"按钮
### 7.5 设置部门负责人
1. 在部门列表中找到需要设置负责人的部门
2. 点击"负责人"按钮
3. 选择部门负责人
4. 点击"保存"按钮
## 8. 订阅与计费
### 8.1 套餐管理
1. 点击左侧导航栏中的"订阅与计费"
2. 在订阅与计费页面,点击"套餐管理"
3. 查看当前可用的套餐
4. 点击"切换套餐"按钮选择新的套餐
### 8.2 使用量统计
1. 在订阅与计费页面,点击"使用量统计"
2. 查看系统的使用情况,包括:
- AI调用次数
- 店铺数量
- 存储空间使用情况
- API调用次数
3. 选择时间范围查看不同时期的使用数据
### 8.3 计费周期
1. 在订阅与计费页面,点击"计费周期"
2. 查看当前的计费周期和费用
3. 选择计费方式(月付或年付)
## 9. 数据管理
### 9.1 数据导出
1. 在系统设置页面,点击"数据管理"
2. 点击"数据导出"按钮
3. 选择要导出的数据类型
4. 选择导出格式CSV或Excel
5. 点击"导出"按钮
### 9.2 数据导入
1. 在系统设置页面,点击"数据管理"
2. 点击"数据导入"按钮
3. 选择要导入的数据类型
4. 上传数据文件
5. 点击"导入"按钮
### 9.3 数据备份
1. 在系统设置页面,点击"数据管理"
2. 点击"数据备份"按钮
3. 选择备份类型(手动备份或自动备份)
4. 点击"开始备份"按钮
## 10. 日志管理
### 10.1 操作日志
1. 在系统设置页面,点击"日志管理"
2. 查看系统的操作日志,包括:
- 操作人
- 操作类型
- 操作时间
- 操作内容
3. 使用搜索框和筛选条件快速找到目标日志
### 10.2 登录日志
1. 在日志管理页面,点击"登录日志"
2. 查看系统的登录日志,包括:
- 登录人
- 登录时间
- 登录IP
- 登录状态
3. 使用搜索框和筛选条件快速找到目标日志
### 10.3 异常日志
1. 在日志管理页面,点击"异常日志"
2. 查看系统的异常日志,包括:
- 异常时间
- 异常类型
- 异常详情
- 影响范围
3. 使用搜索框和筛选条件快速找到目标日志
## 11. 常见问题
### 11.1 用户管理问题
- **用户无法登录**:检查用户状态是否为启用,密码是否正确
- **用户权限不足**:检查用户角色和权限设置
### 11.2 店铺授权问题
- **授权失败**:检查平台开发者配置是否正确,网络连接是否正常
- **授权过期**:重新授权店铺
### 11.3 系统配置问题
- **配置不生效**:检查配置是否保存成功,是否需要重启系统
- **系统性能问题**:检查系统资源使用情况,优化系统配置
### 11.4 数据问题
- **数据丢失**:恢复最近的备份
- **数据错误**:检查数据导入过程,修正错误数据
## 12. 联系支持
如果您在使用过程中遇到任何问题,可以通过以下方式联系支持:
- **在线客服**:系统右下角的在线客服按钮
- **邮件支持**support@crawlful.com
- **电话支持**400-123-4567
- **技术支持**tech@crawlful.com
---
本指南会定期更新,以反映系统的最新功能和变化。

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
---
本手册会定期更新,以反映系统的最新功能和变化。