技术栈
前端技术栈
| 组件 |
技术 |
版本 |
| 框架 |
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/ # 文档