History

zpc cc1c644b44 重新推送		2026-03-24 11:27:37 +08:00
..
API接口文档.md	重新推送	2026-03-24 11:27:37 +08:00
README.md	重新推送	2026-03-24 11:27:37 +08:00
功能模块详细设计.md	重新推送	2026-03-24 11:27:37 +08:00
数据库扩展设计.md	重新推送	2026-03-24 11:27:37 +08:00
爬虫系统重构设计文档.md	重新推送	2026-03-24 11:27:37 +08:00

README.md

Live Forum 后台管理功能设计

功能概述

基于前端页面功能需求，设计专门的后台管理功能，用于管理前端应用的内容和用户行为。不包含基础的后台管理功能（如菜单、权限、管理员、登录等）。

🎯 核心管理功能

1. 内容管理模块

1.1 帖子管理

功能描述: 管理社区中的所有帖子内容

管理功能:

✅ 帖子列表查看 - 分页展示所有帖子
✅ 帖子详情查看 - 查看帖子完整内容和图片
✅ 帖子状态管理 - 草稿/发布/审核/下架/删除
✅ 帖子置顶管理 - 设置/取消置顶
✅ 帖子热门标记 - 设置/取消热门标记
✅ 帖子精华标记 - 设置/取消精华标记
✅ 帖子分类管理 - 修改帖子分类
✅ 帖子删除 - 软删除或硬删除
✅ 批量操作 - 批量审核、删除、分类调整

筛选条件:

按状态筛选（草稿、发布、审核、下架）
按分类筛选（娱乐、电商等）
按时间范围筛选
按用户筛选
按关键词搜索

操作记录:

记录所有管理操作（谁、何时、做了什么）
支持操作回滚

1.2 评论管理

功能描述: 管理帖子下的所有评论内容

管理功能:

✅ 评论列表查看 - 分页展示所有评论
✅ 评论详情查看 - 查看评论内容和回复
✅ 评论删除 - 删除不当评论
✅ 评论隐藏 - 隐藏敏感评论
✅ 批量删除 - 批量处理违规评论
✅ 评论审核 - 审核新评论

筛选条件:

按帖子筛选
按用户筛选
按时间筛选
按关键词搜索

1.3 图片管理

功能描述: 管理用户上传的所有图片资源

管理功能:

✅ 图片列表查看 - 展示所有上传的图片
✅ 图片预览 - 查看图片详情
✅ 图片删除 - 删除违规图片
✅ 图片审核 - 审核图片内容
✅ 批量操作 - 批量删除、审核

筛选条件:

按上传时间筛选
按用户筛选
按帖子筛选
按图片大小筛选

2. 用户管理模块

2.1 用户信息管理

功能描述: 管理注册用户的基本信息

管理功能:

✅ 用户列表查看 - 分页展示所有用户
✅ 用户详情查看 - 查看用户完整信息
✅ 用户状态管理 - 正常/禁用/冻结
✅ 用户等级管理 - 调整用户等级
✅ 用户经验值管理 - 调整经验值
✅ VIP状态管理 - 设置/取消VIP
✅ 认证状态管理 - 管理用户认证状态

筛选条件:

按注册时间筛选
按等级筛选
按VIP状态筛选
按认证状态筛选
按用户名搜索

2.2 认证申请管理

功能描述: 管理用户的SK认证申请

管理功能:

✅ 申请列表查看 - 展示所有认证申请
✅ 申请详情查看 - 查看申请材料和视频
✅ 申请审核 - 通过/拒绝认证申请
✅ 审核记录 - 记录审核结果和原因
✅ 批量审核 - 批量处理申请

筛选条件:

按申请状态筛选（待审核、已通过、已拒绝）
按申请时间筛选
按用户筛选

3. 互动管理模块

3.1 举报管理

功能描述: 处理用户举报的内容

管理功能:

✅ 举报列表查看 - 展示所有举报记录
✅ 举报详情查看 - 查看举报内容和原因
✅ 举报处理 - 处理举报并给出结果
✅ 处理记录 - 记录处理结果
✅ 批量处理 - 批量处理举报

