From c7f9748718a08e58b7b4f61a09925ad43a957223 Mon Sep 17 00:00:00 2001
From: Debian <debian@dev4.novalocal>
Date: Mon, 8 Sep 2025 15:07:32 +0000
Subject: [PATCH] =?UTF-8?q?docs(usage):=20acc=C3=A8s=20depuis=20Windows=20?=
 =?UTF-8?q?(WSL2/VM)=20via=20localhost=20ou=20IP;=20routes=20Nginx?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docker-compose.yml | 77 ++++++++++++++++++++++++++++++++++++++++++++++
 docs/USAGE.md      |  8 ++++-
 2 files changed, 84 insertions(+), 1 deletion(-)

diff --git a/docker-compose.yml b/docker-compose.yml
index fcbc9f46..61b39716 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -292,6 +292,83 @@ services:
         ipv4_address: 172.20.0.40
     restart: unless-stopped
 
+  # Profil monitoring: Loki + Promtail + Grafana
+  loki:
+    image: grafana/loki:2.9.0
+    container_name: 4nk-loki
+    ports:
+      - "3100:3100"
+    command: -config.file=/etc/loki/local-config.yaml
+    volumes:
+      - ./log/loki-config.yaml:/etc/loki/local-config.yaml:ro
+      - loki_data:/loki
+    networks:
+      4nk_network:
+        ipv4_address: 172.20.0.41
+    restart: unless-stopped
+
+  promtail:
+    image: grafana/promtail:2.9.0
+    container_name: 4nk-promtail
+    command: -config.file=/etc/promtail/config.yml
+    volumes:
+      - ./log/promtail-config.yml:/etc/promtail/config.yml:ro
+      - /var/lib/docker/containers:/var/lib/docker/containers:ro
+      - /var/log/docker:/var/log/docker:ro
+      - ./modules:/workspace/modules:ro
+      - ./projects:/workspace/projects:ro
+      - ./log:/workspace/logs:ro
+    networks:
+      4nk_network:
+        ipv4_address: 172.20.0.42
+    restart: unless-stopped
+    depends_on:
+      - loki
+
+  grafana:
+    image: grafana/grafana:10.0.0
+    container_name: 4nk-grafana
+    ports:
+      - "3000:3000"
+    environment:
+      - GF_SECURITY_ADMIN_PASSWORD=admin
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_SERVER_ROOT_URL=%(protocol)s://%(domain)s/grafana
+      - GF_SERVER_SERVE_FROM_SUB_PATH=true
+    volumes:
+      - grafana_data:/var/lib/grafana
+      - ./log/grafana-datasources.yml:/etc/grafana/provisioning/datasources/datasources.yml:ro
+      - ./log/grafana-dashboards.yml:/etc/grafana/provisioning/dashboards/dashboards.yml:ro
+      - ./log/dashboards:/etc/grafana/provisioning/dashboards/dashboards:ro
+    networks:
+      4nk_network:
+        ipv4_address: 172.20.0.43
+    restart: unless-stopped
+    depends_on:
+      - loki
+
+  # Profil outils de développement et diagnostic
+  devtools:
+    image: alpine:3.19
+    container_name: 4nk-devtools
+    command: ["sh", "-c", "sleep infinity"]
+    tty: true
+    stdin_open: true
+    volumes:
+      - ./log:/workspace/logs
+      - ./modules:/workspace/modules:ro
+      - ./projects:/workspace/projects:ro
+    networks:
+      4nk_network:
+        ipv4_address: 172.20.0.44
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "sh", "-lc", "apk info >/dev/null 2>&1"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+
+
 volumes:
   miniback_pg_data:
 
diff --git a/docs/USAGE.md b/docs/USAGE.md
index f071f2a2..f9a2a717 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -37,4 +37,10 @@
 - Vérifier les hostnames Docker internes (DNS du réseau `4nk_network`): voir `docker-compose.yml`
 - Les tags `:dev` sont en cours de création; en cas d’indisponibilité, utiliser des tags stables temporaires
 - Conf Tor: `modules/tor/conf/tor.conf` est montée si l'image Tor supporte `/etc/tor/torrc`
-- Le reverse proxy Nginx s’appuie sur les hostnames Docker (`*.4nk.local`); en cas de changement d’IP/hostnames, mettre à jour `docker-compose.yml` et relancer `nginx`.
\ No newline at end of file
+- Le reverse proxy Nginx s’appuie sur les hostnames Docker (`*.4nk.local`); en cas de changement d’IP/hostnames, mettre à jour `docker-compose.yml` et relancer `nginx`.
+
+## Accès depuis Windows (WSL2 ou VM Linux)
+
+- WSL2 (Docker dans WSL): accéder via le navigateur Windows à `http://localhost/`. Si non accessible, utiliser l’IP WSL (`wsl hostname -I` côté PowerShell) et ouvrir `http://<IP_WSL>/`.
+- VM Linux (Hyper‑V/VirtualBox/VMware): utiliser l’IP de la VM (`ip addr` dans la VM) et ouvrir `http://<IP_VM>/`.
+- Les routes exposées par Nginx: `/`, `/blindbit/`, `/sdk_storage/`, `/relay1/`, `/relay2/`, `/relay3/`, `/signer/`, `/coffre/`, `/grafana/`.
\ No newline at end of file