# roshann-28/deeptrace architecture

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

- Interactive diagram: https://gitdiagram.com/roshann-28/deeptrace
- Repository: https://github.com/roshann-28/deeptrace

## Overview

Packet Analyzer is an offline PCAP deep-packet-inspection application. Its documented user-to-result workflow reads capture records, parses packets, identifies flows, extracts application metadata, classifies traffic, evaluates blocking rules, and writes allowed packets to an output capture. The sampled FastPath source confirms the core parse–detect–track–evaluate sequence; the README documents the wider PCAP workflow and reporting goals. QUIC decryption and multithreaded processing are represented as documented or indexed capabilities, but their complete runtime wiring was not sampled.

Main entry points: [`src/main/java/com/deeptrace/fastpath/FastPath.java`](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/fastpath/FastPath.java) (Fast Path), [`src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java) (Detection Engine), [`src/main/java/com/deeptrace/writer/PcapOutputProcessor.java`](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/writer/PcapOutputProcessor.java) (Output Processor), [`src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java`](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java) (QUIC Packet Processor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Capture Input"]
  node_pcap_reader["PCAP Reader<br/>[PcapReader.java]"]
  node_raw_packet["Raw Packet<br/>[RawPacket.java]"]
  node_pcap_header["PCAP Headers"]
end

subgraph group_inspection["Packet Inspection"]
  node_parser["Packet Parser<br/>[PacketParser.java]"]
  node_parsed_packet["Parsed Packet<br/>[ParsedPacket.java]"]
  node_detection["Detection Engine"]
  node_metadata["Application Metadata"]
  node_dns["DNS Extractor<br/>[DNSExtractor.java]"]
  node_http["HTTP Host Extractor"]
  node_tls["TLS Extractor<br/>[TLSExtractor.java]"]
  node_quic["QUIC Extractor<br/>[QUICExtractor.java]"]
  node_quic_processor["QUIC Packet Processor"]
  node_quic_initial["QUIC Initial Decryptor"]
  node_quic_header["QUIC Header Protection"]
  node_quic_payload["QUIC Payload Decryptor"]
end

subgraph group_analysis["Flow And Policy"]
  node_classifier["Application Classifier"]
  node_app_type["Application Categories<br/>[AppType.java]"]
  node_tracker["Connection Tracker"]
  node_connection[("Connection State<br/>[Connection.java]")]
  node_five_tuple["Five-Tuple Key<br/>[FiveTuple.java]"]
  node_rule_evaluator["Rule Evaluator<br/>[RuleEvaluator.java]"]
  node_rule_manager[("Rule Manager<br/>[RuleManager.java]")]
  node_decision["Rule Decision<br/>[RuleDecision.java]"]
  node_statistics["Rule Statistics"]
end

subgraph group_processing["Processing And Output"]
  node_main["Application Entry<br/>[Main.java]"]
  node_fastpath["Fast Path<br/>[FastPath.java]"]
  node_load_balancer["Load Balancer<br/>[LoadBalancer.java]"]
  node_worker["Packet Worker<br/>[PacketWorker.java]"]
  node_worker_manager["Worker Manager<br/>[WorkerManager.java]"]
  node_output_processor["Output Processor"]
  node_writer["PCAP Writer<br/>[PcapWriter.java]"]
end

node_operator(("Analyst"))

node_operator -.->|"starts analysis"| node_main
node_main -.->|"opens capture"| node_pcap_reader
node_pcap_reader -.->|"reads records"| node_raw_packet
node_pcap_reader -.->|"parses headers"| node_pcap_header
node_raw_packet -->|"parsed by"| node_parser
node_parser -->|"creates"| node_parsed_packet
node_parsed_packet -->|"inspected by"| node_fastpath
node_fastpath -->|"parses with"| node_parser
node_fastpath -->|"detects with"| node_detection
node_detection -->|"tries extraction"| node_dns
node_detection -->|"tries extraction"| node_http
node_detection -->|"tries extraction"| node_tls
node_detection -->|"checks packet"| node_quic
node_detection -->|"classifies metadata"| node_classifier
node_dns -->|"extracts metadata"| node_metadata
node_http -->|"extracts metadata"| node_metadata
node_tls -->|"extracts metadata"| node_metadata
node_classifier -->|"returns category"| node_app_type
node_fastpath -->|"tracks flow"| node_tracker
node_fastpath -->|"evaluates rules"| node_rule_evaluator
node_tracker -->|"keys connections"| node_five_tuple
node_tracker -->|"updates state"| node_connection
node_rule_evaluator -->|"checks rules"| node_rule_manager
node_rule_evaluator -->|"returns decision"| node_decision
node_rule_manager -->|"reports counts"| node_statistics
node_worker -->|"takes packets"| node_load_balancer
node_worker -->|"processes packet"| node_fastpath
node_worker_manager -->|"manages workers"| node_worker
node_worker_manager -->|"configures distribution"| node_load_balancer
node_output_processor -->|"uses result"| node_fastpath
node_output_processor -->|"writes permitted"| node_writer
node_writer -->|"writes header"| node_pcap_header
node_fastpath -.->|"filters packets"| node_output_processor
node_quic_processor -.->|"decrypts initial"| node_quic_initial
node_quic_processor -.->|"protects header"| node_quic_header
node_quic_processor -.->|"decrypts payload"| node_quic_payload
node_main -.->|"writes analysis output"| node_output_processor

click node_main "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/Main.java"
click node_pcap_reader "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/PcapReader.java"
click node_raw_packet "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/RawPacket.java"
click node_pcap_header "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/PcapGlobalHeader.java"
click node_parser "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/parser/PacketParser.java"
click node_parsed_packet "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/parser/ParsedPacket.java"
click node_detection "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java"
click node_metadata "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/ApplicationMetadata.java"
click node_dns "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/DNSExtractor.java"
click node_http "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/HTTPHostExtractor.java"
click node_tls "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/TLSExtractor.java"
click node_quic "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICExtractor.java"
click node_quic_processor "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java"
click node_quic_initial "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICInitialDecryptor.java"
click node_quic_header "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICHeaderProtection.java"
click node_quic_payload "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICPayloadDecryptor.java"
click node_classifier "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/ApplicationClassifier.java"
click node_app_type "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/AppType.java"
click node_fastpath "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/fastpath/FastPath.java"
click node_tracker "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/ConnectionTracker.java"
click node_connection "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/Connection.java"
click node_five_tuple "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/FiveTuple.java"
click node_rule_evaluator "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleEvaluator.java"
click node_rule_manager "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleManager.java"
click node_decision "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleDecision.java"
click node_load_balancer "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/LoadBalancer.java"
click node_worker "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/PacketWorker.java"
click node_worker_manager "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/WorkerManager.java"
click node_output_processor "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/writer/PcapOutputProcessor.java"
click node_writer "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/writer/PcapWriter.java"
click node_statistics "https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleStatistics.java"

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_pcap_reader,node_raw_packet,node_pcap_header toneBlue
class node_parser,node_parsed_packet,node_detection,node_metadata,node_dns,node_http,node_tls,node_quic,node_quic_processor,node_quic_initial,node_quic_header,node_quic_payload toneAmber
class node_classifier,node_app_type,node_tracker,node_connection,node_five_tuple,node_rule_evaluator,node_rule_manager,node_decision,node_statistics toneMint
class node_main,node_fastpath,node_load_balancer,node_worker,node_worker_manager,node_output_processor,node_writer toneRose
class node_operator toneIndigo
```

## Components

### Capture Input

- [PCAP Reader](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/PcapReader.java): `src/main/java/com/deeptrace/reader/PcapReader.java`
- [Raw Packet](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/RawPacket.java): `src/main/java/com/deeptrace/reader/RawPacket.java`
- [PCAP Headers](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/reader/PcapGlobalHeader.java): `src/main/java/com/deeptrace/reader/PcapGlobalHeader.java`

### Packet Inspection

- [Packet Parser](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/parser/PacketParser.java): `src/main/java/com/deeptrace/parser/PacketParser.java`
- [Parsed Packet](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/parser/ParsedPacket.java): `src/main/java/com/deeptrace/parser/ParsedPacket.java`
- [Detection Engine](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java): `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`
- [Application Metadata](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/ApplicationMetadata.java): `src/main/java/com/deeptrace/extractor/ApplicationMetadata.java`
- [DNS Extractor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/DNSExtractor.java): `src/main/java/com/deeptrace/extractor/DNSExtractor.java`
- [HTTP Host Extractor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/HTTPHostExtractor.java): `src/main/java/com/deeptrace/extractor/HTTPHostExtractor.java`
- [TLS Extractor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/TLSExtractor.java): `src/main/java/com/deeptrace/extractor/TLSExtractor.java`
- [QUIC Extractor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICExtractor.java): `src/main/java/com/deeptrace/extractor/QUICExtractor.java`
- [QUIC Packet Processor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java): `src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java`
- [QUIC Initial Decryptor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICInitialDecryptor.java): `src/main/java/com/deeptrace/extractor/QUICInitialDecryptor.java`
- [QUIC Header Protection](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICHeaderProtection.java): `src/main/java/com/deeptrace/extractor/QUICHeaderProtection.java`
- [QUIC Payload Decryptor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/extractor/QUICPayloadDecryptor.java): `src/main/java/com/deeptrace/extractor/QUICPayloadDecryptor.java`

### Flow And Policy

- [Application Classifier](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/ApplicationClassifier.java): `src/main/java/com/deeptrace/classifier/ApplicationClassifier.java`
- [Application Categories](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/classifier/AppType.java): `src/main/java/com/deeptrace/classifier/AppType.java`
- [Connection Tracker](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/ConnectionTracker.java): `src/main/java/com/deeptrace/connection/ConnectionTracker.java`
- [Connection State](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/Connection.java): `src/main/java/com/deeptrace/connection/Connection.java`
- [Five-Tuple Key](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/connection/FiveTuple.java): `src/main/java/com/deeptrace/connection/FiveTuple.java`
- [Rule Evaluator](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleEvaluator.java): `src/main/java/com/deeptrace/rules/RuleEvaluator.java`
- [Rule Manager](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleManager.java): `src/main/java/com/deeptrace/rules/RuleManager.java`
- [Rule Decision](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleDecision.java): `src/main/java/com/deeptrace/rules/RuleDecision.java`
- [Rule Statistics](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/rules/RuleStatistics.java): `src/main/java/com/deeptrace/rules/RuleStatistics.java`

### Processing And Output

- [Application Entry](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/Main.java): `src/main/java/com/deeptrace/Main.java`
- [Fast Path](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/fastpath/FastPath.java): `src/main/java/com/deeptrace/fastpath/FastPath.java`
- [Load Balancer](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/LoadBalancer.java): `src/main/java/com/deeptrace/loadbalancer/LoadBalancer.java`
- [Packet Worker](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/PacketWorker.java): `src/main/java/com/deeptrace/loadbalancer/PacketWorker.java`
- [Worker Manager](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/loadbalancer/WorkerManager.java): `src/main/java/com/deeptrace/loadbalancer/WorkerManager.java`
- [Output Processor](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/writer/PcapOutputProcessor.java): `src/main/java/com/deeptrace/writer/PcapOutputProcessor.java`
- [PCAP Writer](https://github.com/roshann-28/deeptrace/blob/main/src/main/java/com/deeptrace/writer/PcapWriter.java): `src/main/java/com/deeptrace/writer/PcapWriter.java`

### Other components

- **Analyst**

## Connections

- Analyst → Application Entry: starts analysis
- Application Entry → PCAP Reader: opens capture (evidence: `src/main/java/com/deeptrace/Main.java`)
- PCAP Reader → Raw Packet: reads records (evidence: `src/main/java/com/deeptrace/reader/PcapReader.java`)
- PCAP Reader → PCAP Headers: parses headers (evidence: `src/main/java/com/deeptrace/reader/PcapReader.java`)
- Raw Packet → Packet Parser: parsed by (evidence: `src/main/java/com/deeptrace/parser/PacketParser.java`)
- Packet Parser → Parsed Packet: creates (evidence: `src/main/java/com/deeptrace/parser/PacketParser.java`)
- Parsed Packet → Fast Path: inspected by (evidence: `src/main/java/com/deeptrace/fastpath/FastPath.java`)
- Fast Path → Packet Parser: parses with (evidence: `src/main/java/com/deeptrace/fastpath/FastPath.java`)
- Fast Path → Detection Engine: detects with (evidence: `src/main/java/com/deeptrace/fastpath/FastPath.java`)
- Detection Engine → DNS Extractor: tries extraction (evidence: `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`)
- Detection Engine → HTTP Host Extractor: tries extraction (evidence: `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`)
- Detection Engine → TLS Extractor: tries extraction (evidence: `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`)
- Detection Engine → QUIC Extractor: checks packet (evidence: `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`)
- Detection Engine → Application Classifier: classifies metadata (evidence: `src/main/java/com/deeptrace/classifier/ApplicationDetectionEngine.java`)
- DNS Extractor → Application Metadata: extracts metadata (evidence: `src/main/java/com/deeptrace/extractor/DNSExtractor.java`)
- HTTP Host Extractor → Application Metadata: extracts metadata (evidence: `src/main/java/com/deeptrace/extractor/HTTPHostExtractor.java`)
- TLS Extractor → Application Metadata: extracts metadata (evidence: `src/main/java/com/deeptrace/extractor/TLSExtractor.java`)
- Application Classifier → Application Categories: returns category (evidence: `src/main/java/com/deeptrace/classifier/ApplicationClassifier.java`)
- Fast Path → Connection Tracker: tracks flow (evidence: `src/main/java/com/deeptrace/fastpath/FastPath.java`)
- Fast Path → Rule Evaluator: evaluates rules (evidence: `src/main/java/com/deeptrace/fastpath/FastPath.java`)
- Connection Tracker → Five-Tuple Key: keys connections (evidence: `src/main/java/com/deeptrace/connection/ConnectionTracker.java`)
- Connection Tracker → Connection State: updates state (evidence: `src/main/java/com/deeptrace/connection/ConnectionTracker.java`)
- Rule Evaluator → Rule Manager: checks rules (evidence: `src/main/java/com/deeptrace/rules/RuleEvaluator.java`)
- Rule Evaluator → Rule Decision: returns decision (evidence: `src/main/java/com/deeptrace/rules/RuleEvaluator.java`)
- Rule Manager → Rule Statistics: reports counts (evidence: `src/main/java/com/deeptrace/rules/RuleManager.java`)
- Packet Worker → Load Balancer: takes packets (evidence: `src/main/java/com/deeptrace/loadbalancer/PacketWorker.java`)
- Packet Worker → Fast Path: processes packet (evidence: `src/main/java/com/deeptrace/loadbalancer/PacketWorker.java`)
- Worker Manager → Packet Worker: manages workers (evidence: `src/main/java/com/deeptrace/loadbalancer/WorkerManager.java`)
- Worker Manager → Load Balancer: configures distribution (evidence: `src/main/java/com/deeptrace/loadbalancer/WorkerManager.java`)
- Output Processor → Fast Path: uses result (evidence: `src/main/java/com/deeptrace/writer/PcapOutputProcessor.java`)
- Output Processor → PCAP Writer: writes permitted (evidence: `src/main/java/com/deeptrace/writer/PcapOutputProcessor.java`)
- PCAP Writer → PCAP Headers: writes header (evidence: `src/main/java/com/deeptrace/writer/PcapWriter.java`)
- Fast Path → Output Processor: filters packets (evidence: `src/main/java/com/deeptrace/writer/PcapOutputProcessor.java`)
- QUIC Packet Processor → QUIC Initial Decryptor: decrypts initial (evidence: `src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java`)
- QUIC Packet Processor → QUIC Header Protection: protects header (evidence: `src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java`)
- QUIC Packet Processor → QUIC Payload Decryptor: decrypts payload (evidence: `src/main/java/com/deeptrace/extractor/QUICPacketProcessor.java`)
- Application Entry → Output Processor: writes analysis output
