## USAGE

## Prérequis

- Docker et docker compose installés
- Nginx installé localement (hors Docker)
- Grafana installé localement (hors Docker)

## Installation locale

- Cloner le dépôt et se placer à la racine
- Vérifier la présence des répertoires `modules/` et `projects/` avec `conf/`, `data/`, `logs/`, `scripts/`
- Vérifier la disponibilité des images taggées `:dev` (en cours de création) ou utiliser des tags stables le cas échéant

## Démarrage

### Services Docker
- Tester la configuration : `docker compose config --services`
- Démarrer les services externes : `docker compose up -d tor bitcoin blindbit miniback-postgres`
- Démarrer les services 4NK : `docker compose up -d sdk_storage sdk_relay1 sdk_relay2 sdk_relay3 sdk_signer ihm_client`

### Services locaux
- Démarrer Nginx local : `systemctl start nginx`
- Démarrer Grafana local : `systemctl start grafana-server`

### Services IA (optionnel)
- Cloner le repository IA : `git clone https://git.4nkweb.com/4nk/4NK_IA.git`
- Basculer sur le tag dev : `cd 4NK_IA && git checkout dev`
- Suivre les instructions d'installation dans le repository 4NK_IA

### Accès aux services
- IHM: `http://localhost/`
- Blindbit: `http://localhost/blindbit/`
- SDK Storage: `http://localhost/sdk_storage/`
- Relais HTTP: `http://localhost/relay1/`, `/relay2/`, `/relay3/`
- Relais WebSocket: `ws://localhost/relay1/ws/` (idem `relay2`, `relay3`)
- Signer WS: `ws://localhost/signer/ws/`; HTTP: `http://localhost/signer/`
- Coffre: `http://localhost/coffre/`
- Grafana: `http://localhost:3000/` (direct) ou `http://localhost/grafana/` (via Nginx)

## Commandes utiles

### Docker
- Mettre à jour les images: `docker compose pull`
- Voir les logs des services (montés): `tail -f modules/<service>/logs/*`

### Services locaux
- Voir les logs Nginx: `tail -f /var/log/nginx/4nk_node.access.log`
- Voir les logs Grafana: `journalctl -u grafana-server -f`
- Redémarrer Nginx: `systemctl restart nginx`
- Redémarrer Grafana: `systemctl restart grafana-server`

### Monitoring
- Grafana local: `http://localhost:3000/` (admin/admin)
- Logs des services Docker: montés dans `modules/*/logs/` et `projects/*/*/logs/`
- Configuration Grafana: `log/grafana-datasources.yml` et `log/grafana-dashboards.yml`

## Dépannage

### Docker
- 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`

### Services locaux
- Nginx: vérifier la configuration avec `nginx -t`
- Grafana: vérifier le statut avec `systemctl status grafana-server`
- Le reverse proxy Nginx pointe vers `127.0.0.1` avec les ports exposés par Docker Compose
- En cas de changement de ports dans `docker-compose.yml`, mettre à jour `conf/nginx/sites-enabled/4nk_node.conf`

## 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/`.
  - Services IA: voir le repository [4NK_IA](https://git.4nkweb.com/4nk/4NK_IA.git) sur le tag `dev`