📖 文档说明

本文档分为三部分：

• 第一部分：管理员操作手册​ – 后台管理系统的完整操作指南
• 第二部分：普通用户使用指南​ – 网站前台功能使用说明
• 第三部分：技术开发规范​ – 前端CSS规范和后端开发注意事项

---

第一部分：管理员操作手册

1. 管理员登录与权限

1.1 登录后台

1. 访问后台地址：http://您的域名/admin/login.html
2. 输入管理员账号和密码
3. 点击登录按钮
4. 验证通过后进入后台管理首页

注意事项：

• 默认管理员账号：admin
• 首次登录建议修改密码
• 如忘记密码，需通过数据库重置

1.2 后台界面概览

后台主要功能模块：

• 系统设置
• 会员管理
• 贴吧管理
• 内容管理
• 数据统计
• 权限管理

2. 系统设置

2.1 基本设置

路径：系统设置 → 基本设置

操作步骤：

1. 进入基本设置页面
2. 修改对应字段
3. 点击”保存设置”按钮
4. 系统提示保存成功

2.2 SEO设置

路径：系统设置 → SEO设置

特殊变量说明：

• {title}：帖子标题
• {tags}：帖子标签
• {summary}：帖子摘要
• {username}：用户名

2.3 邮件设置

路径：系统设置 → 邮件设置

测试方法：

1. 填写正确配置
2. 点击”测试发送”
3. 查看测试邮箱是否收到邮件

2.4 上传设置

路径：系统设置 → 上传设置

3. 会员管理

3.1 会员列表

路径：会员管理 → 会员列表

功能说明：

• 查看所有注册会员
• 搜索会员（用户名、邮箱、手机号）
• 筛选会员状态
• 导出会员数据

操作按钮：

• 查看：查看会员详情
• 编辑：修改会员信息
• 禁用：禁止会员登录
• 删除：删除会员账号（谨慎操作）

3.2 会员等级

路径：会员管理 → 会员等级

设置等级规则：

1. 点击”添加等级”
2. 填写等级名称（如：普通会员、VIP会员）
3. 设置所需积分
4. 设置等级权限（发帖数、附件大小等）
5. 保存设置

注意事项：

• 等级积分必须递增
• 修改等级后，会员等级不会自动更新，需手动触发或等待系统任务

3.3 会员组管理

路径：会员管理 → 会员组

功能说明：

• 创建会员组（如：管理员组、版主组）
• 设置组权限（帖子管理、评论管理、用户管理等）
• 分配会员到组

操作流程：

1. 点击”添加组”
2. 填写组名称和描述
3. 勾选权限项
4. 保存后，在会员列表分配会员到组

4. 贴吧管理

4.1 贴吧分类

路径：贴吧管理 → 分类管理

操作步骤：

1. 点击”添加分类”
2. 填写分类名称（如：技术交流、生活分享）
3. 设置排序（数字越小越靠前）
4. 选择是否显示
5. 保存分类

多级分类：

• 可以设置二级分类
• 在父级分类下添加子分类
• 最多支持三级分类

4.2 贴吧管理

路径：贴吧管理 → 贴吧列表

功能说明：

• 创建新贴吧
• 管理现有贴吧
• 设置贴吧版主
• 配置贴吧权限

添加贴吧：

1. 点击”添加贴吧”
2. 填写贴吧名称（英文标识，如：tech）
3. 设置显示名称（中文名称，如：技术交流）
4. 选择所属分类
5. 设置贴吧图标（可选）
6. 设置发帖权限（哪些会员组可以发帖）
7. 保存贴吧

贴吧设置项：

• 状态：开启/关闭贴吧
• 发帖审核：是否开启审核
• 匿名发帖：是否允许匿名
• 发帖积分：发帖获得的积分
• 回帖积分：回帖获得的积分

4.3 帖子管理

路径：贴吧管理 → 帖子列表

管理功能：

• 查看所有帖子
• 按贴吧、状态筛选
• 搜索帖子（标题、内容、作者）
• 帖子操作：置顶、加精、删除、审核

批量操作：

