How thilakarathnamtm/pss-backend works
This repository is a FastAPI backend for factory energy-cost management and machine scheduling. The visible workflow is user signup/login, authenticated factory and machine data access, then schedule optimization against tariffs, with optimization, dashboard, and report endpoints supporting results. The graph separates API dispatch, domain endpoints, persistence models, and internal services. The README provides no capability details, so feature coverage is based on the endpoint and module names in the source index; several endpoint implementations were not excerpted, so their links reflect indexed references only.
Main entry points: optimization.py Optimization endpoints · api.py API router · auth.py Authentication · dashboard.py Dashboard endpoints
Components 24
API and access
- Application
app/main.py - API router
app/api/v1/api.py - Authentication
app/api/v1/endpoints/auth.py
Factory operations
- Factory endpoints
app/api/v1/endpoints/factories.py - Machine endpoints
app/api/v1/endpoints/machines.py - Tariff endpoints
app/api/v1/endpoints/tariffs.py - Optimization endpoints
app/api/v1/endpoints/optimization.py - Dashboard endpoints
app/api/v1/endpoints/dashboard.py - Report endpoints
app/api/v1/endpoints/reports.py - API schemas
app/schemas
Persistence
- Factory model
app/models/factory.py - Machine model
app/models/machine.py - Tariff model
app/models/tariff.py - Optimization models
app/models/optimization.py - Report model
app/models/report.py - User model
app/models/user.py
Optimization services
- Schedule optimizer
app/services/optimizer.py - Cost calculations
app/services/cost.py
Runtime infrastructure
- Request dependencies
app/core/deps.py - Token security
app/core/security.py - Configuration
app/core/config.py - Database session
app/db/session.py - ORM base
app/db/base.py
Other components
- API client
Connections 48
- API client → Application: sends requests
- Application → API router: mounts routes
app/main.py - API router → Authentication: registers
app/api/v1/api.py - API router → Factory endpoints: registers
app/api/v1/api.py - API router → Machine endpoints: registers
app/api/v1/api.py - API router → Tariff endpoints: registers
app/api/v1/api.py - API router → Optimization endpoints: registers
app/api/v1/api.py - API router → Dashboard endpoints: registers
app/api/v1/api.py - API router → Report endpoints: registers
app/api/v1/api.py - Authentication → Request dependencies: uses
app/api/v1/endpoints/auth.py - Authentication → Token security: uses
app/api/v1/endpoints/auth.py - Authentication → User model: queries
app/api/v1/endpoints/auth.py - Authentication → Factory model: creates
app/api/v1/endpoints/auth.py - Authentication → API schemas: validates with
app/api/v1/endpoints/auth.py - Factory endpoints → User model: references
app/api/v1/endpoints/factories.py - Factory endpoints → Factory model: uses
app/api/v1/endpoints/factories.py - Factory endpoints → API schemas: validates with
app/api/v1/endpoints/factories.py - Machine endpoints → User model: references
app/api/v1/endpoints/machines.py - Machine endpoints → Machine model: uses
app/api/v1/endpoints/machines.py - Machine endpoints → API schemas: validates with
app/api/v1/endpoints/machines.py - Tariff endpoints → Tariff model: uses
app/api/v1/endpoints/tariffs.py - Tariff endpoints → API schemas: validates with
app/api/v1/endpoints/tariffs.py - Optimization endpoints → Request dependencies: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → Factory model: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → Machine model: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → Tariff model: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → Schedule optimizer: calls
app/api/v1/endpoints/optimization.py - Optimization endpoints → Optimization models: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → Report model: uses
app/api/v1/endpoints/optimization.py - Optimization endpoints → API schemas: validates with
app/api/v1/endpoints/optimization.py - Dashboard endpoints → User model: uses
app/api/v1/endpoints/dashboard.py - Dashboard endpoints → Factory model: uses
app/api/v1/endpoints/dashboard.py - Dashboard endpoints → Machine model: uses
app/api/v1/endpoints/dashboard.py - Dashboard endpoints → Optimization models: uses
app/api/v1/endpoints/dashboard.py - Dashboard endpoints → API schemas: returns
app/api/v1/endpoints/dashboard.py - Report endpoints → User model: references
app/api/v1/endpoints/reports.py - Report endpoints → Report model: uses
app/api/v1/endpoints/reports.py - Report endpoints → API schemas: validates with
app/api/v1/endpoints/reports.py - Request dependencies → Database session: opens session
app/core/deps.py - Request dependencies → Token security: decodes token
app/core/deps.py - Request dependencies → User model: loads user
app/core/deps.py - Token security → Configuration: reads settings
app/core/security.py - Database session → Configuration: reads settings
app/db/session.py - Schedule optimizer → Machine model: reads inputs
app/services/optimizer.py - Schedule optimizer → Tariff model: reads inputs
app/services/optimizer.py - Cost calculations → Machine model: references
app/services/cost.py - Cost calculations → Tariff model: references
app/services/cost.py - Factory model → ORM base: inherits
app/models/factory.py