# bbs_forum

**Repository Path**: situbu/bbs_forum

## Basic Information

- **Project Name**: bbs_forum
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-26
- **Last Updated**: 2025-12-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bbs_forum

#### 介绍
BBS论坛，提供了完整的论坛功能，界面美观，用户体验良好，可以根据需要进一步扩展功能，如添加图片上传、富文本编辑器、私信系统等。

#### 软件架构
后端实现 (Django + DRF)
前端实现 (Vue3 + Element Plus + Vite)


#### 安装教程

后端创建命令：
1. 创建虚拟环境（推荐）
<!-- 在backend目录中 -->
python -m venv venv

<!-- 激活虚拟环境 -->
<!-- Linux/Mac -->
source venv/bin/activate

<!-- Windows -->
venv\Scripts\activate

2. 安装依赖

<!-- 安装依赖 -->
pip install -r requirements.txt

3. 配置Django项目

<!-- 应用数据库迁移 -->
python manage.py makemigrations
python manage.py migrate

<!-- 创建超级用户 -->
python manage.py createsuperuser

<!-- 收集静态文件（生产环境） -->
python manage.py collectstatic

<!-- 运行开发服务器 -->
python manage.py runserver

前端创建命令：
1. 创建基础项目结构
<!-- 在frontend目录中执行 -->
mkdir -p src/{components/{common,forum},views,stores,router,api,utils,assets/{styles,images}}
mkdir -p public

<!-- 创建基础文件 -->
touch src/App.vue
touch src/main.js
touch src/router/index.js
touch src/stores/index.js
touch src/api/index.js
touch vite.config.js
touch index.html

2. 初始化package.json和安装依赖
<!-- 初始化package.json -->
npm init -y

<!-- 安装核心依赖 -->
npm install vue@^3.3.0 vue-router@^4.2.0 pinia@^2.1.0 axios@^1.5.0

<!-- 安装UI框架 -->
npm install element-plus@^2.3.0 @element-plus/icons-vue@^2.1.0

<!-- 安装开发依赖 -->
npm install @vitejs/plugin-vue vite --save-dev

<!-- 可选：安装其他有用依赖 -->
npm install dayjs@^1.11.0  # 日期处理
npm install js-cookie@^3.0.0  # Cookie操作
npm install nprogress@^0.2.0  # 进度条

3. 创建package.json脚本

{
  "name": "bbs-frontend",
  "private": true,
  "version": "0.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview",
    "build:dev": "vite build --mode development",
    "build:prod": "vite build --mode production",
    "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs --fix --ignore-path .gitignore",
    "preview:prod": "vite preview --mode production"
  },
  "dependencies": {
    "vue": "^3.3.0",
    "vue-router": "^4.2.0",
    "pinia": "^2.1.0",
    "axios": "^1.5.0",
    "element-plus": "^2.3.0",
    "@element-plus/icons-vue": "^2.1.0",
    "dayjs": "^1.11.0",
    "js-cookie": "^3.0.0",
    "nprogress": "^0.2.0"
  },
  "devDependencies": {
    "@vitejs/plugin-vue": "^4.3.0",
    "vite": "^4.4.0"
  }
}

4. 运行项目
<!-- 安装依赖 -->

<!-- 启动开发服务器 -->
npm run dev

<!-- 构建生产版本 -->
npm run build

<!-- 预览生产构建 -->
npm run preview

#### 部署和运行

1.  后端运行
cd backend
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

2.  前端运行
cd frontend
npm install
npm run dev

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 功能特点

1. 完整的用户认证系统 - JWT token认证

2. 帖子管理 - 发布、浏览、分类、搜索

3. 评论系统 - 登录用户可评论

4. 响应式设计 - 适配不同屏幕尺寸

5. 权限控制 - 非登录用户只能浏览

6. 搜索和过滤 - 按标题搜索和分类过滤