first

README.md

@@ -0,0 +1,113 @@
+# postinstall-debian
+
+Framework Bash modulaire de post-installation pour Debian 13, pense pour etre lance via `curl | bash`.
+
+## Objectif
+
+Fournir une base propre pour :
+
+- installer des outils
+- appliquer des configurations
+- regrouper des modules par profil ou materiel
+- proposer une interface console simple
+- tester les modules isolemment
+
+## Etat actuel
+
+Le depot contient maintenant une architecture initiale :
+
+- un point d'entree `install.sh`
+- un noyau `core/`
+- des bibliotheques reutilisables `lib/`
+- des menus interactifs par categorie
+- des modules systeme, reseau, hardware, boot et conteneurs
+- l'arborescence cible du framework
+
+## Demarrage local
+
+Execution recommandee pour tester le bootstrap :
+
+```bash
+sudo bash install.sh
+```
+
+Le script ouvre ensuite un menu interactif. Pour le premier module disponible :
+
+```bash
+sudo bash install.sh
+```
+
+Puis :
+
+```text
+4. Configuration systeme
+1. system/user-groups
+2. system/user-sudo
+```
+
+Exemple pour `system/user-groups` :
+
+```text
+4
+1
+gilles
+audio,video,plugdev,dialout,netdev,lpadmin,scanner
+```
+
+Exemple pour `network/ssh-server` :
+
+```text
+1
+1
+7
+22
+y
+n
+```
+
+Exemple pour `network/mdns-avahi` :
+
+```text
+1
+1
+3
+y
+y
+```
+
+Exemple pour `network/identity` :
+
+```text
+1
+1
+1
+monpc
+local
+```
+
+Exemple pour `network/ip-config` :
+
+```text
+1
+1
+2
+enp0s31f6
+static
+10.0.0.25
+22
+10.0.0.1
+10.0.0.1
+```
+
+## Prochaines etapes
+
+- remplir `tools.md`
+- ajouter les modules suivants
+- implementer les menus interactifs
+- ajouter des tests shell et ShellCheck
+
+## Validation reseau
+
+Une checklist de validation LAN est disponible ici :
+
+- [docs/lan-validation.md](/home/gilles/Documents/vscode/postinstall-debian/docs/lan-validation.md)