How nealsz/smartbuild works
SmartBuild turns budget, workload, cooling and display preferences into compatible PC recommendations, or supports a guided component-by-component build. The result experience compares value and performance alternatives, supports swaps and reservations; staff manage tickets and inventory. The graph follows documented routes and sampled import/call references. Several frontend-to-API links and unsampled feature internals are based on the README rather than inspected implementation details.
Main entry points: recommender.py Quick recommender · main.py FastAPI routes · builder_service.py Guided build service · supabase_service.py Component catalog
Components 23
Build experience
- PC builder
client/src/app/page.tsx - Preference intake
client/src/app/user-input/page.tsx - Guided assembly
client/src/app/guided-builder/page.tsx - Build comparison
client/src/app/build-result/page.tsx - Reservation form
client/src/app/build-result/StoreTicketModal.tsx - Admin portal
client/src/app/admin/page.tsx - Inventory manager
client/src/app/admin/AdminTable.tsx - Ticket manager
client/src/app/admin/TicketsTable.tsx
API orchestration
- FastAPI routes
backend/main.py - Input validation
backend/schemas/user_input.py - Admin routes
backend/routers/admin.py - Ticket routes
backend/routers/tickets.py
Recommendation engine
- Quick recommender
backend/services/recommender.py - Guided build service
backend/services/builder_service.py - Component selector
backend/services/selector.py - Compatibility rules
backend/services/compatibility.py - Workload classifier
backend/services/intent_classifier.py
Model and data
- Model training v4
backend/model/train_model_v4.py - Model training v3
backend/model/train_model_v3.py - Hardware weights
backend/config.py - Component catalog
backend/services/supabase_service.py
Other components
- PC builder user
- Store staff
Connections 34
- PC builder user → PC builder: starts
README.md - PC builder → Preference intake: enters preferences
README.md - PC builder user → Guided assembly: chooses guided build
README.md - Preference intake → FastAPI routes: submits build request
README.md - Guided assembly → FastAPI routes: requests options
README.md - Guided assembly → FastAPI routes: finalizes selection
README.md - FastAPI routes → Input validation: validates
backend/main.py - FastAPI routes → Quick recommender: generates build
backend/main.py - FastAPI routes → Guided build service: gets options
backend/main.py - FastAPI routes → Guided build service: finalizes build
backend/main.py - Quick recommender → Workload classifier: classifies workload
backend/services/recommender.py - Quick recommender → Component selector: selects components
backend/services/recommender.py - Quick recommender → Compatibility rules: checks build
backend/services/recommender.py - Guided build service → Compatibility rules: validates compatibility
backend/services/builder_service.py - Guided build service → Quick recommender: uses recommendation logic
backend/services/builder_service.py - Quick recommender → Model training v4: uses model logic
backend/services/recommender.py - Component selector → Compatibility rules: checks candidates
backend/services/selector.py - Quick recommender → Component catalog: loads components
backend/services/recommender.py - Guided build service → Component catalog: uses catalog data
- Build comparison → Reservation form: opens reservation
client/src/app/build-result/page.tsx - Build comparison → FastAPI routes: requests build
README.md - Reservation form → Ticket routes: creates ticket
README.md - Store staff → Admin portal: manages store
README.md - Admin portal → Inventory manager: opens inventory
client/src/app/admin/page.tsx - Admin portal → Ticket manager: opens tickets
client/src/app/admin/page.tsx - Inventory manager → Admin routes: manages components
README.md - Ticket manager → Ticket routes: manages reservations
README.md - Admin routes → Component catalog: reads and updates
backend/routers/admin.py - Ticket routes → Component catalog: adjusts stock
backend/routers/tickets.py - Model training v4 → Component catalog: loads training data
backend/model/train_model_v4.py - Model training v3 → Component catalog: loads training data
backend/model/train_model_v3.py - Quick recommender → Hardware weights: uses hardware weights
backend/services/recommender.py - Guided build service → Hardware weights: uses budget shares
backend/services/builder_service.py - Compatibility rules → Hardware weights: uses compatibility settings
backend/services/compatibility.py