How saumyatiwariexe/sunpowerodoo works
SunPower is a rooftop-solar installation management platform. Its documented business workflow runs from enquiry and survey through quoting, ordering, dispatch with serial scans, installation proof, warranty, and service; a director dashboard provides oversight. The available backend source implements the FastAPI entry point, user authentication, shared database/security foundations, and product/user models, while the README documents broader workflow capabilities whose implementation is not present in the supplied tree. Links for those documented stages rely on the README; unsampled wiring is not inferred.
Main entry points: router.py Authentication routes · service.py Login service · db.py Database sessions · deps.py Session and role checks
Components 22
User experience
- React interface
frontend
Solar operations
- Enquiry intake
backend/app/modules - Site survey
backend/app/modules - Quote
backend/app/modules - Order
backend/app/modules - Dispatch and serial scans
backend/app/modules - Installation proof
backend/app/modules - Warranty
backend/app/modules - Service tickets
backend/app/modules - Director dashboard
backend/app/modules - Product catalog
backend/app/modules/catalog/models.py
Identity and access
- Authentication routes
backend/app/modules/users/router.py - Login service
backend/app/modules/users/service.py - User records
backend/app/modules/users/models.py - Session and role checks
backend/app/core/deps.py - Token and password security
backend/app/core/security.py
Backend platform
- FastAPI application
backend/app/main.py - Application settings
backend/app/core/config.py - Database sessions
backend/app/core/db.py - Error responses
backend/app/core/errors.py
Other components
- Company staff
- PostgreSQL
Connections 24
- Company staff → React interface: uses
README.md - React interface → FastAPI application: calls API
- FastAPI application → Authentication routes: mounts routes
backend/app/main.py - FastAPI application → Error responses: registers handlers
backend/app/main.py - Company staff → Enquiry intake: starts workflow
README.md - Enquiry intake → Site survey: leads to
README.md - Site survey → Quote: leads to
README.md - Quote → Order: leads to
README.md - Order → Dispatch and serial scans: leads to
README.md - Dispatch and serial scans → Installation proof: leads to
README.md - Installation proof → Warranty: triggers
README.md - Warranty → Service tickets: followed by
README.md - Company staff → Director dashboard: reviews
README.md - Authentication routes → Login service: authenticates
backend/app/modules/users/router.py - Authentication routes → Database sessions: gets session
backend/app/modules/users/router.py - Authentication routes → Token and password security: creates token
backend/app/modules/users/router.py - Login service → User records: loads user
backend/app/modules/users/service.py - Login service → Token and password security: verifies password
backend/app/modules/users/service.py - Session and role checks → Database sessions: gets session
backend/app/core/deps.py - Session and role checks → User records: loads user
backend/app/core/deps.py - Session and role checks → Token and password security: validates token
backend/app/core/deps.py - Database sessions → Application settings: reads settings
backend/app/core/db.py - Database sessions → PostgreSQL: connects
README.md - Login service → Error responses: raises errors
backend/app/modules/users/service.py