feat: OCR 服务 + 会议材料模块
ry-ocr/ (新)
本地发票识别微服务 (PaddleOCR 3.x + FastAPI, 8801)
- QR 优先: 扫到二维码即取开票时间/发票号/金额; 没扫到/格式不合法直接判非发票, 不跑 OCR
- 配置 QR_FULL_OCR 控制快路径(false, 0.2s)还是全字段(true, 4.5s)
- /recognize/invoice (multipart) + /recognize/invoice/by-path (本地路径, 白名单) + /recognize/text
- is_invoice / from_qr / qr_raw / qr_error / error_code 字段
- 12 字段发票抽取 (regex + 启发式, 左右主体识别)
- 超时保护 (15s 单页 / 60s 总流程) + PaddleOCR 单例 + ThreadPoolExecutor
ry-api/ruoyi-business/
- pom.xml: 加 hutool-http/json/core 5.8.27, lombok 1.18.30 (OcrClient @Slf4j 所需)
- ocr/: OcrClient + InvoiceResult/Fields/Line + ZipExtractor + InvoiceOcrScheduler
- oss/: OssUploader + OssConfMeta (OCR 识别后重传 OSS)
- config/: OcrConfig + OcrExecutorConfig (后台线程池)
- service/impl/InvoiceOcrService: 后台提交 OCR, ZIP 路径解压识别, 替换场景先清旧
- 会议材料 CRUD 全套 (BizMeetingAuditLog/Executor/Invoice/Material/Supervisor):
controller + service + mapper + domain + xml
ry-vue3/
- MeetingDetail.vue (新建): 会议详情页 (含评分维度章节, 改只读)
- Meetings.vue / OssFileUploader.vue / router / Login.vue: 适配新字段
ry-api/ruoyi-admin/
- RuoYiApplication.java + application.yml: 启用 @Async 异步支持
_self/
- manager_meetings.md / manager_meeting_detail.md: 文档
This commit is contained in:
@@ -0,0 +1,4 @@
|
||||
"""数据模型"""
|
||||
from .schemas import OCRLine, InvoiceFields, InvoiceResult, HealthResponse, PathRecognizeRequest
|
||||
|
||||
__all__ = ["OCRLine", "InvoiceFields", "InvoiceResult", "HealthResponse", "PathRecognizeRequest"]
|
||||
@@ -0,0 +1,71 @@
|
||||
"""接口协议 - Pydantic v2"""
|
||||
from typing import List, Optional
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ===== 单行 OCR 结果 =====
|
||||
|
||||
class OCRLine(BaseModel):
|
||||
"""OCR 识别到的一行文字"""
|
||||
text: str = Field(..., description="识别文本")
|
||||
confidence: float = Field(..., ge=0, le=1, description="置信度 0~1")
|
||||
box: List[List[float]] = Field(default_factory=list, description="四点坐标 [[x1,y1],...]")
|
||||
|
||||
|
||||
# ===== 发票字段 =====
|
||||
|
||||
class InvoiceFields(BaseModel):
|
||||
"""结构化发票字段"""
|
||||
# 基本信息
|
||||
invoice_type: Optional[str] = Field(None, description="发票类型,如 增值税电子普通发票")
|
||||
invoice_no: Optional[str] = Field(None, description="发票号码")
|
||||
invoice_code: Optional[str] = Field(None, description="发票代码")
|
||||
invoice_date: Optional[str] = Field(None, description="开票日期 YYYY-MM-DD")
|
||||
|
||||
# 金额
|
||||
amount: Optional[float] = Field(None, description="价税合计(小写)")
|
||||
amount_cn: Optional[str] = Field(None, description="价税合计(大写中文)")
|
||||
amount_pretax: Optional[float] = Field(None, description="不含税金额")
|
||||
tax_amount: Optional[float] = Field(None, description="税额")
|
||||
|
||||
# 主体
|
||||
seller_name: Optional[str] = Field(None, description="销售方名称")
|
||||
seller_tax_no: Optional[str] = Field(None, description="销售方纳税人识别号")
|
||||
buyer_name: Optional[str] = Field(None, description="购买方名称")
|
||||
buyer_tax_no: Optional[str] = Field(None, description="购买方纳税人识别号")
|
||||
|
||||
# 校验
|
||||
amount_match: Optional[bool] = Field(None, description="大写金额与小数金额是否一致")
|
||||
|
||||
|
||||
# ===== 响应 =====
|
||||
|
||||
class InvoiceResult(BaseModel):
|
||||
"""发票识别总响应"""
|
||||
success: bool = Field(..., description="是否识别成功")
|
||||
is_invoice: bool = Field(True, description="是否被判定为发票(false = 非发票图片)")
|
||||
raw_text: str = Field("", description="全部 OCR 文本拼接")
|
||||
lines: List[OCRLine] = Field(default_factory=list, description="分行识别结果")
|
||||
fields: InvoiceFields = Field(default_factory=InvoiceFields, description="抽取的结构化字段")
|
||||
page_count: int = Field(1, description="PDF 页数 / 图片=1")
|
||||
engine: str = Field("paddleocr", description="使用的 OCR 引擎")
|
||||
elapsed_ms: int = Field(0, description="识别耗时(毫秒)")
|
||||
error: Optional[str] = Field(None, description="失败原因")
|
||||
error_code: Optional[str] = Field(None, description="错误码: not_invoice / timeout / unsupported / ocr_failed")
|
||||
|
||||
# QR 识别相关
|
||||
from_qr: bool = Field(False, description="是否从二维码取到了 3 个核心字段 (开票时间/发票号/金额)")
|
||||
qr_raw: Optional[str] = Field(None, description="二维码原始文本 (用于排查)")
|
||||
qr_error: Optional[str] = Field(None, description="二维码识别失败原因 (no_qr / bad_format)")
|
||||
|
||||
|
||||
class HealthResponse(BaseModel):
|
||||
status: str = "ok"
|
||||
version: str
|
||||
engine_ready: bool
|
||||
|
||||
|
||||
class PathRecognizeRequest(BaseModel):
|
||||
"""按文件路径识别的请求体"""
|
||||
file_path: str = Field(..., description="服务器本地绝对路径", examples=["E:/invoice/abc.pdf"])
|
||||
Reference in New Issue
Block a user