docs: Admin管理系统融合方案完整分析文档 - 包含四端功能融合、15个新角色权限体系、5个新菜单详设计、15周实施路线图

2026-02-04 17:37:38 +08:00
parent df642813c3
commit c411c23b9c
14 changed files with 5174 additions and 5 deletions
--- a/ADMIN_IMPLEMENTATION_CHECKLIST.md
+++ b/ADMIN_IMPLEMENTATION_CHECKLIST.md
@@ -0,0 +1,687 @@
+# Admin管理系统融合方案 - 实施检查清单
+
+> 📋 从0到1实施admin端融合方案的完整检查清单
+
+---
+
+## Phase 0: 方案评审（第0-1周）
+
+### 方案理解
+- [ ] 管理层理解融合方案的目标和收益
+- [ ] 理解新增5个菜单的功能和必要性
+- [ ] 确认15个新角色是否满足公司组织结构
+- [ ] 确认是否需要删除或合并某些菜单
+- [ ] 确认优先级排序（哪些菜单先做）
+
+### 需求确认
+- [ ] 确认是否支持多商户模式（若不支持，商户管理菜单不必做）
+- [ ] 确认是否有自建配送（若不支持，配送管理菜单不必做）
+- [ ] 确认是否需要用户行为追踪（资源密集）
+- [ ] 确认是否需要智能风控（需要ML团队支持）
+- [ ] 确认权限细度是否需要到按钮级
+
+### 资源规划
+- [ ] 确认开发团队规模和技能
+- [ ] 规划测试团队资源
+- [ ] 规划UAT参与者（业务人员）
+- [ ] 规划项目经理和设计师
+- [ ] 规划后续维护团队
+
+---
+
+## Phase 1: 技术基础建设（第1-2周）
+
+### 数据库设计
+- [ ] 设计 `roles` 表结构（id、name、description、status）
+- [ ] 设计 `permissions` 表结构（id、code、name、resource、action）
+- [ ] 设计 `role_permissions` 表结构（role_id、permission_id）
+- [ ] 设计 `user_roles` 表结构（user_id、role_id、start_date、end_date）
+- [ ] 设计 `permission_audit_log` 表（谁在何时修改了什么权限）
+- [ ] 设计 `operation_audit_log` 表（所有操作记录）
+- [ ] 添加索引优化查询
+- [ ] 创建RLS策略保证数据隔离
+
+### 后端API开发
+- [ ] 开发 `/api/auth/user-roles` - 获取当前用户的所有角色
+- [ ] 开发 `/api/auth/permissions` - 获取当前用户的所有权限
+- [ ] 开发 `/api/roles` - CRUD角色
+- [ ] 开发 `/api/permissions` - CRUD权限
+- [ ] 开发 `/api/role-permissions` - 角色权限分配
+- [ ] 开发 `/api/user-audit-log` - 用户操作审计日志查询
+- [ ] 开发权限验证中间件
+- [ ] 开发数据权限过滤中间件
+
+### 前端权限库开发
+- [ ] 创建 `usePermission()` hook
+- [ ] 创建 `hasPermission(code)` 函数
+- [ ] 创建 `hasRole(roleId)` 函数
+- [ ] 创建菜单过滤函数
+- [ ] 创建按钮权限隐藏指令 `v-permission`
+- [ ] 创建权限检查中间件（路由守卫）
+
+### 测试编写
+- [ ] 编写权限查询单元测试
+- [ ] 编写数据隔离测试（A用户不能看B用户数据）
+- [ ] 编写权限提升防护测试
+- [ ] 编写API权限验证测试
+
+**交付成果**: 基础权限框架就位，所有API都有权限验证
+
+---
+
+## Phase 2: 菜单和首页重构（第2-3周）
+
+### 菜单树数据结构
+- [ ] 定义菜单树TypeScript类型
+- [ ] 创建菜单树配置文件（JSON）
+- [ ] 为每个菜单项添加 `requiredRoles` 和 `requiredPermissions` 字段
+- [ ] 实现菜单权限过滤函数
+
+### 侧边栏组件重构
+- [ ] 重构 `Sidebar` 组件支持动态菜单
+- [ ] 实现菜单展开/折叠
+- [ ] 实现菜单搜索
+- [ ] 实现菜单高亮当前页面
+- [ ] 添加菜单权限不足时的提示
+
+### 首页看板动态化
+- [ ] 创建 `DashboardConfig` 数据结构（看板配置）
+- [ ] 实现看板选择器（用户选择要看哪些KPI）
+- [ ] 实现7个角色特定的看板模板
+  - [ ] 超级管理员看板
+  - [ ] 总经理看板
+  - [ ] 用户运营看板
+  - [ ] 商品运营看板
+  - [ ] 订单管理看板
+  - [ ] 营销运营看板
+  - [ ] 数据分析师看板
+- [ ] 实现看板主题切换
+- [ ] 实现看板配置保存/加载
+
+### 页面级权限守卫
+- [ ] 为每个现有页面添加权限验证
+- [ ] 无权限时重定向到首页+提示
+- [ ] 添加权限变化时的动态更新
+
+**交付成果**: 用户登录后看到的菜单和首页完全根据角色定制化
+
+---
+
+## Phase 3: 新增菜单实现（第4-12周）
+
+### 14. 数据分析菜单（第4-5周）
+
+#### 看板管理子菜单
+- [ ] 看板配置页面
+  - [ ] 看板列表（查看、编辑、删除、新建）
+  - [ ] 看板编辑界面（拖拽配置）
+  - [ ] KPI指标选择器（30+个指标）
+  - [ ] 图表类型选择器
+  - [ ] 预览功能
+- [ ] 看板样式页面
+  - [ ] 颜色方案选择
+  - [ ] 布局选择
+  - [ ] 字体大小调整
+- [ ] 看板权限页面
+  - [ ] 选择哪些角色可见
+  - [ ] 选择哪些用户可见
+  - [ ] 权限历史查看
+
+#### 报表管理子菜单
+- [ ] 报表模板库
+  - [ ] 预设模板列表
+  - [ ] 模板详情查看
+  - [ ] 一键应用模板
+  - [ ] 自定义模板保存
+- [ ] 定时报表
+  - [ ] 创建定时报表向导
+  - [ ] 报表参数配置
+  - [ ] 发送时间设置（日/周/月）
+  - [ ] 接收人列表
+  - [ ] 发送历史
+- [ ] 报表审计
+  - [ ] 谁查看了哪些报表
+  - [ ] 何时导出了什么数据
+  - [ ] 筛选和搜索
+  - [ ] 下载审计日志
+- [ ] 数据权限
+  - [ ] 按角色配置数据可见范围
+  - [ ] 按地区/商户配置
+  - [ ] 权限生效测试
+
+#### 异常告警子菜单
+- [ ] 告警规则配置
+  - [ ] 选择告警类型（KPI、库存、用户、成本）
+  - [ ] 设置阈值和触发条件
+  - [ ] 配置生效时间
+  - [ ] 规则列表管理
+- [ ] 告警频道配置
+  - [ ] 启用/禁用各种通知渠道
+  - [ ] 配置收件人
+  - [ ] 配置通知模板
+- [ ] 告警历史
+  - [ ] 告警日志查看
+  - [ ] 标记已处理
+  - [ ] 处理统计
+
+#### 对标管理子菜单
+- [ ] 目标设置
+  - [ ] 设置月度目标（销售、利润、新客等）
+  - [ ] 部门目标分配
+  - [ ] 目标历史查看
+- [ ] 对标查询
+  - [ ] 选择对标对象（去年同期、上月、行业均值）
+  - [ ] 显示对比图表
+  - [ ] 导出对标数据
+- [ ] 达成分析
+  - [ ] 完成度进度条
+  - [ ] 驱动因素分析
+  - [ ] 月度复盘报告
+
+#### 数据库和RPC
+- [ ] 创建 analytics_dashboards 表
+- [ ] 创建 analytics_reports 表
+- [ ] 创建 analytics_alerts 表
+- [ ] 创建 analytics_audit_log 表
+- [ ] 实现 RPC：get_dashboard_data
+- [ ] 实现 RPC：get_report_data
+- [ ] 实现 RPC：check_alert_conditions
+
+#### 测试
+- [ ] 测试权限验证（只有指定角色能编辑）
+- [ ] 测试报表生成和发送
+- [ ] 测试告警触发和通知
+- [ ] 性能测试（大数据量报表查询）
+
+**第4-5周交付成果**: 完整的数据分析菜单就位
+
+---
+
+### 15. 配送管理菜单（第6-8周）（仅O2O模式）
+
+#### 配送统计子菜单
+- [ ] 今日数据看板
+  - [ ] 待接单数、配送中数、已完成数
+  - [ ] 总收入、平均送达时间
+  - [ ] 实时更新
+- [ ] 配送员排行
+  - [ ] 今日/周/月排行
+  - [ ] 按收入、订单数、评分排行
+  - [ ] 导出排行榜
+- [ ] 路线分析
+  - [ ] 配送费用效率（总费用/订单数）
+  - [ ] 完成率分析
+  - [ ] 里程成本
+  - [ ] 最优路线建议
+
+#### 配送员管理子菜单
+- [ ] 配送员列表
+  - [ ] 表格展示（姓名、评分、车辆、服务区）
+  - [ ] 编辑配送员信息
+  - [ ] 启用/禁用配送员
+  - [ ] 批量导入/导出
+  - [ ] 高级搜索和过滤
+- [ ] 配送员审核
+  - [ ] 新申请列表
+  - [ ] 文件上传验证
+  - [ ] 批准/拒绝流程
+  - [ ] 审核历史
+- [ ] 黑名单管理
+  - [ ] 冻结账户
+  - [ ] 记录冻结原因
+  - [ ] 申诉处理
+  - [ ] 黑名单解除流程
+- [ ] 配送员分级
+  - [ ] 设置等级标准（销售额、评分、投诉率）
+  - [ ] 自动升降级
+  - [ ] 手动调整
+  - [ ] 等级权益配置
+- [ ] 激励管理
+  - [ ] 创建激励活动
+  - [ ] 配置激励规则（达成XX→获得YY）
+  - [ ] 激励统计
+- [ ] 申诉处理
+  - [ ] 投诉列表
+  - [ ] 处理工单
+  - [ ] 处理结果记录
+  - [ ] 投诉统计
+
+#### 任务分配子菜单
+- [ ] 自动分配规则
+  - [ ] 配置算法参数（距离权重、工作量均衡系数等）
+  - [ ] 地理围栏配置
+  - [ ] 测试规则
+- [ ] 手动分配
+  - [ ] 选择订单和配送员
+  - [ ] 分配备注
+  - [ ] 批量分配
+- [ ] 分配记录
+  - [ ] 历史查看
+  - [ ] 统计分析
+
+#### 绩效考核子菜单
+- [ ] 考核指标
+  - [ ] 定义指标（送达时间、评分、投诉等）
+  - [ ] 指标权重配置
+  - [ ] 目标设置
+  - [ ] 奖惩规则
+- [ ] 月度考核
+  - [ ] 自动生成考核报告
+  - [ ] 考核分数计算
+  - [ ] 等级评定
+  - [ ] 结果公示
+- [ ] 工资计算
+  - [ ] 基本工资+考核+分层计价
+  - [ ] 自动计算
+  - [ ] 工资表导出
+
+#### 费用结算子菜单
+- [ ] 费率配置
+  - [ ] 按距离/时间/订单量分层定价
+  - [ ] 特殊商品加价
+  - [ ] 规则管理
+- [ ] 提现管理
+  - [ ] 提现申请审核
+  - [ ] 转账处理
+  - [ ] 到账确认
+- [ ] 结算周期
+  - [ ] 配置周期（日/周/月结）
+  - [ ] 自动结算
+- [ ] 结算报表
+  - [ ] 日/周/月结单导出
+
+#### 车辆管理子菜单
+- [ ] 车辆列表
+  - [ ] 车辆信息展示和编辑
+  - [ ] 关联配送员
+- [ ] 车牌审核
+  - [ ] 行驶证审核
+  - [ ] 保险验证
+  - [ ] 年检查看
+- [ ] 轨迹追踪
+  - [ ] 实时位置查看
+  - [ ] 路线可视化
+  - [ ] 行驶速度监控
+  - [ ] 异常告警
+
+#### 数据库
+- [ ] 创建 ml_delivery_drivers 表（if not exists）
+- [ ] 创建 ml_delivery_tasks 表
+- [ ] 创建 ml_delivery_performance 表
+- [ ] 创建 ml_delivery_vehicles 表
+- [ ] 创建 ml_delivery_payroll 表
+
+**第6-8周交付成果**: 完整的配送管理菜单就位（仅O2O模式）
+
+---
+
+### 16. 商户管理菜单（第9-10周）（仅平台模式）
+
+#### 商户统计子菜单
+- [ ] 商户总数
+  - [ ] 按等级、状态、分类统计
+  - [ ] 增长曲线
+- [ ] 商户排行
+  - [ ] 销售额/订单数/评分排行
+  - [ ] 导出排行榜
+- [ ] 商户画像
+  - [ ] 分类分布
+  - [ ] 地区分布
+  - [ ] 等级分布
+
+#### 商户审核子菜单
+- [ ] 入驻申请
+  - [ ] 申请列表
+  - [ ] 资质审核
+  - [ ] 批准/驳回
+  - [ ] 申请历史
+- [ ] 资质审核
+  - [ ] 身份验证
+  - [ ] 银行账户验证
+  - [ ] 税务信息验证
+- [ ] 保证金缴纳
+  - [ ] 缴纳记录
+  - [ ] 缴纳确认
+  - [ ] 退款处理
+- [ ] 激活管理
+  - [ ] 激活前检查
+  - [ ] 生成激活码
+  - [ ] 激活状态变更
+
+#### 商户管理子菜单
+- [ ] 商户列表
+  - [ ] 商户信息查看和编辑
+  - [ ] 启用/禁用
+  - [ ] 批量操作
+- [ ] 商户分级
+  - [ ] 分级标准配置
+  - [ ] 自动升降级
+  - [ ] 手动调整
+- [ ] 店铺信息
+  - [ ] 店铺名称、logo、简介编辑
+  - [ ] 营业时间配置
+- [ ] 联系方式管理
+  - [ ] 账号、邮箱、电话、微信管理
+- [ ] 冻结/解冻
+  - [ ] 冻结操作
+  - [ ] 解冻申请处理
+
+#### 费用管理子菜单
+- [ ] 保证金管理
+  - [ ] 保证金标准设置
+  - [ ] 缴纳记录
+  - [ ] 扣罚管理
+  - [ ] 退还流程
+- [ ] 佣金配置
+  - [ ] 按分类/等级设定佣金率
+  - [ ] 新商户优惠期配置
+  - [ ] 佣金规则审批
+- [ ] 佣金扣除
+  - [ ] 自动计算和扣除
+  - [ ] 明细查看
+  - [ ] 统计报表
+- [ ] 提现管理
+  - [ ] 提现申请审核
+  - [ ] 转账处理
+  - [ ] 提现统计
+- [ ] 罚款管理
+  - [ ] 罚款原因配置
+  - [ ] 罚款处理
+  - [ ] 申诉处理
+- [ ] 结算报表
+  - [ ] 日/周/月结单导出
+  - [ ] 商户个人报表
+  - [ ] 分类汇总
+
+#### 经营管理子菜单
+- [ ] 商户数据
+  - [ ] 销售、转化、评分数据
+  - [ ] 数据对比
+- [ ] 商户违规
+  - [ ] 投诉统计
+  - [ ] 退货率统计
+  - [ ] 风险评分
+- [ ] 营销工具权限
+  - [ ] 配置可用功能
+  - [ ] 功能限制配置
+- [ ] 商户沟通
+  - [ ] 发送通知
+  - [ ] 公告发布
+- [ ] 商户退出
+  - [ ] 退出申请处理
+  - [ ] 清算流程
+
+**第9-10周交付成果**: 完整的商户管理菜单就位（仅平台模式）
+
+---
+
+### 17. 行为分析菜单（第11周）
+
+#### 用户行为追踪子菜单
+- [ ] 浏览行为
+  - [ ] 页面访问统计
+  - [ ] 停留时长分析
+  - [ ] 路径分析
+  - [ ] 热力图
+  - [ ] 用户分群
+- [ ] 收藏分析
+  - [ ] 收藏商品排行
+  - [ ] 收藏转购率
+  - [ ] 未购收藏提醒
+- [ ] 购物车分析
+  - [ ] 放弃率分析
+  - [ ] 商品热度
+  - [ ] 平均金额
+- [ ] 搜索热词
+  - [ ] 热词统计
+  - [ ] 搜索转化率
+  - [ ] 零结果搜索词
+  - [ ] 搜索趋势
+- [ ] 用户路径
+  - [ ] 访问路径流
+  - [ ] 流失分析
+  - [ ] 转化路径
+
+#### 订单风险识别子菜单
+- [ ] 异常订单检测
+  - [ ] 虚假订单识别
+  - [ ] 高风险用户检测
+  - [ ] 大额采购预警
+  - [ ] 风险评分系统
+- [ ] 黑名单管理
+  - [ ] 冻结恶意用户
+  - [ ] 黑名单原因记录
+  - [ ] 黑名单解除申诉
+- [ ] 异常退货分析
+  - [ ] 退货率过高用户识别
+  - [ ] 退货模式分析
+- [ ] 恶意评价识别
+  - [ ] 虚假好评检测
+  - [ ] 违规评价检测
+  - [ ] 处理建议
+- [ ] 风险订单处理
+  - [ ] 待审核队列
+  - [ ] 手动审核
+  - [ ] 处理统计
+
+#### 退款审核管理子菜单
+- [ ] 待审核退款
+  - [ ] 待审核列表
+  - [ ] 订单信息查看
+  - [ ] 用户信息查看
+  - [ ] 审核决定（同意/拒绝）
+- [ ] 自动退款规则
+  - [ ] 快速退款条件配置
+  - [ ] 规则管理
+- [ ] 退款审批流
+  - [ ] 多级审批流配置
+  - [ ] 金额阈值设置
+- [ ] 退款拒绝
+  - [ ] 拒绝原因管理
+  - [ ] 申诉处理
+- [ ] 退款统计
+  - [ ] 退货率分析
+  - [ ] 退款成本统计
+  - [ ] 原因排行
+- [ ] 物流退货追踪
+  - [ ] 退货物流信息
+  - [ ] 退货签收确认
+
+#### 数据库
+- [ ] 创建 user_behavior_tracking 表
+- [ ] 创建 order_risk_assessment 表
+- [ ] 创建 refund_audit_log 表
+
+**第11周交付成果**: 完整的行为分析菜单就位
+
+---
+
+### 18. 审核管理菜单（第12周）
+
+#### 财务审核子菜单
+- [ ] 提现审核
+  - [ ] 待审核列表
+  - [ ] 账户验证
+  - [ ] 批准/驳回
+  - [ ] 转账处理
+  - [ ] 到账确认
+- [ ] 发票审核
+  - [ ] 待审核列表
+  - [ ] 信息验证
+  - [ ] 批准/驳回
+- [ ] 财务异常
+  - [ ] 异常交易提醒
+  - [ ] 人工审核
+- [ ] 审核历史
+  - [ ] 已审核记录
+  - [ ] 审计日志
+
+#### 商户审核子菜单
+- [ ] 入驻申请审核
+- [ ] 资料修改审核
+- [ ] 营销活动审核
+- [ ] 申诉审核
+
+#### 用户审核子菜单
+- [ ] 用户申诉审核
+- [ ] 发票申请审核
+- [ ] 账户异常处理
+- [ ] 账户冻结申请
+
+#### 内容审核子菜单
+- [ ] 商品评价审核
+  - [ ] 待审核列表
+  - [ ] 内容检查
+  - [ ] 图片审核
+  - [ ] 虚假评价检测
+- [ ] 用户反馈审核
+  - [ ] 待审核列表
+  - [ ] 反馈分配
+  - [ ] 回复管理
+- [ ] 文章审核
+  - [ ] 待审核列表
+  - [ ] 内容检查
+  - [ ] 发布/驳回
+- [ ] 评论审核
+  - [ ] 待审核列表
+  - [ ] 内容检查
+  - [ ] 删除/隐藏
+
+**第12周交付成果**: 完整的审核管理菜单就位
+
+---
+
+## Phase 4: 验收和优化（第13-14周）
+
+### UAT准备
+- [ ] 编写UAT测试用例（每个菜单20+用例）
+- [ ] 准备测试数据（模拟真实业务场景）
+- [ ] 准备UAT环境（隔离于生产）
+
+### 业务人员培训
+- [ ] 为各个角色制作培训手册
+- [ ] 举办培训会议（按角色分组）
+- [ ] 准备常见问题FAQ
+- [ ] 建立问题反馈渠道
+
+### 性能优化
+- [ ] 数据库查询优化（加索引、优化WHERE条件）
+- [ ] 大列表分页加载
+- [ ] 报表缓存策略
+- [ ] 前端懒加载和虚拟滚动
+
+### 安全审计
+- [ ] 权限漏洞检查（越权测试）
+- [ ] SQL注入测试
+- [ ] XSS漏洞检查
+- [ ] CSRF保护验证
+- [ ] 数据加密验证
+
+### 灾备和回滚
+- [ ] 准备回滚脚本
+- [ ] 准备数据备份
+- [ ] 制定应急预案
+
+### 上线准备
+- [ ] 制定上线计划和时间表
+- [ ] 准备灰度方案（先给10%用户）
+- [ ] 准备监控告警配置
+- [ ] 准备上线后的值班安排
+
+**第13-14周交付成果**: 完成所有测试、优化和上线准备
+
+---
+
+## Phase 5: 上线和运维（第15周+）
+
+### 灰度发布
+- [ ] 第一批：超级管理员和技术团队
+- [ ] 第二批：各部门经理（用户运营、商品、订单等）
+- [ ] 第三批：执行专员和普通员工
+
+### 线上监控
+- [ ] 监控登录成功率
+- [ ] 监控菜单加载时间
+- [ ] 监控错误日志
+- [ ] 监控权限验证失败率
+- [ ] 监控审计日志生成
+
+### Bug修复
+- [ ] 建立Bug反馈机制
+- [ ] 制定修复优先级
+- [ ] 快速补丁发布
+
+### 持续优化
+- [ ] 收集用户反馈
+- [ ] 分析用户使用习惯
+- [ ] 优化UI/UX
+- [ ] 增加新的小功能
+
+---
+
+## 🎯 总体甘特图
+
+```
+Phase 1  [========] 数据库和权限框架
+Phase 2    [======] 菜单和首页重构
+Phase 3      [=================] 新菜单实现
+  ├─ 数据分析    [====]
+  ├─ 配送管理       [======]
+  ├─ 商户管理           [====]
+  ├─ 行为分析               [==]
+  └─ 审核管理                 [=]
+Phase 4                   [====] 测试和优化
+Phase 5                       [=====] 上线运维
+
+周期：15周
+```
+
+---
+
+## ✅ 成功指标和验收标准
+
+### 功能完整性
+- ✅ 所有15个角色都能正常使用系统
+- ✅ 每个菜单的所有页面都能正常访问
+- ✅ 每个权限都能正确验证
+
+### 性能指标
+- ✅ 页面加载时间 < 2秒（90分位）
+- ✅ 列表页翻页时间 < 1秒
+- ✅ 报表生成时间 < 5秒
+- ✅ 并发用户支持 > 100人
+
+### 安全指标
+- ✅ 权限漏洞 = 0个
+- ✅ 权限验证覆盖率 = 100%
+- ✅ 数据隔离测试通过率 = 100%
+- ✅ 审计日志完整率 = 100%
+
+### 业务指标
+- ✅ 用户培训完成率 > 90%
+- ✅ UAT测试通过率 > 95%
+- ✅ 上线第一周Bug数 < 10个
+- [ ] 用户满意度 > 4/5
+
+---
+
+## 📞 关键联系人
+
+| 角色 | 姓名 | 联系方式 |
+|------|------|---------|
+| 项目经理 | - | - |
+| 产品经理 | - | - |
+| 技术主管 | - | - |
+| 数据库管理员 | - | - |
+| 前端负责人 | - | - |
+| 后端负责人 | - | - |
+| QA负责人 | - | - |
+
+---
+
+**记录**: 此检查清单需要定期更新，每周review一次进度
+
+**相关文档**:
+- [ADMIN_INTEGRATION_COMPREHENSIVE_ANALYSIS.md](ADMIN_INTEGRATION_COMPREHENSIVE_ANALYSIS.md) - 完整分析
+- [ADMIN_INTEGRATION_QUICK_REFERENCE.md](ADMIN_INTEGRATION_QUICK_REFERENCE.md) - 快速参考
+- [ADMIN_MENU_STRUCTURE_COMPARISON.md](ADMIN_MENU_STRUCTURE_COMPARISON.md) - 菜单结构对照