feat(phase1): add static file serving for /images/

backend/main.py

@@ -2,6 +2,7 @@ import os
 from . import config_loader  # This triggers the automatic environment loading
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
 from slowapi import Limiter
 from slowapi.util import get_remote_address
 from . import models
@@ -10,7 +11,7 @@ from .routers import items, operations, users, auth, sync, categories
 from .routers.admin import backups, ai_config, db_config
 from .logger import log
 from .scheduler import scheduler, sync_scheduler_config
-from .services.image_storage import ensure_image_directories
+from .services.image_storage import ensure_image_directories, IMAGES_ROOT
 
 # Create the database tables
 from .database import DATA_DIR, db_path
@@ -95,6 +96,14 @@ app.include_router(backups.router)
 app.include_router(ai_config.router)
 app.include_router(db_config.router)
 
+# [STATIC FILES] Mount /images/ directory for serving uploaded photos
+# Ensure directory exists before mounting (StaticFiles requires pre-existing directory)
+IMAGES_ROOT.mkdir(parents=True, exist_ok=True)
+# Mount at root level after all API routes to avoid conflicts with dynamic routes.
+# MIME types are auto-detected by StaticFiles based on file extensions.
+# Supported formats: JPEG (.jpg/.jpeg), PNG (.png), WebP (.webp), GIF (.gif)
+app.mount("/images", StaticFiles(directory=str(IMAGES_ROOT)), name="images")
+
 @app.on_event("startup")
 def startup_event():
     log.info("[STARTUP] Initializing image storage directories...")