# 技术栈

## 前端技术栈

| 组件 | 技术 | 版本 |
|------|------|------|
| 框架 | Next.js | 14+ |
| UI库 | React | 18+ |
| 语言 | TypeScript | 5.x |
| 样式 | Tailwind CSS | 4.x |
| 组件库 | shadcn/ui | - |
| 图表 | Recharts | - |
| 状态管理 | SWR | - |
| 认证 | NextAuth.js | v5 |

## 后端技术栈

| 组件 | 技术 | 版本 |
|------|------|------|
| 框架 | FastAPI | 0.109+ |
| 语言 | Python | 3.12+ |
| ORM | SQLAlchemy | 2.0+ |
| 数据库 | PostgreSQL | 15+ |
| 缓存 | Redis | 7+ |
| 任务队列 | Celery | 5+ |
| 认证 | JWT + OAuth2 | - |

## AI Agent框架

| 组件 | 技术 |
|------|------|
| Agent基础 | 自研模块化框架 |
| 消息队列 | Redis Pub/Sub |
| 注册中心 | Redis Hash |
| 任务分发 | Dispatcher + Registry |

## 基础设施

| 组件 | 技术 |
|------|------|
| 容器化 | Docker + Docker Compose |
| 反向代理 | Nginx |
| 监控 | Prometheus + Grafana |

## 项目目录结构

```
geo/
├── backend/                    # FastAPI 后端
│   ├── app/
│   │   ├── api/               # API路由
│   │   ├── agent_framework/   # Agent框架
│   │   ├── models/            # 数据模型
│   │   ├── schemas/           # Pydantic模型
│   │   ├── services/          # 业务逻辑
│   │   │   ├── ai_engine/     # AI引擎服务
│   │   │   ├── llm/           # LLM服务
│   │   │   ├── knowledge/     # 知识库服务
│   │   │   ├── content/       # 内容服务
│   │   │   ├── distribution/  # 分发服务
│   │   │   ├── diagnosis/     # 诊断服务
│   │   │   ├── citation/      # 引用服务
│   │   │   ├── competitor/    # 竞品服务
│   │   │   ├── monitoring/    # 监测服务
│   │   │   ├── trend/         # 趋势服务
│   │   │   ├── schema/        # Schema服务
│   │   │   ├── scoring/       # 评分服务
│   │   │   ├── strategy/      # 策略服务
│   │   │   ├── alert/         # 告警服务
│   │   │   ├── advisor/       # 顾问服务
│   │   │   ├── analysis/      # 分析服务
│   │   │   ├── detection/     # 检测服务
│   │   │   └── analytics/     # 分析统计服务
│   │   ├── repositories/      # 数据访问层
│   └── requirements.txt
├── frontend/                   # Next.js 前端
│   ├── app/                  # 页面
│   ├── components/          # 组件
│   └── lib/
│       ├── api/             # API客户端
│       │   ├── analytics.ts
│       │   ├── api-keys.ts
│       │   ├── auth.ts
│       │   ├── brands.ts
│       │   ├── citations.ts
│       │   ├── clients.ts
│       │   ├── competitor-analysis.ts
│       │   ├── contents.ts
│       │   ├── dashboard.ts
│       │   ├── detection.ts
│       │   ├── diagnosis.ts
│       │   ├── distribution.ts
│       │   ├── health.ts
│       │   ├── image.ts
│       │   ├── knowledge.ts
│       │   ├── lifecycle.ts
│       │   ├── monitoring.ts
│       │   ├── onboarding.ts
│       │   ├── organization.ts
│       │   ├── platform-rules.ts
│       │   ├── queries.ts
│       │   ├── reports.ts
│       │   ├── schema-advisor.ts
│       │   ├── strategy.ts
│       │   ├── suggestions.ts
│       │   ├── trends.ts
│       │   └── usage.ts
│       └── ...               # 其他工具函数
└── docs/                     # 文档
```