# avinash-0411/reconx architecture

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

- Interactive diagram: https://gitdiagram.com/avinash-0411/reconx
- Repository: https://github.com/avinash-0411/reconx

## Overview

ReconX is a command-line reconnaissance and security-assessment tool. A user supplies a target and selects a scan command; the CLI dispatches network and web checks, presents findings and severity summaries, and can export results as JSON or CSV. Its capabilities span TCP discovery, service identification, DNS and TLS checks, HTTP analysis, and web vulnerability/resource probes. Finding assessment and severity aggregation form a shared internal layer. The CLI excerpt is partial, so some dispatch relationships rely on its indexed module references and README-documented commands rather than inspected call sites.

Main entry points: [`reconx/main.py`](https://github.com/avinash-0411/reconx/blob/main/reconx/main.py) (Command-line dispatcher), [`reconx/modules/portscan.py`](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/portscan.py) (TCP port scanner), [`reconx/modules/exposed_files.py`](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/exposed_files.py) (Exposed-file detection), [`reconx/modules/lfi.py`](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/lfi.py) (LFI detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_cli["Command-line dispatcher<br/>[main.py]"]
end

subgraph group_network["Network reconnaissance"]
  node_ports["TCP port scanner<br/>[portscan.py]"]
  node_services["Service detection<br/>[service_detect.py]"]
  node_dns["DNS enumeration<br/>[dns_enum.py]"]
  node_tls["TLS inspection<br/>[tls_checker.py]"]
end

subgraph group_web["Web assessment"]
  node_http["HTTP analyzer<br/>[http_analyzer.py]"]
  node_methods["HTTP methods<br/>[http_methods.py]"]
  node_directories["Directory scanner<br/>[dirscan.py]"]
  node_exposed["Exposed-file detection<br/>[exposed_files.py]"]
  node_lfi["LFI detection<br/>[lfi.py]"]
end

subgraph group_results["Findings and reports"]
  node_assessment["Finding assessment"]
  node_severity["Severity summaries<br/>[severity.py]"]
  node_reports["Report export<br/>[report.py]"]
end

node_user(("User"))
node_target(("Assessment target"))

node_user -->|"selects scan"| node_cli
node_cli -->|"dispatches scan"| node_ports
node_cli -->|"dispatches detection"| node_services
node_cli -->|"dispatches enumeration"| node_dns
node_cli -->|"dispatches check"| node_tls
node_cli -->|"dispatches analysis"| node_http
node_cli -->|"dispatches detection"| node_methods
node_cli -->|"dispatches scan"| node_directories
node_cli -->|"dispatches detection"| node_exposed
node_cli -->|"dispatches test"| node_lfi
node_target -->|"scanned by"| node_ports
node_target -->|"queried by"| node_dns
node_target -->|"inspected by"| node_tls
node_target -->|"requested by"| node_http
node_target -->|"queried by"| node_methods
node_target -->|"probed by"| node_directories
node_target -->|"checked by"| node_exposed
node_target -->|"tested by"| node_lfi
node_ports -->|"identifies open ports"| node_services
node_exposed -->|"normalizes findings"| node_assessment
node_lfi -->|"assesses findings"| node_assessment
node_cli -->|"summarizes findings"| node_severity
node_cli -->|"exports results"| node_reports

click node_cli "https://github.com/avinash-0411/reconx/blob/main/reconx/main.py"
click node_ports "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/portscan.py"
click node_services "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/service_detect.py"
click node_dns "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/dns_enum.py"
click node_tls "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/tls_checker.py"
click node_http "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/http_analyzer.py"
click node_methods "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/http_methods.py"
click node_directories "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/dirscan.py"
click node_exposed "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/exposed_files.py"
click node_lfi "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/lfi.py"
click node_assessment "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/finding_assessment.py"
click node_severity "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/severity.py"
click node_reports "https://github.com/avinash-0411/reconx/blob/main/reconx/modules/report.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_cli,node_user toneBlue
class node_ports,node_services,node_dns,node_tls toneAmber
class node_http,node_methods,node_directories,node_exposed,node_lfi toneMint
class node_assessment,node_severity,node_reports toneRose
class node_target toneIndigo
```

## Components

### CLI workflow

- [Command-line dispatcher](https://github.com/avinash-0411/reconx/blob/main/reconx/main.py): `reconx/main.py`

### Network reconnaissance

- [TCP port scanner](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/portscan.py): `reconx/modules/portscan.py`
- [Service detection](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/service_detect.py): `reconx/modules/service_detect.py`
- [DNS enumeration](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/dns_enum.py): `reconx/modules/dns_enum.py`
- [TLS inspection](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/tls_checker.py): `reconx/modules/tls_checker.py`

### Web assessment

- [HTTP analyzer](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/http_analyzer.py): `reconx/modules/http_analyzer.py`
- [HTTP methods](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/http_methods.py): `reconx/modules/http_methods.py`
- [Directory scanner](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/dirscan.py): `reconx/modules/dirscan.py`
- [Exposed-file detection](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/exposed_files.py): `reconx/modules/exposed_files.py`
- [LFI detection](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/lfi.py): `reconx/modules/lfi.py`

### Findings and reports

- [Finding assessment](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/finding_assessment.py): `reconx/modules/finding_assessment.py`
- [Severity summaries](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/severity.py): `reconx/modules/severity.py`
- [Report export](https://github.com/avinash-0411/reconx/blob/main/reconx/modules/report.py): `reconx/modules/report.py`

### Other components

- **User**
- **Assessment target**

## Connections

- User → Command-line dispatcher: selects scan (evidence: `README.md`)
- Command-line dispatcher → TCP port scanner: dispatches scan (evidence: `reconx/main.py`)
- Command-line dispatcher → Service detection: dispatches detection (evidence: `reconx/main.py`)
- Command-line dispatcher → DNS enumeration: dispatches enumeration (evidence: `reconx/main.py`)
- Command-line dispatcher → TLS inspection: dispatches check (evidence: `reconx/main.py`)
- Command-line dispatcher → HTTP analyzer: dispatches analysis (evidence: `reconx/main.py`)
- Command-line dispatcher → HTTP methods: dispatches detection (evidence: `reconx/main.py`)
- Command-line dispatcher → Directory scanner: dispatches scan (evidence: `README.md`)
- Command-line dispatcher → Exposed-file detection: dispatches detection (evidence: `reconx/main.py`)
- Command-line dispatcher → LFI detection: dispatches test (evidence: `reconx/main.py`)
- Assessment target → TCP port scanner: scanned by (evidence: `README.md`)
- Assessment target → DNS enumeration: queried by (evidence: `reconx/modules/dns_enum.py`)
- Assessment target → TLS inspection: inspected by (evidence: `reconx/modules/tls_checker.py`)
- Assessment target → HTTP analyzer: requested by (evidence: `reconx/modules/http_analyzer.py`)
- Assessment target → HTTP methods: queried by (evidence: `reconx/modules/http_methods.py`)
- Assessment target → Directory scanner: probed by (evidence: `reconx/modules/dirscan.py`)
- Assessment target → Exposed-file detection: checked by (evidence: `reconx/modules/exposed_files.py`)
- Assessment target → LFI detection: tested by (evidence: `reconx/modules/lfi.py`)
- TCP port scanner → Service detection: identifies open ports (evidence: `reconx/main.py`)
- Exposed-file detection → Finding assessment: normalizes findings (evidence: `reconx/modules/exposed_files.py`)
- LFI detection → Finding assessment: assesses findings (evidence: `reconx/modules/lfi.py`)
- Command-line dispatcher → Severity summaries: summarizes findings (evidence: `reconx/main.py`)
- Command-line dispatcher → Report export: exports results (evidence: `README.md`)
