# 7yph0n/six_eyes architecture

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

- Interactive diagram: https://gitdiagram.com/7yph0n/six_eyes
- Repository: https://github.com/7yph0n/six_eyes

## Overview

Six_Eyes is a Python/PHP IP-logging tool. The operator starts MySQL and a PHP server, exposes it through ngrok (optionally shortening the public URL), and generates a PHP POST handler; a visitor opening the page fetches IP details from ipinfo.io and submits them for storage. The sampled sources support the browser-to-handler data path and the Python setup/database operations. Some menu orchestration and PHP-server details are omitted from excerpts, so those links are not expanded beyond what the shown calls establish.

Main entry points: [`grabber.py`](https://github.com/7yph0n/six_eyes/blob/main/grabber.py) (CLI menu), [`index.php`](https://github.com/7yph0n/six_eyes/blob/main/index.php) (IP capture page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator workflow"]
  node_runner["CLI menu<br/>[grabber.py]"]
  node_mysql_ctl["MySQL control<br/>[grabber.py]"]
  node_php_server["PHP server<br/>[grabber.py]"]
  node_tunnel["Public tunnel<br/>[grabber.py]"]
  node_shortener["URL shortener<br/>[grabber.py]"]
end

subgraph group_runtime["Capture and storage"]
  node_landing["IP capture page<br/>[index.php]"]
  node_post_handler["Generated POST handler<br/>[grabber.py]"]
  node_database_setup["Database setup<br/>[grabber.py]"]
  node_ip_store[("MySQL records")]
  node_record_view["Record display<br/>[grabber.py]"]
end

node_admin(("Operator"))
node_visitor(("Link visitor"))
node_ipinfo["IPinfo API"]

node_admin -->|"runs"| node_runner
node_runner -->|"starts or stops"| node_mysql_ctl
node_runner -->|"initializes"| node_database_setup
node_database_setup -->|"creates schema"| node_ip_store
node_runner -->|"starts"| node_php_server
node_runner -->|"generates"| node_post_handler
node_runner -->|"starts"| node_tunnel
node_tunnel -->|"optionally shortens"| node_shortener
node_visitor -.->|"opens"| node_landing
node_landing -->|"fetches details"| node_ipinfo
node_landing -->|"posts fields"| node_post_handler
node_post_handler -->|"inserts record"| node_ip_store
node_runner -->|"displays records"| node_record_view
node_record_view -->|"reads records"| node_ip_store

click node_runner "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_mysql_ctl "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_php_server "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_tunnel "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_shortener "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_landing "https://github.com/7yph0n/six_eyes/blob/main/index.php"
click node_post_handler "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_database_setup "https://github.com/7yph0n/six_eyes/blob/main/grabber.py"
click node_record_view "https://github.com/7yph0n/six_eyes/blob/main/grabber.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_runner,node_mysql_ctl,node_php_server,node_tunnel,node_shortener toneBlue
class node_landing,node_post_handler,node_database_setup,node_ip_store,node_record_view toneAmber
class node_admin,node_visitor toneIndigo
class node_ipinfo toneMint
```

## Components

### Operator workflow

- [CLI menu](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- [MySQL control](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- [PHP server](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- [Public tunnel](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- [URL shortener](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`

### Capture and storage

- [IP capture page](https://github.com/7yph0n/six_eyes/blob/main/index.php): `index.php`
- [Generated POST handler](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- [Database setup](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`
- **MySQL records**
- [Record display](https://github.com/7yph0n/six_eyes/blob/main/grabber.py): `grabber.py`

### Other components

- **Operator**
- **Link visitor**
- **IPinfo API**

## Connections

- Operator → CLI menu: runs (evidence: `README.md`)
- CLI menu → MySQL control: starts or stops (evidence: `grabber.py`)
- CLI menu → Database setup: initializes (evidence: `grabber.py`)
- Database setup → MySQL records: creates schema (evidence: `grabber.py`)
- CLI menu → PHP server: starts (evidence: `grabber.py`)
- CLI menu → Generated POST handler: generates (evidence: `grabber.py`)
- CLI menu → Public tunnel: starts (evidence: `grabber.py`)
- Public tunnel → URL shortener: optionally shortens (evidence: `grabber.py`)
- Link visitor → IP capture page: opens (evidence: `README.md`)
- IP capture page → IPinfo API: fetches details (evidence: `index.php`)
- IP capture page → Generated POST handler: posts fields (evidence: `index.php`)
- Generated POST handler → MySQL records: inserts record (evidence: `grabber.py`)
- CLI menu → Record display: displays records (evidence: `grabber.py`)
- Record display → MySQL records: reads records (evidence: `grabber.py`)
