# RSS 信息处理平台

模块化、工业化、AI 驱动的 RSS 信息处理平台，统一承接 RSS 抓取、数据清洗、AI 分类/摘要/打分、去重、日报产出、聊天问答等能力。

## 快速开始

### 1. 环境准备

复制示例配置：

```bash
cp .env.example .env
```

根据需要修改 `.env` 中的配置，尤其是 `SECRET_KEY`。

### 2. 启动开发环境

```bash
make dev
```

服务将启动：
- 后端：`http://localhost:8000`
- 前端：`http://localhost:5173`
- PostgreSQL：`localhost:5432`
- Redis：`localhost:6379`
- MinIO：`http://localhost:9000`

### 3. 首次使用

默认会创建一个管理员账号（见 `.env` 中 `DEFAULT_ADMIN_USERNAME` / `DEFAULT_ADMIN_PASSWORD`），使用它登录前端。

**安全提示**：生产环境务必修改 `SECRET_KEY` 和默认管理员密码；如未修改，`/health` 接口会返回安全警告。

### 4. 停止环境

```bash
make down
```

## 开发命令

```bash
make migrate   # 执行数据库迁移
make test      # 运行测试
make lint      # 代码检查
make format    # 代码格式化
```

## 项目结构

```
rss-platform/
├── backend/        # FastAPI 后端
├── frontend/       # Vue 3 + TypeScript 前端
├── plugins/        # 可插拔插件（去重算法等）
├── docker/         # Docker 相关文件
├── scripts/        # 工具脚本
└── docs/           # 文档
```

## 配套文档

- 架构设计：`docs/design.md`
- 开发步骤：`docs/dev-plan.md`
- 代码审核与修复记录：`docs/code-review.md`