• 勾选多个帖子
• 选择操作（删除、审核通过、取消置顶等）
• 点击”执行操作”

帖子状态说明：

• 待审核：需要管理员审核
• 已发布：正常显示
• 已删除：已删除到回收站
• 置顶：帖子置顶显示
• 精华：精华帖标识

5. 内容管理

5.1 评论管理

路径：内容管理 → 评论列表

管理功能：

• 查看所有评论
• 按帖子、用户筛选
• 删除评论
• 回复评论（管理员回复）

注意事项：

• 删除评论会同时删除子评论
• 管理员回复会显示特殊标识

5.2 举报管理

路径：内容管理 → 举报列表

处理流程：

1. 查看被举报内容（帖子/评论）
2. 核实举报内容
3. 处理方式：
   • 忽略举报（内容正常）
   • 删除内容（违规内容）
   • 警告用户
   • 封禁用户

5.3 数据统计

路径：数据统计 → 概览

统计项目：

• 会员总数
• 今日注册数
• 帖子总数
• 今日发帖数
• 评论总数
• 访问量统计

查看详细数据：

• 按日期筛选
• 导出统计数据
• 查看趋势图表

---

第二部分：普通用户使用指南

1. 注册与登录

1.1 用户注册

注册流程：

1. 访问网站首页
2. 点击”注册”按钮
3. 填写注册信息：
   • 用户名（2-20个字符）
   • 邮箱（用于验证和找回密码）
   • 密码（6-20位，包含字母和数字）
   • 确认密码
   • 验证码（图片验证码）
4. 阅读并同意用户协议
5. 点击”注册”按钮
6. 注册成功，自动登录

注意事项：

• 用户名不能包含特殊字符
• 邮箱需要真实有效
• 如开启邮箱验证，需验证邮箱后才能登录

1.2 用户登录

登录方式：

1. 点击”登录”按钮
2. 输入用户名/邮箱和密码
3. 输入验证码（如开启）
4. 点击”登录”
5. 登录成功跳转到首页或原页面

忘记密码：

1. 点击”忘记密码”
2. 输入注册邮箱
3. 接收重置邮件
4. 点击邮件中的链接重置密码
5. 设置新密码

1.3 个人资料

路径：登录后 → 用户中心 → 个人资料

可修改信息：

• 昵称（显示名称）
• 性别
• 生日
• 个人简介
• 签名档

保存修改：

1. 修改信息后点击”保存”
2. 系统提示修改成功
3. 刷新页面查看效果

2. 帖子操作

2.1 发帖流程

步骤：

1. 登录后进入目标贴吧
2. 点击”发新帖”按钮
3. 填写帖子信息：
   • 标题（必填）
   • 内容（支持富文本编辑器）
   • 选择分类（如有）
   • 上传图片/附件
   • 设置标签（关键词）
4. 点击”发布”按钮

注意事项：

• 部分贴吧需要审核，发布后需等待审核
• 内容需遵守社区规范
• 图片大小不能超过限制

2.2 编辑帖子

操作：

1. 进入自己的帖子页面
2. 点击”编辑”按钮（仅限作者）
3. 修改标题或内容
4. 点击”保存修改”

限制：

• 只能编辑自己的帖子
• 部分贴吧可能限制编辑时间（如发布后30分钟内可编辑）

2.3 删除帖子

操作：

1. 进入帖子页面
2. 点击”删除”按钮
3. 确认删除
4. 帖子移至回收站

注意：

• 删除后不可恢复（除非管理员恢复）
• 删除帖子会同时删除评论

3. 评论与互动

3.1 发表评论

操作：

1. 进入帖子详情页
2. 滚动到评论区
3. 在评论框输入内容
4. 点击”发表评论”
5. 评论成功显示

功能说明：

• 支持@其他用户（格式：@用户名）
• 支持表情插入
• 支持回复他人评论（形成子评论）

3.2 回复评论

操作：

1. 点击评论右下角的”回复”按钮
2. 自动引用原评论内容
3. 输入回复内容
4. 点击”回复”
5. 回复显示在子评论区域

3.3 删除评论

操作：

1. 在自己的评论上点击”删除”
2. 确认删除
3. 评论被移除

