How boysabio/muttmetrics works
MuttMetrics is a grooming-duration intelligence product whose current runtime centers on capturing groomer visits, elapsed time, and optional photos; its structured visit and dog history supports duration ranges. The graph follows the documented React-to-FastAPI capture flow and separates visit/client handling, photo processing and storage, and persistence/reference data. The README documents P50/P90 duration ranges, but the sampled source does not show a scoring or reporting implementation, so that capability is represented as a documented, unverified branch rather than an asserted runtime call.
Main entry points: App.tsx Capture SPA · photos.py Photo routes · dogs.py Dog routes · deps.py Auth and DB dependency
Components 24
Visit capture
- Capture SPA
frontend/src/App.tsx - Photo picker
frontend/src/PhotoPicker.tsx
API handling
- FastAPI app
src/muttmetrics/api/app.py - Dog routes
src/muttmetrics/api/routes/dogs.py - Owner routes
src/muttmetrics/api/routes/owners.py - Visit routes
src/muttmetrics/api/routes/visits.py - Dog services
src/muttmetrics/api/services/dogs.py - Owner services
src/muttmetrics/api/services/owners.py - Auth and DB dependency
src/muttmetrics/api/deps.py
Photo handling
- Photo routes
src/muttmetrics/api/routes/photos.py - Image processing
src/muttmetrics/images.py - Photo file storage
src/muttmetrics/storage.py
Persistence and domain
- Owner records
src/muttmetrics/models/owner.py - Dog records
src/muttmetrics/models/dog.py - Visit records
src/muttmetrics/models/visit.py - Photo metadata
src/muttmetrics/models/photo.py - SQLAlchemy sessions
src/muttmetrics/db/session.py - Runtime settings
src/muttmetrics/config.py
Reference data
- Breed reference
src/muttmetrics/models/breed.py - Service reference
src/muttmetrics/models/service.py - Reference seeding
src/muttmetrics/seed/data.py
Other components
- Groomer
- PostgreSQL
- P50/P90 ranges
Connections 30
- Groomer → Capture SPA: captures visits
- Capture SPA → Photo picker: renders
frontend/src/App.tsx - Capture SPA → Dog routes: searches dogs
frontend/src/App.tsx - Capture SPA → Owner routes: creates owners
frontend/src/App.tsx - Capture SPA → Dog routes: creates dogs
frontend/src/App.tsx - Capture SPA → Visit routes: saves visits
frontend/src/App.tsx - Capture SPA → Photo routes: uploads photos
frontend/src/App.tsx - FastAPI app → Dog routes: registers
src/muttmetrics/api/app.py - FastAPI app → Owner routes: registers
src/muttmetrics/api/app.py - FastAPI app → Visit routes: registers
src/muttmetrics/api/app.py - FastAPI app → Photo routes: registers
src/muttmetrics/api/app.py - Dog routes → Auth and DB dependency: uses dependencies
src/muttmetrics/api/routes/dogs.py - Dog routes → Dog services: delegates
src/muttmetrics/api/routes/dogs.py - Owner routes → Auth and DB dependency: uses dependencies
src/muttmetrics/api/routes/owners.py - Owner routes → Owner services: delegates
src/muttmetrics/api/routes/owners.py - Visit routes → Auth and DB dependency: uses dependencies
src/muttmetrics/api/routes/visits.py - Visit routes → Visit records: reads and writes
src/muttmetrics/api/routes/visits.py - Photo routes → Auth and DB dependency: uses dependencies
src/muttmetrics/api/routes/photos.py - Photo routes → Image processing: processes uploads
src/muttmetrics/api/routes/photos.py - Photo routes → Photo file storage: reads and writes bytes
src/muttmetrics/api/routes/photos.py - Photo routes → Photo metadata: reads and writes metadata
src/muttmetrics/api/routes/photos.py - Dog services → Dog records: uses records
src/muttmetrics/api/services/dogs.py - Owner services → Owner records: uses records
src/muttmetrics/api/services/owners.py - Auth and DB dependency → SQLAlchemy sessions: creates sessions
src/muttmetrics/api/deps.py - SQLAlchemy sessions → Runtime settings: gets database URL
src/muttmetrics/db/session.py - SQLAlchemy sessions → PostgreSQL: connects
- Reference seeding → Breed reference: seeds reference
- Reference seeding → Service reference: seeds reference
- Visit records → P50/P90 ranges: provides duration facts
- P50/P90 ranges → Groomer: informs day planning