liquiSync

liquiSync — Le Flux de Données Indestructible & Conscient

**liquiSync** est un utilitaire de synchronisation haute performance, multi-OS, développé en Rust. Il garantit une réplication instantanée et résiliente entre les stations Cloud, Maison et Mobile de l'infrastructure Rustlets.

🚀 Vision et Architecture (v5.2)

liquiSync ne se contente plus de déplacer des fichiers ; il assure la **Conscience Système** de l'infrastructure :

- **Moteur v5.2** : Basé sur `notify-rs` (capture native) et `tokio` (asynchrone).

- **Intégrité Blake3** : Chaque "particule" (fichier) est scellée par un hash Blake3 avant l'envoi.

- **Validateur de Séquence** : Numérotation des lots (Seq: X) pour garantir l'ordre temporel des modifications.

- **ACL Guard** : Préservation intelligente des permissions d'exécution (+x) lors des transferts Multi-OS.

📊 Benchmarks de Guerre (Test "Chaos Colony")

:-------------------:-------------------:------------------:-------------------------------
**Concurrent Users**N/A (Manuel)1-2 (Crash SSH)**30+ (Chaos Colony Validé)**
**Efficacité Batch**0% (1 envoi/fichier)10%**95% (Optimisation native)**
**Résilience**Nulle (Abort)Faible (Retry brut)**Backoff Exponentiel + Jitter**
**Intégrité**BasiqueBasique**Scellé Blake3 + ACL Check**

🛠️ Installation et Déploiement

### 1. Compilation Native

Le binaire doit être compilé sur chaque OS pour garantir la compatibilité GLIBC (Linux) et ARM64 (Mac) :

cd ~/RUSTLETS/1-DEV/LIQUISYNC
cargo build --release
sudo cp target/release/liquisync /usr/local/bin/

### 2. Configuration (Variables d'environnement)

- **`RUSTLETS_ROOT`** : Chemin racine (ex: `/home/leblondx/RUSTLETS`)

- **`LIQUISYNC_TARGET`** : Alias SSH du Hub (ex: `rc`)

🔍 Observabilité & KPIs

liquiSync expose ses métriques en temps réel pour **Beszel** :

- **Chemin de stat (RAM)** : `/dev/shm/liquisync_last_stats.json` (Linux) ou `/tmp/` (Mac).

- **KPIs D'Or** :

- **Latency** : Délai de capture (< 1.5s).

- **Sync Speed** : Performance réseau réelle.

- **Batch Size** : Nombre de fichiers par session.

📁 Gestion des Exclusions

Protection native du CPU via filtrage applicatif :

- `node_modules/`, `.git/`

- `target/`, `dist/`, `build/`

- Journaux SQLite (`-journal`, `.db-wal`, `.db-shm`)

_liquiSync — L'épine dorsale de la liquidité Rustlets. Stable. Observable. Indestructible._

← index