限制：

• 只能删除自己的评论
• 删除后不可恢复

4. 收藏与关注

4.1 收藏帖子

操作：

1. 进入帖子详情页
2. 点击”收藏”按钮（☆图标）
3. 收藏成功，图标变为实心（★）
4. 取消收藏：再次点击

查看收藏：

• 用户中心 → 我的收藏
• 查看所有收藏的帖子
• 可取消收藏

4.2 关注用户

操作：

1. 进入其他用户主页
2. 点击”关注”按钮
3. 关注成功
4. 取消关注：再次点击

查看关注：

• 用户中心 → 我的关注
• 查看关注的人和粉丝

5. 个人中心功能

5.1 修改头像

路径：用户中心 → 修改头像

操作步骤：

1. 点击”选择图片”
2. 选择本地图片文件
3. 裁剪头像（可选）
4. 点击”保存头像”
5. 头像更新成功

图片要求：

• 格式：JPG、PNG、GIF
• 大小：建议小于2MB
• 尺寸：建议正方形图片

5.2 修改密码

路径：用户中心 → 安全设置

操作：

1. 输入当前密码
2. 输入新密码
3. 确认新密码
4. 点击”修改密码”
5. 修改成功，需重新登录

5.3 消息通知

路径：用户中心 → 我的消息

消息类型：

• 系统通知（帖子被回复、被@等）
• 私信（其他用户发送）
• 点赞/收藏通知

操作：

• 查看未读消息
• 标记已读
• 回复私信
• 删除消息

---

第三部分：技术开发规范

1. 前端CSS规范

1.1 文件结构规范

css/
├── base/           # 基础样式
│   ├── reset.css   # 样式重置
│   ├── variables.css # CSS变量定义
│   └── common.css  # 通用样式
├── components/     # 组件样式
│   ├── header.css  # 头部组件
│   ├── footer.css  # 底部组件
│   ├── comment.css # 评论组件
│   └── button.css  # 按钮组件
├── pages/          # 页面样式
│   ├── index.css   # 首页样式
│   ├── post.css    # 帖子页样式
│   └── user.css    # 用户中心样式
└── main.css        # 主样式文件（引入所有文件）

1.2 命名规范

BEM命名法：

/* Block */
.comment-list {}

/* Element */
.comment-list__item {}

/* Modifier */
.comment-list__item--highlight {}

实际应用示例：

/* 评论列表组件 */
.comment-list {
    margin: 20px 0;
}

.comment-list__item {
    padding: 15px 0;
    border-bottom: 1px solid #eee;
}

.comment-list__item--highlight {
    background: #f9f9f9;
}

.comment-list__author {
    display: flex;
    align-items: center;
}

.comment-list__avatar {
    width: 40px;
    height: 40px;
    border-radius: 50%;
}

1.3 颜色变量规范

:root {
    /* 主色调 */
    --primary-color: #36c5d2;
    --primary-hover: #2da8b4;
    
    /* 文字颜色 */
    --text-primary: #333;
    --text-secondary: #666;
    --text-muted: #999;
    
    /* 背景色 */
    --bg-white: #fff;
    --bg-gray: #f8f9fa;
    --bg-hover: #f5f5f5;
    
    /* 边框颜色 */
    --border-color: #e8e8e8;
    --border-hover: #d9d9d9;
    
    /* 状态色 */
    --success-color: #52c41a;
    --warning-color: #faad14;
    --error-color: #f5222d;
}

/* 使用示例 */
.comment-content {
    background: var(--bg-gray);
    border: 1px solid var(--border-color);
    color: var(--text-primary);
}

.comment-content:hover {
    border-color: var(--primary-color);
}

1.4 响应式规范

断点设置：

/* 移动端优先 */
.comment-list {
    /* 默认移动端样式 */
}

/* 平板 */
@media (min-width: 768px) {
    .comment-list {
        /* 平板样式调整 */
    }
}

/* 桌面 */
@media (min-width: 1024px) {
    .comment-list {
        /* 桌面样式 */
    }
}

移动端适配要点：

