[bobdivx]

🎯 Résumé

Ce PR corrige 6 problèmes UI critiques identifiés lors du QA de production sur https://web.briseteia.me (projet ZIMAOS, équipe Root, utilisateur bobdivx).

Bilan : 6/8 symptômes corrigés. Les 2 problèmes majeurs restants nécessitent un accès production et sont documentés dans QA_FINDINGS.md avec analyse technique complète.

---

✅ Corrections implémentées

🔒 Sécurité (CRITIQUE)

• Masquage des secrets dans les tâches planifiées : Les tokens Bearer et API keys affichés en clair dans les commandes cron sont maintenant masqués (••••••)
• Nouveau helper maskSecretsInText() qui détecte et masque automatiquement :
  • Bearer tokens (Bearer xxx → Bearer ••••••)
  • Variables d'environnement sensibles (API_KEY=xxx, TOKEN=xxx, PASSWORD=xxx → masqués)
  • Supporte les formats avec et sans guillemets

🇫🇷 Traduction et grammaire

• Recherche : "Rechercher un application" → "Rechercher une application"
• Recherche bases : "Rechercher un bases de donnée" → "Rechercher une base de données"
• Message 404 : "Resource not found." → "Ressource introuvable."

🏷️ Titres de document

• /connexions/ : "Tokens & Clés API" → "Connexions" (cohérent avec nav)
• /settings/servers/ : "Paramètres" → "Serveurs"
• /settings/projects/ : "Paramètres" → "Projets"

🔍 Recherche URL

• Paramètre ?q= : Maintenant pris en compte à l'initialisation
• Les liens /applications/?q=popcorn fonctionnent correctement

💾 Clarté stockage

• Message disque : "Racine / à 100 % (CasaOS)" → "Partition racine (inodes) saturée — Docker sur autre partition"
• Explique clairement que le disque Docker (15%) est sur une partition différente

---

🚧 Problèmes identifiés mais NON corrigés (hors scope)

1. Status mismatch (apps healthy vs URL unreachable)

Symptôme : /applications/ et /monitoring/ montrent 10/11 apps online, /deployments/ montre 8/11 "En alerte"

Analyse technique :

• ResourceStatusData.php lit Application.status directement (statut Docker container)
• DeploymentTopologyData.php utilise ApplicationReadiness.last_probe_ok qui vient d'un probe HTTP réel via ApplicationDomainProbe
• Une app peut avoir un conteneur Docker running mais être inaccessible via son URL publique

Causes possibles :

• Proxy Traefik : labels Docker incorrects, certificat SSL, règles de routage
• DNS : FQDN ne pointe pas vers le bon serveur
• Firewall : ports 80/443 bloqués
• Health check : conteneur écoute sur mauvais port

Diagnostic requis (voir QA_FINDINGS.md pour commandes détaillées) :

docker inspect <container> | grep -A 20 Labels  # Vérifier labels Traefik
curl -I https://teslarep.briseteia.me           # Tester connectivity
docker logs traefik | grep teslarep             # Logs proxy

Raison hors scope : Nécessite accès SSH production, logs temps réel, et potentiellement régénération labels Traefik ou fix DNS.

---

2. Onglet Logs bloqué sur "Chargement…"

Symptôme : /applications/{uuid}/?tab=logs reste >25s sur "Chargement…"

Analyse technique :

• Route API existe : /api/devforge/v1/applications/{uuid}/logs
• Controller ApplicationContainerLogs.php ligne 24 appelle getCurrentApplicationContainerStatus($server, $application->id)
• Cette fonction fait un appel SSH au serveur Docker qui peut timeout sans error handling

Causes possibles :

• Timeout SSH vers serveur Docker (>25s)
• Exception catchée sans log ni retour JSON
• Fonction helper bloquante sans timeout configuré

Diagnostic requis (voir QA_FINDINGS.md pour commandes détaillées) :

ssh <docker-server> "docker ps"              # Tester SSH
tail -f storage/logs/laravel.log             # Logs backend
curl -H "Authorization: Bearer <token>" \
  https://web.briseteia.me/api/.../logs      # Tester endpoint

Raison hors scope : Nécessite tests réseau sur instance production, inspection logs backend temps réel, et potentiellement fix timeout SSH ou error handling.

---

📦 Fichiers modifiés

Backend (1 fichier) :

• app/Http/Controllers/DevForge/Core/ResourceController.php : Message 404 en français

Frontend (5 fichiers) :

• components/applications/ApplicationScheduledTasksPanel.tsx : Masquage secrets
• components/storage/ServerStorageCard.tsx : Clarification message disque
• lib/routing/routes.ts : Titres cohérents, label "Connexions"
• lib/secret-masking.ts : NOUVEAU - Helper masquage secrets
• pages/resources/_CoreResourcesPage.tsx : Grammaire française, lecture ?q=

Documentation (1 fichier) :

• QA_FINDINGS.md : NOUVEAU - Rapport QA complet avec analyse technique des 2 problèmes majeurs

---

🔐 Sécurité

Impact : Les tokens Bearer et API keys ne sont plus exposés en clair dans l'UI. Le masquage est côté présentation uniquement - les secrets restent accessibles via l'API pour les utilisateurs autorisés (nécessaire pour l'édition).

Patterns détectés :

• Bearer tokens : /\b(bearer)\s+([a-z0-9\-._~+/]+)/gi
• Variables sensibles : /(api[_-]?key|token|password|passwd|secret)/i

---

🧪 Tests suggérés

Tests UI (post-merge)

1. Vérifier que les tokens sont masqués dans les tâches planifiées
2. Tester les recherches avec ?q= fonctionnent
3. Vérifier les titres de document sur /connexions/, /settings/servers/, /settings/projects/
4. Confirmer la grammaire française dans les placeholders de recherche
5. Tester l'affichage du message disque sur /storage/

Tests réseau (accès production requis)

6. Diagnostiquer status mismatch (voir commandes dans QA_FINDINGS.md)
7. Diagnostiquer timeout logs (voir commandes dans QA_FINDINGS.md)

---

🚀 Déploiement

Aucune migration requise. Les changements sont :

• 5 corrections frontend (compilation Astro/Vite requise)
• 1 message d'erreur backend
• 1 nouveau helper TypeScript
• 1 fichier documentation

Pas d'impact sur la base de données ou les APIs existantes.

---

📊 Tableau récapitulatif

Symptôme	Priorité	Status	Fichiers modifiés
1. Status mismatch	MAJEUR	⚠️ Hors scope	—
2. Logs timeout	MAJEUR	⚠️ Hors scope	—
3. Titres document	MINEUR	✅ Corrigé	routes.ts
4. Recherche ?q=	MINEUR	✅ Corrigé	_CoreResourcesPage.tsx
5. Grammaire FR	MINEUR	✅ Corrigé	_CoreResourcesPage.tsx
6. Message 404 EN	MINEUR	✅ Corrigé	ResourceController.php
7. Secrets en clair	SÉCURITÉ	✅ Corrigé	ApplicationScheduledTasksPanel.tsx, secret-masking.ts
8. Message disque	MINEUR	✅ Corrigé	ServerStorageCard.tsx

---

📖 Documentation complète

Consultez QA_FINDINGS.md pour :

• Analyse technique détaillée des 2 problèmes majeurs
• Commandes de diagnostic pour investigation production
• Architecture des sources de données (status Docker vs probe HTTP)
• Schémas de flux de données backend