Files
medical-mall/ADMIN_IMPLEMENTATION_CHECKLIST.md
2026-02-05 09:01:16 +08:00

740 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 表
- [ ] 实现 RPCget_dashboard_data
- [ ] 实现 RPCget_report_data
- [ ] 实现 RPCcheck_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) - 菜单结构对照