• 使用相对单位（rem、em）
• 避免固定宽度
• 使用flex布局
• 隐藏非必要元素

1.5 动画与交互规范

/* 过渡动画 */
.comment-item {
    transition: all 0.3s ease;
}

.comment-item:hover {
    transform: translateY(-2px);
    box-shadow: 0 2px 8px rgba(0,0,0,0.1);
}

/* 按钮交互 */
.btn {
    transition: all 0.2s ease;
}

.btn:hover {
    transform: translateY(-1px);
}

.btn:active {
    transform: translateY(0);
}

2. ThinkAdmin v6开发规范

2.1 目录结构说明

app/
├── admin/           # 后台模块
│   ├── controller/  # 后台控制器
│   ├── model/       # 后台模型
│   └── view/        # 后台视图
├── user/            # 用户模块（前台）
│   ├── controller/  # 用户控制器
│   ├── model/       # 用户模型
│   └── view/        # 用户视图
├── common/          # 公共模块
│   ├── model/       # 公共模型
│   └── paginator/   # 分页器
└── route/           # 路由配置

2.2 控制器开发规范

命名规范：

• 控制器类名：首字母大写，驼峰命名
• 文件名：与类名一致，小写
• 方法名：小写，下划线分隔

示例：

<?php
namespace app\user\controller;

use app\user\model\User;

class Index extends BaseUser
{
    // 用户中心首页
    public function index()
    {
        // 业务逻辑
        return $this->fetch();
    }
    
    // 修改头像
    public function avatar()
    {
        if ($this->request->isPost()) {
            // 处理表单提交
            return $this->success('修改成功');
        }
        
        return $this->fetch();
    }
}

2.3 模型开发规范

模型定义：

<?php
namespace app\user\model;

use think\Model;

class User extends Model
{
    // 表名
    protected $name = 'jd_user';
    
    // 自动写入时间戳
    protected $autoWriteTimestamp = true;
    
    // 字段自动完成
    protected $auto = ['password'];
    
    // 密码自动加密
    protected function setPasswordAttr($value)
    {
        return password_hash($value, PASSWORD_DEFAULT);
    }
    
    // 获取器：头像URL
    protected function getAvatarUrlAttr($value, $data)
    {
        if ($data['avatar']) {
            return config('filesystem.disks.public.url') . $data['avatar'];
        }
        return '/static/images/default-avatar.png';
    }
}

2.4 权限验证规范

后台权限验证：

<?php
namespace app\admin\controller;

use think\admin\Controller;

class BaseAdmin extends Controller
{
    protected function initialize()
    {
        parent::initialize();
        
        // 自定义权限验证
        if (!$this->checkAdminLogin()) {
            $this->error('请先登录', url('admin/login/index'));
        }
    }
    
    protected function checkAdminLogin()
    {
        return session('admin_user') && session('admin_user.id');
    }
}

前台用户验证：

<?php
namespace app\user\controller;

use think\Controller;

class BaseUser extends Controller
{
    protected function initialize()
    {
        // 检查用户登录
        if (!$this->checkUserLogin()) {
            if ($this->request->isAjax()) {
                return json(['code' => 0, 'msg' => '请先登录']);
            } else {
                $this->redirect(url('user/index/login'));
            }
        }
    }
    
    protected function checkUserLogin()
    {
        return session('user_id') && session('user_id') > 0;
    }
}

2.5 数据库操作规范

查询规范：

// 推荐写法
$users = User::where('status', 1)
    ->order('create_time desc')
    ->paginate(20);

// 不推荐写法（容易SQL注入）
$users = Db::query("SELECT * FROM jd_user WHERE status = 1");

事务处理：

try {
    Db::startTrans();
    
    // 多个数据库操作
    $user = User::create($data);
    $profile = Profile::create(['user_id' => $user->id]);
    
    Db::commit();
} catch (\Exception $e) {
    Db::rollback();
    return $this->error('操作失败');
}

2.6 表单验证规范

验证器使用：

