# lil-saumyavats/digital-footprint-investigator architecture

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

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

## Overview

This is a small Python CLI: the user enters a username, the investigation checks GitHub through its API, evaluates the result, prints and saves a report, and appends the username to history. Although the README mentions investigating digital footprints, the source only checks GitHub; the declared platform list is unused. The single-file graph reflects visible calls and file writes, without implying checks for Reddit or Instagram.

Main entry points: [`footprint_v12.py`](https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py) (Investigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_menu["Menu and input<br/>[footprint_v12.py]"]
end

subgraph group_investigation["Investigation"]
  node_investigate["Investigation<br/>[footprint_v12.py]"]
  node_github["GitHub lookup<br/>[footprint_v12.py]"]
  node_risk["Risk assessment<br/>[footprint_v12.py]"]
end

subgraph group_outputs["Outputs"]
  node_report["Report file"]
  node_history["History file"]
end

node_user(("CLI user"))
node_github_api["GitHub API"]

node_user -->|"enters choice"| node_menu
node_menu -->|"calls"| node_investigate
node_investigate -->|"calls"| node_github
node_github -->|"requests user"| node_github_api
node_github -->|"returns result"| node_investigate
node_investigate -->|"assesses count"| node_risk
node_investigate -->|"writes report"| node_report
node_investigate -->|"appends username"| node_history
node_risk -->|"prints risk"| node_investigate

click node_menu "https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py"
click node_investigate "https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py"
click node_github "https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py"
click node_risk "https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.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_menu,node_user toneBlue
class node_investigate,node_github,node_risk toneAmber
class node_report,node_history,node_github_api toneMint
```

## Components

### CLI workflow

- [Menu and input](https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py): `footprint_v12.py`

### Investigation

- [Investigation](https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py): `footprint_v12.py`
- [GitHub lookup](https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py): `footprint_v12.py`
- [Risk assessment](https://github.com/lil-saumyavats/digital-footprint-investigator/blob/main/footprint_v12.py): `footprint_v12.py`

### Outputs

- **Report file**
- **History file**

### Other components

- **CLI user**
- **GitHub API**

## Connections

- CLI user → Menu and input: enters choice (evidence: `footprint_v12.py`)
- Menu and input → Investigation: calls (evidence: `footprint_v12.py`)
- Investigation → GitHub lookup: calls (evidence: `footprint_v12.py`)
- GitHub lookup → GitHub API: requests user (evidence: `footprint_v12.py`)
- GitHub lookup → Investigation: returns result (evidence: `footprint_v12.py`)
- Investigation → Risk assessment: assesses count (evidence: `footprint_v12.py`)
- Investigation → Report file: writes report (evidence: `footprint_v12.py`)
- Investigation → History file: appends username (evidence: `footprint_v12.py`)
- Risk assessment → Investigation: prints risk (evidence: `footprint_v12.py`)
