# ocr-server-test

**Repository Path**: pcupso1990/ocr-server-test

## Basic Information

- **Project Name**: ocr-server-test
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-25
- **Last Updated**: 2025-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OCR识别记录管理系统

## 项目简介

这是一个基于SpringBoot的OCR识别记录管理系统，提供OCR识别记录的增删改查功能。

## 技术栈

- Spring Boot 2.7.18
- Spring Data JPA
- MySQL 8.0
- Maven
- Lombok

## 数据库配置

- 主机: 221.230.88.202
- 端口: 60100
- 用户名: root
- 密码: Geek@123456
- 数据库: db_ocrtest
- 字符集: utf8

## 项目结构

```
src/main/java/com/ocr/
├── OcrServerApplication.java          # 启动类
├── controller/
│   └── OcrRecordController.java       # 控制器
├── service/
│   └── OcrRecordService.java          # 服务层
├── repository/
│   └── OcrRecordRepository.java       # 数据访问层
├── entity/
│   └── OcrRecord.java                 # 实体类
├── dto/
│   ├── OcrRecordDto.java              # 数据传输对象
│   └── ApiResponse.java               # 统一响应格式
└── exception/
    └── GlobalExceptionHandler.java    # 全局异常处理器
```

## 数据库表结构

### ocr_record 表

| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | bigint | 主键ID |
| recognition_time | datetime | 识别时间 |
| image_url | varchar(500) | 图片地址 |
| recognition_text | text | 图片识别文本 |
| is_correct | tinyint(1) | 正确错误字段：1-正确，0-错误 |
| is_deleted | tinyint(1) | 是否删除标记：1-已删除，0-未删除 |
| create_time | datetime | 创建时间 |
| update_time | datetime | 更新时间 |

## API接口

### 1. 提交识别记录
- **URL**: `POST /api/ocr-records`
- **描述**: 创建新的OCR识别记录
- **请求体**:
```json
{
  "recognitionTime": "2024-01-15T10:30:00",
  "imageUrl": "https://example.com/image.jpg",
  "recognitionText": "识别出的文本内容",
  "isCorrect": true
}
```

### 2. 获取所有记录
- **URL**: `GET /api/ocr-records`
- **描述**: 获取所有未删除的识别记录

### 3. 分页查询记录
- **URL**: `GET /api/ocr-records/page?page=0&size=10`
- **描述**: 分页查询识别记录
- **参数**:
  - page: 页码（从0开始）
  - size: 每页大小

### 4. 根据ID查询记录
- **URL**: `GET /api/ocr-records/{id}`
- **描述**: 根据ID查询特定记录

### 5. 根据时间范围查询
- **URL**: `GET /api/ocr-records/time-range?startTime=2024-01-01T00:00:00&endTime=2024-01-31T23:59:59`
- **描述**: 根据时间范围查询记录

### 6. 根据正确性查询
- **URL**: `GET /api/ocr-records/correctness?isCorrect=true`
- **描述**: 根据识别正确性查询记录

### 7. 逻辑删除记录
- **URL**: `DELETE /api/ocr-records/{id}`
- **描述**: 逻辑删除指定记录

### 8. 获取统计信息
- **URL**: `GET /api/ocr-records/statistics`
- **描述**: 获取识别记录统计信息

## 运行说明

### 1. 初始化数据库
```sql
-- 执行 database_init.sql 文件中的SQL语句
```

### 2. 启动应用
```bash
# 编译项目
mvn clean compile

# 运行项目
mvn spring-boot:run
```

### 3. 访问应用
- 应用地址: http://localhost:8080
- API文档: http://localhost:8080/api/ocr-records

## 响应格式

所有API接口都使用统一的响应格式：

```json
{
  "code": 200,
  "message": "操作成功",
  "data": {
    // 具体数据
  }
}
```

## 注意事项

1. 确保MySQL数据库已启动并可访问
2. 检查数据库连接配置是否正确
3. 首次运行时会自动创建表结构
4. 所有删除操作都是逻辑删除，不会物理删除数据