How numerotec/delegate_photo_auto_crop works
This Flask application manages conference delegate photos: an operator selects a conference, processes its delegate images into passport-style crops, reviews or edits results, and uploads approved images to S3 while updating delegate records. Separate routes provide dashboards, logs, previews, and record updates; per-conference state keeps processing and upload jobs isolated. The sampled files and source index support the main processing and upload links; several route implementations were not sampled, so their internal behavior is represented only where indexed references support it.
Main entry points: app.py Flask app · database.py Database access · dashboard.py Conference dashboard · state.py Conference state
Components 21
Web application
- Flask app
app.py - Conference dashboard
routes/dashboard.py - Photo review
routes/photos.py - Preview route
routes/preview.py - Processing logs
routes/logs.py - Delegate updates
routes/update.py - Processing routes
routes/processing.py - Dashboard and photo views
templates/dashboard.html
Photo workflow
- Conference lookup
services/conference_service.py - Photo service
services/photo_service.py - Face detection
services/face_detector.py - Passport cropping
services/crop_service.py
State and persistence
- Conference state
routes/state.py - Configuration
config.py - Database access
db/database.py
Photo delivery
- S3 upload routes
routes/s3_upload.py - S3 service
services/s3_service.py
Other components
- Operator
- MySQL
- Amazon S3
- Photo source
Connections 37
- Operator → Flask app: uses
app.py - Flask app → Conference dashboard: registers
app.py - Flask app → Processing routes: registers
app.py - Flask app → Preview route: registers
app.py - Flask app → Delegate updates: registers
app.py - Flask app → Photo review: registers
app.py - Flask app → Processing logs: registers
app.py - Flask app → S3 upload routes: registers
app.py - Conference dashboard → Dashboard and photo views: renders
routes/dashboard.py - Conference dashboard → Conference lookup: loads conferences
routes/dashboard.py - Conference dashboard → Photo service: fetches delegates
routes/dashboard.py - Conference dashboard → Face detection: detects faces
routes/dashboard.py - Conference dashboard → Passport cropping: generates crops
routes/dashboard.py - Conference dashboard → Conference state: tracks jobs
routes/dashboard.py - Photo source → Photo service: downloads originals
services/photo_service.py - Photo service → Database access: queries delegates
services/photo_service.py - Conference lookup → Database access: queries conferences
services/conference_service.py - Database access → Configuration: reads settings
db/database.py - Database access → MySQL: opens connection
db/database.py - Processing routes → Photo service: uses photo service
routes/processing.py - Processing routes → Face detection: detects faces
routes/processing.py - Processing routes → Passport cropping: generates crops
routes/processing.py - Processing routes → Conference state: tracks jobs
routes/processing.py - Passport cropping → Configuration: reads crop settings
services/crop_service.py - Passport cropping → Face detection: uses detection
services/crop_service.py - Photo review → Conference state: reads photo state
routes/photos.py - Photo review → Database access: accesses records
routes/photos.py - Photo review → Photo service: builds photo URLs
routes/photos.py - Preview route → Conference state: loads preview data
routes/preview.py - Processing logs → Conference state: reads job state
routes/logs.py - Processing logs → Database access: accesses records
routes/logs.py - Delegate updates → Conference state: updates job state
routes/update.py - Delegate updates → Database access: updates records
routes/update.py - S3 upload routes → Conference state: tracks uploads
routes/s3_upload.py - S3 upload routes → S3 service: uploads photos
routes/s3_upload.py - S3 upload routes → Database access: updates delegate records
routes/s3_upload.py - S3 service → Amazon S3: transfers objects
services/s3_service.py