# ssakthipraveen6/iosph architecture

> Architecture diagram of the GitHub repository ssakthipraveen6/iosph, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ssakthipraveen6/iosph
- Repository: https://github.com/ssakthipraveen6/iosph

## Overview

Sentinel is an SRE operations and observability web application. Operators use the dashboard to inspect health, telemetry, logs, entity relationships, analytics, configuration, and remediation; the backend serves APIs that collect and normalize signals, persist operational state, and provide analysis. The graph emphasizes documented runtime links and README-independent evidence in the supplied excerpts and source index. Several major UI and service capabilities are represented by their exact tree paths, but their internal wiring is not inferred where source was unsampled.

Main entry points: [`sentinel-webdesign/backend/server.js`](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/server.js) (HTTP API server), [`sentinel-webdesign/frontend/src/App.jsx`](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/App.jsx) (Dashboard shell), [`sentinel-webdesign/database/event_store.js`](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/event_store.js) (Event store), [`sentinel-webdesign/metrics_collection/collector_coordinator.js`](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/metrics_collection/collector_coordinator.js) (Metrics coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator console"]
  node_app["Dashboard shell<br/>[App.jsx]"]
  node_healthui["Health views<br/>[HealthOverview.jsx]"]
  node_metricsui["Metrics analytics<br/>[MetricsDetail.jsx]"]
  node_correlationui["Entity exploration"]
  node_adminui["Admin management"]
  node_yamlui["YAML manager"]
  node_sreui["SRE command center<br/>[CommandCenter.jsx]"]
  node_opsui["Pipeline operations"]
end

subgraph group_api["API and access"]
  node_server["HTTP API server<br/>[server.js]"]
  node_auth["LDAP sessions<br/>[ldap_client.js]"]
  node_config["Config services<br/>[yaml_config.js]"]
end

subgraph group_ingest["Signal collection"]
  node_collect["Metrics coordinator"]
  node_collectors["Real and simulated collectors"]
  node_logs["Log normalization<br/>[log_parser.js]"]
end

subgraph group_domain["Operations services"]
  node_inventory[("Entity inventory<br/>[store.js]")]
  node_resolver["Entity resolution<br/>[entity_resolver.js]"]
  node_analysis["AI and RCA"]
  node_correlation["Event correlation<br/>[index.js]"]
  node_health["Health calculation"]
  node_remediation["Recovery actions<br/>[recovery.js]"]
  node_expiry["Expiry radar<br/>[expiryEngine.js]"]
end

subgraph group_storage["Persistence"]
  node_db["Metric data access<br/>[db.js]"]
  node_postgres[("PostgreSQL<br/>[postgres.js]")]
  node_events[("Event store<br/>[event_store.js]")]
  node_logsstore[("Log store<br/>[log_store.js]")]
end

node_operator(("SRE operator"))
node_external{{"Telemetry sources"}}

node_operator -->|"uses"| node_app
node_app -->|"renders"| node_healthui
node_app -->|"renders"| node_metricsui
node_app -->|"renders"| node_correlationui
node_app -->|"renders"| node_adminui
node_app -->|"renders"| node_yamlui
node_app -->|"renders"| node_sreui
node_operator -.->|"requests APIs"| node_server
node_server -->|"authenticates"| node_auth
node_server -->|"coordinates collection"| node_collect
node_server -->|"calculates health"| node_health
node_server -->|"dispatches actions"| node_remediation
node_server -->|"routes analysis"| node_analysis
node_server -.->|"routes correlation"| node_correlation
node_server -->|"queries entities"| node_inventory
node_server -->|"serves config"| node_config
node_server -->|"parses logs"| node_logs
node_server -->|"reads and writes"| node_db
node_collect -.->|"dispatches collection"| node_collectors
node_external -.->|"provides signals"| node_collectors
node_collect -.->|"polls sources"| node_external
node_resolver -->|"resolves entities"| node_inventory
node_analysis -->|"reads events"| node_events
node_correlation -->|"reads events"| node_events
node_expiry -.->|"emits events"| node_events
node_logs -->|"normalizes for storage"| node_logsstore
node_db -->|"persists metrics"| node_postgres
node_events -->|"persists events"| node_postgres
node_auth -.->|"authenticates identity"| node_operator

click node_app "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/App.jsx"
click node_healthui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/health/HealthOverview.jsx"
click node_metricsui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/analytics/MetricsDetail.jsx"
click node_correlationui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/correlation/EntityExplorerView.jsx"
click node_adminui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/admin/AdminManagement.jsx"
click node_yamlui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/admin/YamlConfigManager.jsx"
click node_sreui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/sre/CommandCenter.jsx"
click node_opsui "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/ops/PipelineOpsView.jsx"
click node_server "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/server.js"
click node_auth "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/auth/ldap_client.js"
click node_config "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/config/yaml_config.js"
click node_collect "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/metrics_collection/collector_coordinator.js"
click node_collectors "https://github.com/ssakthipraveen6/iosph/tree/main/sentinel-webdesign/metrics_collection"
click node_logs "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/logs_collection/parser/log_parser.js"
click node_inventory "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/inventory/store.js"
click node_resolver "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/inventory/entity_resolver.js"
click node_analysis "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/ai_analysis/rca_analytics_engine.js"
click node_correlation "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/correlation/index.js"
click node_health "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/services/health/healthCalculator.js"
click node_remediation "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/remediation/recovery.js"
click node_expiry "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/config/expiryEngine.js"
click node_db "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/db.js"
click node_postgres "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/postgres.js"
click node_events "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/event_store.js"
click node_logsstore "https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/log_store.js"

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_app,node_healthui,node_metricsui,node_correlationui,node_adminui,node_yamlui,node_sreui,node_opsui toneBlue
class node_server,node_auth,node_config toneAmber
class node_collect,node_collectors,node_logs toneMint
class node_inventory,node_resolver,node_analysis,node_correlation,node_health,node_remediation,node_expiry toneRose
class node_db,node_postgres,node_events,node_logsstore,node_operator,node_external toneIndigo
```

## Components

### Operator console

- [Dashboard shell](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/App.jsx): `sentinel-webdesign/frontend/src/App.jsx`
- [Health views](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/health/HealthOverview.jsx): `sentinel-webdesign/frontend/src/components/health/HealthOverview.jsx`
- [Metrics analytics](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/analytics/MetricsDetail.jsx): `sentinel-webdesign/frontend/src/components/analytics/MetricsDetail.jsx`
- [Entity exploration](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/correlation/EntityExplorerView.jsx): `sentinel-webdesign/frontend/src/components/correlation/EntityExplorerView.jsx`
- [Admin management](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/admin/AdminManagement.jsx): `sentinel-webdesign/frontend/src/components/admin/AdminManagement.jsx`
- [YAML manager](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/admin/YamlConfigManager.jsx): `sentinel-webdesign/frontend/src/components/admin/YamlConfigManager.jsx`
- [SRE command center](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/sre/CommandCenter.jsx): `sentinel-webdesign/frontend/src/components/sre/CommandCenter.jsx`
- [Pipeline operations](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/frontend/src/components/ops/PipelineOpsView.jsx): `sentinel-webdesign/frontend/src/components/ops/PipelineOpsView.jsx`

### API and access

- [HTTP API server](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/server.js): `sentinel-webdesign/backend/server.js`
- [LDAP sessions](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/auth/ldap_client.js): `sentinel-webdesign/backend/auth/ldap_client.js`
- [Config services](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/config/yaml_config.js): `sentinel-webdesign/backend/config/yaml_config.js`

### Signal collection

- [Metrics coordinator](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/metrics_collection/collector_coordinator.js): `sentinel-webdesign/metrics_collection/collector_coordinator.js`
- [Real and simulated collectors](https://github.com/ssakthipraveen6/iosph/tree/main/sentinel-webdesign/metrics_collection): `sentinel-webdesign/metrics_collection`
- [Log normalization](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/logs_collection/parser/log_parser.js): `sentinel-webdesign/logs_collection/parser/log_parser.js`

### Operations services

- [Entity inventory](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/inventory/store.js): `sentinel-webdesign/inventory/store.js`
- [Entity resolution](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/inventory/entity_resolver.js): `sentinel-webdesign/inventory/entity_resolver.js`
- [AI and RCA](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/ai_analysis/rca_analytics_engine.js): `sentinel-webdesign/ai_analysis/rca_analytics_engine.js`
- [Event correlation](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/correlation/index.js): `sentinel-webdesign/correlation/index.js`
- [Health calculation](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/services/health/healthCalculator.js): `sentinel-webdesign/backend/services/health/healthCalculator.js`
- [Recovery actions](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/remediation/recovery.js): `sentinel-webdesign/remediation/recovery.js`
- [Expiry radar](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/backend/config/expiryEngine.js): `sentinel-webdesign/backend/config/expiryEngine.js`

### Persistence

- [Metric data access](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/db.js): `sentinel-webdesign/database/db.js`
- [PostgreSQL](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/postgres.js): `sentinel-webdesign/database/postgres.js`
- [Event store](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/event_store.js): `sentinel-webdesign/database/event_store.js`
- [Log store](https://github.com/ssakthipraveen6/iosph/blob/main/sentinel-webdesign/database/log_store.js): `sentinel-webdesign/database/log_store.js`

### Other components

- **SRE operator**
- **Telemetry sources**

## Connections

- SRE operator → Dashboard shell: uses (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → Health views: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → Metrics analytics: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → Entity exploration: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → Admin management: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → YAML manager: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- Dashboard shell → SRE command center: renders (evidence: `sentinel-webdesign/frontend/src/App.jsx`)
- SRE operator → HTTP API server: requests APIs
- HTTP API server → LDAP sessions: authenticates (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Metrics coordinator: coordinates collection (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Health calculation: calculates health (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Recovery actions: dispatches actions (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → AI and RCA: routes analysis (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Event correlation: routes correlation
- HTTP API server → Entity inventory: queries entities (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Config services: serves config (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Log normalization: parses logs (evidence: `sentinel-webdesign/backend/server.js`)
- HTTP API server → Metric data access: reads and writes (evidence: `sentinel-webdesign/backend/server.js`)
- Metrics coordinator → Real and simulated collectors: dispatches collection (evidence: `sentinel-webdesign/metrics_collection/collector_coordinator.js`)
- Telemetry sources → Real and simulated collectors: provides signals
- Metrics coordinator → Telemetry sources: polls sources
- Entity resolution → Entity inventory: resolves entities (evidence: `sentinel-webdesign/inventory/sources/yaml_source.js`)
- AI and RCA → Event store: reads events (evidence: `sentinel-webdesign/ai_analysis/rca_analytics_engine.js`)
- Event correlation → Event store: reads events (evidence: `sentinel-webdesign/correlation/index.js`)
- Expiry radar → Event store: emits events (evidence: `sentinel-webdesign/backend/config/expiryEngine.js`)
- Log normalization → Log store: normalizes for storage (evidence: `sentinel-webdesign/database/log_store.js`)
- Metric data access → PostgreSQL: persists metrics (evidence: `sentinel-webdesign/database/db.js`)
- Event store → PostgreSQL: persists events (evidence: `sentinel-webdesign/database/event_store.js`)
- LDAP sessions → SRE operator: authenticates identity
