# ravipandit991/digital-footprint-investigator architecture

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

- Interactive diagram: https://gitdiagram.com/ravipandit991/digital-footprint-investigator
- Repository: https://github.com/ravipandit991/digital-footprint-investigator

## Overview

Digital Footprint Investigator is a browser-based OSINT application with a Flask backend. An investigator submits a target or file through the web interface; the backend dispatches a selected reconnaissance or intelligence tool, stores results in a case, extracts entities and suggests follow-up investigations. Case results can then be exported as a PDF report. The README documents all 22 tools and professional capabilities; sampled backend excerpts support the orchestration, case storage, correlation, configuration and reporting links, but not the internal calls of every tool.

Main entry points: [`backend/app.py`](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/app.py) (Flask API), [`backend/tools/email_investigation.py`](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/email_investigation.py) (Email investigation), [`backend/tools/domain_investigation.py`](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/domain_investigation.py) (Domain investigation), [`backend/tools/username_lookup.py`](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/username_lookup.py) (Username lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Investigation interface"]
  node_web_ui["Web interface<br/>[index.html]"]
  node_frontend_logic["UI interactions<br/>[script.js]"]
end

subgraph group_backend["Backend workflow"]
  node_flask["Flask API<br/>[app.py]"]
  node_correlation["Entity correlation<br/>[correlation.py]"]
  node_config["API key config<br/>[config.py]"]
  node_authentication["Authentication manager<br/>[authentication.py]"]
end

subgraph group_active["Active reconnaissance"]
  node_port_scan["Port scanning<br/>[port_scan.py]"]
  node_dns_enum["DNS enumeration<br/>[dns_enum.py]"]
  node_subdomains["Subdomain enumeration<br/>[subdomain_enum.py]"]
  node_whois["WHOIS lookup<br/>[whois_lookup.py]"]
  node_directory_brute["Directory bruteforce<br/>[dir_brute.py]"]
  node_crawler["Web crawler<br/>[web_crawler.py]"]
  node_ssl_scan["SSL/TLS scanner<br/>[ssl_scan.py]"]
  node_banner["Banner grabbing<br/>[banner_grab.py]"]
end

subgraph group_passive["Passive intelligence"]
  node_username["Username lookup<br/>[username_lookup.py]"]
  node_email["Email investigation"]
  node_domain["Domain investigation"]
  node_ip["IP investigation"]
  node_phone["Phone investigation"]
  node_metadata["Metadata extraction"]
  node_website["Website analysis"]
  node_social["Social media search<br/>[social_media.py]"]
  node_breach["Data breach check<br/>[breach_check.py]"]
  node_reverse_image["Reverse image search<br/>[reverse_image.py]"]
  node_dorking["Google dorking<br/>[google_dorking.py]"]
  node_public_records["Public records<br/>[public_records.py]"]
  node_dark_web["Dark web monitor<br/>[dark_web.py]"]
end

subgraph group_persistence["Cases and reporting"]
  node_cases_db[("Case database<br/>[db.py]")]
  node_pdf_report["PDF reports"]
end

node_investigator(("Investigator"))
node_external_services{{"External intelligence services"}}

node_investigator -->|"uses"| node_web_ui
node_web_ui -->|"interacts through"| node_frontend_logic
node_frontend_logic -->|"submits investigations"| node_flask
node_flask -->|"dispatches tool"| node_port_scan
node_flask -->|"dispatches tool"| node_dns_enum
node_flask -->|"dispatches tool"| node_subdomains
node_flask -->|"dispatches tool"| node_whois
node_flask -->|"dispatches tool"| node_directory_brute
node_flask -->|"dispatches tool"| node_crawler
node_flask -->|"dispatches tool"| node_ssl_scan
node_flask -->|"dispatches tool"| node_banner
node_flask -->|"dispatches tool"| node_username
node_flask -->|"dispatches tool"| node_email
node_flask -->|"dispatches tool"| node_domain
node_flask -->|"dispatches tool"| node_ip
node_flask -->|"dispatches tool"| node_phone
node_flask -->|"dispatches tool"| node_metadata
node_flask -->|"dispatches tool"| node_website
node_flask -->|"dispatches tool"| node_social
node_flask -->|"dispatches tool"| node_breach
node_flask -->|"dispatches tool"| node_reverse_image
node_flask -->|"dispatches tool"| node_dorking
node_flask -->|"dispatches tool"| node_public_records
node_flask -->|"dispatches tool"| node_dark_web
node_flask -->|"routes key management"| node_authentication
node_flask -->|"stores case results"| node_cases_db
node_flask -->|"extracts entities"| node_correlation
node_correlation -->|"reads case entities"| node_cases_db
node_flask -->|"builds report"| node_pdf_report
node_flask -->|"manages keys"| node_config
node_email -->|"reads API keys"| node_config
node_domain -->|"uses lookup"| node_whois
node_domain -->|"uses enumeration"| node_dns_enum
node_social -->|"includes lookup"| node_username
node_authentication -->|"loads and saves keys"| node_config
node_email -->|"queries optional APIs"| node_external_services
node_username -->|"checks platforms"| node_external_services
node_investigator -.->|"configures credentials"| node_external_services

click node_web_ui "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/index.html"
click node_frontend_logic "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/script.js"
click node_flask "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/app.py"
click node_correlation "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/correlation.py"
click node_config "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/config.py"
click node_cases_db "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/db.py"
click node_pdf_report "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/report_generator.py"
click node_port_scan "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/port_scan.py"
click node_dns_enum "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dns_enum.py"
click node_subdomains "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/subdomain_enum.py"
click node_whois "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/whois_lookup.py"
click node_directory_brute "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dir_brute.py"
click node_crawler "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/web_crawler.py"
click node_ssl_scan "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/ssl_scan.py"
click node_banner "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/banner_grab.py"
click node_username "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/username_lookup.py"
click node_email "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/email_investigation.py"
click node_domain "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/domain_investigation.py"
click node_ip "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/ip_investigation.py"
click node_phone "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/phone_investigation.py"
click node_metadata "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/metadata_extraction.py"
click node_website "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/website_analysis.py"
click node_social "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/social_media.py"
click node_breach "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/breach_check.py"
click node_reverse_image "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/reverse_image.py"
click node_dorking "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/google_dorking.py"
click node_public_records "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/public_records.py"
click node_dark_web "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dark_web.py"
click node_authentication "https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/authentication.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_web_ui,node_frontend_logic toneBlue
class node_flask,node_correlation,node_config,node_authentication toneAmber
class node_port_scan,node_dns_enum,node_subdomains,node_whois,node_directory_brute,node_crawler,node_ssl_scan,node_banner toneMint
class node_username,node_email,node_domain,node_ip,node_phone,node_metadata,node_website,node_social,node_breach,node_reverse_image,node_dorking,node_public_records,node_dark_web toneRose
class node_cases_db,node_pdf_report,node_investigator,node_external_services toneIndigo
```

## Components

### Investigation interface

- [Web interface](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/index.html): `index.html`
- [UI interactions](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/script.js): `script.js`

### Backend workflow

- [Flask API](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/app.py): `backend/app.py`
- [Entity correlation](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/correlation.py): `backend/correlation.py`
- [API key config](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/config.py): `backend/config.py`
- [Authentication manager](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/authentication.py): `backend/tools/authentication.py`

### Active reconnaissance

- [Port scanning](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/port_scan.py): `backend/tools/port_scan.py`
- [DNS enumeration](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dns_enum.py): `backend/tools/dns_enum.py`
- [Subdomain enumeration](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/subdomain_enum.py): `backend/tools/subdomain_enum.py`
- [WHOIS lookup](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/whois_lookup.py): `backend/tools/whois_lookup.py`
- [Directory bruteforce](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dir_brute.py): `backend/tools/dir_brute.py`
- [Web crawler](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/web_crawler.py): `backend/tools/web_crawler.py`
- [SSL/TLS scanner](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/ssl_scan.py): `backend/tools/ssl_scan.py`
- [Banner grabbing](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/banner_grab.py): `backend/tools/banner_grab.py`

### Passive intelligence

- [Username lookup](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/username_lookup.py): `backend/tools/username_lookup.py`
- [Email investigation](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/email_investigation.py): `backend/tools/email_investigation.py`
- [Domain investigation](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/domain_investigation.py): `backend/tools/domain_investigation.py`
- [IP investigation](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/ip_investigation.py): `backend/tools/ip_investigation.py`
- [Phone investigation](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/phone_investigation.py): `backend/tools/phone_investigation.py`
- [Metadata extraction](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/metadata_extraction.py): `backend/tools/metadata_extraction.py`
- [Website analysis](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/website_analysis.py): `backend/tools/website_analysis.py`
- [Social media search](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/social_media.py): `backend/tools/social_media.py`
- [Data breach check](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/breach_check.py): `backend/tools/breach_check.py`
- [Reverse image search](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/reverse_image.py): `backend/tools/reverse_image.py`
- [Google dorking](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/google_dorking.py): `backend/tools/google_dorking.py`
- [Public records](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/public_records.py): `backend/tools/public_records.py`
- [Dark web monitor](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/tools/dark_web.py): `backend/tools/dark_web.py`

### Cases and reporting

- [Case database](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/db.py): `backend/db.py`
- [PDF reports](https://github.com/ravipandit991/digital-footprint-investigator/blob/feat/ui-foundation/backend/report_generator.py): `backend/report_generator.py`

### Other components

- **Investigator**
- **External intelligence services**

## Connections

- Investigator → Web interface: uses (evidence: `README.md`)
- Web interface → UI interactions: interacts through (evidence: `README.md`)
- UI interactions → Flask API: submits investigations (evidence: `README.md`)
- Flask API → Port scanning: dispatches tool (evidence: `backend/app.py`)
- Flask API → DNS enumeration: dispatches tool (evidence: `backend/app.py`)
- Flask API → Subdomain enumeration: dispatches tool (evidence: `backend/app.py`)
- Flask API → WHOIS lookup: dispatches tool (evidence: `backend/app.py`)
- Flask API → Directory bruteforce: dispatches tool (evidence: `backend/app.py`)
- Flask API → Web crawler: dispatches tool (evidence: `backend/app.py`)
- Flask API → SSL/TLS scanner: dispatches tool (evidence: `backend/app.py`)
- Flask API → Banner grabbing: dispatches tool (evidence: `backend/app.py`)
- Flask API → Username lookup: dispatches tool (evidence: `backend/app.py`)
- Flask API → Email investigation: dispatches tool (evidence: `backend/app.py`)
- Flask API → Domain investigation: dispatches tool (evidence: `backend/app.py`)
- Flask API → IP investigation: dispatches tool (evidence: `backend/app.py`)
- Flask API → Phone investigation: dispatches tool (evidence: `README.md`)
- Flask API → Metadata extraction: dispatches tool (evidence: `backend/app.py`)
- Flask API → Website analysis: dispatches tool (evidence: `backend/app.py`)
- Flask API → Social media search: dispatches tool (evidence: `README.md`)
- Flask API → Data breach check: dispatches tool (evidence: `README.md`)
- Flask API → Reverse image search: dispatches tool (evidence: `README.md`)
- Flask API → Google dorking: dispatches tool (evidence: `README.md`)
- Flask API → Public records: dispatches tool (evidence: `README.md`)
- Flask API → Dark web monitor: dispatches tool (evidence: `README.md`)
- Flask API → Authentication manager: routes key management (evidence: `backend/app.py`)
- Flask API → Case database: stores case results (evidence: `backend/app.py`)
- Flask API → Entity correlation: extracts entities (evidence: `backend/app.py`)
- Entity correlation → Case database: reads case entities (evidence: `backend/app.py`)
- Flask API → PDF reports: builds report (evidence: `backend/app.py`)
- Flask API → API key config: manages keys
- Email investigation → API key config: reads API keys (evidence: `backend/tools/email_investigation.py`)
- Domain investigation → WHOIS lookup: uses lookup (evidence: `README.md`)
- Domain investigation → DNS enumeration: uses enumeration (evidence: `README.md`)
- Social media search → Username lookup: includes lookup (evidence: `README.md`)
- Authentication manager → API key config: loads and saves keys (evidence: `backend/tools/authentication.py`)
- Email investigation → External intelligence services: queries optional APIs (evidence: `backend/tools/email_investigation.py`)
- Username lookup → External intelligence services: checks platforms (evidence: `backend/tools/username_lookup.py`)
- Investigator → External intelligence services: configures credentials (evidence: `README.md`)
