COT Studio

COT Studio 是一个端到端的交互式平台，旨在帮助研究者和工程团队以高质量、可验证和可追溯的方式构建、泛化和合成 Chain-of-Thought (CoT) 数据集。

项目结构

cot-studio-mvp/
├── frontend/          # React + TypeScript 前端
├── backend/           # FastAPI 后端
├── docker/            # Docker 配置文件
├── docs/              # 项目文档
├── .github/           # GitHub Actions CI/CD
├── docker-compose.yml # 开发环境配置
└── README.md

快速开始

一键部署 (推荐)

# 1. 克隆项目
git clone <repository-url>
cd cot-studio-mvp

# 2. 运行一键安装脚本 (Linux/macOS)
./scripts/setup.sh

# 3. Windows 用户使用 Make 命令
make deploy-dev

手动部署

# 1. 复制环境配置
cp .env.example .env

# 2. 编辑配置文件 (配置API密钥等)
# 编辑 .env 文件

# 3. 启动所有服务
make docker-up

# 4. 验证部署
make health-check

服务访问地址

• 前端应用: http://localhost:3000
• 后端API: http://localhost:8000
• API文档: http://localhost:8000/docs
• Neo4j浏览器: http://localhost:7474
• MinIO控制台: http://localhost:9001
• RabbitMQ管理: http://localhost:15672
• Celery监控: http://localhost:5555

技术栈

前端

• React 18 + TypeScript
• Vite 构建工具
• Ant Design UI组件库
• Zustand 状态管理

后端

• FastAPI Python框架
• SQLAlchemy ORM
• Celery 异步任务队列
• Pydantic 数据验证

数据存储

• PostgreSQL 主数据库
• Neo4j 知识图谱数据库
• Redis 缓存和会话存储
• MinIO 对象存储
• RabbitMQ 消息队列

常用命令

# 查看所有可用命令
make help

# 开发环境
make dev              # 启动开发环境
make health-check     # 健康检查
make logs            # 查看实时日志

# 维护操作
make backup          # 创建系统备份
make monitor         # 查看系统监控
make update          # 更新系统

# 数据库操作
make db-migrate      # 执行数据库迁移
make db-reset        # 重置数据库

文档

详细文档请参考 docs/ 目录：

• 用户指南 - 完整的用户操作指南
• 部署指南 - 部署和配置说明
• API文档 - API接口文档
• 故障排除 - 常见问题解决方案
• 维护指南 - 系统维护和监控
• 开发指南 - 开发环境和流程

系统要求

最低配置

• CPU: 4核心
• 内存: 8GB RAM
• 存储: 50GB 可用空间
• 软件: Docker 20.10+, Docker Compose 2.0+

推荐配置

• CPU: 8核心
• 内存: 16GB RAM
• 存储: 100GB SSD