kiwi/app/api/endpoints/receipts.py
pyr0ball c18bfec8f5
Some checks are pending
CI / Backend (Python) (push) Waiting to run
CI / Frontend (Vue) (push) Waiting to run
Mirror / mirror (push) Waiting to run
fix(lint): add ruff config, fix all lint errors for GitHub CI
- pyproject.toml: add [tool.ruff] config suppressing E402/W293 globally,
  F841/E741/E702 in tests, E741 in scripts
- inventory.py: split semicolon import (E702)
- recipes.py: fix logger -> log (F821 undefined name)
- shopping.py: rename l -> lnk in list comprehension (E741)
- format_conversion.py: noqa F841 on CUDA flag (used as future hook)
- backfill_keywords.py: rename done -> _done (F841)
- ingest_purplecarrot.py: drop == True comparison (E712)
- Auto-fix: I001 import sorting, F401 unused imports across all files
2026-07-06 02:49:02 -07:00

119 lines
4.5 KiB
Python

"""Receipt upload, OCR, and quality endpoints."""
from __future__ import annotations
import asyncio
import uuid
from pathlib import Path
from typing import List
import aiofiles
from fastapi import APIRouter, BackgroundTasks, Depends, File, HTTPException, UploadFile
from app.cloud_session import CloudUser, get_session
from app.core.config import settings
from app.db.session import get_store
from app.db.store import Store
from app.models.schemas.quality import QualityAssessment
from app.models.schemas.receipt import ReceiptResponse
from app.tiers import can_use
router = APIRouter()
async def _save_upload(file: UploadFile, dest_dir: Path) -> Path:
dest = dest_dir / f"{uuid.uuid4()}_{file.filename}"
async with aiofiles.open(dest, "wb") as f:
await f.write(await file.read())
return dest
@router.post("/", response_model=ReceiptResponse, status_code=201)
async def upload_receipt(
background_tasks: BackgroundTasks,
file: UploadFile = File(...),
store: Store = Depends(get_store),
session: CloudUser = Depends(get_session),
):
settings.ensure_dirs()
saved = await _save_upload(file, settings.UPLOAD_DIR)
receipt = await asyncio.to_thread(
store.create_receipt, file.filename, str(saved)
)
# Only queue OCR if the feature is enabled server-side AND the user's tier allows it.
# Check tier here, not inside the background task — once dispatched it can't be cancelled.
# Pass session.db (a Path) rather than store — the store dependency closes before
# background tasks run, so the task opens its own store from the DB path.
ocr_allowed = settings.ENABLE_OCR and can_use("receipt_ocr", session.tier, session.has_byok)
if ocr_allowed:
background_tasks.add_task(_process_receipt_ocr, receipt["id"], saved, session.db)
return ReceiptResponse.model_validate(receipt)
@router.post("/batch", response_model=List[ReceiptResponse], status_code=201)
async def upload_receipts_batch(
background_tasks: BackgroundTasks,
files: List[UploadFile] = File(...),
store: Store = Depends(get_store),
session: CloudUser = Depends(get_session),
):
settings.ensure_dirs()
ocr_allowed = settings.ENABLE_OCR and can_use("receipt_ocr", session.tier, session.has_byok)
results = []
for file in files:
saved = await _save_upload(file, settings.UPLOAD_DIR)
receipt = await asyncio.to_thread(
store.create_receipt, file.filename, str(saved)
)
if ocr_allowed:
background_tasks.add_task(_process_receipt_ocr, receipt["id"], saved, session.db)
results.append(ReceiptResponse.model_validate(receipt))
return results
@router.get("/{receipt_id}", response_model=ReceiptResponse)
async def get_receipt(receipt_id: int, store: Store = Depends(get_store)):
receipt = await asyncio.to_thread(store.get_receipt, receipt_id)
if not receipt:
raise HTTPException(status_code=404, detail="Receipt not found")
return ReceiptResponse.model_validate(receipt)
@router.get("/", response_model=List[ReceiptResponse])
async def list_receipts(
limit: int = 50, offset: int = 0, store: Store = Depends(get_store)
):
receipts = await asyncio.to_thread(store.list_receipts, limit, offset)
return [ReceiptResponse.model_validate(r) for r in receipts]
@router.get("/{receipt_id}/quality", response_model=QualityAssessment)
async def get_receipt_quality(receipt_id: int, store: Store = Depends(get_store)):
qa = await asyncio.to_thread(
store._fetch_one,
"SELECT * FROM quality_assessments WHERE receipt_id = ?",
(receipt_id,),
)
if not qa:
raise HTTPException(status_code=404, detail="Quality assessment not found")
return QualityAssessment.model_validate(qa)
async def _process_receipt_ocr(receipt_id: int, image_path: Path, db_path: Path) -> None:
"""Background task: run OCR pipeline on an uploaded receipt.
Accepts db_path (not a Store instance) because FastAPI closes the request-scoped
store before background tasks execute. This task owns its store lifecycle.
"""
store = Store(db_path)
try:
await asyncio.to_thread(store.update_receipt_status, receipt_id, "processing")
from app.services.receipt_service import ReceiptService
service = ReceiptService(store)
await service.process(receipt_id, image_path)
except Exception as exc:
await asyncio.to_thread(
store.update_receipt_status, receipt_id, "error", str(exc)
)
finally:
store.close()