筛选条件:

按举报类型筛选（帖子、评论、用户）
按处理状态筛选（待处理、已处理）
按举报时间筛选

3.2 点赞管理

功能描述: 监控和管理点赞行为

管理功能:

✅ 点赞统计查看 - 查看点赞数据统计
✅ 异常点赞检测 - 检测刷赞行为
✅ 点赞记录查看 - 查看详细点赞记录
✅ 点赞清理 - 清理异常点赞

3.3 关注管理

功能描述: 管理用户关注关系

管理功能:

✅ 关注关系查看 - 查看用户关注关系
✅ 关注统计 - 统计关注数据
✅ 异常关注检测 - 检测刷关注行为

4. 内容配置模块

4.1 轮播图管理

功能描述: 管理首页轮播图内容

管理功能:

✅ 轮播图列表 - 展示所有轮播图
✅ 轮播图添加 - 添加新的轮播图
✅ 轮播图编辑 - 编辑轮播图信息
✅ 轮播图删除 - 删除轮播图
✅ 轮播图排序 - 调整轮播图顺序
✅ 轮播图状态 - 启用/禁用轮播图
✅ 定时发布 - 设置轮播图发布时间

配置项:

图片URL
跳转链接
标题
排序权重
开始/结束时间
状态（启用/禁用）

4.2 帖子分类管理

功能描述: 管理帖子分类体系

管理功能:

✅ 分类列表 - 展示所有分类
✅ 分类添加 - 添加新分类
✅ 分类编辑 - 编辑分类信息
✅ 分类删除 - 删除分类
✅ 分类排序 - 调整分类顺序
✅ 分类状态 - 启用/禁用分类

配置项:

分类名称
分类描述
分类图标
排序权重
状态（启用/禁用）

4.3 用户等级管理

功能描述: 管理用户等级体系

管理功能:

✅ 等级列表 - 展示所有等级
✅ 等级添加 - 添加新等级
✅ 等级编辑 - 编辑等级信息
✅ 等级删除 - 删除等级
✅ 等级特权配置 - 配置等级特权

配置项:

等级名称（LV0-LV5）
等级图标
等级颜色
经验值范围
等级特权（JSON格式）

4.4 协议内容管理

功能描述: 管理用户协议和隐私政策

管理功能:

✅ 协议列表 - 展示所有协议
✅ 协议编辑 - 编辑协议内容
✅ 协议版本管理 - 管理协议版本
✅ 协议发布 - 发布新版本协议

协议类型:

用户协议
隐私政策

5. 消息管理模块

5.1 系统通知管理

功能描述: 管理系统通知消息

管理功能:

✅ 通知列表 - 展示所有系统通知
✅ 通知添加 - 添加新通知
✅ 通知编辑 - 编辑通知内容
✅ 通知删除 - 删除通知
✅ 通知发布 - 发布通知
✅ 定时发布 - 设置定时发布
✅ 目标用户设置 - 设置通知接收用户

通知类型:

系统公告
活动通知
维护通知
功能更新

5.2 用户消息管理

功能描述: 管理用户间的消息

管理功能:

✅ 消息列表 - 展示所有用户消息
✅ 消息详情 - 查看消息内容
✅ 消息删除 - 删除不当消息
✅ 消息统计 - 统计消息数据

6. 数据统计模块

6.1 内容统计

功能描述: 统计内容相关数据

统计维度:

✅ 帖子统计 - 总帖子数、今日新增、分类分布
✅ 评论统计 - 总评论数、今日新增、活跃度
✅ 图片统计 - 总图片数、存储空间使用
✅ 用户统计 - 总用户数、活跃用户、等级分布

6.2 用户行为统计

功能描述: 统计用户行为数据

统计维度:

✅ 登录统计 - 日活、月活、留存率
✅ 互动统计 - 点赞数、评论数、分享数
✅ 内容消费 - 浏览数、停留时间
✅ 用户增长 - 注册趋势、用户来源

