How yash-anpat/predictive-maintenance-platform works
The product is a predictive equipment-maintenance platform. Its main workflow registers equipment, ingests telemetry, runs a failure prediction from the latest telemetry, persists the result, and presents prediction history and explanations alongside maintenance records. The graph includes the documented React pages and API capabilities; unsampled modules are represented only where the tree and README establish their role. Arrows are limited to relationships shown by excerpts, SOURCE INDEX references, or README statements.
Main entry points: prediction.py Prediction routes · main.py FastAPI app · equipment.py Equipment records · telemetry.py Telemetry routes
Components 25
React dashboard
- Dashboard pages
frontend/src/pages - API client
frontend/src/api/client.js
REST API
- FastAPI app
backend/app/main.py - Equipment routes
backend/app/api/equipment.py - Telemetry routes
backend/app/api/telemetry.py - Prediction routes
backend/app/api/prediction.py - Maintenance routes
backend/app/api/maintenance.py
Equipment operations
- Equipment records
backend/app/crud/equipment.py - Telemetry operations
backend/app/services/telemetry_service.py - Maintenance operations
backend/app/services/maintenance_service.py - Risk policy
backend/app/services/risk_policy.py - Prediction records
backend/app/crud/prediction.py - Maintenance records
backend/app/crud/maintenance.py
Prediction and explainability
- Feature contract
backend/app/ml/feature_engineering.py - Model loader
backend/app/ml/model_loader.py - Failure inference
backend/app/ml/predict.py - SHAP explanations
backend/app/ml/explainability.py
Persistence
- PostgreSQL
backend/app/database/database.py - Equipment model
backend/app/models/equipment.py - Telemetry records
backend/app/crud/telemetry.py - Telemetry model
backend/app/models/telemetry.py - Prediction model
backend/app/models/prediction.py - Maintenance model
backend/app/models/maintenance.py
Other components
- Platform user
- Telemetry simulator
tools/telemetry_simulator.py
Connections 33
- Platform user → Dashboard pages: uses
- Dashboard pages → API client: requests data
frontend/src/pages/Predictions.jsx - API client → FastAPI app: calls REST
- FastAPI app → Equipment routes: registers routes
backend/app/main.py - FastAPI app → Telemetry routes: registers routes
backend/app/main.py - FastAPI app → Prediction routes: registers routes
backend/app/main.py - FastAPI app → Maintenance routes: registers routes
backend/app/main.py - Equipment routes → Equipment records: calls
backend/app/api/equipment.py - Telemetry routes → Telemetry records: calls
backend/app/api/telemetry.py - Telemetry routes → Telemetry operations: delegates
backend/app/api/telemetry.py - Prediction routes → Equipment records: validates equipment
backend/app/api/prediction.py - Prediction routes → Telemetry records: loads telemetry
backend/app/api/prediction.py - Prediction routes → Failure inference: runs inference
backend/app/api/prediction.py - Prediction routes → Prediction records: saves predictions
backend/app/api/prediction.py - Prediction routes → SHAP explanations: requests explanations
backend/app/api/prediction.py - Maintenance routes → Maintenance records: calls
backend/app/api/maintenance.py - Failure inference → Feature contract: transforms telemetry
backend/app/ml/predict.py - Failure inference → Model loader: uses model
backend/app/ml/predict.py - SHAP explanations → Feature contract: builds features
backend/app/ml/explainability.py - SHAP explanations → Model loader: uses model
backend/app/ml/explainability.py - Telemetry operations → Telemetry records: reads and writes
backend/app/services/telemetry_service.py - Telemetry operations → Equipment records: checks equipment
backend/app/services/telemetry_service.py - Maintenance operations → Maintenance records: uses records
backend/app/services/maintenance_service.py - Maintenance operations → Equipment records: checks equipment
backend/app/services/maintenance_service.py - Equipment records → Equipment model: queries
backend/app/crud/equipment.py - Telemetry records → Telemetry model: queries
backend/app/crud/telemetry.py - Prediction records → Prediction model: queries
backend/app/crud/prediction.py - Maintenance records → Maintenance model: queries
backend/app/crud/maintenance.py - Equipment model → PostgreSQL: persists in
- Telemetry model → PostgreSQL: persists in
- Prediction model → PostgreSQL: persists in
- Maintenance model → PostgreSQL: persists in
- Telemetry simulator → Telemetry routes: submits telemetry