How shahir-47/grab-pic works
GrabPic lets event hosts create albums and upload photos, then lets guests use a shared link and selfie to find matching photos. The documented flow queues uploaded photos for face processing; guest searches return matching photo IDs, which the API turns into signed viewing URLs. The graph retains the major album-management, upload, access-control, face-processing, search and download capabilities. Several backend and frontend integrations are documented in the README but their implementation was not sampled, so those edges cite the README.
Main entry points: AlbumController.java Album endpoints · api.ts API client · page.tsx Guest search · S3StorageService.java Storage URL service
Components 25
Web application
- Next.js app
grab-pic-web/app/page.tsx - Host albums
grab-pic-web/app/dashboard/page.tsx - Album management
grab-pic-web/app/dashboard/albums/[id]/page.tsx - Album viewing
grab-pic-web/app/dashboard/albums/[id]/view/page.tsx - Guest search
grab-pic-web/app/albums/[id]/guest/page.tsx - Sign-in and signup
grab-pic-web/app/login/page.tsx - API client
grab-pic-web/lib/api.ts - ZIP download
grab-pic-web/lib/download.ts
Album API
- Album endpoints
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Album repository
api/src/main/java/com/grabpic/api/repository/SharedAlbumRepository.java - Photo repository
api/src/main/java/com/grabpic/api/repository/PhotoRepository.java - Album and photo models
api/src/main/java/com/grabpic/api/model/SharedAlbum.java - Storage URL service
api/src/main/java/com/grabpic/api/service/S3StorageService.java - Processing queue client
api/src/main/java/com/grabpic/api/service/SqsService.java - Captcha verification
api/src/main/java/com/grabpic/api/service/TurnstileService.java
Face processing
- Face worker
ai-face-worker/main.py - Selfie search API
ai-face-worker/api.py
External services
- Supabase Auth
- PostgreSQL and pgvector
- AWS S3
- AWS SQS
- Cloudflare Turnstile
- CloudFront
Other components
- Album host
- Album guest
Connections 30
- Album host → Next.js app: opens app
README.md - Album guest → Guest search: opens shared link
README.md - Album host → Sign-in and signup: signs in
README.md - Sign-in and signup → Supabase Auth: authenticates
README.md - Album host → Host albums: manages albums
README.md - Host albums → API client: requests albums
- Album management → API client: manages photos
- Album viewing → API client: loads photos
- Guest search → API client: searches album
- Guest search → ZIP download: downloads matches
- API client → Album endpoints: proxies API calls
README.md - Album endpoints → Album repository: reads and writes
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Album endpoints → Photo repository: reads and writes
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Album repository → PostgreSQL and pgvector: persists albums
README.md - Photo repository → PostgreSQL and pgvector: persists photos
README.md - Album endpoints → Storage URL service: signs upload and view URLs
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Storage URL service → AWS S3: presigns and manages objects
api/src/main/java/com/grabpic/api/service/S3StorageService.java - Storage URL service → CloudFront: signs view URLs
api/src/main/java/com/grabpic/api/service/S3StorageService.java - Album endpoints → Processing queue client: queues photo jobs
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Processing queue client → AWS SQS: sends jobs
api/src/main/java/com/grabpic/api/service/SqsService.java - AWS SQS → Face worker: delivers jobs
README.md - Face worker → AWS S3: downloads photos
README.md - Face worker → PostgreSQL and pgvector: stores face embeddings
README.md - Guest search → Selfie search API: submits selfie
README.md - Selfie search API → PostgreSQL and pgvector: queries face matches
README.md - Album endpoints → Selfie search API: routes search calls
README.md - Album endpoints → Captcha verification: checks captcha
api/src/main/java/com/grabpic/api/controller/AlbumController.java - Captcha verification → Cloudflare Turnstile: verifies token
api/src/main/java/com/grabpic/api/service/TurnstileService.java - Album endpoints → Supabase Auth: validates JWT
README.md - Album endpoints → Album and photo models: maps album and photo data
api/src/main/java/com/grabpic/api/controller/AlbumController.java