# alihamz10/computer-networks-lab-comp-352l architecture

> Architecture diagram of the GitHub repository alihamz10/computer-networks-lab-comp-352l, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alihamz10/computer-networks-lab-comp-352l
- Repository: https://github.com/alihamz10/computer-networks-lab-comp-352l

## Overview

##### Project Type and Purpose
- This is an educational repository of four hands-on labs in computer networks.
- It contains:
- Lab manuals (PDFs) describing exercises
- Raw data (PCAP files) and code (Python scripts) for each lab
- Screenshots / test harness outputs
- Markdown lab reports summarizing findings

##### File Structure
- Top-level directories:
- Lab Manuals/ (PDF instructions)
- Lab 03/ (Wireshark PCAPs + Screenshots)
- Lab 04/, 05/, 06/ (Python socket programming modules)
- Lab Reports/ (Markdown write-ups)
- Key files:
- user_credentials.json (shared data for auth tasks in Labs 05/06)
- README.md (entry-point documentation, prerequisites, quick start)

##### README for Technical Stack & Workflow
- External tools: Wireshark (for PCAP inspection)
- Runtime: Python 3.10+
- Modules use standard libraries: socket, threading, json.
- Workflow per lab: follow manual → run scripts / inspect PCAP → capture output → document in report.

##### Defining Main Components
a. Resources Layer
- “Lab Manuals” (PDF) ← the source of requirements for each lab.
b. Experiment Modules (one per lab)
- Lab 03 Module
- Inputs: PCAP files in Lab 03/
- Processor: Wireshark GUI / CLI
- Outputs: Screenshots/analysis images
- Lab 04-06 Modules
- Inputs: Python scripts + user_credentials.json (for auth labs)
- Processor: Python interpreter
- Outputs: Screenshots/tests under each Lab XX/Screenshots
c. Documentation Layer
- Lab Reports (Markdown) consolidating screenshots and answers
- README.md orchestrates the overall workflow
d. External Services & Tools
- Wireshark
- Python 3.10+ runtime
- Git

##### Interactions & Data Flow
- Manuals → guide → Experiment Modules
- PCAPs + Scripts → fed into → Tools (Wireshark / Python)
- Tools → produce → Artifacts (Screenshots, test logs)
- Artifacts → referenced by → Lab Reports
- README → entry-point → links Manuals, Labs, Reports

##### Architectural Patterns & Design Principles
- Clear separation of concerns:
- Instruction layer (PDF manuals)
- Execution layer (PCAP analysis, socket code)
- Verification/output layer (screenshots/tests)
- Documentation layer (reports)
- Consistent folder layout per lab for uniformity

##### Essential Elements
- Clear, unique labels for: Lab 03, Lab 04, Lab 05, Lab 06, Lab Manuals, Lab Reports, README
- Callouts for key configuration files (e.g., user_credentials.json) and dependencies (Python, Wireshark)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry-point
    README["README.md"]:::doc

    %% Resources Layer
    LabManuals["Lab Manuals"]:::resources
    click LabManuals "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab Manuals/"

    %% External Tools/Services
    Wireshark["Wireshark"]:::tool
    PythonRuntime["Python 3.10+ Runtime"]:::tool
    Git["Git"]:::tool

    %% Experiment Modules
    subgraph "Lab 03 Module" 
        direction TB
        Lab03Inputs["PCAP Files"]:::module
        click Lab03Inputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 03/"
        Lab03Processor["Wireshark Analysis"]:::tool
        Lab03Outputs["Screenshots / Analysis Images"]:::output
        click Lab03Outputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 03/Screenshots/"
        Lab03Inputs -->|"analyze with"| Lab03Processor
        Lab03Processor -->|produce| Lab03Outputs
    end

    subgraph "Lab 04 Module"
        direction TB
        Lab04Inputs["Python Scripts"]:::module
        click Lab04Inputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 04/"
        Lab04Processor["Python Interpreter\n(socket, threading, json)"]:::module
        Lab04Outputs["Screenshots / Test Logs"]:::output
        click Lab04Outputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 04/Screenshots/"
        Lab04Inputs -->|"run on"| Lab04Processor
        Lab04Processor -->|produce| Lab04Outputs
    end

    subgraph "Lab 05 Module"
        direction TB
        Lab05Inputs["Python Scripts\n+ user_credentials.json"]:::module
        click Lab05Inputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 05/"
        click Credentials "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/user_credentials.json"
        Lab05Processor["Python Interpreter\n(auth experiments)"]:::module
        Lab05Outputs["Screenshots / Test Logs"]:::output
        click Lab05Outputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 05/Screenshots/"
        Lab05Inputs -->|"run on"| Lab05Processor
        Lab05Processor -->|produce| Lab05Outputs
    end

    subgraph "Lab 06 Module"
        direction TB
        Lab06Inputs["Python Scripts\n+ user_credentials.json"]:::module
        click Lab06Inputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 06/"
        click Credentials "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/user_credentials.json"
        Lab06Processor["Python Interpreter\n(multithreaded auth & group chat)"]:::module
        Lab06Outputs["Screenshots / Test Logs"]:::output
        click Lab06Outputs "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab 06/Screenshots/"
        Lab06Inputs -->|"run on"| Lab06Processor
        Lab06Processor -->|produce| Lab06Outputs
    end

    %% Documentation Layer
    LabReports["Lab Reports"]:::doc
    click LabReports "https://github.com/alihamz10/computer-networks-lab-comp-352l/tree/main/Lab Reports/"
    subgraph "Reports"
        direction TB
        Report03["Lab Report 03.md"]:::doc
        click Report03 "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/Lab Reports/Lab Report 03.md"
        Report04["Lab Report 04.md"]:::doc
        click Report04 "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/Lab Reports/Lab Report 04.md"
        Report05["Lab Report 05.md"]:::doc
        click Report05 "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/Lab Reports/Lab Report 05.md"
        Report06["Lab Report 06.md"]:::doc
        click Report06 "https://github.com/alihamz10/computer-networks-lab-comp-352l/blob/main/Lab Reports/Lab Report 06.md"
    end

    %% Workflow Orchestration
    README --> LabManuals
    README --> Lab03Inputs
    README --> Lab04Inputs
    README --> Lab05Inputs
    README --> Lab06Inputs
    LabManuals --> Lab03Inputs
    LabManuals --> Lab04Inputs
    LabManuals --> Lab05Inputs
    LabManuals --> Lab06Inputs

    %% Tool integrations
    Lab03Inputs -->|"open .pcapng"| Wireshark
    Lab03Processor --> Wireshark
    Lab04Inputs -->|"execute"| PythonRuntime
    Lab05Inputs -->|"execute"| PythonRuntime
    Lab06Inputs -->|"execute"| PythonRuntime

    %% Aggregation to Reports
    Lab03Outputs -->|referenced by| LabReports
    Lab04Outputs -->|referenced by| LabReports
    Lab05Outputs -->|referenced by| LabReports
    Lab06Outputs -->|referenced by| LabReports

    %% Class Definitions
    classDef resources fill:#a3c4f3,stroke:#1f78b4,color:#000;
    classDef module fill:#b8e994,stroke:#2d6a4f,color:#000;
    classDef output fill:#fdba74,stroke:#d9480f,color:#000;
    classDef tool fill:#d0bfff,stroke:#6a4c93,color:#000;
    classDef doc fill:#ffe066,stroke:#d39e00,color:#000;
```
