# 管理后台设计 ## 管理端系统架构与功能 **版本**: v1.0 **状态**: 已落地（MVP 完成，持续演进） **最后更新**: 2026-06-13 --- ## 1. 概述 ### 1.1 为什么要管理端？ | 需求 | 解决什么问题 | | -------- | -------------------------- | | 用户管理 | 查看注册用户、使用情况 | | 内容管理 | 管理案例、规则、模板 | | 数据监控 | 了解系统运行状态、用户行为 | | 运营支持 | 协助用户、处理问题 | | 质量把控 | 监控方案质量、错误检测 | ### 1.2 使用角色 | 角色 | 权限级别 | 主要操作 | | -------------- | :------: | ---------------------------- | | **超级管理员** | 所有权限 | 创建管理员、系统配置 | | **产品经理** | 高 | 查看数据、导出报告、配置功能 | | **运营人员** | 中 | 处理用户反馈、管理内容 | | **数据分析师** | 中 | 查看统计、导出数据 | | **客服** | 低 | 查看用户信息、协助问题 | --- ## 2. 管理端架构 ### 2.1 技术方案 ``` 管理端架构: ├── 前端 │ ├── React/Vue (单页应用) │ ├── Ant Design / Element Plus (UI组件库) │ └── 响应式（支持PC端） │ ├── 后端 API │ ├── RESTful API │ ├── 鉴权：JWT Token │ └── RBAC 权限控制 │ └── 数据库 ├── 用户数据（只读） ├── 统计数据（聚合） └── 操作日志 ``` ### 2.2 安全设计 - ✅ **独立域名/路径**: admin.gk.example.com / /admin - ✅ **IP白名单**: 限制访问IP（可选） - ✅ **双因素认证**: 管理员登录需2FA - ✅ **操作审计**: 所有操作记录日志 - ✅ **数据脱敏**: 用户敏感信息脱敏显示 --- ## 3. 功能模块 ### 3.1 仪表盘 (Dashboard) ``` ┌─────────────────────────────────────────────────────────┐ │ 今日概览 2026-06-11 │ ├─────────────────────────────────────────────────────────┤ │ │ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │ 新用户 │ │ 方案生成 │ │ 活跃会话 │ │ │ │ 23 │ │ 156 │ │ 8 │ │ │ │ ↑12% │ │ ↑8% │ │ ↓2% │ │ │ └───────────┘ └───────────┘ └───────────┘ │ │ │ │ ┌─────────────────┐ ┌─────────────────┐ │ │ │ 用户增长趋势 │ │ 方案生成分布 │ │ │ │ [折线图] │ │ [饼图] │ │ │ │ 近7天/30天/90天│ │ 按省份分布 │ │ │ └─────────────────┘ └─────────────────┘ │ │ │ │ ┌───────────────────────────────────────────────┐ │ │ │ 实时告警 │ │ │ │ ⚠️ 湖南规则配置已过期 (2天前) │ │ │ │ 🔴 系统错误率超过阈值 (5%) │ │ │ │ ℹ️ 新用户增速下降 (需关注) │ │ │ └───────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 核心指标 | 指标 | 计算方式 | 告警阈值 | | --------------- | --------------- | ---------------- | | 日活跃用户(DAU) | 当日访问用户数 | <50触发关注 | | 新用户注册 | 当日注册用户 | <10触发关注 | | 方案生成数 | 当日生成方案数 | 趋势下降>20%告警 | | 规范检查错误率 | 错误数/总检查数 | >10%触发告警 | | 平均响应时间 | API响应时长 | >3s触发告警 | | 系统错误率 | 错误请求/总请求 | >5%触发告警 | --- ### 3.2 用户管理 ``` 用户列表页面: ┌─────────────────────────────────────────────────────────┐ │ 用户管理 [导出] │ ├─────────────────────────────────────────────────────────┤ │ [搜索:用户名/手机号] [省份筛选▼] [时间范围▼] [查询] │ ├─────────────────────────────────────────────────────────┤ │ │ │ 共 1,234 位用户 第1/13页 │ │ │ │ ┌────────┬────────┬────────┬────────┬────────┬────────┐│ │ │用户ID │姓名 │手机号 │省份 │注册时间│操作 ││ │ ├────────┼────────┼────────┼────────┼────────┼────────┤│ │ │U000123│李** │138**** │湖南 │06-11 │[详情] ││ │ │U000124│张** │139**** │湖北 │06-11 │[详情] ││ │ │... │... │... │... │... │... ││ │ └────────┴────────┴────────┴────────┴────────┴────────┘│ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 功能 - 查看用户列表（脱敏显示） - 搜索/筛选用户 - 查看用户详情（咨询记录、生成的方案） - 导出用户数据（审批后） - 用户状态管理（禁用/启用） --- ### 3.3 案例管理 ``` 真实案例库管理: ┌─────────────────────────────────────────────────────────┐ │ 案例管理 [新增案例] [批量导入] │ ├─────────────────────────────────────────────────────────┤ │ │ │ 案例列表: │ │ ┌─────────────────────────────────────────────────┐ │ │ │ ✓ 湖南 578分 物化生 C型 会计方向 │ │ │ │ 类型:成功案例 状态:已发布 浏览:234 │ │ │ │ [查看] [编辑] [隐藏] [删除] │ │ │ └─────────────────────────────────────────────────┘ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ ...更多案例 │ │ │ └─────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 功能 - 添加/编辑/删除案例 - 案例分类（成功/典型/警告） - 案例审核（发布前审核） - 案例浏览统计 - 从真实咨询导入案例（脱敏处理） --- ### 3.4 规则管理 ``` 省份规则配置: ┌─────────────────────────────────────────────────────────┐ │ 省份规则管理 [新增省份] │ ├─────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 湖南省 2026 ●│ │ │ │ 模式:院校专业组 志愿数:45 更新:2026-05-15 │ │ │ │ 规则版本: v1.2 │ │ │ │ [查看详情] [修改配置] [更新规则] [测试规则] │ │ │ └─────────────────────────────────────────────────┘ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 浙江省 2026 ◐│ │ │ │ 模式:专业+学校 志愿数:80 更新:2026-05-15 │ │ │ │ 规则版本: v1.1 │ │ │ │ [查看详情] [修改配置] [更新规则] [测试规则] │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ 图例: ● 已验证 ◐ 待验证 ○ 草稿 │ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 功能 - 查看/编辑省份规则 - 规则版本管理 - 规则测试验证 - 规则更新历史 - 批量导入规则 --- ### 3.5 数据监控 ``` 数据监控中心: ┌─────────────────────────────────────────────────────────┐ │ 数据监控 [导出报告] │ ├─────────────────────────────────────────────────────────┤ │ [实时] [24小时] [7天] [30天] │ │ │ │ ┌─────────────────┐ ┌─────────────────┐ │ │ │ 用户行为路径 │ │ 功能使用频率 │ │ │ │ [桑基图] │ │ [柱状图] │ │ │ └─────────────────┘ └─────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 省份分布热力图 │ │ │ │ [中国地图热力图] │ │ │ │ 湖南最多(234人), 湖北次之(189人)... │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 热门专业 TOP10 │ 热门院校 TOP10 │ │ │ │ 1. 会计学 │ 1. 湖南工商大学 │ │ │ │ 2. 计算机... │ 2. 长沙理工... │ │ │ └─────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 监控维度 | 维度 | 指标 | 展示方式 | | ---- | ----------------- | ---------- | | 用户 | 注册/活跃/留存 | 趋势图 | | 地域 | 省份分布/城市分布 | 地图热力图 | | 时间 | 使用时段/周期规律 | 时间轴 | | 功能 | 功能使用率 | 漏斗图 | | 内容 | 热门专业/院校 | TOP列表 | | 转化 | 注册率/分享率 | 转化率图 | --- ### 3.6 系统日志 ``` 系统操作日志: ┌─────────────────────────────────────────────────────────┐ │ 操作日志 [筛选] │ ├─────────────────────────────────────────────────────────┤ │ [时间范围] [操作类型▼] [用户▼] [搜索] │ ├─────────────────────────────────────────────────────────┤ │ │ │ 2026-06-11 14:32:05 [INFO] 用户U00123 生成方案 │ │ 2026-06-11 14:30:12 [WARN] 系统 规则检测失败 │ │ 2026-06-11 14:28:33 [INFO] 用户U00124 注册 │ │ 2026-06-11 14:25:18 [ERROR] 系统 API超时 │ │ ... │ │ │ │ [导出日志] 第1/50页 │ │ │ └─────────────────────────────────────────────────────────┘ ``` #### 日志类型 - **用户行为日志**: 登录、查询、生成方案 - **系统运行日志**: API调用、错误、性能 - **操作审计日志**: 管理员操作记录 - **安全日志**: 异常访问、攻击检测 --- ### 3.7 配置中心 ``` 系统配置: ┌─────────────────────────────────────────────────────────┐ │ 系统配置 │ ├─────────────────────────────────────────────────────────┤ │ │ │ ┌─ 基础配置 ─────────────────────────────────────┐ │ │ │ □ 允许匿名咨询 │ │ │ │ □ 强制注册后生成方案 │ │ │ │ □ 限制单IP每日咨询次数 [50] 次 │ │ │ │ │ │ │ │ 注册默认权限: ○ 标准版 ○ 高级版 │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ ┌─ 分享配置 ─────────────────────────────────────┐ │ │ │ □ 链接分享默认有效期 [30] 天 │ │ │ │ □ 分享需审核 │ │ │ │ □ 公开分享水印 [龙老师志愿规划] │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ ┌─ 通知配置 ─────────────────────────────────────┐ │ │ │ □ 填报提醒推送 │ │ │ │ 提醒时间: [6月29日] [9:00] │ │ │ □ □ 自动发送征集志愿提醒 │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ [保存] [恢复默认] │ │ │ └─────────────────────────────────────────────────────────┘ ``` --- ## 4. 权限管理 (RBAC) ### 4.1 角色权限矩阵 | 功能模块 | 超管 | 产品 | 运营 | 分析师 | 客服 | | ------------- | :--: | :--: | :--: | :----: | :--: | | 仪表盘 | ✅ | ✅ | ✅ | ✅ | ✅ | | 用户管理-查看 | ✅ | ✅ | ✅ | ✅ | ✅ | | 用户管理-导出 | ✅ | ✅ | ❌ | ✅ | ❌ | | 案例管理-CRUD | ✅ | ✅ | ✅ | ❌ | ❌ | | 规则管理-修改 | ✅ | ✅ | ❌ | ❌ | ❌ | | 数据监控-全部 | ✅ | ✅ | ❌ | ✅ | ❌ | | 系统日志-查看 | ✅ | ✅ | ❌ | ✅ | ❌ | | 系统配置 | ✅ | ✅ | ❌ | ❌ | ❌ | | 管理员管理 | ✅ | ❌ | ❌ | ❌ | ❌ | ### 4.2 权限实现 ```python # 权限校验示例 @require_permission(['user:view']) def get_user_list(): pass @require_permission(['rule:edit']) def update_province_rule(): pass ``` --- ## 5. 技术实现 ### 5.1 前后端分离 ``` 管理端技术栈: ├── 前端 │ ├── React 18 / Vue 3 │ ├── Ant Design Pro / Element Plus │ ├── ECharts (数据可视化) │ └── Axios (HTTP请求) │ └── 后端 ├── Python FastAPI / Node.js Express ├── JWT + RBAC ├── 接口与Web端复用 └── 独立管理端鉴权 ``` ### 5.2 部署方案 #### 方案A：独立部署（推荐） ``` admin.gk.example.com ├── 独立前端构建 ├── 独立后端服务 └── 独立域名（安全隔离） ``` #### 方案B：集成部署 ``` gk.example.com/admin ├── 与Web端共享后端 ├── 通过路由区分权限 └── 配置IP白名单 ``` --- ## 6. 实现时间表 | 功能 | 版本 | 时间 | 优先级 | | ---------- | :--: | :-----: | :----: | | 基础仪表盘 | v2.2 | 2027 Q2 | P1 | | 用户管理 | v2.2 | 2027 Q2 | P1 | | 案例管理 | v2.2 | 2027 Q2 | P2 | | 规则管理 | v2.2 | 2027 Q2 | P1 | | 数据监控 | v2.3 | 2027 Q3 | P1 | | 系统日志 | v2.3 | 2027 Q3 | P2 | | 配置中心 | v2.3 | 2027 Q3 | P2 | | RBAC权限 | v2.2 | 2027 Q2 | P1 | --- ## 7. 决策记录 #### D001: 管理端是否单独部署？ **决策**: 独立域名部署（admin.gk.example.com） **理由**: 安全隔离，便于权限控制 #### D002: 用什么前端框架？ **决策**: Ant Design Pro (React) **理由**: 成熟的后台管理模板，中文文档完善 #### D003: 是否支持数据导出？ **决策**: 支持，但需审批 **理由**: 脱敏后的汇总数据可以导出，保护用户隐私 --- ## 8. 相关文档 - [PRD](../PRD.md) - 产品需求文档 - [UX_DESIGN](../UX_DESIGN.md) - 用户端设计 - [SHARING_DESIGN](../SHARING_DESIGN.md) - 分享功能设计 --- **下一步**: 将管理端需求整合到PRD和Roadmap