How yashoswalyo/picshare works
PICSHARE is an event-photo sharing platform: admins manage events and photo processing, while guests submit a selfie to find a curated gallery. The backend covers event and guest records, Drive photo sync, face indexing and matching, and gallery delivery; a separate worker runs recovery and scheduled jobs. The README documents the user-facing capabilities, while sampled backend excerpts establish several internal calls. Frontend-to-API wiring and unsampled job details are not shown, so those links are omitted.
Main entry points: main.py FastAPI Application · db.py SQLite Database · guests.py Guest Requests and Matches · photos.py Photo Upload and Sync
Components 19
Guest and Admin UI
- Home Experience
frontend/src/components/home-client.tsx - Event Listing
frontend/src/components/events-list-client.tsx - Admin Dashboard
frontend/src/components/admin-dashboard-client.tsx - Guest Selfie Upload
frontend/src/components/guest-upload-client.tsx - Guest Gallery
frontend/src/components/guest-gallery-client.tsx
Backend API
- Admin Authentication
backend/app/api/auth.py - Event Management
backend/app/api/events.py - Photo Upload and Sync
backend/app/api/photos.py - Guest Requests and Matches
backend/app/api/guests.py - FastAPI Application
backend/app/main.py
Photo and Matching Services
- SQLite Database
backend/app/services/db.py - Google Drive Service
backend/app/services/drive_service.py - Face Recognition
backend/app/services/face_service.py - Thumbnail Generation
backend/app/services/thumbnail_service.py
Background Operations
- Cron Worker
backend/cron_worker.py - Recovery Tasks
backend/app/services/recovery.py - Scheduled Jobs
backend/app/services/cron_jobs.py
Other components
- Admin or Guest
- Google Drive
Connections 24
- Admin or Guest → Home Experience: browses
README.md - Admin or Guest → Event Listing: finds events
README.md - Admin or Guest → Admin Dashboard: manages events
README.md - Admin or Guest → Guest Selfie Upload: submits selfie
README.md - Guest Selfie Upload → Guest Gallery: views matches
README.md - FastAPI Application → Admin Authentication: registers route
backend/app/main.py - FastAPI Application → Event Management: registers route
backend/app/main.py - FastAPI Application → Photo Upload and Sync: registers route
backend/app/main.py - FastAPI Application → Guest Requests and Matches: registers route
backend/app/main.py - FastAPI Application → SQLite Database: opens connection
backend/app/main.py - Admin Authentication → FastAPI Application: serves route
backend/app/main.py - Event Management → SQLite Database: reads and writes
backend/app/api/events.py - Photo Upload and Sync → SQLite Database: reads and writes
backend/app/api/photos.py - Photo Upload and Sync → Google Drive Service: syncs and retrieves
backend/app/api/photos.py - Photo Upload and Sync → Thumbnail Generation: generates thumbnails
backend/app/api/photos.py - Guest Requests and Matches → SQLite Database: reads and writes
backend/app/api/guests.py - Guest Requests and Matches → Face Recognition: extracts and compares
backend/app/api/guests.py - Guest Requests and Matches → Google Drive Service: downloads originals
backend/app/api/guests.py - Guest Requests and Matches → Photo Upload and Sync: returns photo URLs
backend/app/api/guests.py - Google Drive Service → Google Drive: syncs files
backend/app/services/drive_service.py - Cron Worker → SQLite Database: opens connection
backend/cron_worker.py - Cron Worker → Recovery Tasks: runs recovery
backend/cron_worker.py - Cron Worker → Scheduled Jobs: starts jobs
backend/cron_worker.py - Recovery Tasks → SQLite Database: accesses records
backend/app/services/recovery.py