# joaquin-ocr

**Repository Path**: zijol/joaquin-ocr

## Basic Information

- **Project Name**: joaquin-ocr
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-03
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 平台简介

基于 PaddleOCR 的 OCR(+LLM)识别平台(含管理功能)，基础环境 Ubuntu 22.04，CUDA 12.8，python 3.10+

## 内置功能

1.  用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2.  角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
3.  菜单管理：配置系统菜单，操作权限，按钮权限标识等。
4.  部门管理：配置系统组织机构（公司、部门、小组）。
5.  岗位管理：配置系统用户所属担任职务。
6.  字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7.  参数管理：对系统动态配置常用参数。
8.  通知公告：系统通知公告信息发布维护。
9.  操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 登录日志：系统登录日志记录查询包含登录异常。
11. 在线用户：当前系统中活跃用户状态监控。
12. 定时任务：在线（添加、修改、删除）任务调度包含执行结果日志。
13. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
14. 缓存监控：对系统的缓存信息查询，命令统计等。
15. 在线构建器：拖动表单元素生成相应的HTML代码。
16. 系统接口：根据业务代码自动生成相关的api接口文档。
17. 代码生成：配置数据库表信息一键生成前后端代码（python、sql、vue、js），支持下载。
18. OCR配置：用于OCR服务的启动相关参数的配置，按照实际系统环境配置合适的参数。
19. 大模型：用于OCR+LLM的场景下，大模型调用的参数配置。

## 项目开发及发布相关

### 预装（需 Python > 3.10）

(安装参考)[https://www.paddlepaddle.org.cn/en/install/quick?docurl=undefined]

```bash
# 安装paddlepaddle的CPU版本，如果使用GPU推理则安装gpu版本
python -m pip install paddlepaddle==3.1.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

# 安装 paddleocr
pip install paddleocr
```

### 开发

```bash
# 克隆项目
git clone https://gitee.com/zijol/joaquin-ocr.git Joaquin-OCR

# 进入项目根目录
cd Joaquin-OCR
```

#### 前端
```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install 或 yarn --registry=https://registry.npmmirror.com

# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com

# 启动服务
npm run dev 或 yarn dev
```

#### 后端
```bash
# 进入后端目录
cd backend

# 如果使用的是MySQL数据库，请执行以下命令安装项目依赖环境
pip install -r requirements.txt

# 配置环境
在.env.dev文件中配置开发环境的数据库和redis

# 运行sql文件
1.使用的是MySQL数据库，新建数据库joaquin_ocr.sql
2.使用的是MongoDB数据库，新建数据库joaquin_ocr.js

# 运行后端
python app.py --env=dev
```

#### 访问
```bash
# 默认账号密码
账号：admin
密码：admin123

# 浏览器访问
地址：http://localhost:80
```

### 发布

#### 前端
```bash
# 构建测试环境
npm run build:stage 或 yarn build:stage

# 构建生产环境
npm run build:prod 或 yarn build:prod
```

#### 后端
```bash
# 配置环境
在.env.prod文件中配置生产环境的数据库、Redis、MongoDB相关参数

# 运行后端
python app.py --env=prod