# darksider70-yep/system_revamp architecture

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

- Interactive diagram: https://gitdiagram.com/darksider70-yep/system_revamp
- Repository: https://github.com/darksider70-yep/system_revamp

## Overview

System Revamp is a system-inventory and security dashboard. The user-facing workflow is to inspect installed applications and driver health, check software versions and binary reputation, then use offline packages, remediation scripts, or attack simulations as needed. The README documents the service topology and capabilities; sampled source confirms key service handlers, scanners, and shared storage/authentication. Some frontend request details and unsampled service internals cannot be verified, so those links rely on README statements or are omitted.

Main entry points: [`frontend/src/App.js`](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/App.js) (Dashboard), [`backend/common/auth.py`](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/auth.py) (Internal Auth and Tickets), [`backend/scanner_service/main.py`](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/scanner_service/main.py) (Inventory and Exports), [`backend/protection_service/main.py`](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/protection_service/main.py) (Binary Protection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard"]
  node_dashboard["Dashboard<br/>[App.js]"]
  node_apps_table["Installed Apps"]
  node_table_columns["App Columns"]
  node_drivers_view["Driver View<br/>[MissingDrivers.jsx]"]
  node_protection_view["Protection View"]
end

subgraph group_inventory["Inventory and Updates"]
  node_scanner_api["Inventory and Exports<br/>[main.py]"]
  node_inventory_scan["Cross-platform Discovery<br/>[scanner.py]"]
  node_version_api["Version Service<br/>[main.py]"]
  node_version_check["Version Drift and Risk<br/>[version_checker.py]"]
  node_attack_stream["Attack Simulation SSE<br/>[simulate_attack.py]"]
end

subgraph group_security["Security and Drivers"]
  node_drivers_api["Driver Diagnostics<br/>[drivers_api.py]"]
  node_protection_api["Binary Protection<br/>[main.py]"]
end

subgraph group_shared["Shared Services"]
  node_auth["Internal Auth and Tickets<br/>[auth.py]"]
  node_redis[("Cache and Rate Limits<br/>[redis_client.py]")]
  node_db[("Application Data Store<br/>[db.py]")]
end

node_admin(("IT user"))
node_system["Local System"]
node_upstream["Version Sources"]
node_virustotal["VirusTotal"]

node_admin -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_apps_table
node_dashboard -->|"renders"| node_drivers_view
node_dashboard -->|"renders"| node_protection_view
node_apps_table -->|"uses"| node_table_columns
node_dashboard -->|"requests inventory and exports"| node_scanner_api
node_dashboard -->|"requests version checks"| node_version_api
node_dashboard -->|"requests diagnostics"| node_drivers_api
node_dashboard -->|"requests protection"| node_protection_api
node_dashboard -->|"starts simulation"| node_attack_stream
node_scanner_api -->|"scans applications"| node_inventory_scan
node_scanner_api -->|"registers routes"| node_attack_stream
node_inventory_scan -->|"queries installed software"| node_system
node_scanner_api -->|"reads and saves snapshots"| node_db
node_version_api -->|"checks versions"| node_version_check
node_version_check -->|"reads version catalog"| node_db
node_version_check -->|"checks live versions"| node_upstream
node_version_check -->|"caches lookups"| node_redis
node_drivers_api -->|"queries and updates devices"| node_system
node_protection_api -->|"queries hash reputation"| node_virustotal
node_protection_api -->|"resolves and verifies binaries"| node_system
node_scanner_api -->|"checks requests"| node_auth
node_version_api -->|"checks requests"| node_auth
node_drivers_api -->|"checks requests"| node_auth
node_protection_api -->|"checks requests"| node_auth
node_attack_stream -->|"issues and consumes tickets"| node_auth
node_auth -->|"stores tickets"| node_redis
node_drivers_api -->|"uses driver history"| node_db
node_protection_api -->|"uses cache and limits"| node_redis

click node_dashboard "https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/App.js"
click node_apps_table "https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/InstalledAppsTable.jsx"
click node_table_columns "https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/InstalledAppsTableColumns.js"
click node_drivers_view "https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/MissingDrivers.jsx"
click node_protection_view "https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/ProtectionCenter.jsx"
click node_scanner_api "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/scanner_service/main.py"
click node_inventory_scan "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/scanner_service/utils/scanner.py"
click node_version_api "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/version_service/main.py"
click node_version_check "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/version_service/utils/version_checker.py"
click node_attack_stream "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/routes/simulate_attack.py"
click node_drivers_api "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/drivers_api.py"
click node_protection_api "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/protection_service/main.py"
click node_auth "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/auth.py"
click node_redis "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/redis_client.py"
click node_db "https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/db.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_apps_table,node_table_columns,node_drivers_view,node_protection_view,node_admin toneBlue
class node_scanner_api,node_inventory_scan,node_version_api,node_version_check,node_attack_stream toneAmber
class node_drivers_api,node_protection_api toneMint
class node_auth,node_redis,node_db toneRose
class node_system,node_upstream,node_virustotal toneIndigo
```

## Components

### Dashboard

- [Dashboard](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/App.js): `frontend/src/App.js`
- [Installed Apps](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/InstalledAppsTable.jsx): `frontend/src/components/InstalledAppsTable.jsx`
- [App Columns](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/InstalledAppsTableColumns.js): `frontend/src/components/InstalledAppsTableColumns.js`
- [Driver View](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/MissingDrivers.jsx): `frontend/src/components/MissingDrivers.jsx`
- [Protection View](https://github.com/darksider70-yep/system_revamp/blob/Version_1/frontend/src/components/ProtectionCenter.jsx): `frontend/src/components/ProtectionCenter.jsx`

### Inventory and Updates

- [Inventory and Exports](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/scanner_service/main.py): `backend/scanner_service/main.py`
- [Cross-platform Discovery](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/scanner_service/utils/scanner.py): `backend/scanner_service/utils/scanner.py`
- [Version Service](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/version_service/main.py): `backend/version_service/main.py`
- [Version Drift and Risk](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/version_service/utils/version_checker.py): `backend/version_service/utils/version_checker.py`
- [Attack Simulation SSE](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/routes/simulate_attack.py): `backend/routes/simulate_attack.py`

### Security and Drivers

- [Driver Diagnostics](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/drivers_api.py): `backend/drivers_api.py`
- [Binary Protection](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/protection_service/main.py): `backend/protection_service/main.py`

### Shared Services

- [Internal Auth and Tickets](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/auth.py): `backend/common/auth.py`
- [Cache and Rate Limits](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/redis_client.py): `backend/common/redis_client.py`
- [Application Data Store](https://github.com/darksider70-yep/system_revamp/blob/Version_1/backend/common/db.py): `backend/common/db.py`

### Other components

- **IT user**
- **Local System**
- **Version Sources**
- **VirusTotal**

## Connections

- IT user → Dashboard: uses (evidence: `README.md`)
- Dashboard → Installed Apps: renders (evidence: `frontend/src/App.js`)
- Dashboard → Driver View: renders (evidence: `frontend/src/App.js`)
- Dashboard → Protection View: renders (evidence: `frontend/src/App.js`)
- Installed Apps → App Columns: uses (evidence: `frontend/src/components/InstalledAppsTable.jsx`)
- Dashboard → Inventory and Exports: requests inventory and exports (evidence: `README.md`)
- Dashboard → Version Service: requests version checks (evidence: `README.md`)
- Dashboard → Driver Diagnostics: requests diagnostics (evidence: `README.md`)
- Dashboard → Binary Protection: requests protection (evidence: `README.md`)
- Dashboard → Attack Simulation SSE: starts simulation (evidence: `README.md`)
- Inventory and Exports → Cross-platform Discovery: scans applications (evidence: `backend/scanner_service/main.py`)
- Inventory and Exports → Attack Simulation SSE: registers routes (evidence: `backend/scanner_service/main.py`)
- Cross-platform Discovery → Local System: queries installed software (evidence: `backend/scanner_service/utils/scanner.py`)
- Inventory and Exports → Application Data Store: reads and saves snapshots (evidence: `backend/scanner_service/main.py`)
- Version Service → Version Drift and Risk: checks versions (evidence: `backend/version_service/main.py`)
- Version Drift and Risk → Application Data Store: reads version catalog (evidence: `backend/version_service/utils/version_checker.py`)
- Version Drift and Risk → Version Sources: checks live versions (evidence: `README.md`)
- Version Drift and Risk → Cache and Rate Limits: caches lookups (evidence: `backend/version_service/utils/version_checker.py`)
- Driver Diagnostics → Local System: queries and updates devices (evidence: `README.md`)
- Binary Protection → VirusTotal: queries hash reputation (evidence: `backend/protection_service/main.py`)
- Binary Protection → Local System: resolves and verifies binaries (evidence: `backend/protection_service/main.py`)
- Inventory and Exports → Internal Auth and Tickets: checks requests (evidence: `backend/scanner_service/main.py`)
- Version Service → Internal Auth and Tickets: checks requests (evidence: `backend/version_service/main.py`)
- Driver Diagnostics → Internal Auth and Tickets: checks requests (evidence: `backend/drivers_api.py`)
- Binary Protection → Internal Auth and Tickets: checks requests (evidence: `backend/protection_service/main.py`)
- Attack Simulation SSE → Internal Auth and Tickets: issues and consumes tickets (evidence: `backend/routes/simulate_attack.py`)
- Internal Auth and Tickets → Cache and Rate Limits: stores tickets (evidence: `backend/common/auth.py`)
- Driver Diagnostics → Application Data Store: uses driver history (evidence: `backend/drivers_api.py`)
- Binary Protection → Cache and Rate Limits: uses cache and limits (evidence: `backend/protection_service/main.py`)