# vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system architecture

> Architecture diagram of the GitHub repository vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system
- Repository: https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system

## Overview

FactoryOps AI monitors industrial equipment and supports predictive maintenance: telemetry is collected and stored, processed into model features, and used for failure-risk predictions and health assessment that inform maintenance work. FastAPI exposes management APIs, while the Streamlit console presents fleet, telemetry, incident, prediction, maintenance, and inventory views. The README documents the overall workflow; sampled code confirms API registration, selected service-to-model operations, and frontend data fetching. ML-to-API wiring and several unsampled routes are not verified, so those links are omitted.

Main entry points: [`predictive_maintainance/frontend/app.py`](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/app.py) (Operations dashboard), [`predictive_maintainance/backend/models`](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/models) (Operational records), [`predictive_maintainance/ml/predict.py`](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/predict.py) (Prediction), [`predictive_maintainance/backend/api/main.py`](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/api/main.py) (FastAPI application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Operations console"]
  node_dashboard["Operations dashboard<br/>[app.py]"]
  node_fleet["Fleet explorer<br/>[fleet_explorer.py]"]
  node_telemetry_view["Telemetry lab<br/>[telemetry_lab.py]"]
  node_incident_view["Predictions and incidents"]
  node_maintenance_view["Maintenance and inventory"]
  node_data_view["Data management<br/>[data_management.py]"]
  node_view_utils["View transformations<br/>[utils.py]"]
end

subgraph group_api["API and services"]
  node_api_service["FastAPI application<br/>[main.py]"]
  node_auth["Authentication routes<br/>[auth_routes.py]"]
  node_domain_routes["Domain API routes"]
  node_services["Domain services"]
  node_schemas["Request and response schemas"]
end

subgraph group_data["Operational data"]
  node_db_session["Database sessions<br/>[connection.py]"]
  node_sqlite[("SQLite database<br/>[connection.py]")]
  node_domain_models["Operational records"]
end

subgraph group_ml["Predictive analytics"]
  node_feature_engineering["Telemetry features<br/>[features.py]"]
  node_model["Failure classifier<br/>[model.py]"]
  node_training["Model training<br/>[train_model.py]"]
  node_prediction["Prediction<br/>[predict.py]"]
  node_evaluation["Model evaluation<br/>[evaluate.py]"]
end

node_operator(("Plant operator"))
node_sensor_input(("Machine sensors"))

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"requests data"| node_api_service
node_dashboard -.->|"renders"| node_fleet
node_dashboard -.->|"renders"| node_telemetry_view
node_dashboard -.->|"renders"| node_incident_view
node_dashboard -.->|"renders"| node_maintenance_view
node_dashboard -.->|"renders"| node_data_view
node_fleet -->|"uses"| node_view_utils
node_incident_view -->|"uses"| node_view_utils
node_data_view -->|"uses"| node_view_utils
node_api_service -->|"registers"| node_domain_routes
node_api_service -->|"registers"| node_auth
node_domain_routes -->|"delegates to"| node_services
node_domain_routes -->|"uses"| node_schemas
node_services -->|"queries and updates"| node_domain_models
node_services -->|"uses"| node_schemas
node_api_service -->|"creates tables"| node_db_session
node_db_session -->|"connects"| node_sqlite
node_sensor_input -.->|"provides telemetry"| node_domain_models
node_domain_models -.->|"supplies telemetry"| node_feature_engineering
node_feature_engineering -->|"prepares inputs"| node_model
node_training -->|"builds training data"| node_feature_engineering
node_training -->|"trains"| node_model
node_training -->|"evaluates"| node_evaluation
node_prediction -->|"prepares inputs"| node_feature_engineering
node_prediction -->|"uses"| node_model
node_prediction -.->|"produces risk records"| node_domain_models
node_domain_models -.->|"informs decisions"| node_maintenance_view
node_prediction -.->|"informs health view"| node_dashboard

click node_dashboard "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/app.py"
click node_fleet "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/fleet_explorer.py"
click node_telemetry_view "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/telemetry_lab.py"
click node_incident_view "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/predictions_incidents.py"
click node_maintenance_view "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/maintenance_inventory.py"
click node_data_view "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/data_management.py"
click node_view_utils "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/utils.py"
click node_api_service "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/api/main.py"
click node_auth "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/api/routers/auth_routes.py"
click node_domain_routes "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/api/routers"
click node_services "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/services"
click node_schemas "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/schemas"
click node_db_session "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/database/connection.py"
click node_sqlite "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/database/connection.py"
click node_domain_models "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/models"
click node_feature_engineering "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/features.py"
click node_model "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/model.py"
click node_training "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/train_model.py"
click node_prediction "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/predict.py"
click node_evaluation "https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/evaluate.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_fleet,node_telemetry_view,node_incident_view,node_maintenance_view,node_data_view,node_view_utils toneBlue
class node_api_service,node_auth,node_domain_routes,node_services,node_schemas toneAmber
class node_db_session,node_sqlite,node_domain_models toneMint
class node_feature_engineering,node_model,node_training,node_prediction,node_evaluation toneRose
class node_operator,node_sensor_input toneIndigo
```

## Components

### Operations console

- [Operations dashboard](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/app.py): `predictive_maintainance/frontend/app.py`
- [Fleet explorer](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/fleet_explorer.py): `predictive_maintainance/frontend/fleet_explorer.py`
- [Telemetry lab](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/telemetry_lab.py): `predictive_maintainance/frontend/telemetry_lab.py`
- [Predictions and incidents](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/predictions_incidents.py): `predictive_maintainance/frontend/predictions_incidents.py`
- [Maintenance and inventory](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/maintenance_inventory.py): `predictive_maintainance/frontend/maintenance_inventory.py`
- [Data management](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/data_management.py): `predictive_maintainance/frontend/data_management.py`
- [View transformations](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/frontend/utils.py): `predictive_maintainance/frontend/utils.py`

### API and services

- [FastAPI application](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/api/main.py): `predictive_maintainance/backend/api/main.py`
- [Authentication routes](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/api/routers/auth_routes.py): `predictive_maintainance/backend/api/routers/auth_routes.py`
- [Domain API routes](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/api/routers): `predictive_maintainance/backend/api/routers`
- [Domain services](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/services): `predictive_maintainance/backend/services`
- [Request and response schemas](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/schemas): `predictive_maintainance/backend/schemas`

### Operational data

- [Database sessions](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/database/connection.py): `predictive_maintainance/backend/database/connection.py`
- [SQLite database](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/backend/database/connection.py): `predictive_maintainance/backend/database/connection.py`
- [Operational records](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/tree/main/predictive_maintainance/backend/models): `predictive_maintainance/backend/models`

### Predictive analytics

- [Telemetry features](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/features.py): `predictive_maintainance/ml/features.py`
- [Failure classifier](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/model.py): `predictive_maintainance/ml/model.py`
- [Model training](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/train_model.py): `predictive_maintainance/ml/train_model.py`
- [Prediction](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/predict.py): `predictive_maintainance/ml/predict.py`
- [Model evaluation](https://github.com/vaishnavi791/ai-based-industrial-maintenance-and-process-optimization-system/blob/main/predictive_maintainance/ml/evaluate.py): `predictive_maintainance/ml/evaluate.py`

### Other components

- **Plant operator**
- **Machine sensors**

## Connections

- Plant operator → Operations dashboard: uses (evidence: `predictive_maintainance/frontend/app.py`)
- Operations dashboard → FastAPI application: requests data (evidence: `predictive_maintainance/frontend/app.py`)
- Operations dashboard → Fleet explorer: renders (evidence: `predictive_maintainance/frontend/fleet_explorer.py`)
- Operations dashboard → Telemetry lab: renders
- Operations dashboard → Predictions and incidents: renders
- Operations dashboard → Maintenance and inventory: renders
- Operations dashboard → Data management: renders
- Fleet explorer → View transformations: uses (evidence: `predictive_maintainance/frontend/fleet_explorer.py`)
- Predictions and incidents → View transformations: uses (evidence: `predictive_maintainance/frontend/predictions_incidents.py`)
- Data management → View transformations: uses (evidence: `predictive_maintainance/frontend/data_management.py`)
- FastAPI application → Domain API routes: registers (evidence: `predictive_maintainance/backend/api/main.py`)
- FastAPI application → Authentication routes: registers (evidence: `predictive_maintainance/backend/api/main.py`)
- Domain API routes → Domain services: delegates to (evidence: `predictive_maintainance/backend/api/routers/machine.py`)
- Domain API routes → Request and response schemas: uses (evidence: `predictive_maintainance/backend/api/routers/machine.py`)
- Domain services → Operational records: queries and updates (evidence: `predictive_maintainance/backend/services/machine_service.py`)
- Domain services → Request and response schemas: uses (evidence: `predictive_maintainance/backend/services/maintenance_service.py`)
- FastAPI application → Database sessions: creates tables (evidence: `predictive_maintainance/backend/api/main.py`)
- Database sessions → SQLite database: connects (evidence: `predictive_maintainance/backend/database/connection.py`)
- Machine sensors → Operational records: provides telemetry (evidence: `README.md`)
- Operational records → Telemetry features: supplies telemetry (evidence: `README.md`)
- Telemetry features → Failure classifier: prepares inputs (evidence: `predictive_maintainance/ml/model.py`)
- Model training → Telemetry features: builds training data (evidence: `predictive_maintainance/ml/train_model.py`)
- Model training → Failure classifier: trains (evidence: `predictive_maintainance/ml/train_model.py`)
- Model training → Model evaluation: evaluates (evidence: `predictive_maintainance/ml/train_model.py`)
- Prediction → Telemetry features: prepares inputs (evidence: `predictive_maintainance/ml/predict.py`)
- Prediction → Failure classifier: uses (evidence: `predictive_maintainance/ml/predict.py`)
- Prediction → Operational records: produces risk records (evidence: `README.md`)
- Operational records → Maintenance and inventory: informs decisions (evidence: `README.md`)
- Prediction → Operations dashboard: informs health view (evidence: `README.md`)
