lecoffre_node/docs/ARCHITECTURE.md

2.6 KiB

Architecture LeCoffre Node

Vue d'ensemble

LeCoffre Node est un projet de configuration Docker Compose qui orchestre les services nécessaires pour l'application LeCoffre.

Services

Services Locaux (dev4.4nkweb.com)

  • sdk_relay : Service de relais WebSocket (ports 8090-8091)
  • sdk_storage : Service de stockage (port 8081)
  • bitcoin-signet : Nœud Bitcoin Signet
  • blindbit-oracle : Oracle blockchain (port 8000)
  • tor-proxy : Proxy Tor
  • signet_miner : Mineur Signet
  • watchtower : Surveillance des conteneurs

Services Distants

Configuration des Connexions

lecoffre-back

environment:
  - SIGNER_WS_URL=ws://dev3.4nkweb.com:9090
  - RELAY_URLS=ws://sdk_relay:8090
  - SIGNER_BASE_URL=https://dev3.4nkweb.com

ihm_client

environment:
  - REACT_APP_RELAY_URL=ws://sdk_relay:8090

Séquence de Démarrage

Script Optimisé

Le script scripts/startup-sequence.sh utilise les healthchecks Docker Compose pour orchestrer le démarrage :

  1. Services de base : tor, bitcoin, blindbit, sdk_storage
  2. sdk_relay : Attend que blindbit soit healthy, puis démarre avec healthcheck
  3. ihm_client : Attend que sdk_relay soit healthy
  4. lecoffre-back : Attend que sdk_relay soit healthy
  5. lecoffre-front : Attend que lecoffre-back soit healthy

Healthchecks

Tous les services critiques ont des healthchecks configurés avec des start_period appropriés pour gérer les temps de démarrage.

Problèmes Actuels

dev3.4nkweb.com:9090

Le service signer sur dev3.4nkweb.com:9090 n'est pas accessible :

  • Port 9090 : Connection refused
  • Port 443 : Nginx fonctionne mais services backend retournent 502 Bad Gateway

Impact

  • lecoffre-back ne peut pas se connecter au signer distant
  • ihm_client et lecoffre-front ne peuvent pas démarrer (dépendance)

Solutions Temporaires

En attendant la résolution du problème dev3.4nkweb.com, les options sont :

  1. Utiliser le signer local (sdk_signer)
  2. Attendre que le service signer soit redémarré sur dev3.4nkweb.com

Documentation Technique

Historique

  • 20/09/2025 : Implémentation des améliorations de séquence de démarrage
  • 20/09/2025 : Résolution des problèmes de build CI
  • 20/09/2025 : Documentation de l'architecture et des problèmes de connectivité