public function register()
{
    if ($this->request->isPost()) {
        $data = $this->request->post();
        
        // 验证数据
        $validate = new \think\Validate([
            'username' => 'require|length:2,20',
            'email' => 'require|email',
            'password' => 'require|min:6',
            'confirm_password' => 'require|confirm:password'
        ]);
        
        if (!$validate->check($data)) {
            return $this->error($validate->getError());
        }
        
        // 验证通过，继续处理
    }
}

2.7 文件上传规范

上传处理：

public function uploadAvatar()
{
    $file = $this->request->file('avatar');
    
    if (!$file) {
        return $this->error('请选择图片');
    }
    
    try {
        $validate = [
            'size' => 2 * 1024 * 1024, // 2M
            'ext' => 'jpg,png,gif'
        ];
        
        $info = $file->validate($validate)->move('./uploads/avatar');
        
        if ($info) {
            $avatarPath = '/uploads/avatar/' . $info->getSaveName();
            
            // 更新用户头像
            User::where('id', session('user_id'))->update(['avatar' => $avatarPath]);
            
            return $this->success('上传成功', '', ['avatar' => $avatarPath]);
        } else {
            return $this->error($file->getError());
        }
    } catch (\Exception $e) {
        return $this->error('上传失败');
    }
}

2.8 分页规范

分页使用：

public function posts()
{
    $userId = session('user_id');
    
    $posts = Post::where('user_id', $userId)
        ->order('create_time desc')
        ->paginate(20);
    
    $this->assign('posts', $posts);
    return $this->fetch();
}

模板中显示分页：

<div class="pagination">
    {$posts->render()}
</div>

3. 常见问题处理

3.1 登录验证问题

问题：访问/user路径提示”请重新登录”

解决方案：

1. 检查BaseUser控制器是否调用了父类initialize方法
2. 检查session配置是否正确
3. 检查权限验证逻辑

3.2 文件上传失败

可能原因：

• 目录权限不足
• 文件大小超限
• 文件类型不允许

检查步骤：

1. 检查上传目录权限（755）
2. 检查php.ini中的upload_max_filesize
3. 检查ThinkAdmin上传配置

3.3 数据库连接错误

错误信息：数据库连接失败

排查方法：

1. 检查database.php配置文件
2. 检查数据库服务是否启动
3. 检查数据库账号密码是否正确

3.4 模板变量未定义

错误：模板中变量未定义

解决方法：

1. 检查控制器是否assign变量
2. 检查变量名是否拼写错误
3. 检查模板文件路径是否正确

---

📋 附录：常用配置说明

数据库配置（config/database.php）

return [
    'default' => 'mysql',
    'connections' => [
        'mysql' => [
            'type' => 'mysql',
            'hostname' => '127.0.0.1',
            'database' => 'your_database',
            'username' => 'root',
            'password' => 'your_password',
            'charset' => 'utf8mb4',
            'prefix' => 'jd_',
        ],
    ],
];

Session配置（config/session.php）

return [
    'prefix' => 'think',
    'type' => 'file',
    'auto_start' => true,
    'expire' => 3600 * 24, // 24小时
];

上传配置（config/filesystem.php）

return [
    'default' => 'local',
    'disks' => [
        'local' => [
            'type' => 'local',
            'root' => app()->getRootPath() . 'public/uploads',
            'url' => '/uploads',
        ],
    ],
];

---

🎯 总结

本文档涵盖了ThinkAdmin v6后台管理系统和前端评论系统的完整使用说明，包括：

管理员部分：

• 后台登录与权限管理
• 系统设置（基本、SEO、邮件、上传）
• 会员管理（列表、等级、分组）
• 贴吧管理（分类、贴吧、帖子）
• 内容管理（评论、举报、统计）

普通用户部分：

• 注册登录流程
• 帖子发布与编辑
• 评论与互动功能
• 收藏关注操作
• 个人中心功能（头像、密码、消息）

技术规范部分：

• 前端CSS开发规范（结构、命名、响应式）
• ThinkAdmin开发规范（控制器、模型、权限、数据库）
• 常见问题解决方案

建议管理员和开发人员仔细阅读相关章节，按照规范操作和开发，确保系统稳定运行。普通用户可参考用户指南快速上手网站功能。

文档版本：v1.0

最后更新：2026-02-02