> ## Documentation Index
> Fetch the complete documentation index at: https://insight-flow.potatodog.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# 架构

> Insight Flow 的主要模块、运行路径和职责划分

Insight Flow 由后端 API、调度与采集层、前端管理界面以及文档系统组成。

## 模块划分

* `backend/`：FastAPI、数据库模型、调度器、采集器、报告生成与输出逻辑
* `frontend/`：Next.js 管理界面
* `docs/`：Mint 文档站和设计记录

## 主要运行路径

1. Source 定义输入来源
2. Monitor 组合 source、AI 路由、destination 和报告类型
3. 调度器或手动触发 monitor run
4. 后端执行采集、筛选、摘要、报告生成与输出
5. 前端和 API 提供结果查看与管理入口

## 关键约束

* API 前缀统一为 `/api/v1/`
* Schema 通过 `backend/app/schemas/` 定义
* 数据库变更必须走 Alembic migration
* Collector / Renderer / Sink 需要遵守插件约定

## 推荐阅读顺序

1. [API 总览](/zh/development/api-overview)
2. [编写 Collector 插件](/zh/development/collector-plugin)
3. [部署](/zh/development/deployment)