# prithvisb08/secorchestrator-or-enterprise-security-sast-platform- architecture

> Architecture diagram of the GitHub repository prithvisb08/secorchestrator-or-enterprise-security-sast-platform-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-
- Repository: https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-

## Overview

SecOrchestrator scans repositories through API, CLI, and worker entry points, then aggregates findings, assesses risk, and exposes reports or remediation. The graph preserves the README’s SAST, taint/dataflow, supply-chain, CI/VCS, sandbox, and observability capabilities. Several subsystems are represented from the README and source tree without claiming their unsampled internal wiring; dashed, uncited links mark those documented but unverified integrations.

Main entry points: [`src/security_platform/analysis/orchestrator.py`](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/analysis/orchestrator.py) (Scan orchestrator), [`src/security_platform/api/app.py`](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/api/app.py) (FastAPI service), [`src/security_platform/cli.py`](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/cli.py) (CLI scanner), [`src/security_platform/dataflow/engine.py`](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/dataflow/engine.py) (Taint analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Scan entry points"]
  node_api["FastAPI service<br/>[app.py]"]
  node_cli["CLI scanner<br/>[cli.py]"]
  node_worker["Scan worker<br/>[worker.py]"]
end

subgraph group_analysis["Analysis pipeline"]
  node_snapshot["Repository snapshot<br/>[snapshot.py]"]
  node_orchestrator["Scan orchestrator<br/>[orchestrator.py]"]
  node_dataflow["Taint analysis<br/>[engine.py]"]
  node_sast["SAST rules<br/>[engine.py]"]
  node_code_context["Code context<br/>[context.py]"]
  node_external_engines["Scanner adapters"]
  node_sca["Dependency analysis"]
  node_config_scan["Configuration analysis<br/>[config_analyzer.py]"]
end

subgraph group_domain["Findings and risk"]
  node_finding["Finding model<br/>[finding.py]"]
  node_dedupe["Finding deduplication<br/>[dedupe.py]"]
  node_risk["Risk assessment<br/>[engine.py]"]
  node_triage["Finding triage<br/>[triage.py]"]
end

subgraph group_delivery["Results and integrations"]
  node_reporting["Report export<br/>[exporter.py]"]
  node_sbom["CycloneDX export<br/>[cyclonedx.py]"]
  node_remediation["Auto-remediation<br/>[engine.py]"]
  node_vcs["VCS providers"]
  node_cicd["CI security gate<br/>[gate.py]"]
  node_notifications["Notifications<br/>[dispatcher.py]"]
end

subgraph group_operations["Runtime operations"]
  node_scan_store[("Scan result store<br/>[repository.py]")]
  node_sandbox["Worker sandbox<br/>[sandbox.py]"]
  node_telemetry["Metrics and tracing<br/>[metrics.py]"]
  node_logging["Structured logging<br/>[logging.py]"]
  node_version["Version metadata<br/>[version.py]"]
end

node_developer(("Developer / CI"))

node_developer -->|"submits scans"| node_api
node_developer -->|"runs scans"| node_cli
node_api -->|"runs scan"| node_orchestrator
node_cli -->|"runs scan"| node_orchestrator
node_worker -->|"runs scan"| node_orchestrator
node_api -->|"saves results"| node_scan_store
node_api -->|"routes webhooks"| node_vcs
node_orchestrator -->|"builds snapshot"| node_snapshot
node_orchestrator -->|"runs analysis"| node_dataflow
node_orchestrator -->|"scans manifests"| node_sca
node_orchestrator -->|"analyzes config"| node_config_scan
node_orchestrator -->|"dispatches scans"| node_external_engines
node_orchestrator -.->|"runs rules"| node_sast
node_sast -->|"analyzes context"| node_code_context
node_code_context -->|"reads snapshot"| node_snapshot
node_orchestrator -->|"deduplicates findings"| node_dedupe
node_dataflow -->|"creates findings"| node_finding
node_orchestrator -->|"calculates risk"| node_risk
node_orchestrator -.->|"aggregates findings"| node_finding
node_orchestrator -.->|"exports results"| node_reporting
node_reporting -.->|"offers CycloneDX"| node_sbom
node_orchestrator -.->|"supports fixes"| node_remediation
node_developer -.->|"gates builds"| node_cicd
node_vcs -.->|"publishes findings"| node_cicd
node_orchestrator -.->|"runs isolated"| node_sandbox
node_orchestrator -.->|"notifies results"| node_notifications
node_api -.->|"exposes metrics"| node_telemetry
node_orchestrator -->|"logs activity"| node_logging
node_orchestrator -->|"gets version"| node_version

click node_api "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/api/app.py"
click node_cli "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/cli.py"
click node_worker "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/workers/worker.py"
click node_snapshot "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/ingestion/snapshot.py"
click node_orchestrator "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/analysis/orchestrator.py"
click node_dataflow "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/dataflow/engine.py"
click node_sast "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/sast/engine.py"
click node_code_context "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/intelligence/context.py"
click node_external_engines "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/tree/main/src/security_platform/engines/adapters"
click node_sca "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/engines/dependency_analyzer.py"
click node_config_scan "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/engines/config_analyzer.py"
click node_finding "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/models/finding.py"
click node_dedupe "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/analysis/dedupe.py"
click node_risk "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/risk/engine.py"
click node_triage "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/domain/triage.py"
click node_reporting "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/reporting/exporter.py"
click node_sbom "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/reporting/cyclonedx.py"
click node_remediation "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/remediation/engine.py"
click node_vcs "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/tree/main/src/security_platform/integrations/vcs"
click node_cicd "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/cicd/gate.py"
click node_notifications "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/integrations/notifications/dispatcher.py"
click node_scan_store "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/persistence/repository.py"
click node_sandbox "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/workers/sandbox.py"
click node_telemetry "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/telemetry/metrics.py"
click node_logging "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/core/logging.py"
click node_version "https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/core/version.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_api,node_cli,node_worker toneBlue
class node_snapshot,node_orchestrator,node_dataflow,node_sast,node_code_context,node_external_engines,node_sca,node_config_scan toneAmber
class node_finding,node_dedupe,node_risk,node_triage toneMint
class node_reporting,node_sbom,node_remediation,node_vcs,node_cicd,node_notifications toneRose
class node_scan_store,node_sandbox,node_telemetry,node_logging,node_version,node_developer toneIndigo
```

## Components

### Scan entry points

- [FastAPI service](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/api/app.py): `src/security_platform/api/app.py`
- [CLI scanner](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/cli.py): `src/security_platform/cli.py`
- [Scan worker](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/workers/worker.py): `src/security_platform/workers/worker.py`

### Analysis pipeline

- [Repository snapshot](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/ingestion/snapshot.py): `src/security_platform/ingestion/snapshot.py`
- [Scan orchestrator](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/analysis/orchestrator.py): `src/security_platform/analysis/orchestrator.py`
- [Taint analysis](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/dataflow/engine.py): `src/security_platform/dataflow/engine.py`
- [SAST rules](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/sast/engine.py): `src/security_platform/sast/engine.py`
- [Code context](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/intelligence/context.py): `src/security_platform/intelligence/context.py`
- [Scanner adapters](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/tree/main/src/security_platform/engines/adapters): `src/security_platform/engines/adapters`
- [Dependency analysis](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/engines/dependency_analyzer.py): `src/security_platform/engines/dependency_analyzer.py`
- [Configuration analysis](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/engines/config_analyzer.py): `src/security_platform/engines/config_analyzer.py`

### Findings and risk

- [Finding model](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/models/finding.py): `src/security_platform/models/finding.py`
- [Finding deduplication](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/analysis/dedupe.py): `src/security_platform/analysis/dedupe.py`
- [Risk assessment](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/risk/engine.py): `src/security_platform/risk/engine.py`
- [Finding triage](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/domain/triage.py): `src/security_platform/domain/triage.py`

### Results and integrations

- [Report export](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/reporting/exporter.py): `src/security_platform/reporting/exporter.py`
- [CycloneDX export](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/reporting/cyclonedx.py): `src/security_platform/reporting/cyclonedx.py`
- [Auto-remediation](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/remediation/engine.py): `src/security_platform/remediation/engine.py`
- [VCS providers](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/tree/main/src/security_platform/integrations/vcs): `src/security_platform/integrations/vcs`
- [CI security gate](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/cicd/gate.py): `src/security_platform/cicd/gate.py`
- [Notifications](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/integrations/notifications/dispatcher.py): `src/security_platform/integrations/notifications/dispatcher.py`

### Runtime operations

- [Scan result store](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/persistence/repository.py): `src/security_platform/persistence/repository.py`
- [Worker sandbox](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/workers/sandbox.py): `src/security_platform/workers/sandbox.py`
- [Metrics and tracing](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/telemetry/metrics.py): `src/security_platform/telemetry/metrics.py`
- [Structured logging](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/core/logging.py): `src/security_platform/core/logging.py`
- [Version metadata](https://github.com/prithvisb08/secorchestrator-or-enterprise-security-sast-platform-/blob/main/src/security_platform/core/version.py): `src/security_platform/core/version.py`

### Other components

- **Developer / CI**

## Connections

- Developer / CI → FastAPI service: submits scans (evidence: `README.md`)
- Developer / CI → CLI scanner: runs scans (evidence: `README.md`)
- FastAPI service → Scan orchestrator: runs scan (evidence: `src/security_platform/api/app.py`)
- CLI scanner → Scan orchestrator: runs scan (evidence: `src/security_platform/cli.py`)
- Scan worker → Scan orchestrator: runs scan (evidence: `src/security_platform/workers/worker.py`)
- FastAPI service → Scan result store: saves results (evidence: `src/security_platform/api/app.py`)
- FastAPI service → VCS providers: routes webhooks
- Scan orchestrator → Repository snapshot: builds snapshot (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Taint analysis: runs analysis (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Dependency analysis: scans manifests (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Configuration analysis: analyzes config (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Scanner adapters: dispatches scans (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → SAST rules: runs rules (evidence: `src/security_platform/analysis/orchestrator.py`)
- SAST rules → Code context: analyzes context (evidence: `src/security_platform/sast/engine.py`)
- Code context → Repository snapshot: reads snapshot (evidence: `src/security_platform/intelligence/context.py`)
- Scan orchestrator → Finding deduplication: deduplicates findings (evidence: `src/security_platform/analysis/orchestrator.py`)
- Taint analysis → Finding model: creates findings (evidence: `src/security_platform/dataflow/engine.py`)
- Scan orchestrator → Risk assessment: calculates risk (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Finding model: aggregates findings (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Report export: exports results
- Report export → CycloneDX export: offers CycloneDX
- Scan orchestrator → Auto-remediation: supports fixes
- Developer / CI → CI security gate: gates builds (evidence: `README.md`)
- VCS providers → CI security gate: publishes findings (evidence: `README.md`)
- Scan orchestrator → Worker sandbox: runs isolated (evidence: `README.md`)
- Scan orchestrator → Notifications: notifies results (evidence: `README.md`)
- FastAPI service → Metrics and tracing: exposes metrics (evidence: `README.md`)
- Scan orchestrator → Structured logging: logs activity (evidence: `src/security_platform/analysis/orchestrator.py`)
- Scan orchestrator → Version metadata: gets version (evidence: `src/security_platform/analysis/orchestrator.py`)
