# pcr-server-Python

**Repository Path**: ibs-bj_0/pcr-server-Python

## Basic Information

- **Project Name**: pcr-server-Python
- **Description**: Python版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-11
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PCR Python 服务

这是Java PcrController的Python重写版本，提供PCR文件上传和处理功能。

## 功能特性

- ✅ 文件上传和MD5校验
- ✅ channeldata.json文件解析
- ✅ 参数验证和错误处理
- ✅ 与Java版本功能完全一致
- ✅ RESTful API接口
- ✅ 健康检查接口

## 文件说明

- `main.py` - 主服务文件，包含PCR控制器逻辑
- `requirements.txt` - Python依赖包列表
- `test_pcr_service.py` - 功能测试脚本
- `PcrController.java` - 原始Java版本代码（参考）

## 安装和运行

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 启动服务

```bash
python main.py
```

服务将在 `http://localhost:8080` 启动

### 3. 验证服务

```bash
python test_pcr_service.py
```

## API接口

### 文件上传接口

**POST** `/api/emb/upLoadFile`

**参数：**
- `files` - 上传的文件数组
- `pid` - 项目ID
- `time` - 时间戳
- `nonceStr` - 随机字符串
- `params` - JSON格式的文件MD5信息

**响应格式：**
```json
{
    "msg": "数据",
    "rel": "SUCCESS",
    "code": 1
}
```

### 健康检查接口

**GET** `/health`

**响应：**
```json
{
    "status": "healthy",
    "timestamp": "2025-01-XX...",
    "service": "PCR Python Service"
}
```

### 根路径接口

**GET** `/`

**响应：**
```json
{
    "message": "PCR Python Service is running",
    "version": "1.0.0",
    "endpoints": {
        "upload": "/api/emb/upLoadFile",
        "health": "/health"
    }
}
```

## 功能对比

| 功能 | Java版本 | Python版本 | 状态 |
|------|----------|------------|------|
| 文件上传 | ✅ | ✅ | 一致 |
| MD5校验 | ✅ | ✅ | 一致 |
| 参数验证 | ✅ | ✅ | 一致 |
| JSON解析 | ✅ | ✅ | 一致 |
| 错误处理 | ✅ | ✅ | 一致 |
| 日志记录 | ✅ | ✅ | 一致 |

## 测试用例

测试脚本包含以下测试场景：

1. **健康检查测试** - 验证服务是否正常运行
2. **根路径测试** - 验证基础接口
3. **无文件上传测试** - 验证参数验证逻辑
4. **正常文件上传测试** - 验证完整上传流程
5. **错误MD5测试** - 验证MD5校验功能

## 注意事项

- 服务默认监听8080端口
- 支持最大16MB文件上传
- 临时文件会自动清理
- 所有错误都会返回标准格式响应

## 开发说明

这个Python版本完全重写了Java PcrController的功能，保持了相同的业务逻辑和接口规范，确保与现有系统的兼容性。