FastNews

KO | EN

gitlite — search

#javascript #react #rust #deep-learning #linux #docker #java #awesome #kubernetes #awesome-list #pytorch #ios #mcp #openai

(★ 10)

基于FastAPI的新闻资讯类项目

FastNews 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FastNews 新闻资讯系统

基于 FastAPI + Vue 3 的前后端分离新闻资讯应用，支持用户注册登录、新闻分类浏览、收藏、历史记录、AI 问答等功能。

## 目录

- [技术栈](#技术栈)
- [项目结构](#项目结构)
- [快速开始](#快速开始)
- [数据库设计](#数据库设计)
- [缓存设计](#缓存设计)
- [API 接口](#api-接口)
- [认证机制](#认证机制)
- [分层架构](#分层架构)
- [安全](#安全)
- [前端](#前端)
- [相关文档](#相关文档)

## 技术栈

| 角色 | 技术 |
|------|------|
| 后端框架 | FastAPI (Python 3.11+) |
| ORM | SQLAlchemy 2.0 (异步) |
| 数据库 | MySQL 8.0 |
| 缓存 | Redis |
| 密码加密 | passlib + bcrypt |
| 前端 | Vue 3 + Vant 4 + Pinia（位于 `frontend/`） |

## 项目结构

```
FastNews/
├── main.py                    # 应用入口
├── pyproject.toml             # 项目依赖
├── database.sql               # 数据库初始化脚本
├── cache/
│   └── news_cache.py          # Redis 缓存键管理
├── config/
│   ├── db_conf.py             # MySQL 异步连接配置
│   └── cache_conf.py          # Redis 连接配置
├── crud/
│   ├── users.py               # 用户 CRUD
│   ├── news.py                # 新闻 CRUD（无缓存）
│   ├── news_cache.py          # 新闻 CRUD（带缓存）
│   ├── favorite.py            # 收藏 CRUD
│   └── history.py             # 历史记录 CRUD
├── models/
│   ├── base.py                # ORM 基类
│   ├── users.py               # User / UserToken
│   ├── news.py                # Category / News
│   ├── favorite.py            # Favorite
│   └── history.py             # History
├── routers/
│   ├── users.py               # /api/user/*
│   ├── news.py                # /api/news/*
│   ├── favorite.py            # /api/favorite/*
│   └── history.py             # /api/history/*
├── schemas/
│   ├── users.py               # 用户 Pydantic 模型
│   ├── favorite.py            # 收藏 Pydantic 模型
│   ├── history.py             # 历史 Pydantic 模型
│   └── base.py
├── utils/
│   ├── auth.py                # Token 认证依赖
│   ├── security.py            # bcrypt 密码加密/验证
│   ├── response.py            # 统一 JSON 响应
│   ├── exception.py           # 自定义异常
│   └── excepton_handlers.py   # 全局异常处理
└── frontend/                  # 前端项目 (Vue 3 + Vant 4)
    ├── package.json
    ├── vite.config.js
    └── src/
        ├── main.js
        ├── App.vue
        ├── components/        # 通用组件
        ├── views/             # 页面组件
        ├── router/            # 路由配置
        ├── store/             # Pinia 状态管理
        ├── i18n/              # 国际化
        └── config/            # API 配置
```

前端项目位于 `frontend/`，Vue 3 + Vite + Vant 4 + Pinia，提供移动端 H5 界面，支持中英文国际化、多主题切换、AI 流式问答。

## 快速开始

### 环境要求

| 依赖 | 版本 |
|------|------|
| Python | ≥3.11 |
| MySQL | ≥8.0 |
| Redis | ≥7.0 |
| Node.js | ≥18.x |

### 1. 数据库

```bash
mysql -u root -p < database.sql
```

### 2. 后端

```bash
# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate      # Linux/Mac
.venv\Scripts\activate         # Windows

# 安装依赖
uv sync

# 确保 Redis 已启动，然后启动服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```

启动后访问 API: http://localhost:8000 ，Swagger 文档: http://localhost:8000/docs

### 3. 前端

```bash
cd frontend
npm install
npm run dev       # http://localhost:5173
```

### 4. 配置

**后端配置**

`config/db_conf.py` — 数据库连接：
```python
ASYNC_DATABASE_URL = "mysql+asyncmy://用户名:密码@主机:端口/数据库名?charset=utf8mb4"
```

`config/cache_conf.py` — Redis 连接：
```python
REDIS_HOST = "127.0.0.1"
REDIS_PORT = 6379
REDIS_DB = 0
```

**前端配置**

`frontend/src/config/api.js` — 后端地址和 AI 服务：
```javascript
export const apiConfig = {
  baseURL: 'http://127.0.0.1:8000',   // 后端地址
}

export const aiChatConfig = {
  apiEndpoint: 'https://api.deepseek.com/chat/completions',
  apiKey: 'sk-your-api-key',
  model: 'deepseek-v4-flash'
}
```

**切换 AI 模型服务商**：只需改 `aiChatConfig` 三个字段，SSE 解析已兼容 OpenAI / DeepSeek / DashScope 格式。

```javascript
// DeepSeek
apiEndpoint: 'https://api.deepseek.com/chat/completions'
model: 'deepseek-chat'

// OpenAI
apiEndpoint: 'https://api.openai.com/v1/chat/completions'
model: 'gpt-4o'

// 阿里云百炼 (DashScope)
apiEndpoint: 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions'
model: 'qwen-plus'

// 本地 Ollama
apiEndpoint: 'http://localhost:11434/v1/chat/completions'
apiKey: 'ollama'
model: 'qwen3:latest'
```

## 数据库设计

### ER 关系

```
user ──1:N──→ user_token
user ──1:N──→ favorite
user ──1:N──→ history
news_category ──1:N──→ news
news ──1:N──→ favorite
news ──1:N──→ history
```

### 数据表

**user（用户表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 用户ID |
| username | VARCHAR(50) UNIQUE | 用户名 |
| password | VARCHAR(255) | 密码（bcrypt 加密） |
| nickname | VARCHAR(50) | 昵称 |
| avatar | VARCHAR(255) | 头像URL |
| gender | ENUM('male','female','unknown') | 性别 |
| bio | VARCHAR(500) | 个人简介 |
| phone | VARCHAR(20) | 手机号 |
| created_at / updated_at | DATETIME | 时间戳 |

**user_token（令牌表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 令牌ID |
| user_id | INT FK | 用户ID |
| token | VARCHAR(255) UNIQUE | UUID令牌 |
| expires_at | DATETIME | 过期时间（7天） |

**news_category（分类表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 分类ID |
| name | VARCHAR(50) UNIQUE | 分类名称 |
| sort_order | INT | 排序权重 |

**news（新闻表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 新闻ID |
| title | VARCHAR(255) | 标题 |
| description | VARCHAR(500) | 摘要 |
| content | TEXT | 正文 |
| image | VARCHAR(255) | 封面图 |
| author | VARCHAR(50) | 作者 |
| category_id | INT FK | 分类ID |
| views | INT | 浏览量 |
| publish_time | DATETIME | 发布时间 |

**favorite（收藏表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 收藏ID |
| user_id | INT FK | 用户ID |
| news_id | INT FK | 新闻ID |
| created_at | DATETIME | 收藏时间 |

> 联合唯一约束 `UNIQUE(user_id, news_id)`，同一用户对同一新闻只能收藏一次。

**history（浏览历史表）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT PK | 历史ID |
| user_id | INT FK | 用户ID |
| news_id | INT FK | 新闻ID |
| view_time | DATETIME | 浏览时间 |

> 联合唯一约束 `UNIQUE(user_id, news_id)`，同一用户同一新闻只保留最新记录。

## 缓存设计

系统使用 Redis 缓存热点数据，采用 Cache-Aside 模式（先查缓存，未命中再查数据库）。

| 缓存数据 | 缓存键 | 过期时间 |
|---------|--------|---------|
| 新闻分类 | `news:categories` | 2 小时 |
| 新闻列表 | `news:list:{category_id}:{page}:{size}` | 30 分钟 |
| 新闻详情 | `news:detail:{news_id}` | 30 分钟 |
| 相关推荐 | `news:related_news:{news_id}` | 30 分钟 |

## API 接口

**Base URL**: `http://localhost:8000`  
**认证方式**: 请求头 `Authorization: {token}`  
**响应格式**:

```json
{ "code": 200, "message": "success", "data": {} }
```

### 用户模块 `/api/user`

| 方法 | 路径 | 认证 | 说明 |
|------|------|:--:|------|
| POST | `/register` | - | 用户注册 |
| POST | `/login` | - | 用户登录 |
| GET | `/info` | ✅ | 获取用户信息 |
| PUT | `/update` | ✅ | 更新用户信息 |
| PUT | `/password` | ✅ | 修改密码 |

### 新闻模块 `/api/news`

| 方法 | 路径 | 认证 | 说明 |
|------|------|:--:|------|
| GET | `/categories` | - | 获取分类列表 |
| GET | `/list` | - | 获取新闻列表 |
| GET | `/detail` | - | 获取新闻详情 |

`/list` 参数：

| 参数 | 类型 | 必填 | 说明 |
|------|------|:--:|------|
| categoryId | int | ✅ | 分类ID |
| page | int | - | 页码，默认 1 |
| pageSize | int | - | 每页条数，≤100，默认 10 |

### 收藏模块 `/api/favorite`

| 方法 | 路径 | 认证 | 说明 |
|------|------|:--:|------|
| GET | `/check` | ✅ | 检查收藏状态 |
| POST | `/add` | ✅ | 添加收藏 |
| DELETE | `/remove` | ✅ | 取消收藏 |
| GET | `/list` | ✅ | 获取收藏列表 |
| DELETE | `/clear` | ✅ | 清空所有收藏 |

### 历史记录模块 `/api/history`

| 方法 | 路径 | 认证 | 说明 |
|------|------|:--:|------|
| POST | `/add` | ✅ | 添加浏览记录 |
| GET | `/list` | ✅ | 获取历史列表 |
| DELETE | `/delete/{history_id}` | ✅ | 删除单条记录 |
| DELETE | `/clear` | ✅ | 清空所有历史 |

## 认证机制

1. 用户登录/注册后服务端生成 UUID 令牌，存入 `user_token` 表
2. 令牌有效期 **7 天**
3. 请求头携带 `Authorization: {token}`
4. 后端通过 `utils/auth.py` 的 `get_current_user` 依赖解析 token 获取用户
5. 同一用户多次登录会更新已有 token 而非新建

## 分层架构

```
请求 → Router（路由层，参数接收/响应组装）
         ↓
     CRUD（数据访问层，业务逻辑封装）
         ↓
     Model（ORM 层，表结构映射）
         ↓
   MySQL / Redis
```

- **Router**: 只做参数接收和响应返回，不写业务逻辑
- **CRUD**: 封装数据库操作，部分方法集成 Redis 缓存
- **Model**: SQLAlchemy 2.0 声明式映射，定义表结构和约束
- **Schema**: Pydantic 模型，自动验证请求/响应数据格式

## 安全

- 密码 bcrypt 加密存储，不解密
- SQLAlchemy ORM 参数化查询防 SQL 注入
- 敏感接口强制 Token 认证
- 开发环境 CORS 允许所有来源，生产环境需修改 `allow_origins`

## 前端

前端项目位于 `frontend/`，技术栈 Vue 3 + Vant 4 + Pinia + Vue Router + Vue I18n。

主要功能：首页新闻浏览（分类 + 无限滚动）、新闻详情（收藏 + 相关推荐）、用户登录注册、个人中心、收藏列表、浏览历史、AI 问答（SSE 流式对话）、主题切换、中英文。启动和配置详见上方[快速开始](#快速开始)。

## 相关文档

- [API接口规范文档](./API接口规范文档.md) — 接口请求/响应示例
- [项目后端设计说明文档](./项目后端设计说明文档.md) — 后端设计概要
- [database.sql](./database.sql) — 数据库建表 SQL

FastNews

FastNews 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

FastNews

FastNews 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README