6.3 系统性能统计

功能描述: 监控系统性能指标

统计维度:

✅ API性能 - 响应时间、成功率
✅ 数据库性能 - 查询时间、连接数
✅ 缓存性能 - 命中率、缓存大小
✅ 存储统计 - 文件存储、空间使用

🔧 技术实现方案

后端API设计

基于现有的53个API接口，新增后台管理专用API：

管理API命名规范

基础路径: /api/v1/admin
认证方式: 管理员Token认证
响应格式: 统一JSON格式

核心API接口

内容管理API:

GET    /admin/posts              # 获取帖子列表
GET    /admin/posts/{id}         # 获取帖子详情
PUT    /admin/posts/{id}/status  # 更新帖子状态
PUT    /admin/posts/{id}/feature # 更新帖子特性（置顶、热门等）
DELETE /admin/posts/{id}         # 删除帖子
POST   /admin/posts/batch        # 批量操作帖子

GET    /admin/comments           # 获取评论列表
DELETE /admin/comments/{id}       # 删除评论
POST   /admin/comments/batch     # 批量操作评论

GET    /admin/images             # 获取图片列表
DELETE /admin/images/{id}         # 删除图片

用户管理API:

GET    /admin/users              # 获取用户列表
GET    /admin/users/{id}         # 获取用户详情
PUT    /admin/users/{id}/status  # 更新用户状态
PUT    /admin/users/{id}/level   # 更新用户等级
PUT    /admin/users/{id}/vip     # 更新VIP状态

GET    /admin/certifications     # 获取认证申请列表
PUT    /admin/certifications/{id}/review # 审核认证申请

配置管理API:

GET    /admin/banners            # 获取轮播图列表
POST   /admin/banners            # 添加轮播图
PUT    /admin/banners/{id}       # 更新轮播图
DELETE /admin/banners/{id}       # 删除轮播图

GET    /admin/categories         # 获取分类列表
POST   /admin/categories         # 添加分类
PUT    /admin/categories/{id}    # 更新分类
DELETE /admin/categories/{id}    # 删除分类

GET    /admin/levels             # 获取等级列表
POST   /admin/levels             # 添加等级
PUT    /admin/levels/{id}        # 更新等级
DELETE /admin/levels/{id}        # 删除等级

统计API:

GET    /admin/statistics/content # 内容统计
GET    /admin/statistics/users   # 用户统计
GET    /admin/statistics/system  # 系统统计

数据库扩展

管理操作记录表

CREATE TABLE dbo.AdminOperations
(
    OperationId BIGINT PRIMARY KEY IDENTITY(1,1),
    AdminId BIGINT NOT NULL,
    OperationType NVARCHAR(50) NOT NULL, -- 操作类型
    TargetType NVARCHAR(50) NOT NULL,    -- 目标类型（帖子、用户等）
    TargetId BIGINT NOT NULL,            -- 目标ID
    OperationData NVARCHAR(MAX) NULL,    -- 操作数据（JSON）
    OperationResult NVARCHAR(500) NULL,  -- 操作结果
    CreatedAt DATETIME2(7) NOT NULL DEFAULT GETDATE()
);

系统配置表

CREATE TABLE dbo.SystemConfigs
(
    ConfigId INT PRIMARY KEY IDENTITY(1,1),
    ConfigKey NVARCHAR(100) NOT NULL UNIQUE,
    ConfigValue NVARCHAR(MAX) NOT NULL,
    ConfigType NVARCHAR(50) NOT NULL,    -- 配置类型
    Description NVARCHAR(500) NULL,
    IsActive BIT NOT NULL DEFAULT 1,
    CreatedAt DATETIME2(7) NOT NULL DEFAULT GETDATE(),
    UpdatedAt DATETIME2(7) NOT NULL DEFAULT GETDATE()
);

📊 功能优先级

高优先级（核心功能）

