# GEO 平台 - 项目总览

## 项目定位

**GEO（Generative Engine Optimization）平台** 是一款面向企业级客户的 **AI 搜索引擎品牌曝光度优化 SaaS 平台**。

随着生成式 AI 搜索引擎（如 ChatGPT、Perplexity、Google SGE、Kimi 等）的崛起，传统 SEO 已无法满足品牌在 AI 生成答案中的可见性需求。GEO 平台通过系统化的诊断、策略制定、内容生产、分发执行和监测优化，帮助企业在 AI 搜索引擎中获得更高的品牌引用率和曝光度。

## 核心业务价值

- **AI 引用检测**：自动扫描主流 AI 平台对品牌的引用情况，识别引用、未引用和竞品引用场景
- **策略智能生成**：基于诊断结果，自动生成 GEO 优化策略和内容生产计划
- **内容自动化生产**：利用 AI Agent 框架自动生成符合 GEO 优化标准的内容资产
- **多渠道分发执行**：将内容分发至目标平台，并跟踪分发效果
- **持续监测优化**：建立监测闭环，持续追踪品牌在 AI 搜索引擎中的表现变化

## 业务生命周期（5 个阶段）

GEO 平台的业务运营遵循完整的 5 阶段生命周期：

| 阶段 | 名称 | 核心目标 | 关键动作 |
|------|------|----------|----------|
| Stage 1 | 诊断分析 | 了解品牌在 AI 搜索中的现状 | 查询执行、引用检测、竞品分析 |
| Stage 2 | 策略制定 | 制定 GEO 优化策略 | 策略生成、规则制定、计划排期 |
| Stage 3 | 内容生产 | 生成符合 GEO 标准的内容 | 内容生成、质量检查、素材准备 |
| Stage 4 | 分发执行 | 将内容分发至目标渠道 | 渠道管理、内容发布、效果追踪 |
| Stage 5 | 监测优化 | 持续监测并优化效果 | 性能追踪、报告生成、策略迭代 |

## 双运营模式

GEO 平台支持两种运营模式，满足不同客户的需求：

### 模式一：自主订阅（SaaS 自助）

- **目标客户**：中小企业、有自有运营团队的品牌方
- **核心特征**：
  - 客户自主注册订阅
  - 通过平台自助完成全生命周期操作
  - 按订阅等级（Basic / Pro / Enterprise）享受不同功能权限
  - 支持多用户团队协作
- **收费模式**：月度/年度订阅制

### 模式二：代理运营（全托管服务）

- **目标客户**：大型企业、需要专业团队代运营的品牌方
- **核心特征**：
  - 由专业运营团队代替客户执行 GEO 优化
  - 客户通过代理模式接入，无需直接操作系统
  - 运营团队使用平台全部功能为客户服务
  - 提供定制化策略和专属服务
- **收费模式**：项目制或月度服务费

### 双模式权限设计

| 功能模块 | 自主订阅 | 代理运营 |
|----------|----------|----------|
| 查询管理 | 有（按订阅等级限额） | 有（无限制） |
| 引用检测 | 有 | 有 |
| 策略生成 | 有 | 有 |
| 内容生产 | 有（AI 生成限额） | 有 |
| 分发执行 | 有 | 有 |
| 监测报告 | 有 | 有 |
| 多用户管理 | Enterprise 支持 | 支持 |
| 代理客户管理 | 无 | 有 |
| 白标报告 | 无 | 有 |

## 技术栈概要

### 前端

- **框架**：Next.js 15 + React 19 + TypeScript
- **样式**：Tailwind CSS 4 + shadcn/ui
- **状态管理**：React Server Components + SWR
- **认证**：NextAuth.js v5
- **图表**：Recharts

### 后端

- **框架**：FastAPI + Python 3.12
- **数据库**：PostgreSQL + SQLAlchemy 2.0
- **ORM**：SQLAlchemy 2.0 + Alembic 迁移
- **异步**：Celery + Redis 任务队列
- **认证**：JWT + OAuth2

### AI Agent 框架

- **架构**：模块化 Agent 注册机制
- **通信**：基于消息队列的异步通信协议
- **核心 Agent**：CitationDetector / ContentGenerator / RuleChecker / CompetitorAnalyzer / PerformanceTracker

### 基础设施

- **容器化**：Docker + Docker Compose
- **部署**：云服务器 + Nginx 反向代理
- **监控**：日志系统 + 健康检查

## 快速开始指引

### 环境准备

1. 确保已安装 Docker 和 Docker Compose
2. 克隆项目仓库到本地
3. 复制 `.env.example` 为 `.env` 并配置必要的环境变量

### 启动开发环境

```bash
# 启动全部服务（前端 + 后端 + 数据库 + Redis）
docker-compose up -d

# 后端数据库迁移
cd backend
alembic upgrade head

# 启动前端开发服务器
cd frontend
npm run dev
```

### 默认访问地址

- 前端应用：`http://localhost:3000`
- 后端 API：`http://localhost:8000`
- API 文档：`http://localhost:8000/docs`

### 初始账号

系统初始化后，可通过注册功能创建首个管理员账号，或联系运维团队获取默认管理员凭据。

## 文档导航

| 目录 | 说明 |
|------|------|
| `00-project/` | 项目概述、架构设计、技术栈说明 |
| `01-requirements/` | 业务需求、功能清单、用户故事 |
| `02-design/` | UI 设计、数据库设计、Agent 框架设计 |
| `03-development/` | 开发规范、TDD 流程、模块指南 |
| `04-testing/` | 测试策略、测试计划、测试报告 |
| `05-deployment/` | 部署指南、Docker 配置、环境配置 |
| `06-progress/` | 迭代计划、任务看板、周报 |

## 项目里程碑

| 阶段 | 目标 | 状态 |
|------|------|------|
| Phase 0 | 基础设施搭建 + 文档体系建立 | 进行中 |
| Phase 1 | Stage 1 诊断分析（查询+检测）| 规划中 |
| Phase 2 | Stage 2 策略制定 + Stage 3 内容生产 | 规划中 |
| Phase 3 | Stage 4 分发执行 + Stage 5 监测优化 | 规划中 |
| Phase 4 | 代理运营模式 + 管理后台 | 规划中 |
| Phase 5 | 性能优化 + 稳定性提升 | 规划中 |
| Phase 6 | 生产环境部署 + 正式发布 | 规划中 |

---

*GEO 平台 - 让品牌在 AI 时代被看见。*
