# jaafar-trabelsi/cti-platform architecture

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

- Interactive diagram: https://gitdiagram.com/jaafar-trabelsi/cti-platform
- Repository: https://github.com/jaafar-trabelsi/cti-platform

## Overview

CTI Platform is a local threat-intelligence and OSINT application. Its documented workflow discovers monitoring targets, manages a watchlist, collects raw findings, analyzes and extracts IOCs, classifies severity, and presents alerts and reports through a React dashboard. The README also describes authentication, analytics, and external reputation checks. The tree contains crawler and server directories, an API specification, and a database schema, but no frontend or implementation excerpts; subsystem paths and relationships therefore reflect README documentation, not inspected code.

Main entry points: [`backend/DebianOs_Server`](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server) (REST API Gateway), [`backend/DebianOs_Crawler`](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler) (OSINT Crawlers), [`backend/openapi.json`](https://github.com/jaafar-trabelsi/cti-platform/blob/main/backend/openapi.json) (OpenAPI Specification), [`database/schema.sql`](https://github.com/jaafar-trabelsi/cti-platform/blob/main/database/schema.sql) (Platform Database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Discovery and Collection"]
  node_discovery["Target Discovery"]
  node_watchlist["Watchlist Management"]
  node_sources["OSINT Sources"]
  node_crawler["OSINT Crawlers"]
  node_findings["Raw Findings"]
end

subgraph group_analysis["Threat Analysis"]
  node_intel["Threat Intelligence"]
  node_ioc["IOC Extraction"]
  node_severity["Severity Classification"]
  node_reputation["Reputation Checks"]
end

subgraph group_application["Platform Application"]
  node_alerts["Alerts and Reports"]
  node_api["REST API Gateway"]
  node_auth["JWT Authentication"]
  node_dashboard["React Dashboard"]
  node_api_spec["OpenAPI Specification<br/>[openapi.json]"]
end

subgraph group_persistence["Data Storage"]
  node_database[("Platform Database<br/>[schema.sql]")]
end

node_analyst(("Analyst"))

node_discovery -->|"proposes targets"| node_watchlist
node_watchlist -->|"configures monitoring"| node_crawler
node_sources -->|"provides sources"| node_crawler
node_crawler -->|"collects findings"| node_findings
node_findings -->|"analyzes findings"| node_intel
node_intel -->|"extracts and correlates"| node_ioc
node_ioc -->|"classifies indicators"| node_severity
node_intel -.->|"checks reputation"| node_reputation
node_severity -->|"produces alerts"| node_alerts
node_alerts -->|"presents intelligence"| node_dashboard
node_analyst -->|"uses"| node_dashboard
node_dashboard -.->|"uses gateway"| node_api
node_api -->|"handles authentication"| node_auth
node_api -->|"interacts with"| node_database
node_api_spec -.->|"specifies endpoints"| node_api

click node_discovery "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler"
click node_watchlist "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_crawler "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler"
click node_findings "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler"
click node_intel "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_ioc "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_severity "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_alerts "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_api "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_auth "https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server"
click node_database "https://github.com/jaafar-trabelsi/cti-platform/blob/main/database/schema.sql"
click node_api_spec "https://github.com/jaafar-trabelsi/cti-platform/blob/main/backend/openapi.json"

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_discovery,node_watchlist,node_sources,node_crawler,node_findings toneBlue
class node_intel,node_ioc,node_severity,node_reputation toneAmber
class node_alerts,node_api,node_auth,node_dashboard,node_api_spec toneMint
class node_database toneRose
class node_analyst toneIndigo
```

## Components

### Discovery and Collection

- [Target Discovery](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler): `backend/DebianOs_Crawler`
- [Watchlist Management](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- **OSINT Sources**
- [OSINT Crawlers](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler): `backend/DebianOs_Crawler`
- [Raw Findings](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Crawler): `backend/DebianOs_Crawler`

### Threat Analysis

- [Threat Intelligence](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- [IOC Extraction](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- [Severity Classification](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- **Reputation Checks**

### Platform Application

- [Alerts and Reports](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- [REST API Gateway](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- [JWT Authentication](https://github.com/jaafar-trabelsi/cti-platform/tree/main/backend/DebianOs_Server): `backend/DebianOs_Server`
- **React Dashboard**
- [OpenAPI Specification](https://github.com/jaafar-trabelsi/cti-platform/blob/main/backend/openapi.json): `backend/openapi.json`

### Data Storage

- [Platform Database](https://github.com/jaafar-trabelsi/cti-platform/blob/main/database/schema.sql): `database/schema.sql`

### Other components

- **Analyst**

## Connections

- Target Discovery → Watchlist Management: proposes targets (evidence: `README.md`)
- Watchlist Management → OSINT Crawlers: configures monitoring (evidence: `README.md`)
- OSINT Sources → OSINT Crawlers: provides sources (evidence: `README.md`)
- OSINT Crawlers → Raw Findings: collects findings (evidence: `README.md`)
- Raw Findings → Threat Intelligence: analyzes findings (evidence: `README.md`)
- Threat Intelligence → IOC Extraction: extracts and correlates (evidence: `README.md`)
- IOC Extraction → Severity Classification: classifies indicators (evidence: `README.md`)
- Threat Intelligence → Reputation Checks: checks reputation (evidence: `README.md`)
- Severity Classification → Alerts and Reports: produces alerts (evidence: `README.md`)
- Alerts and Reports → React Dashboard: presents intelligence (evidence: `README.md`)
- Analyst → React Dashboard: uses (evidence: `README.md`)
- React Dashboard → REST API Gateway: uses gateway (evidence: `README.md`)
- REST API Gateway → JWT Authentication: handles authentication (evidence: `README.md`)
- REST API Gateway → Platform Database: interacts with (evidence: `README.md`)
- OpenAPI Specification → REST API Gateway: specifies endpoints
