docs(portal): doc d'administration + guide utilisateur

- admin/k8s/auth-portal-admin.md : exploitation au quotidien — cycle de
  vie utilisateur (créer/groupe guacamole/assigner/révoquer), gestion des
  machines et des apps du hub, durcissement (MFA), table de débogage
- docs/portail-guide-utilisateur.md : guide grand public à envoyer aux
  utilisateurs (connexion, console, presse-papiers, règles, dépannage)
- renvois croisés depuis auth-portal.md et CLAUDE.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/portail-guide-utilisateur.md

@@ -0,0 +1,59 @@
+# 🖥️ Accéder aux machines du lab Funk — guide utilisateur
+
+Bienvenue ! Ce guide t'explique comment ouvrir un **terminal sur les serveurs du lab,
+directement dans ton navigateur**. Rien à installer.
+
+## Ce qu'il te faut
+
+- Un navigateur (PC, Mac, tablette… ça marche partout)
+- Ton **compte** : un nom d'utilisateur + mot de passe fournis par Ali
+- L'adresse du portail : **http://kaya.freeboxos.fr:9081**
+
+## Se connecter (30 secondes)
+
+1. Ouvre **http://kaya.freeboxos.fr:9081**
+2. Entre ton nom d'utilisateur puis ton mot de passe
+3. Tu arrives sur **ta page d'applications** : chaque vignette est un service auquel
+   tu as accès
+4. Clique sur **« Portail consoles »** → tu es connecté automatiquement (pas de
+   deuxième mot de passe)
+5. Clique sur une machine (ex. *Console s01* ou *Console g01*) → **un terminal
+   s'ouvre dans l'onglet** — tu es dessus, tu peux taper des commandes
+
+> 💡 À ta **toute première** connexion, il est possible que tu voies « aucune
+> machine » : c'est normal, Ali doit t'attribuer les accès après ton premier login.
+> Préviens-le, puis reconnecte-toi.
+
+## Utiliser la console
+
+- C'est un **vrai terminal Linux** : `ls`, `htop`, `df -h`, `exit`… tape comme si tu
+  y étais
+- **Le menu magique : `Ctrl + Alt + Shift`** — ouvre un panneau latéral avec :
+  - le **presse-papiers** : colle du texte dedans → clic droit/collage dans le
+    terminal ; et inversement pour copier vers ton PC
+  - les réglages d'affichage (zoom, clavier)
+  - le bouton **Déconnexion**
+- Pour quitter : referme l'onglet, ou `Ctrl+Alt+Shift` → Disconnect. (Ta session se
+  ferme aussi toute seule après un moment d'inactivité.)
+- Retour à la liste des machines : bouton « Home » du menu, ou ré-ouvre le portail
+
+## Les règles du jeu 🤝
+
+- Ton compte est **personnel** — ne le prête pas, ne partage pas ton mot de passe
+- Tu es connecté avec un utilisateur **sans droits d'administration** : tu peux
+  observer et utiliser, pas casser — c'est fait exprès 😉
+- Les connexions sont **journalisées** (qui, quand, sur quelle machine)
+- Un doute, une commande qui te dépasse ? Demande avant de taper
+
+## En cas de pépin
+
+| Problème | Solution |
+|---|---|
+| La page ne charge pas | Vérifie l'adresse exacte (avec le `:9081`) et ta connexion |
+| Mot de passe refusé | Attention aux majuscules ; sinon demande une réinitialisation à Ali |
+| « Trop de tentatives » | Patiente 5 minutes, puis réessaie calmement |
+| La vignette « Portail consoles » n'apparaît pas | Ton compte n'est pas encore activé pour le portail — préviens Ali |
+| Terminal noir ou « connexion refusée » | La machine est peut-être éteinte — préviens Ali |
+| Le copier/coller ne marche pas | Passe par le presse-papiers du menu `Ctrl+Alt+Shift` |
+
+Bonne exploration 🚀