How the-pixel-pushers/ctp-project works
PhotoCull is a photo-quality culling application: the backend accepts batches of image uploads, validates and prepares each image, runs blur and exposure analysis, and returns per-image results. The frontend currently presents upload and gallery experiences backed by mock data; the sampled sources do not show it calling the API, so no frontend-to-backend connection is asserted. The backend entry point, processing path, shared image preparation, analyzer implementations, and mock-driven gallery are evidenced; several backend routes and analyzer modules are indexed but unsampled.
Main entry points: processing.py Batch processing · base.py Analyzer contract · overexposure/analyzer.py Overexposure analysis · underexposure/analyzer.py Underexposure analysis
Components 22
PhotoCull interface
- App and navigation
frontend/src/App.tsx - Upload interface
frontend/src/components/UploadView.tsx - Gallery and filters
frontend/src/components/GalleryView.tsx - Photo card
frontend/src/components/PhotoCard.tsx - Mock photo data
frontend/src/data/mockData.ts
Analysis service
- FastAPI application
backend/app/main.py - Upload API routes
backend/app/api.py - Runtime settings
backend/app/config.py - Batch processing
backend/app/processing.py - Response schemas
backend/app/schemas.py - Analyzer registry
backend/app/analyzers/registry.py
Image quality analysis
- Image preparation
backend/app/imaging.py - Analyzer contract
backend/app/analyzers/base.py - Blur analysis
backend/app/analyzers/blur/analyzer.py - Blur settings
backend/app/analyzers/blur/settings.py - Luma helpers
backend/app/analyzers/luma.py - Overexposure analysis
backend/app/analyzers/overexposure/analyzer.py - Overexposure settings
backend/app/analyzers/overexposure/settings.py - Underexposure analysis
backend/app/analyzers/underexposure/analyzer.py - Underexposure settings
backend/app/analyzers/underexposure/settings.py
Other components
- Photographer
- API client
Connections 29
- Photographer → App and navigation: uses
frontend/src/App.tsx - App and navigation → Upload interface: renders
frontend/src/App.tsx - App and navigation → Gallery and filters: renders
frontend/src/App.tsx - Gallery and filters → Mock photo data: reads
frontend/src/components/GalleryView.tsx - Gallery and filters → Photo card: renders
frontend/src/components/GalleryView.tsx - Upload interface → Mock photo data: reads
frontend/src/components/UploadView.tsx - API client → FastAPI application: uploads batch
- FastAPI application → Runtime settings: loads
backend/app/main.py - FastAPI application → Analyzer registry: builds
backend/app/main.py - FastAPI application → Upload API routes: mounts
backend/app/main.py - Upload API routes → Batch processing: dispatches
backend/app/api.py - Upload API routes → Runtime settings: reads
backend/app/api.py - Upload API routes → Response schemas: returns
backend/app/api.py - Batch processing → Runtime settings: validates with
backend/app/processing.py - Batch processing → Image preparation: prepares
backend/app/processing.py - Batch processing → Analyzer contract: runs
backend/app/processing.py - Batch processing → Response schemas: builds results
backend/app/processing.py - Analyzer registry → Analyzer contract: registers
backend/app/analyzers/registry.py - Blur analysis → Analyzer contract: implements
backend/app/analyzers/blur/analyzer.py - Blur analysis → Image preparation: analyzes
backend/app/analyzers/blur/analyzer.py - Blur analysis → Blur settings: uses
backend/app/analyzers/blur/analyzer.py - Overexposure analysis → Analyzer contract: implements
backend/app/analyzers/overexposure/analyzer.py - Overexposure analysis → Image preparation: analyzes
backend/app/analyzers/overexposure/analyzer.py - Overexposure analysis → Luma helpers: uses
backend/app/analyzers/overexposure/analyzer.py - Overexposure analysis → Overexposure settings: uses
backend/app/analyzers/overexposure/analyzer.py - Underexposure analysis → Analyzer contract: implements
backend/app/analyzers/underexposure/analyzer.py - Underexposure analysis → Image preparation: analyzes
backend/app/analyzers/underexposure/analyzer.py - Underexposure analysis → Luma helpers: uses
backend/app/analyzers/underexposure/analyzer.py - Underexposure analysis → Underexposure settings: uses
backend/app/analyzers/underexposure/analyzer.py