# BirdChatNews

**Repository Path**: Marthkoper/bird-chat-news

## Basic Information

- **Project Name**: BirdChatNews
- **Description**: BirdChat应用程序的新闻后台接口
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bird Chat News API 项目说明

这是一个基于 Spring Boot 的新闻管理系统后端 API，提供文章管理、分类管理、标签管理、浏览统计等功能。

## 项目特点

- 提供完整的新闻文章管理功能（增删改查、发布/撤稿）
- 支持文章分类和标签管理
- 实现文章浏览统计功能，包含缓存优化
- 提供后台管理界面（admin.html）
- 使用 MyBatis Plus 进行数据库操作
- 包含 Redis 缓存配置
- 支持跨域请求

## 主要模块

- **AdminController**：后台管理接口，提供文章、分类、标签的管理操作
- **ArticleController**：前端文章展示接口
- **ArticleViewController**：文章浏览统计接口，包含缓存处理
- **HtmlContentProcessor**：HTML 内容处理工具，提供内容清理、优化、摘要生成等功能
- **实体类**：包含 Article、Category、Tag 等数据模型
- **DTO**：数据传输对象，用于接口数据交互

## 数据库结构

请查看 sql/news_db.sql 文件了解数据库结构，包含以下主要表：
- articles：文章表
- categories：分类表
- tags：标签表
- article_images：文章图片表

## 配置要求

- Java 1.8+
- MySQL 数据库
- Redis 服务
- Maven 构建工具

## 启动方式

1. 创建数据库并导入 sql/news_db.sql
2. 修改 application.yml 中的数据库连接配置
3. 启动 Redis 服务
4. 使用 Maven 构建项目：`mvn clean install`
5. 运行启动类 NewsApiApplication

## 接口文档

项目提供 RESTful API 接口，具体接口信息请查看：
- AdminController：后台管理接口
- ArticleController：文章展示接口
- ArticleViewController：浏览统计接口

## 前端界面

项目包含一个简单的后台管理界面（src/main/resources/static/admin.html），可通过访问该页面进行文章管理操作。

## 安全特性

- 使用 HTML 内容处理器防止 XSS 攻击
- 对文章内容进行安全校验
- 提供内容清理和过滤功能

## 扩展性

项目结构清晰，易于扩展新的功能模块，如添加用户系统、评论系统等。