auto_clea
All checks were successful
Docker Build and Push (ext) / build (push) Successful in 1m15s

This commit is contained in:
4NK CI Bot 2025-09-25 15:24:56 +00:00
parent 09c2d1f969
commit b1be8e65ac
15 changed files with 44 additions and 425 deletions

View File

@ -50,3 +50,6 @@
34 - Dans le menu, je peux me déconnecter avec le bouton "Disconnect"
## TO DO
### Documentation centralisée
- Voir `/home/debian/4NK_env/docs/ihm_client/`

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 1.9 MiB

View File

@ -1,39 +0,0 @@
## Analyse détaillée
### Périmètre
Client front (Vite) intégrant un package WASM préconstruit `pkg/` et Nginx pour le dev.
### Stack
- **Outillage**: Vite 5, TypeScript 5
- **WASM**: paquet `sdk_client` précompilé (copié dans `pkg/`)
- **UI/Libs**: axios, QR, SweetAlert2, plugins Vite (React/Vue activables)
- **Serveur**: Nginx en dev via `start-dev.sh`
### Build et exécution
- Scripts: `build_wasm`, `start` (Vite host 0.0.0.0), `build`, `deploy`.
- Dockerfile: Node 20alpine, installe `git` et `nginx`, `npm install`, copie `nginx.dev.conf`, script de démarrage.
### Ports
- 3003 (exposition dev), 80 via Nginx.
### Risques et points dattention
- Coexistence double serveur (Vite + Nginx) en dev: veiller au routage, CORS et proxys.
- Paquet WASM précompilé: vérifier cohérence de version avec `sdk_client`.
- Absence de tests automatiques; ajouter stratégie `tests/` (unit/integration).
### Actions proposées
- Documenter matrice compatibilité `pkg/``sdk_client` (source, commit/tag, date).
- Ajouter lints/tests en CI; unifier serveur dev (proxy Nginx vers Vite ou inverse).
- Paramétrer variables denv front (URLs relais, API) et fournir `.env.example`.

View File

@ -1,21 +0,0 @@
# Architecture - IHM Client
## Composants
- Frontend embarqué en iframe dans `lecoffre-front`.
## Dépendances
- `sdk_relay` via `VITE_WS_URL`.
- Backend `lecoffre-back-mini` via `VITE_API_BASE_URL`.(sur dev3.4nkweb.com)
## Réseau et ports
- Exposé derrière Nginx via `https://dev4.4nkweb.com/`.
## Variables denvironnement (centralisées)
- Chargement depuis `lecoffre_node/.env.master`.
## Monitoring
- Logs → Promtail → Loki → Grafana (Frontend Services).
## Notes
- Code splitting (`React.lazy`, `Suspense`).
- Pas de `.env` local, configuration via Docker Compose.

View File

@ -1,40 +0,0 @@
# Corrections Appliquées - IHM Client
## Date: 20 Septembre 2025
### 🔧 Corrections Majeures
#### 1. Problème de Configuration WebSocket
**Problème:** L'iframe était bloquée sur "Chargement de l'authentification..." car elle tentait de se connecter à une URL WebSocket inaccessible.
**Solution:**
- Correction de `VITE_BOOTSTRAPURL` pour pointer vers le bootstrap externe
- Configuration des `RELAY_URLS` pour utiliser le relais local et externe
- Mise à jour des variables d'environnement
**Fichiers modifiés:**
- `.env` - Configuration WebSocket corrigée
- `docker-compose.yml` - Variables d'environnement mises à jour
#### 2. Configuration des URLs
**Variables d'environnement:**
```env
BOOTSTRAPURL=wss://dev3.4nkweb.com/ws/
RELAY_URLS=ws://sdk_relay:8090,wss://dev3.4nkweb.com/ws/
```
#### 3. Installation des Outils
**Ajouté dans le Dockerfile:**
- `curl`, `git`, `wget`, `jq`, `telnet`, `npm`, `wscat`
- Outils de diagnostic et de connectivité
### 📊 État Actuel
- **Statut:** ✅ Healthy
- **Connectivité:** Bootstrap et relais configurés
- **URLs:** Correctement mappées
- **Logs:** Optimisés
### 🔄 Prochaines Étapes
- Tests de connectivité WebSocket
- Monitoring des performances
- Optimisations supplémentaires

View File

