# gabriel-rb-devc/oxyohanos architecture

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

- Interactive diagram: https://gitdiagram.com/gabriel-rb-devc/oxyohanos
- Repository: https://github.com/gabriel-rb-devc/oxyohanos

## Overview

OxyohanOS is a Debian-based, customized Linux distribution repository, not a single application. Its user-facing story is a ready-to-use desktop, with a welcome screen and Central Manager for onboarding and system maintenance; the repository also includes an ospkg command that dispatches install, uninstall, and update scripts. The tree shows desktop defaults and package-repository artifacts. README documentation identifies Debian and Calamares, but the sampled tree places installer configuration under a legacy Oxys directory, so it is not treated as a confirmed current OxyohanOS workflow. Connections are limited to README statements and sampled calls.

Main entry points: [`src/centralManager/main.py`](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py) (Central Manager), [`src/ospkg/usr/bin/ospkg.c`](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/ospkg/usr/bin/ospkg.c) (ospkg dispatcher), [`src/SkelXfceConfig`](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/SkelXfceConfig) (XFCE defaults), [`src/welcome_to_Oxyohan/main.py`](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/welcome_to_Oxyohan/main.py) (Welcome window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_xfce["XFCE defaults"]
  node_welcome["Welcome window<br/>[main.py]"]
end

subgraph group_maintenance["System maintenance"]
  node_manager["Central Manager<br/>[main.py]"]
  node_systemctl["Service controls<br/>[main.py]"]
  node_diagnostics["Diagnostics<br/>[main.py]"]
  node_useradmin["User administration<br/>[main.py]"]
end

subgraph group_packages["Package operations"]
  node_ospkg["ospkg dispatcher<br/>[ospkg.c]"]
  node_install["Install scripts"]
  node_uninstall["Uninstall scripts"]
  node_update["Update script<br/>[update.sh]"]
end

subgraph group_distribution["Distribution assets"]
  node_aptrepo[("APT repository")]
  node_calamares["Calamares installer"]
end

node_user(("Oxyohan user"))
node_debian["Debian base"]

node_debian -->|"customizes"| node_xfce
node_user -.->|"opens"| node_welcome
node_user -->|"runs"| node_manager
node_manager -->|"dispatches"| node_systemctl
node_manager -->|"dispatches"| node_diagnostics
node_manager -->|"dispatches"| node_useradmin
node_user -.->|"invokes"| node_ospkg
node_ospkg -->|"executes"| node_install
node_ospkg -->|"executes"| node_uninstall
node_ospkg -->|"executes"| node_update
node_debian -.->|"uses packages"| node_aptrepo
node_user -.->|"installs with"| node_calamares

click node_xfce "https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/SkelXfceConfig"
click node_welcome "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/welcome_to_Oxyohan/main.py"
click node_manager "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py"
click node_systemctl "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py"
click node_diagnostics "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py"
click node_useradmin "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py"
click node_ospkg "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/ospkg/usr/bin/ospkg.c"
click node_install "https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/ospkg/usr/share/ospkg/receita"
click node_uninstall "https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/ospkg/usr/share/ospkg/app-uninstall"
click node_update "https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/ospkg/usr/share/ospkg/update/update.sh"
click node_aptrepo "https://github.com/gabriel-rb-devc/oxyohanos/tree/main/dists/stable"
click node_calamares "https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/oxys-pack-old/calamares-config"

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_xfce,node_welcome,node_user toneBlue
class node_manager,node_systemctl,node_diagnostics,node_useradmin toneAmber
class node_ospkg,node_install,node_uninstall,node_update toneMint
class node_aptrepo,node_calamares toneRose
class node_debian toneIndigo
```

## Components

### Desktop experience

- [XFCE defaults](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/SkelXfceConfig): `src/SkelXfceConfig`
- [Welcome window](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/welcome_to_Oxyohan/main.py): `src/welcome_to_Oxyohan/main.py`

### System maintenance

- [Central Manager](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py): `src/centralManager/main.py`
- [Service controls](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py): `src/centralManager/main.py`
- [Diagnostics](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py): `src/centralManager/main.py`
- [User administration](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/centralManager/main.py): `src/centralManager/main.py`

### Package operations

- [ospkg dispatcher](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/ospkg/usr/bin/ospkg.c): `src/ospkg/usr/bin/ospkg.c`
- [Install scripts](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/ospkg/usr/share/ospkg/receita): `src/ospkg/usr/share/ospkg/receita`
- [Uninstall scripts](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/ospkg/usr/share/ospkg/app-uninstall): `src/ospkg/usr/share/ospkg/app-uninstall`
- [Update script](https://github.com/gabriel-rb-devc/oxyohanos/blob/main/src/ospkg/usr/share/ospkg/update/update.sh): `src/ospkg/usr/share/ospkg/update/update.sh`

### Distribution assets

- [APT repository](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/dists/stable): `dists/stable`
- [Calamares installer](https://github.com/gabriel-rb-devc/oxyohanos/tree/main/src/oxys-pack-old/calamares-config): `src/oxys-pack-old/calamares-config`

### Other components

- **Oxyohan user**
- **Debian base**

## Connections

- Debian base → XFCE defaults: customizes (evidence: `README.md`)
- Oxyohan user → Welcome window: opens
- Oxyohan user → Central Manager: runs (evidence: `src/centralManager/main.py`)
- Central Manager → Service controls: dispatches (evidence: `src/centralManager/main.py`)
- Central Manager → Diagnostics: dispatches (evidence: `src/centralManager/main.py`)
- Central Manager → User administration: dispatches (evidence: `src/centralManager/main.py`)
- Oxyohan user → ospkg dispatcher: invokes
- ospkg dispatcher → Install scripts: executes (evidence: `src/ospkg/usr/bin/ospkg.c`)
- ospkg dispatcher → Uninstall scripts: executes (evidence: `src/ospkg/usr/bin/ospkg.c`)
- ospkg dispatcher → Update script: executes (evidence: `src/ospkg/usr/bin/ospkg.c`)
- Debian base → APT repository: uses packages
- Oxyohan user → Calamares installer: installs with (evidence: `README.md`)
