domverse
457dd5bd90
Ports the safety review and the Photo Analyzer Library/Analyze/Stats experiences onto the shared API + service layer, and adds the Workflow home, enforcing the pipeline gates and the one-mutating-job policy. Backend - migration 0005 + models: safety_reviews (append-only, latest row is the current decision) and analysis_results (donor photos schema re-keyed to asset_id). - SafetyService: persist scores/decisions, review queue with filters, and the EXIF safety checkpoint (mutually-exclusive sfw/nsfw keyword written, read back, current_sha256 refreshed) that upload eligibility depends on. - AnalysisService: the privacy gate — the vision provider is called ONLY for canonical, confirmed-SFW assets; nsfw/undecided are recorded skipped without a request. Provider is an injected adapter (real OpenAI-compatible Gemini call extracted from photo_analyzer.analyze_image; a fake in tests). - LibraryService: Library search + Stats read model ported from webapp/query.py (LIKE search in place of FTS5; facets, top tags, years, albums, people). - WorkflowService + GET /api/v1/workflow: per-stage readiness derived from the source tables — counts, blockers, last-run, action, and an active_job that drives read-only-during-jobs. Safety scoring and analysis run as durable jobs under the library_write lock via new domain handlers, so a second mutating job is refused. - routes: workflow, safety (queue/counts/decisions/jobs), analysis (counts/results/jobs), library (assets/facets/stats). Frontend - five views (frontend/js/views.js) on the US02-05 shell: Workflow stepper (status text+icon, not colour alone; actions disabled with a reason while a job runs), Safety review (filter tabs, decide, persists across reload), Library (search + cards), Analyze (counts + live job log via the SSE adapter), Stats. Shared DOM helpers extracted to dom.js; Workflow is the home route. Tests - integration: provider-call privacy (nsfw never reaches the provider), sfw→nsfw flip drops analysis eligibility, decision persistence, one-mutating- job rejection, workflow counts, and the exiftool safety-keyword write/verify. - e2e: Workflow cards, actions disabled+explained during a job, safety decide-persists-across-reload, Library search, Stats, Analyze counts. - traceability map updated for US02-05 and US02-06. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
70 lines
2.5 KiB
Python
70 lines
2.5 KiB
Python
"""FastAPI application factory and lifecycle.
|
|
|
|
Startup runs migrations and opens the database engine; shutdown disposes it so no
|
|
connection or engine resource leaks. The engine, session factory, and config live
|
|
on ``app.state`` for dependencies to use. The app binds to 127.0.0.1 by default
|
|
and exposes the versioned ``/api/v1`` surface; US01-02 ships only health.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from contextlib import asynccontextmanager
|
|
from pathlib import Path
|
|
|
|
from fastapi import FastAPI
|
|
from fastapi.staticfiles import StaticFiles
|
|
|
|
from photo_pipeline.api.routes import (
|
|
analysis,
|
|
duplicates,
|
|
health,
|
|
inventory,
|
|
jobs,
|
|
library,
|
|
safety,
|
|
thumbnails,
|
|
workflow,
|
|
)
|
|
|
|
# Registers the safety_score / analysis job handlers on import.
|
|
import photo_pipeline.jobs.domain_handlers # noqa: F401
|
|
from photo_pipeline.config import Config
|
|
from photo_pipeline.db import create_db_engine, create_session_factory, run_migrations
|
|
from photo_pipeline.logging import configure_logging
|
|
|
|
FRONTEND_DIR = Path(__file__).resolve().parents[2] / "frontend"
|
|
|
|
|
|
def create_app(config: Config | None = None) -> FastAPI:
|
|
config = config or Config.from_env()
|
|
configure_logging(config.log_level, config.log_format)
|
|
|
|
@asynccontextmanager
|
|
async def lifespan(app: FastAPI):
|
|
config.database_path.parent.mkdir(parents=True, exist_ok=True)
|
|
run_migrations(config.database_url)
|
|
engine = create_db_engine(config.database_url)
|
|
app.state.config = config
|
|
app.state.engine = engine
|
|
app.state.session_factory = create_session_factory(engine)
|
|
try:
|
|
yield
|
|
finally:
|
|
engine.dispose()
|
|
app.state.engine = None
|
|
|
|
app = FastAPI(title="Photo Pipeline", version="0.1.0", lifespan=lifespan)
|
|
app.include_router(health.router, prefix="/api/v1")
|
|
app.include_router(inventory.router, prefix="/api/v1")
|
|
app.include_router(duplicates.router, prefix="/api/v1")
|
|
app.include_router(jobs.router, prefix="/api/v1")
|
|
app.include_router(thumbnails.router, prefix="/api/v1")
|
|
app.include_router(workflow.router, prefix="/api/v1")
|
|
app.include_router(safety.router, prefix="/api/v1")
|
|
app.include_router(analysis.router, prefix="/api/v1")
|
|
app.include_router(library.router, prefix="/api/v1")
|
|
# Static single-page app (hash-routed). Mounted last so /api/v1 wins.
|
|
if FRONTEND_DIR.is_dir():
|
|
app.mount("/app", StaticFiles(directory=FRONTEND_DIR, html=True), name="app")
|
|
return app
|