geo/docs/00-project/README.md

157 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# GEO 平台 - 项目总览
## 项目定位
**GEOGenerative 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 时代被看见。*