Skip to main content

RFC-004: Sharing Options Implementation

Overview​

Technical implementation for softcopy QR code generation and delivery.

Feature Requirements​

Feature: Provide a QR code for users to download the digital softcopy of their pictures.

Details:

  • Softcopy is available when the tenant's subscription/license is active.
  • The booth user does not pay to unlock the download QR.
  • Storage cost is part of the tenant-facing product cost.

Business Model​

Tenant-Paid Access​

  • Tenant pays through subscription or one-time license purchase
  • Softcopy can be included as a plan entitlement
  • All eligible booth sessions can expose the download QR without end-user payment

Cloud Storage Architecture​

Storage Bucket Structure​

photobooth-uploads/
  └── {tenant_id}/
      └── {event_id}/
          └── {timestamp}_{uuid}.jpg

API Endpoints​

MethodEndpointDescription
POST/api/uploadUpload photo to storage
GET/api/download/{photo_id}Generate download URL
POST/api/qr/generateCreate QR code

QR Code Configuration​

interface QRConfig {
  url: string; // Presigned download URL
  size: number; // QR code size in pixels
  errorCorrection: "L" | "M" | "Q" | "H";
  expiresIn: number; // URL expiry in seconds
}

Implementation Phases​

  1. Phase 1: Cloud storage upload integration
  2. Phase 2: Presigned URL generation
  3. Phase 3: QR code rendering
  4. Phase 4: Download page (hosted URL)