# blacksentinel-cibersecurity/blacksentinel-command-free architecture

> Architecture diagram of the GitHub repository blacksentinel-cibersecurity/blacksentinel-command-free, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blacksentinel-cibersecurity/blacksentinel-command-free
- Repository: https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free

## Overview

BlackSentinel Command is an open-source cybersecurity command center. The documented user workflow is to enter the web application and use its dashboard and navigation to reach security-operation workspaces: SOC monitoring, threat intelligence, investigations, infrastructure and its digital twin, compliance, and administration. The repository also contains shared UI, tenant theming and tenant/deployment definitions. The README describes additional capabilities, but some routes it lists (including assets) are absent from this tree; `/ai`, automation, marketplace, and analytics are explicitly excluded. Page excerpts show primarily UI composition, so backend data flows and integrations are not established here.

Main entry points: [`apps/web/components/layout/sidebar.tsx`](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/layout/sidebar.tsx) (Command navigation), [`packages/ds/components/card/index.tsx`](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/components/card/index.tsx) (Design components), [`apps/web/app/dashboard/page.tsx`](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/dashboard/page.tsx) (Executive dashboard), [`apps/web/app/layout.tsx`](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/layout.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Web application<br/>[layout.tsx]"]
  node_navigation["Command navigation<br/>[sidebar.tsx]"]
  node_dashboard["Executive dashboard<br/>[page.tsx]"]
  node_widgets["Dashboard widgets<br/>[widget-system.tsx]"]
end

subgraph group_security["Security operations"]
  node_soc["SOC center<br/>[page.tsx]"]
  node_mitre["MITRE matrix<br/>[mitre-matrix.tsx]"]
  node_threatintel["Threat intelligence<br/>[page.tsx]"]
  node_investigations["Investigations<br/>[page.tsx]"]
  node_infrastructure["Infrastructure command<br/>[page.tsx]"]
  node_digitaltwin["Digital twin<br/>[page.tsx]"]
  node_compliance["Compliance center<br/>[page.tsx]"]
end

subgraph group_platform["Platform services"]
  node_administration["Administration<br/>[page.tsx]"]
  node_authroutes["Authentication endpoints<br/>[route.ts]"]
  node_auth["Authentication library<br/>[index.ts]"]
end

subgraph group_shared["Shared foundations"]
  node_designsystem["Design components<br/>[index.tsx]"]
  node_metriccard["Metric card<br/>[index.tsx]"]
  node_tenanttheme["Tenant theming<br/>[tenant.ts]"]
  node_tenanttypes["Tenant definitions<br/>[tenant.ts]"]
  node_deploymenttypes["Deployment definitions<br/>[deployment.ts]"]
  node_graphengine["Graph engine<br/>[index.ts]"]
  node_aiengine["AI engine<br/>[index.ts]"]
end

node_user(("Security operator"))

node_user -->|"opens"| node_webapp
node_webapp -->|"provides navigation"| node_navigation
node_navigation -->|"navigates to"| node_dashboard
node_navigation -->|"navigates to"| node_soc
node_navigation -->|"navigates to"| node_threatintel
node_navigation -->|"navigates to"| node_investigations
node_navigation -->|"navigates to"| node_infrastructure
node_navigation -->|"navigates to"| node_digitaltwin
node_navigation -->|"navigates to"| node_compliance
node_navigation -->|"navigates to"| node_administration
node_soc -.->|"uses"| node_mitre
node_dashboard -->|"supports customization"| node_widgets
node_dashboard -->|"renders metrics"| node_metriccard
node_compliance -->|"uses components"| node_designsystem
node_threatintel -->|"uses components"| node_designsystem
node_investigations -->|"uses components"| node_designsystem
node_administration -->|"uses components"| node_designsystem
node_tenanttheme -->|"imports definitions"| node_tenanttypes
node_deploymenttypes -->|"imports definitions"| node_tenanttypes
node_authroutes -.->|"may use"| node_auth

click node_webapp "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/layout.tsx"
click node_navigation "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/layout/sidebar.tsx"
click node_dashboard "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/dashboard/page.tsx"
click node_soc "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/operations/soc/page.tsx"
click node_mitre "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/modules/mitre-matrix.tsx"
click node_threatintel "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/threat-intelligence/page.tsx"
click node_investigations "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/investigations/page.tsx"
click node_infrastructure "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/infrastructure/page.tsx"
click node_digitaltwin "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/infrastructure/digital-twin/page.tsx"
click node_compliance "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/compliance/page.tsx"
click node_administration "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/administration/page.tsx"
click node_authroutes "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/api/auth/login/route.ts"
click node_auth "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/lib/auth/index.ts"
click node_widgets "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/widgets/widget-system.tsx"
click node_designsystem "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/components/card/index.tsx"
click node_metriccard "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/components/metric-card/index.tsx"
click node_tenanttheme "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/themes/tenant.ts"
click node_tenanttypes "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/types/tenant.ts"
click node_deploymenttypes "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/types/deployment.ts"
click node_graphengine "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/graph-engine/index.ts"
click node_aiengine "https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ai-engine/index.ts"

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_webapp,node_navigation,node_dashboard,node_widgets toneBlue
class node_soc,node_mitre,node_threatintel,node_investigations,node_infrastructure,node_digitaltwin,node_compliance toneAmber
class node_administration,node_authroutes,node_auth toneMint
class node_designsystem,node_metriccard,node_tenanttheme,node_tenanttypes,node_deploymenttypes,node_graphengine,node_aiengine toneRose
class node_user toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/layout.tsx): `apps/web/app/layout.tsx`
- [Command navigation](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/layout/sidebar.tsx): `apps/web/components/layout/sidebar.tsx`
- [Executive dashboard](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/dashboard/page.tsx): `apps/web/app/dashboard/page.tsx`
- [Dashboard widgets](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/widgets/widget-system.tsx): `apps/web/components/widgets/widget-system.tsx`

