# yakupaslantas/delta architecture

> Architecture diagram of the GitHub repository yakupaslantas/delta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yakupaslantas/delta
- Repository: https://github.com/yakupaslantas/delta

## Overview

Delta is a terminal OSINT application: a user selects an IP, domain, or phone-number lookup, receives formatted results, and can save them to a per-session text file. The main workflow and all three lookup types live in the single `main.py` module; the README documents their result fields and save options. The sampled source confirms IP lookup through ipapi.co, phone parsing and metadata extraction through phonenumbers, and session-file saves. Some dispatch and domain-lookup code is omitted, so those links reflect documented behavior rather than inspected call sites.

Main entry points: [`main.py`](https://github.com/yakupaslantas/delta/blob/main/main.py) (Menu and dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Terminal interface"]
  node_main["Menu and dispatch<br/>[main.py]"]
end

subgraph group_lookups["OSINT lookups"]
  node_ip["IP lookup<br/>[main.py]"]
  node_domain["Domain lookup<br/>[main.py]"]
  node_phone["Phone lookup<br/>[main.py]"]
end

subgraph group_results["Session results"]
  node_session["Session setup<br/>[main.py]"]
  node_saved["Saved result files<br/>[main.py]"]
end

subgraph group_external["External data"]
  node_ipapi["ipapi.co"]
  node_whois["WHOIS service"]
  node_phone_lib["phonenumbers"]
end

node_user(("User"))

node_user -->|"selects option"| node_main
node_main -->|"dispatches lookup"| node_ip
node_main -->|"dispatches lookup"| node_domain
node_main -->|"dispatches lookup"| node_phone
node_ip -->|"requests IP data"| node_ipapi
node_domain -->|"queries domain"| node_whois
node_phone -->|"parses and extracts"| node_phone_lib
node_session -->|"creates session files"| node_saved
node_ip -->|"writes results"| node_saved
node_domain -->|"writes results"| node_saved
node_phone -->|"writes results"| node_saved

click node_main "https://github.com/yakupaslantas/delta/blob/main/main.py"
click node_ip "https://github.com/yakupaslantas/delta/blob/main/main.py"
click node_domain "https://github.com/yakupaslantas/delta/blob/main/main.py"
click node_phone "https://github.com/yakupaslantas/delta/blob/main/main.py"
click node_session "https://github.com/yakupaslantas/delta/blob/main/main.py"
click node_saved "https://github.com/yakupaslantas/delta/blob/main/main.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_main,node_user toneBlue
class node_ip,node_domain,node_phone toneAmber
class node_session,node_saved toneMint
class node_ipapi,node_whois,node_phone_lib toneRose
```

## Components

### Terminal interface

- [Menu and dispatch](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`

### OSINT lookups

- [IP lookup](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`
- [Domain lookup](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`
- [Phone lookup](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`

### Session results

- [Session setup](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`
- [Saved result files](https://github.com/yakupaslantas/delta/blob/main/main.py): `main.py`

### External data

- **ipapi.co**
- **WHOIS service**
- **phonenumbers**

### Other components

- **User**

## Connections

- User → Menu and dispatch: selects option
- Menu and dispatch → IP lookup: dispatches lookup
- Menu and dispatch → Domain lookup: dispatches lookup
- Menu and dispatch → Phone lookup: dispatches lookup
- IP lookup → ipapi.co: requests IP data
- Domain lookup → WHOIS service: queries domain
- Phone lookup → phonenumbers: parses and extracts
- Session setup → Saved result files: creates session files
- IP lookup → Saved result files: writes results
- Domain lookup → Saved result files: writes results
- Phone lookup → Saved result files: writes results