帖子管理 - 内容审核和状态管理
用户管理 - 用户状态和认证管理
举报管理 - 处理用户举报
轮播图管理 - 首页内容管理

中优先级（重要功能）

评论管理 - 评论审核和删除
认证申请管理 - SK认证审核
帖子分类管理 - 分类体系管理
系统通知管理 - 消息推送管理

低优先级（辅助功能）

数据统计 - 运营数据分析
图片管理 - 图片资源管理
协议管理 - 协议内容管理
用户等级管理 - 等级体系配置

🎨 界面设计建议

管理界面布局

左侧导航: 功能模块导航
顶部工具栏: 搜索、筛选、批量操作
主内容区: 数据列表和详情展示
右侧面板: 操作按钮和快捷功能

关键界面

帖子管理页面 - 列表+详情+操作
用户管理页面 - 用户列表+详情+状态管理
举报处理页面 - 举报列表+处理流程
数据统计页面 - 图表+数据展示

🔒 安全考虑

操作权限

只读权限: 查看数据，无修改权限
编辑权限: 修改内容状态和属性
删除权限: 删除内容和用户
审核权限: 审核内容和认证申请

操作记录

完整日志: 记录所有管理操作
操作回滚: 支持误操作回滚
审计追踪: 操作历史查询

数据安全

敏感信息脱敏: 用户隐私信息保护
批量操作限制: 防止误操作
操作确认: 重要操作二次确认

📈 扩展性设计

功能扩展

插件化架构: 支持功能模块扩展
配置化管理: 通过配置调整功能
API版本控制: 支持API版本升级

性能优化

分页查询: 大数据量分页处理
缓存策略: 热点数据缓存
异步处理: 耗时操作异步化

监控告警

操作监控: 监控管理操作频率
异常告警: 异常操作自动告警
性能监控: 系统性能实时监控

📝 开发计划

第一阶段（核心功能）

帖子管理（列表、详情、状态管理）
用户管理（列表、详情、状态管理）
举报管理（列表、处理流程）

第二阶段（重要功能）

评论管理
认证申请管理
轮播图管理
帖子分类管理

第三阶段（辅助功能）

数据统计
系统通知管理
用户等级管理
协议内容管理

✅ 总结

本后台管理功能设计完全基于前端页面需求，专注于内容管理和用户管理，不包含基础的后台管理功能。设计涵盖了：

6大核心模块 - 内容、用户、互动、配置、消息、统计
30+管理功能 - 覆盖前端所有业务场景
完整API设计 - 基于现有架构扩展
安全权限控制 - 操作权限和审计追踪
扩展性设计 - 支持功能扩展和性能优化

该设计能够满足Live Forum应用的所有后台管理需求，为运营团队提供高效的内容管理工具。

README.md Unescape Escape

Live Forum 后台管理功能设计

功能概述

🎯 核心管理功能

1. 内容管理模块

1.1 帖子管理

1.2 评论管理

1.3 图片管理

2. 用户管理模块

2.1 用户信息管理

2.2 认证申请管理

3. 互动管理模块

3.1 举报管理

3.2 点赞管理

3.3 关注管理

4. 内容配置模块

4.1 轮播图管理

4.2 帖子分类管理

4.3 用户等级管理

4.4 协议内容管理

5. 消息管理模块

5.1 系统通知管理

5.2 用户消息管理

6. 数据统计模块

6.1 内容统计

6.2 用户行为统计

6.3 系统性能统计

🔧 技术实现方案

后端API设计

管理API命名规范

核心API接口

数据库扩展

管理操作记录表

系统配置表

📊 功能优先级

高优先级（核心功能）

中优先级（重要功能）

低优先级（辅助功能）

🎨 界面设计建议

管理界面布局

关键界面

🔒 安全考虑

操作权限

操作记录

数据安全

📈 扩展性设计

功能扩展

性能优化

监控告警

📝 开发计划

第一阶段（核心功能）

第二阶段（重要功能）

第三阶段（辅助功能）

✅ 总结

README.md