kiwi/app/api/endpoints/receipts.py
pyr0ball 01aae2eec8
Some checks failed
CI / Backend (Python) (push) Has been cancelled
CI / Frontend (Vue) (push) Has been cancelled
CI / Backend (Python) (pull_request) Has been cancelled
CI / Frontend (Vue) (pull_request) Has been cancelled
fix: recipe enrichment backfill, main_ingredient browser domain, bug batch
Recipe corpus (#108):
- Add _MAIN_INGREDIENT_SIGNALS to tag_inferrer.py (Chicken/Beef/Pork/Fish/Pasta/
  Vegetables/Eggs/Legumes/Grains/Cheese) — infers main:* tags from ingredient names
- Update browser_domains.py main_ingredient categories to use main:* tag queries
  instead of raw food terms; recipe_browser_fts now has full 3.19M row coverage
  (was ~1.2K before backfill)

Bug fixes:
- Fix community posts response shape (#96): add total/page/page_size fields
- Fix export endpoint arg types (#92)
- Fix household invite store leak (#93)
- Fix receipts endpoint issues
- Fix saved_recipes endpoint
- Add session endpoint (app/api/endpoints/session.py)

Shopping list:
- Add migration 033_shopping_list.sql
- Add shopping schemas (app/models/schemas/shopping.py)
- Add ShoppingView.vue, ShoppingItemRow.vue, shopping.ts store

Frontend:
- InventoryList, RecipesView, RecipeDetailPanel polish
- App.vue routing updates for shopping view

Docs:
- Add user-facing docs under docs/ (getting-started, user-guide, reference)
- Add screenshots
2026-04-18 15:38:56 -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.receipt import ReceiptResponse
from app.models.schemas.quality import QualityAssessment
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()