# alasaihi001/user-provisioning-system architecture

> Architecture diagram of the GitHub repository alasaihi001/user-provisioning-system, 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/alasaihi001/user-provisioning-system
- Repository: https://github.com/alasaihi001/user-provisioning-system

## Overview

C’est un CLI d’administration Linux pour l’onboarding et le cycle de vie des comptes. Le parcours principal va de la saisie ou de l’import à la validation, puis au provisionnement du compte, de son quota, de ses règles sudo et, facultativement, de sa clé SSH; l’audit contrôle ensuite la conformité. Les groupes, l’état des comptes, les ACL et la suppression complète sont aussi des branches fonctionnelles. Les relations s’appuient sur les extraits, l’index des sources et le README; les scripts Bash individuels n’ont pas été échantillonnés.

Main entry points: [`modules/user_manager.py`](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/user_manager.py) (Gestion utilisateurs), [`ui/menu.py`](https://github.com/alasaihi001/user-provisioning-system/blob/main/ui/menu.py) (Menu interactif), [`modules/role_manager.py`](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/role_manager.py) (Rôles et privilèges), [`modules/quota_manager.py`](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/quota_manager.py) (Quotas disque)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Interface et configuration"]
  node_main["Entrée CLI<br/>[main.py]"]
  node_menu["Menu interactif<br/>[menu.py]"]
  node_settings["Paramètres<br/>[settings.json]"]
  node_roleconfig["Définition des rôles<br/>[roles.json]"]
  node_configloader["Chargement config<br/>[config_loader.py]"]
end

subgraph group_identity["Identités et import"]
  node_importer["Import CSV/JSON<br/>[csv_importer.py]"]
  node_validators["Validation des entrées<br/>[validators.py]"]
  node_users["Gestion utilisateurs<br/>[user_manager.py]"]
  node_groups["Gestion groupes<br/>[group_manager.py]"]
end

subgraph group_provision["Provisionnement et conformité"]
  node_provisioner["Orchestration provisionnement<br/>[provisioning.py]"]
  node_audit["Audit conformité<br/>[provisioning.py]"]
end

subgraph group_access["Accès et stockage"]
  node_roles["Rôles et privilèges<br/>[role_manager.py]"]
  node_quotas["Quotas disque<br/>[quota_manager.py]"]
  node_ssh["Clés SSH<br/>[ssh_manager.py]"]
end

subgraph group_runtime["Opérations système"]
  node_runner["Exécution sécurisée<br/>[system_runner.py]"]
  node_scripts["Opérations Bash"]
  node_logging["Journal d’administration<br/>[logger_config.py]"]
end

node_operator(("Administrateur"))
node_linux["Système Linux"]

node_operator -->|"lance CLI"| node_main
node_main -->|"charge config"| node_configloader
node_configloader -->|"lit paramètres"| node_settings
node_configloader -->|"lit rôles"| node_roleconfig
node_main -->|"ouvre menu"| node_menu
node_main -->|"lance audit"| node_audit
node_menu -->|"analyse fichiers"| node_importer
node_menu -->|"demande provisionnement"| node_provisioner
node_menu -->|"gère comptes"| node_users
node_menu -->|"gère groupes"| node_groups
node_menu -->|"gère quotas"| node_quotas
node_menu -->|"gère rôles"| node_roles
node_menu -->|"gère clés"| node_ssh
node_importer -->|"valide lignes"| node_validators
node_importer -->|"transmet données"| node_users
node_provisioner -->|"crée compte"| node_users
node_provisioner -->|"applique quota"| node_quotas
node_provisioner -->|"applique sudo"| node_roles
node_provisioner -->|"installe clé"| node_ssh
node_audit -->|"inspecte compte"| node_users
node_audit -->|"contrôle quota"| node_quotas
node_audit -->|"contrôle sudo"| node_roles
node_audit -->|"contrôle clés"| node_ssh
node_users -->|"valide compte"| node_validators
node_users -->|"exécute commandes"| node_runner
node_groups -->|"utilise fonctions"| node_users
node_groups -->|"vérifie groupes"| node_validators
node_quotas -->|"lit détails"| node_users
node_quotas -->|"exécute commandes"| node_runner
node_roles -->|"lit rôle quota"| node_quotas
node_roles -->|"gère groupes rôle"| node_groups
node_roles -->|"lit et change"| node_users
node_roles -->|"exécute commandes"| node_runner
node_ssh -->|"vérifie compte"| node_users
node_ssh -->|"valide clé"| node_runner
node_users -->|"appelle scripts"| node_scripts
node_groups -->|"appelle scripts"| node_scripts
node_quotas -->|"appelle scripts"| node_scripts
node_ssh -->|"appelle scripts"| node_scripts
node_runner -->|"exécute commandes"| node_linux
node_scripts -->|"modifie système"| node_linux
node_users -->|"journalise actions"| node_logging
node_provisioner -->|"journalise étapes"| node_logging
node_roles -->|"journalise actions"| node_logging

click node_main "https://github.com/alasaihi001/user-provisioning-system/blob/main/main.py"
click node_menu "https://github.com/alasaihi001/user-provisioning-system/blob/main/ui/menu.py"
click node_settings "https://github.com/alasaihi001/user-provisioning-system/blob/main/config/settings.json"
click node_roleconfig "https://github.com/alasaihi001/user-provisioning-system/blob/main/config/roles.json"
click node_configloader "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/config_loader.py"
click node_importer "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/csv_importer.py"
click node_validators "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/validators.py"
click node_users "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/user_manager.py"
click node_groups "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/group_manager.py"
click node_provisioner "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/provisioning.py"
click node_audit "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/provisioning.py"
click node_roles "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/role_manager.py"
click node_quotas "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/quota_manager.py"
click node_ssh "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/ssh_manager.py"
click node_runner "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/system_runner.py"
click node_scripts "https://github.com/alasaihi001/user-provisioning-system/tree/main/scripts"
click node_logging "https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/logger_config.py"

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_main,node_menu,node_settings,node_roleconfig,node_configloader toneBlue
class node_importer,node_validators,node_users,node_groups toneAmber
class node_provisioner,node_audit toneMint
class node_roles,node_quotas,node_ssh toneRose
class node_runner,node_scripts,node_logging,node_operator,node_linux toneIndigo
```

## Components

### Interface et configuration

- [Entrée CLI](https://github.com/alasaihi001/user-provisioning-system/blob/main/main.py): `main.py`
- [Menu interactif](https://github.com/alasaihi001/user-provisioning-system/blob/main/ui/menu.py): `ui/menu.py`
- [Paramètres](https://github.com/alasaihi001/user-provisioning-system/blob/main/config/settings.json): `config/settings.json`
- [Définition des rôles](https://github.com/alasaihi001/user-provisioning-system/blob/main/config/roles.json): `config/roles.json`
- [Chargement config](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/config_loader.py): `modules/config_loader.py`

### Identités et import

- [Import CSV/JSON](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/csv_importer.py): `modules/csv_importer.py`
- [Validation des entrées](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/validators.py): `modules/validators.py`
- [Gestion utilisateurs](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/user_manager.py): `modules/user_manager.py`
- [Gestion groupes](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/group_manager.py): `modules/group_manager.py`

### Provisionnement et conformité

- [Orchestration provisionnement](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/provisioning.py): `modules/provisioning.py`
- [Audit conformité](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/provisioning.py): `modules/provisioning.py`

### Accès et stockage

- [Rôles et privilèges](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/role_manager.py): `modules/role_manager.py`
- [Quotas disque](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/quota_manager.py): `modules/quota_manager.py`
- [Clés SSH](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/ssh_manager.py): `modules/ssh_manager.py`

### Opérations système

- [Exécution sécurisée](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/system_runner.py): `modules/system_runner.py`
- [Opérations Bash](https://github.com/alasaihi001/user-provisioning-system/tree/main/scripts): `scripts`
- [Journal d’administration](https://github.com/alasaihi001/user-provisioning-system/blob/main/modules/logger_config.py): `modules/logger_config.py`

### Other components

- **Administrateur**
- **Système Linux**

## Connections

- Administrateur → Entrée CLI: lance CLI (evidence: `README.md`)
- Entrée CLI → Chargement config: charge config (evidence: `main.py`)
- Chargement config → Paramètres: lit paramètres (evidence: `modules/config_loader.py`)
- Chargement config → Définition des rôles: lit rôles (evidence: `modules/config_loader.py`)
- Entrée CLI → Menu interactif: ouvre menu (evidence: `main.py`)
- Entrée CLI → Audit conformité: lance audit (evidence: `main.py`)
- Menu interactif → Import CSV/JSON: analyse fichiers (evidence: `ui/menu.py`)
- Menu interactif → Orchestration provisionnement: demande provisionnement (evidence: `ui/menu.py`)
- Menu interactif → Gestion utilisateurs: gère comptes (evidence: `ui/menu.py`)
- Menu interactif → Gestion groupes: gère groupes (evidence: `ui/menu.py`)
- Menu interactif → Quotas disque: gère quotas (evidence: `ui/menu.py`)
- Menu interactif → Rôles et privilèges: gère rôles (evidence: `ui/menu.py`)
- Menu interactif → Clés SSH: gère clés (evidence: `ui/menu.py`)
- Import CSV/JSON → Validation des entrées: valide lignes (evidence: `modules/csv_importer.py`)
- Import CSV/JSON → Gestion utilisateurs: transmet données (evidence: `modules/csv_importer.py`)
- Orchestration provisionnement → Gestion utilisateurs: crée compte (evidence: `modules/provisioning.py`)
- Orchestration provisionnement → Quotas disque: applique quota (evidence: `modules/provisioning.py`)
- Orchestration provisionnement → Rôles et privilèges: applique sudo (evidence: `modules/provisioning.py`)
- Orchestration provisionnement → Clés SSH: installe clé (evidence: `modules/provisioning.py`)
- Audit conformité → Gestion utilisateurs: inspecte compte (evidence: `modules/provisioning.py`)
- Audit conformité → Quotas disque: contrôle quota (evidence: `modules/provisioning.py`)
- Audit conformité → Rôles et privilèges: contrôle sudo (evidence: `modules/provisioning.py`)
- Audit conformité → Clés SSH: contrôle clés (evidence: `modules/provisioning.py`)
- Gestion utilisateurs → Validation des entrées: valide compte (evidence: `modules/user_manager.py`)
- Gestion utilisateurs → Exécution sécurisée: exécute commandes (evidence: `modules/user_manager.py`)
- Gestion groupes → Gestion utilisateurs: utilise fonctions (evidence: `modules/group_manager.py`)
- Gestion groupes → Validation des entrées: vérifie groupes (evidence: `modules/group_manager.py`)
- Quotas disque → Gestion utilisateurs: lit détails (evidence: `modules/quota_manager.py`)
- Quotas disque → Exécution sécurisée: exécute commandes (evidence: `modules/quota_manager.py`)
- Rôles et privilèges → Quotas disque: lit rôle quota (evidence: `modules/role_manager.py`)
- Rôles et privilèges → Gestion groupes: gère groupes rôle (evidence: `modules/role_manager.py`)
- Rôles et privilèges → Gestion utilisateurs: lit et change (evidence: `modules/role_manager.py`)
- Rôles et privilèges → Exécution sécurisée: exécute commandes (evidence: `modules/role_manager.py`)
- Clés SSH → Gestion utilisateurs: vérifie compte (evidence: `modules/ssh_manager.py`)
- Clés SSH → Exécution sécurisée: valide clé (evidence: `modules/ssh_manager.py`)
- Gestion utilisateurs → Opérations Bash: appelle scripts (evidence: `README.md`)
- Gestion groupes → Opérations Bash: appelle scripts (evidence: `README.md`)
- Quotas disque → Opérations Bash: appelle scripts (evidence: `README.md`)
- Clés SSH → Opérations Bash: appelle scripts (evidence: `modules/ssh_manager.py`)
- Exécution sécurisée → Système Linux: exécute commandes (evidence: `modules/system_runner.py`)
- Opérations Bash → Système Linux: modifie système (evidence: `README.md`)
- Gestion utilisateurs → Journal d’administration: journalise actions (evidence: `modules/user_manager.py`)
- Orchestration provisionnement → Journal d’administration: journalise étapes (evidence: `modules/provisioning.py`)
- Rôles et privilèges → Journal d’administration: journalise actions (evidence: `modules/role_manager.py`)
