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

18 KiB
Raw Blame History

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
  • 为每个菜单项添加 requiredRolesrequiredPermissions 字段
  • 实现菜单权限过滤函数

侧边栏组件重构

  • 重构 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一次进度

相关文档: