# paddockbux/novacolumnv2 architecture

> Architecture diagram of the GitHub repository paddockbux/novacolumnv2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paddockbux/novacolumnv2
- Repository: https://github.com/paddockbux/novacolumnv2

## Overview

Key Components to Include:

##### Core Components
- NovaColumnV2 Python Script (ncv2.py)
- MariaDB Database
- Masscan (External Dependency)
- Configuration System
- Optional Web UI (separate repository)

##### Data Flow Architecture

A. Input Layer:
- Masscan JSON Output Files
- Configuration File (novacolumn.conf)
- Command-line Arguments

B. Processing Layer (NovaColumnV2 Core):
- Multi-threaded Scanner
- Database Interface
- Server Verification System
- Player Name Verification System (with dual API support)

C. Storage Layer:
- MariaDB Database Tables
- Index Structures

##### Interaction Flows

- Masscan → JSON Output → NovaColumnV2
- NovaColumnV2 ↔ MariaDB
- NovaColumnV2 ↔ Minecraft Servers (for verification)
- NovaColumnV2 ↔ APIs (Mojang/Mowojang)

Design Guidelines:

##### Specific elements
- Thread Pool representation
- Database connection pool
- Configuration management system
- API integration points
- Error handling paths

##### Separation between local and external database modes

- Thread flow patterns
- Database interaction types
- API communication protocols
- Configuration dependencies
- Verification pathways

Level of Detail:
Maintain a medium-high level of detail that shows:
- Component relationships
- Data flow directions
- System boundaries
- External dependencies
- Configuration points
- Error handling paths

Remember to indicate that this is an educational tool and include appropriate warning symbols for the potentially dangerous network scanning capabilities.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef core fill:#2374f7,stroke:#000,stroke-width:2px,color:white
    classDef input fill:#4CAF50,stroke:#000,stroke-width:1px
    classDef database fill:#ff6b6b,stroke:#000,stroke-width:2px,color:white
    classDef api fill:#9575cd,stroke:#000,stroke-width:1px
    classDef config fill:#ffd54f,stroke:#000,stroke-width:1px
    classDef warning fill:#ef5350,stroke:#000,stroke-width:2px,color:white
    
    %% Input Layer
    subgraph Input
        CONF[("novacolumn.conf")]:::config
        MASS["Masscan Output"]:::input
        ARGS["Command-line Args"]:::input
    end
    
    %% Core Processing Layer
    subgraph Core
        NCV2["NovaColumnV2 Core"]:::core
        THREAD["Thread Pool<br/>(Default: 4)"]:::core
        VERIFY["Server Verification<br/>System"]:::core
        PLAYER["Player Name<br/>Verification"]:::core
        MOJANG["Mojang API Input"]:::api
        MOWO["Mowojang API Input"]:::api
        MC["Minecraft Servers<br/>Input"]:::api
    end
    click NCV2 "https://github.com/PaddockBux/NovaColumnV2/blob/main/ncv2.py"
    
    %% Database Layer
    subgraph Storage
        DB[(MariaDB)]:::database
    end
    
    %% Dependencies
    subgraph Dependencies
        REQS["Requirements"]:::config
        DOCS["Documentation"]:::config
        TASKS["Development Tasks"]:::config
    end
    click REQS "https://github.com/PaddockBux/NovaColumnV2/blob/main/requirements.txt"
    click DOCS "https://github.com/PaddockBux/NovaColumnV2/blob/main/README.md"
    click TASKS "https://github.com/PaddockBux/NovaColumnV2/blob/main/TASKLIST.md"
    
    %% Warning Notice
    WARNING["⚠️ Educational Tool<br/>Use Responsibly"]:::warning
    
    %% Connections
    CONF --> NCV2
    MASS --> NCV2
    ARGS --> NCV2
    
    NCV2 --> THREAD
    THREAD --> VERIFY
    THREAD --> PLAYER
    
    MC --> VERIFY
    MOWO --> |default| PLAYER
    MOJANG --> PLAYER
    
    VERIFY --> DB
    PLAYER --> DB
    MC --> NCV2
    MOJANG --> NCV2
    MOWO --> NCV2
    NCV2 --> DB
    
    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Input Sources"]:::input
        L3["Database"]:::database
        L4["API Inputs"]:::api
        L5["Configuration"]:::config
    end
```