@ -1,23 +0,0 @@
# Déploiement - IHM Client
## Préparation
- Branche `ext` sur tous les dépôts.
- Variables dans `lecoffre_node/.env.master` (pas de `.env` local).
- Ne pas utiliser `docker compose up -d`.
## Déploiement (orchestrateur)
```bash
cd /home/debian/4NK_env/lecoffre_node
./scripts/start.sh | cat
./scripts/validate-deployment.sh | cat
```
## Vérifications
- `https://dev4.4nkweb.com/` (iframe OK)
- WS `wss://dev4.4nkweb.com/ws/`
- `./scripts/monitor-progress.sh | cat`
## Règles
- Pousser sur `ext` sans déclencher de CI tant que non nécessaire.
- Config centralisée uniquement.
- Logs via Promtail → Loki → Grafana.

View File

@ -1,10 +0,0 @@
# Description des Flux - IHM Client
```mermaid
documentation
```
## Flux principaux
1. Auth notaire via front → IdNot → front → iframe IHM.
2. IHM ↔ Signer (opérations signées).
3. IHM ↔ Relay (WebSocket) pour évènements.

View File

@ -1,17 +0,0 @@
# Description Fonctionnelle - IHM Client
## Objectif
Fournir linterface dinteraction utilisateur (iframe) pour les flux métiers et les opérations liées aux clés Bitcoin (Silent Payment).
## Parcours clés
- Authentification via redirection IdNot (depuis `lecoffre-front`).
- Échanges temps réel via `sdk_relay` (WebSocket).
## Rôles
- Notaire: initie les dossiers, suit létat.
- Client: accède aux dossiers, valide via SMS, téléverse des pièces.
## Résultats attendus
- Affichage fiable de liframe.
- Opérations signées validées.
- Erreurs affichées à lutilisateur, logs collectés.

View File

@ -1,35 +0,0 @@
# Installation - IHM Client
## Prérequis
- Accès au dépôt `4NK_env` (branche `ext`).
- Docker/Compose installés.
- Variables centralisées dans `lecoffre_node/.env.master`.
## Récupération du code
```bash
cd /home/debian/4NK_env
# Assure-toi d'être sur la branche ext dans tous les dépôts
```
## Configuration
- Ne pas créer de `.env` local.
- Renseigner/valider `VITE_*` dans `lecoffre_node/.env.master`.
## Démarrage (via orchestrateur)
- Lancer via `lecoffre_node` (recommandé) :
```bash
cd /home/debian/4NK_env/lecoffre_node
./scripts/start.sh | cat
```
## Accès
- `https://dev4.4nkweb.com/` (intégré via Nginx).
## Vérifications
- Page statut: `https://dev4.4nkweb.com/status/`
- WebSocket: `wss://dev4.4nkweb.com/ws/`
- Logs Grafana.
## Notes
- Brancher IHM via iframe dans `lecoffre-front`.
- Ne pas déclencher de CI depuis ce dépôt; builds images depuis pipelines tag `ext` si nécessaire.

View File

@ -1,6 +0,0 @@
# Qualité Logicielle - IHM Client
- Lint/format: respecter config projet.
- Tests: ajouter vérifs WS et intégration iframe.
- Performance: code splitting et lazy loading.
- Observabilité: logs structurés, erreurs gérées.

View File

@ -1,6 +0,0 @@
# Sécurité - IHM Client
- Pas de secrets dans le code/dépôt.
- Variables via `.env.master` uniquement.
- CSP/headers via Nginx.
- WS sécurisé via `wss://`.

View File

@ -1,22 +0,0 @@
# Description Technique - IHM Client
## Tech stack
- Node.js 20, Vite/React.
- Code splitting (`React.lazy`, `Suspense`).
## Configuration
- Variables `VITE_*` via `lecoffre_node/.env.master`.
- Aucune lecture de `.env` local.
## Interfaces
- WebSocket `VITE_WS_URL` (relay).
- REST `VITE_API_BASE_URL` (backend).
- `VITE_SIGNER_URL` (signer).
## Sécurité
- Aucune clé en dépôt.
- Headers sécurisés via Nginx.
## Observabilité
- Logs Promtail → Loki.
- Dashboards Grafana.

View File

@ -1,6 +0,0 @@
# TODO - IHM Client
- Vérifier intégration iframe avec `lecoffre-front`.
- Tester WS `wss://dev4.4nkweb.com/ws/`.
- Vérifier configuration `VITE_*` via `.env.master`.
- Ajouter dashboards Grafana si manquants.

View File

