How mmbarrys/laterite_comparator works
This is a laterite grade-control comparator: a user captures a material image, the backend matches it against comparator samples, adjusts the ranking using geology, and returns sample details for presentation. The backend’s analysis handler coordinates image decoding, visual matching, candidate selection, and Supabase lookups. The frontend also contains result, history, and settings screens. Their detailed wiring is not established by the available excerpts, so frontend-to-backend links are marked unverified; some AI implementation files are indexed but unsampled.
Main entry points: main.py Analysis API · similarity.py Visual candidate search · analysis.ts Analysis client · api.ts API client
Components 22
Capture and navigation
- Camera capture
frontend/components/home/camera-preview.tsx - Camera state
frontend/hooks/useCamera.ts - Camera operations
frontend/services/camera.ts - Scan screen
frontend/app/scan/page.tsx
Results and records
- Match result
frontend/app/result/page.tsx - Scan history
frontend/app/history/page.tsx - App settings
frontend/app/settings/page.tsx
Analysis workflow
- Analysis screen
frontend/app/analysis/page.tsx - Analysis client
frontend/services/analysis.ts - API client
frontend/services/api.ts - Analysis API
backend/app/main.py - Analysis request
backend/app/schemas.py - Image decoding
backend/app/image_input.py - Runtime settings
backend/app/config.py
Visual matching
- Visual candidate search
backend/app/ai/similarity.py - Scan preprocessing
backend/app/ai/preprocessing.py - Image features
backend/app/ai/image_features.py - Zone selection
backend/app/ai/zone_selection.py - Geology reranking
backend/app/ai/geology_reranking.py
Sample data
- Supabase REST access
backend/app/supabase_rest.py - Supabase catalog and storage
Other components
- Field user
Connections 18
- Field user → Camera capture: captures image
- Camera state → Camera operations: uses camera operations
frontend/hooks/useCamera.ts - Analysis screen → Analysis client: submits analysis
- Analysis client → API client: uses API client
- API client → Analysis API: sends scan
- Analysis API → Analysis request: accepts request
backend/app/main.py - Analysis API → Runtime settings: loads settings
backend/app/main.py - Analysis API → Image decoding: decodes image
backend/app/main.py - Analysis API → Visual candidate search: finds candidates
backend/app/main.py - Visual candidate search → Scan preprocessing: preprocesses scan
backend/app/ai/similarity.py - Visual candidate search → Image features: extracts features
backend/app/ai/similarity.py - Analysis API → Zone selection: selects zone candidate
backend/app/main.py - Analysis API → Geology reranking: reranks candidates
backend/app/main.py - Analysis API → Supabase REST access: fetches sample data
backend/app/main.py - Supabase REST access → Supabase catalog and storage: reads catalog; signs image URLs
backend/app/supabase_rest.py - Analysis API → Match result: returns match payload
- Field user → Scan history: views prior scans
- Field user → App settings: opens preferences