# ForumSystem # 滑动师范大学论坛 ### 环境配置 一、更新系统软件包 yum update -y 二、安装软件管理包和可能使用的依赖 yum -y groupinstall "Development tools" yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel psmisc libffi-devel 三、下载Pyhton3到/usr/local 目录 cd /usr/local wget https://www.python.org/ftp/python/3.6.6/Python-3.6.6.tgz 解压 tar -zxvf Python-3.6.6.tgz 进入 Python-3.6.6路径 cd Python-3.6.6 编译安装到指定路径 ./configure --prefix=/usr/local/python3 安装python3 make make install python3建立软连接：ln -s /usr/local/python3/bin/python3.6 /usr/bin/python3 同样给pip3建立软链接：ln -s /usr/local/python3/bin/pip3.6 /usr/bin/pip3 四、安装virtualenv pip3 install virtualenv 建立软链接 ln -s /usr/local/python3/bin/virtualenv /usr/bin/virtualenv 五、下载并安装MySQL wget -i -c http://dev.mysql.com/get/mysql57-community-release-el7-10.noarch.rpm yum -y install mysql57-community-release-el7-10.noarch.rpm yum -y install mysql-community-server MySQL数据库设置： systemctl start mysqld.service grep "password" /var/log/mysqld.log 登录mysql：mysql -uroot -p 修改密码：ALTER USER 'root'@'localhost' IDENTIFIED BY 'new password'; 创建数据库create database forum，并使用use forum； 创建/www/wwwroot/目录，并将项目解压至该目录 在master目录下创建虚拟环境virtualenv --python=/usr/bin/python3 master_venv 执行source ./master_venv/bin/activate 修改/master/ForumSystem下settings.py中数据库密码 回到master目录，在虚拟环境下安装pip3 install django pip3 install pgsql pip3 install uwsgi pip3 install -r requirements.txt 安装requirements.txt出错 centos安装psycopg2时出错：Error: pg_config executable not found.解决方案 yum install postgresql-devel* 使用 pip install psycopg2-binary 安装即可 再执行pip3 install -r requirements.txt 六、配置uwsgi配置文件(master同目录下，已创建，可以修改端口) [uwsgi] master = true processes = 1 threads = 2 chdir = /www/wwwroot/master #wsgi-file= /www/wwwroot/master/ wsgi-file = /www/wwwroot/master/ForumSystem/wsgi.py http = 0.0.0.0:8080 logto = /www/wwwroot/master/logs/error.log chmod-socket = 660 vacuum = true master = true max-requests = 1000 static-map = /static=/www/wwwroot/master/static 在master目录下运行，进行数据库迁移： python manage.py makemigrations python manage.py migrate 在master目录下启动uwsgi uwsgi --ini uwsgi.ini 浏览器输入网址http://ip地址:8080/login 安装成功 ## 展示 ### 用户端 登录 ![image](http://ww1.sinaimg.cn/large/006tNc79ly1g4z46rpj9cj31k10u0drs.jpg) 主页 ![](http://ww4.sinaimg.cn/large/006tNc79ly1g520s6ijl0j31kl0u0e81.jpg) 全部帖子 ![](http://ww2.sinaimg.cn/large/006tNc79ly1g520t8nsslj31k10u0qv5.jpg) 发帖 ![](http://ww1.sinaimg.cn/large/006tNc79ly1g520u2tfwfj31k90u0drc.jpg) ### 管理员端 帖子管理 ![image](http://ww1.sinaimg.cn/large/006tNc79ly1g4z43fiddwj31jm0u0gy1.jpg) 公告管理 ![image](http://ww2.sinaimg.cn/large/006tNc79ly1g4z43pup25j31k10u0136.jpg) 板块（分类）管理 ![image](http://ww3.sinaimg.cn/large/006tNc79ly1g4z44l23y8j31jv0u0131.jpg) ## 功能 ### 用户端功能 - 注册：用户在注册界面可以提交注册，暂不支持手机短信验证，直接注册。 - 登录：已注册的用户可以通过正确的用户名和密码登录。 - 欢迎：主页的导航栏会显示用户名并且欢迎。 - 查看公告：查看管理员发出的公告。 - 查看指南：显示在主页的指南。 - 推荐帖子：每个帖子可以选择推荐在首页显示。 - 查看类别：可以看到论坛里帖子所有的类别，点击可以查看对应下的帖子。 - 查看全部帖子：按照时间顺序，查看所有帖子。 - 帖子筛选：可以根据帖子分类、回复量、发布时间进行组合筛选。 - 帖子搜索：根据输入关键字查询相关帖子。 - 发帖：普通用户可以发帖。 - 查看帖子详细：可以看到帖子的发布时间，作者，类别，标题，简介，详细内容，所有留言信息。 - 留言：可以在帖子下面发表文字或者图片留言（评论），暂不支持回复评论。 ## 系统说明 ### 数据库 项目采用mysql进行存储，我使用的是mysql 8.0.16。表之间不采用任何外键关联，逻辑的管理都在控制层完成。每个表的id都由Django自动创建，也同时作为主键。 #### 表与字段 ##### 用户表：User 字段名称 | 字段类型 | 字段说明 ---|---|--- id | int | 编号，自增，主键 uid | vchar(16) | 用户名，唯一 password | vchar(16) | 密码 create_time | Date | 创建日期 ##### 帖子表：Topic 字段名称 | 字段类型 | 字段说明 ---|---|--- id | int | 编号，自增，主键 t_uid | vchar(16) | 帖子作者 t_kind | vchar(32) | 帖子类型 create_time | Date | 帖子发布日期 t_photo | vchar(128) | 帖子主页图，允许为空 t_content | vchar(3000) | 帖子内容 t_title | vchar(64) | 帖子标题 t_introduce | vchar(256) | 帖子介绍 recommend | boolean | 是否推荐到主页，默认false ##### 回复表：Reply 字段名称 | 字段类型 | 字段说明 ---|---|--- id | int | 编号，自增，主键 r_tid | vchar(16) | 回复的帖子 r_uid | vchar(16) | 发表回复的人 r_time | Date | 回复时间 r_photo | vchar(128) | 回复图片，允许为空 r_content | vchar(256) | 回复内容 ##### 分类表：Kind 字段名称 | 字段类型 | 字段说明 ---|---|--- id | int | 编号，自增，主键 k_name | vchar(16) | 分类名称 ##### 公告表：Announcement 字段名称 | 字段类型 | 字段说明 ---|---|--- id | int | 编号，自增，主键 a_title | vchar(64) | 公告名称 a_content | vchar(3000) | 公告内容，允许为空 #### 数据库代码 数据库代码在模型(models)层：参见/ForumSystem/app01/models.py ### 用户端 #### 用户端前端 - 主页： - 显示公告：模板和数据渲染生成 - 显示指南：html固定内容 - 显示导航栏 - 登陆后显示：主页、发帖、看帖、欢迎、退出 - 未登录显示：主页、发帖（点击会跳转到登录）、看帖、登录。 - 显示推荐帖子：模板和数据渲染生成 - 显示全部帖子按钮：页面固定 - 底部栏：显示名称和导航栏 - 登录&注册页面： - 一个输入框：分为用户名和密码 - 两个按钮（登录/注册） - 通过ajax发送登录或者注册请求 - 全部帖子页面： - 论坛名称（左上角）：固定显示 - 搜索框：固定，form表单post提交 - 导航栏：同上 - 组合筛选栏 - 分类筛选：模板和数据渲染得到所有分类显示 - 回复数量筛选：固定 - 发布时间筛选：固定 - 显示全部帖子：模板和数据渲染获取 - 帖子详情页面：模板和数据渲染获取 - 论坛名称：同上 - 导航栏：同上 - 帖子主图 - 帖子标题和详细内容 - 帖子作者、发布时间、分类 - 发表留言栏：form表单，post提交 - 显示所有留言：模板和数据渲染获取 - 公告详情页面： - 公告标题 - 公告内容 - 发布帖子页面： - 一个大form表单，包括帖子的标题、简介、内容、封面图、类别（下拉选择）。 - 修改密码页面： - 用户名框（只显示，不可改） - 原密码框 - 新密码框 - 确认新密码框 - 提交（成功后返回主页）、取消（返回主页）按钮 #### 用户端接口 ##### 主页 - url：http://127.0.0.1:8000/home/ - GET请求 - 参数：无 - 返回值：10个最新公告列表，所有推荐贴列表，渲染好的**页面**。 ##### 所有帖子 - url：http://127.0.0.1:8000/all-0-0-0 - GET请求 - url说明：后3个0指组合筛选不进行筛选 - 参数：无，也可以说是all后面的3个数字（kid, reply_limit, time_limit） - 返回值：根据3个参数选择后的**帖子列表** - POST请求： - 参数 - keys：搜索关键字 - 返回值：根据关键字搜索到的**帖子列表** ##### 登录、注册 - url：http://127.0.0.1:8000/login/ - GET请求： - 参数：无 - 返回值：登录页面 - POST请求： - 参数： - type：login 或者 register - uid：用户名 - pwd：密码 - 返回值： - msg：信息 - status：状态，成功与否 ##### 发布帖子 - url：http://127.0.0.1:8000/publish/ - GET请求： - 参数：无 - 返回值：发布帖子页面 - POST请求： - 参数： - t_title：标题 - t_introduce：介绍 - t_content：内容 - t_kind：类别 - t_photo：主图 - 返回值： - 成功后重定向到单个帖子页面 ##### 单个帖子 - url：http://127.0.0.1:8000/single/1/ - GET请求： - url说明：1就是tid - 参数：tid - 返回值：帖子相关所有信息，渲染成单个帖子详情页面 - POST请求：主要用于评论的发表和删除 - 参数： - type：类型，删除评论还是发表评论 - r_content：评论内容 - r_photo：评论图片 - r_id：回复id，删除已有回复才用到 - 返回值： - msg：信息 - status：状态，成功与否 ##### 修改密码 - url：http://127.0.0.1:8000/edit-pwd/ - GET请求： - 参数：无 - 返回值：修改密码页面 - POST请求： - 参数： - old_pwd：旧密码 - new_pwd1：新密码 - new_pwd2：确认新密码 - 返回值： - 成功后重定向到主页 ### 管理员端 #### 管理员前端 - 管理员登录： - 一个输入框：分为用户名和密码 - 两个按钮（登录/取消） - 一个form表单，提交数据 - 帖子管理： - 导航栏：帖子管理、公告管理、分类管理 - 欢迎头部 - 帖子列表：序号、名称、简介、推荐、操作 - 推荐操作：绑定ajax，刷新页面 - 取消推荐操作：ajax，刷新 - 查看操作：跳转帖子详情页面 - 删除操作：ajax，同时刷新 - 公告管理： - 导航栏：帖子管理、公告管理、分类管理 - 欢迎头部 - 公告列表：序号、标题、操作 - 查看操作：跳转公告详情页面 - 删除操作：ajax，同时刷新 - 分类（板块）管理： - 导航栏：帖子管理、公告管理、分类管理 - 欢迎头部 - 分类列表：序号、分类名称、操作 - 查看该分类下所有帖子操作：跳转到全部帖子下组合搜索出分类里的帖子 - 删除操作：ajax，同时刷新 #### 管理员接口 ##### 登录 - url：http://127.0.0.1:8000/my-admin/ - GET请求： - 参数：无 - 返回值：管理员登录页面 - POST请求： - 参数： - admin_id：管理员用户名 - admin_pwd：管理员密码 - 返回值： - 成功后重定向到帖子管理页面 - 注意：管理员我没有做表去存放管理员账号密码，所以在程序里写死了管理员账号为guanliyuan，密码为123456 ##### 帖子管理 - url：http://127.0.0.1:8000/admin-home/ - GET请求： - 参数：无 - 返回值：所有帖子信息，渲染后的帖子管理页面，需要验证管理员是否登录（使用session） - POST请求： - 参数： - type：post请求类型（以下为type可用的值） - zhiding：置顶（推荐） - qzhiding：取消置顶 - delete：删除 - t_id：帖子id，根据帖子id进行type操作 - 返回值： - msg：信息 - status：成功与否状态 ##### 公告管理 - url：http://127.0.0.1:8000/announcement/ - GET请求： - 参数：无 - 返回值：所有公告信息，渲染后的公告管理页面，需要验证管理员是否登录（使用session） - POST请求： - 参数： - type：post请求类型 - create：创建公告 - delete：删除公告 - a_id：公告id，如果type=delete需要公告id - a_title：公告标题，如果type=create，需要公告标题 - a_content：公告内容，如果type=create，需要公告标题 - 返回值： - msg：信息 - status：成功与否状态 ##### 分类管理 - url：http://127.0.0.1:8000/kind-manage/ - GET请求： - 参数：无 - 返回值：所有分类信息，渲染后的类别管理页面，需要验证管理员是否登录（使用session） - POST请求： - 参数： - type：post请求类型（删除or创建） - create：创建类别 - delete：删除类别 - k_id：类别id，如果type=delete需要类别id - k_name：类别名称，如果type=create，需要类别名称 - 返回值： - msg：信息 - status：成功与否状态