mzaxd
6cb4545a17
- 更新 AGENTS.md 项目知识库文档（多目录） - 添加 docs/analyst.md 产品分析文档 - 添加 .omc/ 工具状态和会话记录 - 添加 .sisyphus/ 计划文档 - 添加 project-structure.txt 项目结构 - 删除 timeline 测试截图
149 lines
4.7 KiB
Plaintext
149 lines
4.7 KiB
Plaintext
# 项目目录结构
|
|
|
|
## 📁 根目录结构
|
|
|
|
### 🎯 主要源代码目录
|
|
```
|
|
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 项目搜索和过滤
|
|
- **特点**: 多条件搜索、分页、状态过滤
|
|
```
|