KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

ForumSystem

★ 115 Open GitHub ↗

一个基于Django项目的论坛系统

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ForumSystem
# 一个论坛
一个论坛系统，一个Django论坛项目  
使用：pycharm打开项目后，选择好运行环境，然后在命令行创建数据库（下面两条语句），然后运行就行了
> python manage.py makemigrations  
> python manage.py migrate

## 展示
### 用户端
登录
![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：成功与否状态

ForumSystem

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README