# pycloudv2

**Repository Path**: llspark/pycloudv2

## Basic Information

- **Project Name**: pycloudv2
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python 在线编辑器

一个功能强大的在线 Python 编辑和运行平台，支持用户登录、代码编辑、调试、API 发布和定时任务管理。

## 功能特性

- **用户认证与授权**：用户登录后拥有独立的开发空间
- **在线代码编辑**：支持 Python 代码的编写和调试
- **代码文件引用**：代码可以相互引用，支持模块化开发
- **附件管理**：支持附件上传保存和代码引用
- **API 发布**：在方法上声明为 API 后可以对外发布接口
- **定时任务**：支持对方法设置定时任务运行
- **资源限制**：代码调试运行时脚本时间不超过 3 分钟，定时任务运行脚本时不做超时限制
- **安全保障**：保护用户代码和数据安全，防止恶意代码执行

## 技术栈

- **前端**：React、TypeScript、TailwindCSS、Monaco Editor
- **后端**：Python 3.12+、FastAPI、JWT 认证
- **数据库**：MySQL
- **缓存**：Redis
- **文件存储**：本地文件系统和对象存储
- **容器化**：Docker
- **任务调度**：Celery

## 项目结构

```
/
├── specs/                  # 项目核心定义 (产品/技术/结构/规范)
├── docs/                   # 项目文档
├── frontend/               # 前端代码
├── backend/                # 后端代码
├── .gitignore
└── README.md               # 项目入口文档
```

## 开发环境搭建

### 前端

1. 进入前端目录：`cd frontend`
2. 安装依赖：`npm install`
3. 启动开发服务器：`npm run dev`
4. 访问：`http://localhost:3000`

### 后端

1. 进入后端目录：`cd backend`
2. 创建虚拟环境：`python3 -m venv venv`
3. 激活虚拟环境：`source venv/bin/activate`
4. 安装依赖：`pip install -r requirements.txt`
5. 创建 `.env` 文件（参考 `.env.example`）
6. 启动后端服务：`uvicorn app.main:app --reload`
7. 访问：`http://localhost:8000`

## 生产环境部署

使用 Docker Compose 部署：

1. 进入后端目录：`cd backend`
2. 运行：`docker-compose up -d`
3. 访问前端：`http://localhost:3000`
4. 后端 API 地址：`http://localhost:8000`

## 开发规范

请参考 `specs/开发规范.md` 文件。

## 项目状态

正在开发中，欢迎贡献代码和提出建议！