How luckwoon02/picshare works
PICSHARE lets admins manage protected events and upload photos, then lets guests submit a selfie to find matching event photos. The backend coordinates event/photo processing and guest matching, using SQLite for records, S3 for images and Rekognition for face indexing and search; the frontend provides admin and guest portals. The README documents the product flows, while some implementation excerpts are partial or absent, so uncertain frontend-to-API links are shown as unverified rather than asserted.
Main entry points: main.py FastAPI app · db.py SQLite records · photos.py Photo processing · events.py Event management
Components 20
Web portals
- Admin portal
frontend/src/components/admin-dashboard-client.tsx - Guest portal
frontend/src/components/guest-upload-client.tsx - Guest gallery
frontend/src/components/guest-gallery-client.tsx - Event listing
frontend/src/components/events-list-client.tsx
API workflows
- FastAPI app
backend/app/main.py - Admin authentication
backend/app/api/auth.py - Event management
backend/app/api/events.py - Photo processing
backend/app/api/photos.py - Guest matching
backend/app/api/guests.py
Backend services
- Settings
backend/app/core/config.py - Thumbnail generation
backend/app/services/thumbnail_service.py - Face recognition
backend/app/services/rekognition_service.py - Photo storage service
backend/app/services/s3_service.py
Storage and recovery
- SQLite records
backend/app/services/db.py - Recovery worker
backend/cron_worker.py - Recovery tasks
backend/app/services/recovery.py
Other components
- Admin
- Guest
- AWS S3
- AWS Rekognition
Connections 29
- Admin → Admin portal: manages events
README.md - Guest → Guest portal: submits selfie
README.md - Guest portal → Guest gallery: views matches
README.md - Guest → Event listing: browses events
README.md - Admin portal → FastAPI app: uses API
- Guest portal → FastAPI app: uses API
- Guest gallery → FastAPI app: requests gallery
- Event listing → FastAPI app: requests events
- FastAPI app → Admin authentication: registers router
backend/app/main.py - FastAPI app → Event management: registers router
backend/app/main.py - FastAPI app → Photo processing: registers router
backend/app/main.py - FastAPI app → Guest matching: registers router
backend/app/main.py - FastAPI app → SQLite records: opens connection
backend/app/main.py - Admin authentication → Settings: reads settings
backend/app/api/auth.py - Event management → SQLite records: reads and writes
backend/app/api/events.py - Event management → Face recognition: deletes collection
backend/app/api/events.py - Event management → Photo storage service: checks and deletes storage
backend/app/api/events.py - Photo processing → SQLite records: reads and writes
backend/app/api/photos.py - Photo processing → Photo storage service: stores and serves photos
backend/app/api/photos.py - Photo processing → Face recognition: indexes faces
backend/app/api/photos.py - Photo processing → Thumbnail generation: generates thumbnails
backend/app/api/photos.py - Guest matching → SQLite records: reads and writes
backend/app/api/guests.py - Guest matching → Face recognition: searches selfie
backend/app/api/guests.py - Guest matching → Photo storage service: creates gallery URLs
backend/app/api/guests.py - Photo storage service → AWS S3: uploads and signs URLs
backend/app/services/s3_service.py - Face recognition → AWS Rekognition: indexes and searches faces
backend/app/services/rekognition_service.py - Recovery worker → SQLite records: connects to
backend/cron_worker.py - Recovery worker → Recovery tasks: runs tasks
backend/cron_worker.py - Recovery tasks → SQLite records: repairs records
backend/app/services/recovery.py