# arnevm123/setup architecture

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

- Interactive diagram: https://gitdiagram.com/arnevm123/setup
- Repository: https://github.com/arnevm123/setup

## Overview

##### Project Type Analysis
This is a system configuration automation project using Ansible for managing dotfiles, package installation, and system setup across different Linux distributions (notably Arch and Debian/Ubuntu based systems).

##### Main Components

A. Configuration Sources
- Dotfiles Repository
- SSH Configuration
- Task Definitions
- Base Configuration

B. Package Managers
- APT (Debian/Ubuntu)
- Pacman (Arch)
- Flatpak

C. System Components
- Window Managers (i3, Sway)
- Shell Environment (ZSH)
- Development Tools (Git, Golang)

**[Configuration Sources] → [Ansible Playbook Engine] → [Target System]**

##### Specific Elements

- Rectangles: Configuration files
- Hexagons: Ansible components
- Circles: Package managers
- Rounded rectangles: System components

B. Connections:
- Double lines: Privilege escalation paths

C. Labels:
- Task names
- Tag indicators
- Required privileges
- Configuration paths

##### Important Relationships to Highlight

- How tasks/apt.yml and tasks/arch.yml are mutually exclusive based on the target system
- How tasks/dotfiles.yml manages .ssh and shell configurations
- Demonstrate the relationship between base.yml and individual task files
- How tasks/manual.yml fits into the automation flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Configuration
        Base["Base Configuration"]
        Playbook["Main Playbook"]
        Dotfiles["Dotfiles Repository"]
        SSHConfig["SSH Configuration"]
    end

    subgraph "Task Definitions"
        direction TB
        subgraph "Package Management"
            APTTask["APT Tasks"]
            ArchTask["Arch Tasks"]
            FlatpakTask["Flatpak Tasks"]
        end

        subgraph "Environment Setup"
            ZSHTask["ZSH Configuration"]
            SSHTask["SSH Setup"]
            DotfilesTask["Dotfiles Setup"]
            BaseAppsTask["Base Applications"]
            ManualTask["Manual Tasks"]
        end

        subgraph "UI Configuration"
            I3Task["i3 Setup"]
            SwayTask["Sway Setup"]
        end

        subgraph "Dev Tools"
            GitTask["Git Configuration"]
            GolangTask["Golang Setup"]
        end
    end

    subgraph "Target System"
        direction TB
        subgraph "Package Managers"
            APT["APT"]
            Pacman["Pacman"]
            Flatpak["Flatpak"]
        end

        subgraph "System Components"
            Shell["Shell Environment"]
            WM["Window Managers"]
            DevEnv["Development Environment"]
        end
    end

    %% Relationships
    Base --> Playbook
    Playbook --> APTTask & ArchTask & FlatpakTask
    Playbook --> ZSHTask & SSHTask & DotfilesTask
    Playbook --> I3Task & SwayTask
    Playbook --> GitTask & GolangTask
    
    APTTask --> APT
    ArchTask --> Pacman
    FlatpakTask --> Flatpak
    
    ZSHTask --> Shell
    I3Task & SwayTask --> WM
    GitTask & GolangTask --> DevEnv
    
    SSHConfig --> SSHTask
    Dotfiles --> DotfilesTask

    %% Styling
    classDef config fill:#a8d0e6
    classDef task fill:#95c8d8
    classDef system fill:#f8b195
    classDef pkg fill:#f67280
    
    class Base,Playbook,Dotfiles,SSHConfig config
    class APTTask,ArchTask,FlatpakTask,ZSHTask,SSHTask,DotfilesTask,BaseAppsTask,ManualTask,I3Task,SwayTask,GitTask,GolangTask task
    class Shell,WM,DevEnv system
    class APT,Pacman,Flatpak pkg

    %% Click Events
    click Base "https://github.com/arnevm123/setup/blob/main/base.yml"
    click Playbook "https://github.com/arnevm123/setup/blob/main/playbook.yml"
    click SSHConfig "https://github.com/arnevm123/setup/tree/main/.ssh/"
    click ZSHTask "https://github.com/arnevm123/setup/blob/main/tasks/zsh.yml"
    click APTTask "https://github.com/arnevm123/setup/blob/main/tasks/apt.yml"
    click ArchTask "https://github.com/arnevm123/setup/blob/main/tasks/arch.yml"
    click FlatpakTask "https://github.com/arnevm123/setup/blob/main/tasks/flatpak.yml"
    click I3Task "https://github.com/arnevm123/setup/blob/main/tasks/i3.yml"
    click SwayTask "https://github.com/arnevm123/setup/blob/main/tasks/sway.yml"
    click GitTask "https://github.com/arnevm123/setup/blob/main/tasks/git.yml"
    click GolangTask "https://github.com/arnevm123/setup/blob/main/tasks/golang.yml"
    click BaseAppsTask "https://github.com/arnevm123/setup/blob/main/tasks/baseApps.yml"
    click DotfilesTask "https://github.com/arnevm123/setup/blob/main/tasks/dotfiles.yml"
    click ManualTask "https://github.com/arnevm123/setup/blob/main/tasks/manual.yml"
    click SSHTask "https://github.com/arnevm123/setup/blob/main/tasks/ssh.yml"
```
