FotoBoo

A production-ready photo booth system built with Go (Clean Architecture) and Vue 3.
FotoBoo enables photo capture, filtering, framing, collage creation, and export for event photo booths, retail stores, and SaaS applications.

• Photo capture via browser camera (1280x720)
• Live preview with CSS filters (grayscale, vintage, brightness, contrast)
• Frame overlays (simple, event, party)
• Photo collage layouts (single, horizontal, vertical, grid, strip, featured)
• Countdown timer + flash animation
• Print-ready export (4x6, 5x7, 6x8, 2x6 strip at 300 DPI)
• QR code generation for instant photo sharing

• RESTful API for photo, session, and device management
• Dual storage backends: Local filesystem or MinIO/S3 object storage
• SQLite database for metadata persistence
• Sessions with device tracking
• Admin dashboard with usage statistics
• Configurable booth settings (countdown, frames, filters, retention)
• Background cleanup of expired photos
• Rate limiting, metrics, health checks
• CORS support for browser clients

• Docker Compose (local, production, MinIO profiles)
• Render Blueprint (free tier)
• Oracle Always Free VM with automatic HTTPS
• GitHub Actions CI/CD

Clean Architecture / Hexagonal Architecture with strict dependency inversion:

domain (entities + interfaces)
   ↑
usecase (business logic)
   ↑
handler (HTTP transport) + repository (persistence)

fotoboo/
├── cmd/api/              # Application entrypoint
├── internal/
│   ├── domain/           # Entities, value objects, repository interfaces
│   ├── usecase/          # Business logic / application services
│   ├── handler/          # HTTP handlers (inbound adapters)
│   ├── repository/       # Data persistence (outbound adapters)
│   ├── middleware/        # HTTP middleware (logging, metrics, rate limiter)
│   └── background/       # Background jobs (photo cleanup)
├── pkg/storage/          # Storage abstraction (local, MinIO)
├── web/                  # Vue 3 frontend SPA
│   ├── src/              # Vue components, stores, composables
│   ├── public/           # Static assets (favicon, manifest, OG image)
│   └── index.html
├── deploy/               # Deployment scripts
├── docs/                 # Documentation
└── test-cases/           # QA test plans and reports

• Go 1.25+
• Node.js 20+ (for frontend build)

# Build the API server
go build -o bin/fotoboo-api ./cmd/api

# Run directly
go run ./cmd/api

# Run with options
STORAGE_PATH=./data/photos PORT=8080 go run ./cmd/api

cd web
npm install
npm run dev          # Vite dev server on :5173, proxies API to :8080

cd web
npm install && npm run build   # Outputs to web/dist/

Full API reference: docs/api.md

# Run all tests
go test ./...

# Run with verbose output
go test ./... -v -count=1

# All 96+ tests pass covering:
# - Domain entities and errors
# - All use cases (photo, session, device, admin)
# - All HTTP handlers (photo, session, device, admin, print, QR)
# - All SQLite repositories (photo, session, device)
# - All middleware (metrics, rate limiter, logger, session limiter)
# - Local storage backend

# Local storage mode
docker compose up -d --build

# MinIO mode
USE_MINIO=true docker compose --profile minio up -d --build

# Production mode (with Caddy reverse proxy)
docker compose --profile prod up -d --build

• Render (Free): Uses render.yaml Blueprint — push to GitHub, deploy in 1 click
• Railway / Fly.io: See PUBLIC_DEPLOYMENT.md
• Oracle Always Free: Full guide at deploy/oracle/README.md
• Quick HTTPS launch:

  bash deploy/oracle/deploy-nipio.sh

MIT