### Security operations

- [SOC center](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/operations/soc/page.tsx): `apps/web/app/operations/soc/page.tsx`
- [MITRE matrix](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/components/modules/mitre-matrix.tsx): `apps/web/components/modules/mitre-matrix.tsx`
- [Threat intelligence](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/threat-intelligence/page.tsx): `apps/web/app/threat-intelligence/page.tsx`
- [Investigations](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/investigations/page.tsx): `apps/web/app/investigations/page.tsx`
- [Infrastructure command](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/infrastructure/page.tsx): `apps/web/app/infrastructure/page.tsx`
- [Digital twin](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/infrastructure/digital-twin/page.tsx): `apps/web/app/infrastructure/digital-twin/page.tsx`
- [Compliance center](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/compliance/page.tsx): `apps/web/app/compliance/page.tsx`

### Platform services

- [Administration](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/administration/page.tsx): `apps/web/app/administration/page.tsx`
- [Authentication endpoints](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/app/api/auth/login/route.ts): `apps/web/app/api/auth/login/route.ts`
- [Authentication library](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/apps/web/lib/auth/index.ts): `apps/web/lib/auth/index.ts`

### Shared foundations

- [Design components](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/components/card/index.tsx): `packages/ds/components/card/index.tsx`
- [Metric card](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/components/metric-card/index.tsx): `packages/ds/components/metric-card/index.tsx`
- [Tenant theming](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ds/themes/tenant.ts): `packages/ds/themes/tenant.ts`
- [Tenant definitions](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/types/tenant.ts): `packages/types/tenant.ts`
- [Deployment definitions](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/types/deployment.ts): `packages/types/deployment.ts`
- [Graph engine](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/graph-engine/index.ts): `packages/graph-engine/index.ts`
- [AI engine](https://github.com/blacksentinel-cibersecurity/blacksentinel-command-free/blob/main/packages/ai-engine/index.ts): `packages/ai-engine/index.ts`

### Other components

- **Security operator**

## Connections

- Security operator → Web application: opens
- Web application → Command navigation: provides navigation
- Command navigation → Executive dashboard: navigates to
- Command navigation → SOC center: navigates to
- Command navigation → Threat intelligence: navigates to
- Command navigation → Investigations: navigates to
- Command navigation → Infrastructure command: navigates to
- Command navigation → Digital twin: navigates to
- Command navigation → Compliance center: navigates to
- Command navigation → Administration: navigates to
- SOC center → MITRE matrix: uses
- Executive dashboard → Dashboard widgets: supports customization
- Executive dashboard → Metric card: renders metrics (evidence: `apps/web/app/dashboard/page.tsx`)
- Compliance center → Design components: uses components (evidence: `apps/web/app/compliance/page.tsx`)
- Threat intelligence → Design components: uses components (evidence: `apps/web/app/threat-intelligence/page.tsx`)
- Investigations → Design components: uses components (evidence: `apps/web/app/investigations/page.tsx`)
- Administration → Design components: uses components (evidence: `apps/web/app/administration/page.tsx`)
- Tenant theming → Tenant definitions: imports definitions (evidence: `packages/ds/themes/tenant.ts`)
- Deployment definitions → Tenant definitions: imports definitions (evidence: `packages/types/deployment.ts`)
- Authentication endpoints → Authentication library: may use
