geo/docs/00-project/README.md

5.6 KiB
Raw Blame History

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
  • ORMSQLAlchemy 2.0 + Alembic 迁移
  • 异步Celery + Redis 任务队列
  • 认证JWT + OAuth2

AI Agent 框架

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

基础设施

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

快速开始指引

环境准备

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

启动开发环境

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

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

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

默认访问地址

  • 前端应用:http://localhost:3000
  • 后端 APIhttp://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 时代被看见。