# elevenpaths/foca architecture

> Architecture diagram of the GitHub repository elevenpaths/foca, 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/elevenpaths/foca
- Repository: https://github.com/elevenpaths/foca

## Overview

FOCA is a Windows desktop reconnaissance and document-metadata analysis tool. A user works in a project, searches public web sources for documents, and analyzes discovered or local files; FOCA also supports DNS enumeration, host fingerprinting, technology recognition, and HTTP mapping. Results are organized as project data and persisted through controllers to SQL Server. The graph combines README-described capabilities with relationships visible in the supplied source index and excerpts; some capability details are documented but their runtime wiring was not sampled.

Main entry points: [`FOCA/FormMain.cs`](https://github.com/elevenpaths/foca/blob/master/FOCA/FormMain.cs) (FOCA interface), [`FOCA/Database/Entities/Data.cs`](https://github.com/elevenpaths/foca/blob/master/FOCA/Database/Entities/Data.cs) (Project data), [`SearcherCore/SearcherCore/Searcher/Searcher.cs`](https://github.com/elevenpaths/foca/blob/master/SearcherCore/SearcherCore/Searcher/Searcher.cs) (Web search), [`FOCA/Database/FocaContextDb.cs`](https://github.com/elevenpaths/foca/blob/master/FOCA/Database/FocaContextDb.cs) (Database context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop workflow"]
  node_desktop["FOCA interface<br/>[FormMain.cs]"]
  node_project["Project management<br/>[ProjectManager.cs]"]
  node_plugins["Plugin integration"]
end

subgraph group_search["Document discovery"]
  node_searcher["Web search<br/>[Searcher.cs]"]
  node_engines["Search engines"]
end

subgraph group_recon["Organization reconnaissance"]
  node_dns["DNS enumeration<br/>[DNSUtil.cs]"]
  node_dnsengines["DNS search panels"]
  node_fingerprinting["Service fingerprinting<br/>[FingerPrinting.cs]"]
  node_httpmap["HTTP mapping<br/>[HttpMap.cs]"]
  node_technology["Technology analysis"]
  node_shodan["Shodan search<br/>[ShodanSearcher.cs]"]
end

subgraph group_metadata["Document analysis"]
  node_extractor["Document extraction"]
  node_metadataanalysis["Metadata analysis"]
  node_localfiles["Local file input"]
end

subgraph group_state["Project data"]
  node_data["Project data<br/>[Data.cs]"]
  node_entities["Domain entities"]
  node_controllers["Data controllers"]
  node_context["Database context<br/>[FocaContextDb.cs]"]
end

node_user(("Analyst"))
node_sql[("SQL Server")]

node_user -->|"uses"| node_desktop
node_desktop -->|"starts searches"| node_searcher
node_searcher -.->|"dispatches searches"| node_engines
node_searcher -->|"finds documents for analysis"| node_extractor
node_user -->|"adds files"| node_localfiles
node_localfiles -.->|"submits files"| node_extractor
node_extractor -.->|"extracts metadata"| node_metadataanalysis
node_desktop -->|"starts fingerprinting"| node_fingerprinting
node_desktop -->|"starts searches"| node_shodan
node_data -->|"uses DNS utilities"| node_dns
node_data -->|"uses fingerprinting"| node_fingerprinting
node_desktop -->|"manages projects"| node_project
node_project -->|"loads project data"| node_controllers
node_controllers -->|"queries and saves"| node_context
node_context -->|"maps records"| node_entities
node_context -->|"connects to"| node_sql
node_desktop -->|"manages plugins"| node_plugins
node_data -->|"organizes project results"| node_entities
node_dnsengines -.->|"supports enumeration"| node_dns
node_httpmap -.->|"analyzes technology"| node_technology

click node_desktop "https://github.com/elevenpaths/foca/blob/master/FOCA/FormMain.cs"
click node_project "https://github.com/elevenpaths/foca/blob/master/FOCA/ProjectManager.cs"
click node_searcher "https://github.com/elevenpaths/foca/blob/master/SearcherCore/SearcherCore/Searcher/Searcher.cs"
click node_engines "https://github.com/elevenpaths/foca/tree/master/SearcherCore/SearcherCore/Searcher"
click node_extractor "https://github.com/elevenpaths/foca/blob/master/MetadataExtractCore/Metadata/DocumentExtractor.cs"
click node_metadataanalysis "https://github.com/elevenpaths/foca/tree/master/MetadataExtractCore/Analysis"
click node_localfiles "https://github.com/elevenpaths/foca/blob/master/FOCA/FormDocumentsSearch.cs"
click node_dns "https://github.com/elevenpaths/foca/blob/master/FOCA/DNSEnumeration/DNSUtil.cs"
click node_dnsengines "https://github.com/elevenpaths/foca/tree/master/FOCA/DNSEnumeration"
click node_fingerprinting "https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/FingerPrinting/FingerPrinting.cs"
click node_httpmap "https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/HttpMap/HttpMap.cs"
click node_technology "https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/Technology/TechnologyAnalysis.cs"
click node_shodan "https://github.com/elevenpaths/foca/blob/master/SearcherCore/SearcherCore/Searcher/ShodanSearcher.cs"
click node_data "https://github.com/elevenpaths/foca/blob/master/FOCA/Database/Entities/Data.cs"
click node_entities "https://github.com/elevenpaths/foca/tree/master/FOCA/Database/Entities"
click node_controllers "https://github.com/elevenpaths/foca/tree/master/FOCA/Database/Controllers"
click node_context "https://github.com/elevenpaths/foca/blob/master/FOCA/Database/FocaContextDb.cs"
click node_plugins "https://github.com/elevenpaths/foca/blob/master/FOCA/Plugins/ManagePluginCalls.cs"

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_desktop,node_project,node_plugins toneBlue
class node_searcher,node_engines,node_sql toneAmber
class node_dns,node_dnsengines,node_fingerprinting,node_httpmap,node_technology,node_shodan toneMint
class node_extractor,node_metadataanalysis,node_localfiles toneRose
class node_data,node_entities,node_controllers,node_context,node_user toneIndigo
```

## Components

### Desktop workflow

- [FOCA interface](https://github.com/elevenpaths/foca/blob/master/FOCA/FormMain.cs): `FOCA/FormMain.cs`
- [Project management](https://github.com/elevenpaths/foca/blob/master/FOCA/ProjectManager.cs): `FOCA/ProjectManager.cs`
- [Plugin integration](https://github.com/elevenpaths/foca/blob/master/FOCA/Plugins/ManagePluginCalls.cs): `FOCA/Plugins/ManagePluginCalls.cs`

### Document discovery

- [Web search](https://github.com/elevenpaths/foca/blob/master/SearcherCore/SearcherCore/Searcher/Searcher.cs): `SearcherCore/SearcherCore/Searcher/Searcher.cs`
- [Search engines](https://github.com/elevenpaths/foca/tree/master/SearcherCore/SearcherCore/Searcher): `SearcherCore/SearcherCore/Searcher`

### Organization reconnaissance

- [DNS enumeration](https://github.com/elevenpaths/foca/blob/master/FOCA/DNSEnumeration/DNSUtil.cs): `FOCA/DNSEnumeration/DNSUtil.cs`
- [DNS search panels](https://github.com/elevenpaths/foca/tree/master/FOCA/DNSEnumeration): `FOCA/DNSEnumeration`
- [Service fingerprinting](https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/FingerPrinting/FingerPrinting.cs): `FOCA/Analysis/FingerPrinting/FingerPrinting.cs`
- [HTTP mapping](https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/HttpMap/HttpMap.cs): `FOCA/Analysis/HttpMap/HttpMap.cs`
- [Technology analysis](https://github.com/elevenpaths/foca/blob/master/FOCA/Analysis/Technology/TechnologyAnalysis.cs): `FOCA/Analysis/Technology/TechnologyAnalysis.cs`
- [Shodan search](https://github.com/elevenpaths/foca/blob/master/SearcherCore/SearcherCore/Searcher/ShodanSearcher.cs): `SearcherCore/SearcherCore/Searcher/ShodanSearcher.cs`

### Document analysis

- [Document extraction](https://github.com/elevenpaths/foca/blob/master/MetadataExtractCore/Metadata/DocumentExtractor.cs): `MetadataExtractCore/Metadata/DocumentExtractor.cs`
- [Metadata analysis](https://github.com/elevenpaths/foca/tree/master/MetadataExtractCore/Analysis): `MetadataExtractCore/Analysis`
- [Local file input](https://github.com/elevenpaths/foca/blob/master/FOCA/FormDocumentsSearch.cs): `FOCA/FormDocumentsSearch.cs`

### Project data

- [Project data](https://github.com/elevenpaths/foca/blob/master/FOCA/Database/Entities/Data.cs): `FOCA/Database/Entities/Data.cs`
- [Domain entities](https://github.com/elevenpaths/foca/tree/master/FOCA/Database/Entities): `FOCA/Database/Entities`
- [Data controllers](https://github.com/elevenpaths/foca/tree/master/FOCA/Database/Controllers): `FOCA/Database/Controllers`
- [Database context](https://github.com/elevenpaths/foca/blob/master/FOCA/Database/FocaContextDb.cs): `FOCA/Database/FocaContextDb.cs`

### Other components

- **Analyst**
- **SQL Server**

## Connections

- Analyst → FOCA interface: uses
- FOCA interface → Web search: starts searches (evidence: `FOCA/FormMain.cs`)
- Web search → Search engines: dispatches searches (evidence: `SearcherCore/SearcherCore/Searcher/Searcher.cs`)
- Web search → Document extraction: finds documents for analysis
- Analyst → Local file input: adds files
- Local file input → Document extraction: submits files
- Document extraction → Metadata analysis: extracts metadata
- FOCA interface → Service fingerprinting: starts fingerprinting (evidence: `FOCA/FormMain.cs`)
- FOCA interface → Shodan search: starts searches (evidence: `FOCA/FormMain.cs`)
- Project data → DNS enumeration: uses DNS utilities (evidence: `FOCA/Database/Entities/Data.cs`)
- Project data → Service fingerprinting: uses fingerprinting (evidence: `FOCA/Database/Entities/Data.cs`)
- FOCA interface → Project management: manages projects (evidence: `FOCA/FormMain.cs`)
- Project management → Data controllers: loads project data (evidence: `FOCA/ProjectManager.cs`)
- Data controllers → Database context: queries and saves (evidence: `FOCA/Database/Controllers/FilesController.cs`)
- Database context → Domain entities: maps records (evidence: `FOCA/Database/FocaContextDb.cs`)
- Database context → SQL Server: connects to (evidence: `FOCA/Database/FocaContextDb.cs`)
- FOCA interface → Plugin integration: manages plugins (evidence: `FOCA/FormMain.cs`)
- Project data → Domain entities: organizes project results (evidence: `FOCA/Database/Entities/Data.cs`)
- DNS search panels → DNS enumeration: supports enumeration
- HTTP mapping → Technology analysis: analyzes technology
