# 项目目录结构

## 📁 根目录结构

### 🎯 主要源代码目录
```
src/
├── app/                    # Next.js App Router (核心应用)
│   ├── [locale]/          # 国际化路由
│   │   ├── keyword-cloud/  # 词云功能页面
│   │   ├── projects/      # 项目页面
│   │   └── timeline/      # 时间线功能页面
│   └── api/               # API 路由
│       ├── discovery/     # 项目发现 API
│       ├── events/        # 事件 API
│       ├── keyword-cloud/  # 词云 API
│       ├── projects/      # 项目 API
│       ├── search/        # 搜索 API
│       └── webhook/      # Webhook API
├── components/            # React 组件
│   ├── layout/           # 布局组件
│   ├── locale/           # 国际化组件
│   ├── project/          # 项目相关组件
│   ├── search/           # 搜索相关组件
│   └── timeline/         # 时间线相关组件
├── hooks/                # 服务端数据获取函数
├── i18n/                 # 国际化配置
├── lib/                  # 工具库
│   └── github/          # GitHub 相关工具
└── messages/             # 翻译文件
```

### ⚙️ 配置文件
```
├── next.config.js        # Next.js 配置
├── tailwind.config.ts    # Tailwind CSS 配置
├── tsconfig.json         # TypeScript 配置
├── components.json       # Radix UI 组件配置
├── .eslintrc.json        # ESLint 配置
└── .prettierrc.json      # Prettier 配置
```

### 🗄️ 数据库配置
```
prisma/
├── schema.prisma        # 数据库模式
└── migrations/         # 数据库迁移
```

### 🔧 自定义 Agents
```
.claude/
└── agents/             # Claude Code 自定义 Agent
```

### 🔄 n8n 工作流
```
n8n-workflows/
├── keyword-cloud-workflow.json  # 词云采集工作流
└── README.md                    # 工作流文档

docs/n8n/
├── historical-workflow-design.md    # 历史工作流设计
├── incremental-workflow-design.md    # 增量工作流设计
└── tag-janitor-workflow.json         # 标签清理工作流
```

### 📚 文档
```
docs/
├── api-reference.md           # API 参考
├── api-testing-guide.md       # API 测试指南
├── discovery-workflow.md       # 项目发现工作流
├── e2e-testing-guide.md        # E2E 测试指南
├── plans/                      # 项目规划文档
└── n8n/                       # n8n 相关文档
```

### 🎨 设计资源
```
design/
├── hotpot cloud/     # Hotpot 云相关设计
│   └── screen.png
└── timeline/        # 时间线设计
    └── screen.png
```

### 📜 数据库种子脚本
```
scripts/
├── list-tags.js               # 标签列表脚本
├── seed-historical-events.ts # 历史事件种子数据
├── seed-keyword-cloud.ts     # 词云种子数据
└── test-keyword-api.ts       # 词云 API 测试
```

### 🧪 测试
```
tests/
└── screenshots/              # 截图测试
```

### 🚀 其他配置
```
opencode/                  # OpenCode 配置
└── mcp.json              # MCP 服务器配置

.env                      # 环境变量
.env.example              # 环境变量模板
AGENTS.md                 # Agent 文档
CLAUDE.md                 # 项目说明文档
package.json              # 项目依赖
```

## 🎯 特殊功能目录

### 1. 项目发现系统 (Project Discovery)
- **位置**: `src/app/api/discovery/`
- **功能**: 自动化探索和收录 AI 项目
- **特点**: 双 Agent 协作架构

### 2. 词云系统 (Keyword Cloud)
- **位置**: `src/app/[locale]/keyword-cloud/` 和 `src/app/api/keyword-cloud/`
- **功能**: 季度 AI 热点词云展示
- **特点**: n8n 自动化采集、实时数据展示

### 3. 时间线系统 (Timeline)
- **位置**: `src/app/[locale]/timeline/`
- **功能**: AI 历史事件时间线
- **特点**: 渐进式加载、历史事件展示

### 4. n8n 工作流
- **位置**: `n8n-workflows/` 和 `docs/n8n/`
- **功能**: 
  - keyword-cloud-workflow.json: Google Trends 数据采集
  - tag-janitor-workflow.json: 标签清理自动化
- **特点**: 季度触发、错误处理、API 集成

### 5. 项目管理系统
- **位置**: `src/app/[locale]/projects/` 和 `src/app/api/projects/`
- **功能**: AI 项目展示、搜索、分类
- **特点**: 多语言支持、标签系统、Webhook 集成

### 6. 搜索系统
- **位置**: `src/app/api/search/` 和 `src/components/search/`
- **功能**: AI 项目搜索和过滤
- **特点**: 多条件搜索、分页、状态过滤
```
