This repository has been archived on 2026-06-09. You can view files and clone it, but cannot push or open issues or pull requests.
wedding-app/apps/api/app/lib/transcode.py
Claude f882f8a1c8
feat: HEIC->JPEG transcoding and Postgres + MinIO backup sidecars
HEIC handling
- pillow-heif joins the deps; app/lib/transcode.py registers the
  HEIF opener and exposes heic_to_jpeg(bytes, quality=88) with EXIF
  rotation applied so portrait iPhone photos do not show sideways.
- Storage gains get_bytes / put_bytes so the server can read the
  uploaded HEIC out of MinIO, decode it, and put a JPEG back.
- /api/uploads/{id}/confirm now runs the transcode after the HEAD
  check passes when mime_type is image/heic or image/heif: writes
  the JPEG under a sibling key, deletes the HEIC, and updates the
  upload row's storage_key / mime_type / size_bytes. Failures fall
  back to keeping the HEIC so an upload is never lost in transit;
  the admin can re-upload if a particular file is unrenderable.

Backups (two sidecars in docker-compose.yml)
- postgres-backup uses prodrigestivill/postgres-backup-local:16-alpine
  with BACKUP_SCHEDULE_DB (default @daily) and layered retention
  (days/weeks/months) writing to ./backups/postgres on the host.
- media-backup is an alpine container that pulls mc on boot, sets up
  an alias for the in-cluster MinIO, optionally adds a remote alias
  (R2/B2/S3 via BACKUP_REMOTE_*), and runs mc mirror on a configurable
  cron schedule. Local mirror always; remote mirror only when
  BACKUP_REMOTE_* are set.
- Both write to ./backups/ on the host (bind mount), so the operator
  can rsync the directory off-box without touching containers.
- .env.example documents every new variable, including a R2 example
  for the remote target, and TZ for cron alignment.

Local backups directory is .gitignore'd so accidental commits do not
ship someone else's wedding photos to GitHub.
2026-06-07 22:50:29 +00:00

40 lines
1.0 KiB
Python

import io
import logging
import pillow_heif
from PIL import Image, ImageOps
pillow_heif.register_heif_opener()
logger = logging.getLogger(__name__)
HEIC_MIMES = {"image/heic", "image/heif"}
def is_heic(mime_type: str) -> bool:
return mime_type.lower() in HEIC_MIMES
def heic_to_jpeg(heic_bytes: bytes, quality: int = 88) -> bytes:
"""Decode HEIC, apply EXIF rotation, re-encode as JPEG.
Raises on any decode/encode failure so the caller can decide whether
to keep the HEIC fallback.
"""
img = Image.open(io.BytesIO(heic_bytes))
img = ImageOps.exif_transpose(img)
if img.mode not in ("RGB", "L"):
img = img.convert("RGB")
out = io.BytesIO()
img.save(out, format="JPEG", quality=quality, optimize=True, progressive=True)
return out.getvalue()
def swap_extension_to_jpg(key: str) -> str:
lower = key.lower()
if lower.endswith(".heic"):
return key[: -len(".heic")] + ".jpg"
if lower.endswith(".heif"):
return key[: -len(".heif")] + ".jpg"
return key + ".jpg"