@ -1,124 +0,0 @@
# Connexion WebSocket - ihm_client
## Architecture de l'iframe
### Structure de fonctionnement
L'iframe `ihm_client` suit une architecture modulaire :
1. **Initialisation** (`router.ts`) :
- `init()` initialise les services
- `Services.getInstance()` crée l'instance singleton
- `connectAllRelays()` établit les connexions WebSocket
2. **Services** (`services/service.ts`) :
- Gestion des connexions WebSocket
- Communication avec les relays
- Gestion des messages et handshakes
3. **WebSocket** (`websockets.ts`) :
- API WebSocket native
- Gestion des événements (open, message, error, close)
## Configuration WebSocket
### Variables d'environnement
```bash
VITE_BOOTSTRAPURL=wss://dev4.4nkweb.com/ws/
RELAY_URLS=wss://dev4.4nkweb.com/ws/,wss://dev3.4nkweb.com/ws/
```
### Connexion aux relays
```typescript
// Dans service.ts
const BOOTSTRAPURL = [import.meta.env.VITE_BOOTSTRAPURL || `wss://${BASEURL}/ws/`];
// Connexion à tous les relays
await services.connectAllRelays();
```
## Gestion des messages
### Handshake
```typescript
public async handleHandshakeMsg(url: string, parsedMsg: any) {
const handshakeMsg: HandshakeMessage = JSON.parse(parsedMsg);
this.updateRelay(url, handshakeMsg.sp_address);
this.currentBlockHeight = handshakeMsg.chain_tip;
}
```
### Mise à jour des adresses relay
```typescript
public updateRelay(wsurl: string, spAddress: string): void {
this.relayAddresses[wsurl] = spAddress;
console.log(`Updated: ${wsurl} -> ${spAddress}`);
}
```
## Communication avec le parent
### Écoute des messages
```typescript
// Dans router.ts
if (window.self !== window.top) {
// L'iframe écoute les messages du parent
window.addEventListener('message', handleMessage);
}
```
### Gestion des erreurs
```typescript
// Détection des fonds insuffisants
if (insufficientFunds) {
await this.triggerAutomaticFundsTransfer();
}
```
## Problèmes résolus
### 1. Configuration WebSocket incorrecte
**Problème :** L'iframe utilisait `ws://sdk_relay:8090/` au lieu de `wss://dev4.4nkweb.com/ws/`.
**Solution :** Correction des variables d'environnement et redémarrage du container.
### 2. Mixed Content errors
**Problème :** Tentative de connexion WS depuis une page HTTPS.
**Solution :** Utilisation de WSS (WebSocket Secure) pour toutes les connexions.
### 3. Headers WebSocket manquants
**Problème :** Nginx ne transmettait pas les headers WebSocket.
**Solution :** Configuration Nginx avec headers WebSocket explicites.
## Problème persistant
### 502 Bad Gateway
**Statut :** ⚠️ Problème persistant
- L'iframe reçoit 502 Bad Gateway lors de la connexion WebSocket
- Nginx ne transmet pas les headers WebSocket vers le relay
- Le relay rejette les connexions sans headers
**Investigation :** La configuration Nginx semble correcte mais les headers ne sont pas transmis.
## Tests
### Test de connexion WebSocket
```bash
# Depuis l'iframe
wget -O- https://dev4.4nkweb.com/ws/
```
**Résultat actuel :** 502 Bad Gateway
### Test avec headers WebSocket
```bash
curl -v -H "Upgrade: websocket" \
-H "Connection: upgrade" \
-H "Sec-WebSocket-Version: 13" \
-H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" \
https://dev4.4nkweb.com/ws/
```
## Date de mise à jour
2025-01-20 - Architecture de l'iframe analysée et problèmes de connexion WebSocket identifiés

View File

@ -1,31 +0,0 @@
### Objet
Analyse synthétique de `ihm_client` (iframe chargée par `lecoffre-front`).
### Stack et build
- **Outil**: Vite
- **Langage**: TypeScript + HTML templates
- **Cible**: `index.html` + `src/main.ts` (SPA montée en iframe)
- **Serveur dev**: `nginx.dev.conf` et script `start-dev.sh`
### Arborescence notable
- `src/components`: header, modales (confirmation/creation/waiting), login-modal, qrcode-scanner
- `src/pages`: home, chat, account, process, signature (+ variantes)
- `src/services`: database, storage, token, modal, service générique
- `src/utils`: documents, HTML helpers, notifications store, subscriptions utils
- `src/websockets.ts`: temps-réel côté iframe
### Intégrations et communication
- **Token/Session**: `src/services/token.ts`
- **Stockage**: `src/services/storage.service.ts`
- **Base de données**: `src/services/database.service.ts` (cache/worker)
- **Workers**: `service-workers/` (cache/database)
- **Échanges avec parent**: via postMessage (cf. utils/services) et WebSockets
### Points dattention
- Sécurité iframe (sandbox, `postMessage` sécurisé par origine)
- Gestion des tokens (renouvellement, stockage, effacement)
- Cohérence de version avec `lecoffre-front` (API bus/messages)
### Déploiement
- **Dockerfile**: fourni
- **Nginx**: `nginx.dev.conf` pour dev local