# walkerad03/d2-armor-filter architecture

> Architecture diagram of the GitHub repository walkerad03/d2-armor-filter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/walkerad03/d2-armor-filter
- Repository: https://github.com/walkerad03/d2-armor-filter

## Overview

##### Project type and purpose
- The module names (destiny_api.py, armor_cleaner.py, auth.py, controller.py, ui.py, workers.py) indicate it connects to Bungie’s Destiny API, authenticates a user, applies “armor cleaning” logic (business rules), and presents a user interface.

##### File structure
- Top level:
- main.py – application entrypoint
- config.ini – runtime configuration
- run.sh / run.bat – convenience scripts to start the app
- pyproject.toml – package metadata, dependencies
- src/
- assets/svg – static UI assets
- auth.py – handles authentication flows
- destiny_api.py – encapsulates HTTP calls to external Destiny service
- armor_cleaner.py – core business logic implementing “cleaning” rules
- workers.py – background/job-queue or threading utilities
- controller.py – orchestrates between UI, business logic, API, config
- ui.py – UI layer (likely using a GUI toolkit or CLI)

##### README for additional insights
- README is empty, so infer architecture from module names and standard patterns:
- MVC-like separation: ui.py (View), controller.py (Controller), armor_cleaner & destiny_api (Model/Services).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Entry Point"
        Main["main.py
Application Entry Point"]:::entry
    end

    subgraph "Presentation Layer"
        UI["UI Layer"]:::frontend
        SVG["SVG Assets"]:::frontend
    end

    subgraph "Orchestration Layer"
        Controller["Controller"]:::backend
        Config["Config Loader"]:::config
    end

    subgraph "Business & Services"
        Auth["Authentication Service"]:::service
        DestinyAPI["Destiny API Client"]:::service
        ArmorCleaner["ArmorCleaner"]:::service
        Workers["Workers"]:::service
    end

    External["External Destiny API"]:::external

    Main --> UI
    Main --> Controller
    UI --> Controller
    Controller --> Config
    Controller --> Auth
    Auth --> DestinyAPI
    DestinyAPI --> External
    Controller --> ArmorCleaner
    Controller --> Workers
    Workers --> Controller
    Controller --> UI

    click Main "https://github.com/walkerad03/d2-armor-filter/blob/main/main.py"
    click UI "https://github.com/walkerad03/d2-armor-filter/blob/main/src/ui.py"
    click SVG "https://github.com/walkerad03/d2-armor-filter/tree/main/src/assets/svg"
    click Controller "https://github.com/walkerad03/d2-armor-filter/blob/main/src/controller.py"
    click Config "https://github.com/walkerad03/d2-armor-filter/blob/main/config.ini"
    click Auth "https://github.com/walkerad03/d2-armor-filter/blob/main/src/auth.py"
    click DestinyAPI "https://github.com/walkerad03/d2-armor-filter/blob/main/src/destiny_api.py"
    click ArmorCleaner "https://github.com/walkerad03/d2-armor-filter/blob/main/src/armor_cleaner.py"
    click Workers "https://github.com/walkerad03/d2-armor-filter/blob/main/src/workers.py"

    classDef frontend fill:#f9f,stroke:#333,stroke-width:1px
    classDef backend fill:#bbf,stroke:#333,stroke-width:1px
    classDef service fill:#bfb,stroke:#333,stroke-width:1px
    classDef external fill:#ffb,stroke:#333,stroke-width:1px
    classDef config fill:#fbf,stroke:#333,stroke-width:1px
    classDef entry fill:#ffa,stroke:#333,stroke-width:1px
```
