Concept
Bundle OKF 0.2 · 14 conceitos · matrixNeo76/rustcopy
Open source Repository Open in the app JSON README (API)
About
# Concept
* [Prompt per la prossima sessione](NEXT_SESSION_PROMPT.md) - Handoff di sessione — stato progetto, aree da investigare, convenzioni stabilite. Riscritto ad ogni sessione.
# Log
* [Analisi di Robustezza e Ottimizzazione Prestazioni](ANALYSIS.md) - Audit trail dei difetti D1-D27 e delle opportunità di miglioramento O1-O10.
* [Changelog](CHANGELOG.md) - Cronologia lineare delle versioni, in stile Keep a Changelog.
# Reference
* [AGENTS.md — Developer \& AI Agent Guidelines](AGENTS.md) - Architectural rules, directory tree, and testing conventions for this codebase.
* [Architettura di Sistema — robocopy-ingest-cli](ARCHITECTURE.md) - Diagrammi Mermaid, tabella moduli, pipeline di esecuzione, pattern trasversali (D13/D14).
* [CLAUDE.md — Claude Code \& AI Agent Prompt Instructions](CLAUDE.md) - Technical notes and hard constraints for AI agents working on this codebase.
* [Piano della console rustcopy](PIANO_GUI.md) - Documento unico e vivo per la console (F52-F60) — consoli
Details
- Kind
- OKF bundles
- Topic
- Developer tools
- Publisher
- matrixneo76
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Stars
- 1
- Open pull requests
- 2
- Last push
- 2026-09-09T12:36:59Z
- Repository state
- ativo
- Language
- Rust
- License
- MIT
- Added
- 2026-09-09 12:02:17
- Updated
- 2026-09-09 12:02:17
- Origin id
matrixNeo76/rustcopy:index.md
README
---
type: Reference
title: robocopy-ingest-cli (rustcopy) — README
description: Panoramica del progetto — cosa fa, come si installa, primi comandi e indice della documentazione.
status: stable
generated:
by: process:claude-code
at: 2026-08-06T00:00:00Z
---
<p align="center">
<img src="images/rustcopy.jpg" alt="Logo di rustcopy: un ingranaggio con due frecce intrecciate e la scritta RUSTCOPY" width="220">
</p>
# 🚀 robocopy-ingest-cli (rustcopy)
[](https://github.com/matrixNeo76/rustcopy/actions/workflows/ci.yml)
[](https://github.com/matrixNeo76/rustcopy/actions/workflows/security-audit.yml)
[](LICENSE)
[](Cargo.toml)
**Backup e ingestion di grandi volumi di dati su Windows, con verifica di integrità.** `rustcopy`
avvolge `robocopy.exe` in un binario Rust che ne risolve i limiti pratici sui dataset enormi —
deadlock sulle pipe, saturazione della RAM, nessuna verifica dei checksum — e aggiunge backup a
generazioni, cifratura, scheduling e notifiche. Progettato per volumi da 50 GB a oltre 10 TB con
milioni di file.
```console
$ rustcopy --source C:\dati --dest E:\backup\dati --verify-integrity --hash-algo blake3 `
--report-path E:\backup\report.json --log-path E:\backup\ingest.log
Inventory: 8 file(s) matching *, 2.50 MB
Verifying integrity with Blake3...
Source : C:\dati
Destination : E:\backup\dati
Inventory : 8 file(s), 2.50 MB
Robocopy : 2.50 MB in 0.06s (44.13 MB/s), exit code 1, 0 retry attempt(s)
Integrity : PASSED (8 file(s) checked, 0 mismatch(es), 0 missing)
JSON report: E:\backup\report.json
Log file : E:\backup\ingest.log
```
> [!NOTE]
> I backup li esegue **solo la CLI**, e non c'è monitoraggio live: il progresso si segue dalla
> progress bar a terminale; a run concluso restano il report JSON e la dashboard HTML statica
> (`--html-report-path`).
>
> Dalla milestone **7.0.0** esiste anche una **console desktop** (Tauri, componente opzionale
> dell'installer): mostra job, impostazioni risolte e storico, avvia backup avviando la stessa CLI
> come processo separato, e prepara proposte di configurazione in file nuovi. Non installa servizi
> né pianificazioni, non forza un mirror non presidiato, e non tocca mai la configurazione in uso —
> vedi [ROADMAP.md](ROADMAP.md) e [`PIANO_GUI.md`](PIANO_GUI.md).
---
## 📚 Documentazione
| Documento | Contenuto |
|---|---|
| 📋 **[Riferimento CLI](docs/cli-reference.md)** | Tutti i flag, i codici di uscita e il comportamento dettagliato di ogni funzionalità. |
| 📦 **[Installazione](docs/installation.md)** | Requisiti, installer Windows, deploy silenzioso, notify-server. |
| 📖 **[RUNBOOK](RUNBOOK.md)** | Flussi operativi, copie multi-sorgente, comandi reali verificati sul campo. |
| 📄 **[ARCHITECTURE](ARCHITECTURE.md)** | Diagrammi, pipeline interna, gestione memoria anti-OOM, struttura dei moduli. |
| 🗺️ **[ROADMAP](ROADMAP.md)** | Storico delle release e pianificazione futura. |
| 📊 **[ANALYSIS](ANALYSIS.md)** | Audit di robustezza e difetti storici documentati. |
| 📝 **[CHANGELOG](CHANGELOG.md)** | Cronologia delle versioni. |
| 🤖 **[AGENTS](AGENTS.md)** | Linee guida per sviluppatori e contributori AI. |
---
## ⚡ Installazione
`rustcopy` è un eseguibile **portable**: si copiano gli `.exe` e si lanciano da qualunque cartella.
```powershell
# Build dai sorgenti
cargo build --release -p rustcopy-cli --features notify-server
```
Due requisiti verificati sul binario compilato:
- **Visual C++ Redistributable x64** (Microsoft, gratuito) — il binario `windows-msvc` importa
`VCRUNTIME140.dll`, che non è presente in un'installazione Windows pulita. Senza, non parte.
- **`robocopy.exe` di sistema**, presente su ogni Windows da Vista in poi: non serve installarlo,
ma il tool non lo include.
Il repo include anche uno script **Inno Setup** (`installer/rustcopy.iss`) — un installer unico
in cui la console grafica è un componente opzionale (F60) — che genera un vero
`setup.exe` con disinstaller, aggiunta al PATH e deploy silenzioso — istruzioni complete in
**[Installazione e distribuzione](docs/installation.md)**, che copre anche il **notify-server**
per le notifiche multi-canale.
---
## 🏃 Primi comandi
```powershell
# Copia con verifica di integrità
rustcopy --source "C:\dati" --dest "E:\backup" --verify-integrity --hash-algo blake3
# Simulazione: mostra cosa farebbe, senza scrivere nulla
rustcopy --source "C:\dati" --dest "E:\backup" --dry-run
# Backup a generazioni: il primo run dev'essere full, poi si incrementa
rustcopy --source "C:\dati" --dest "E:\backup" --backup-type full
rustcopy --source "C:\dati" --dest "E:\backup" --backup-type incremental --keep-generations 3 --force-purge
```
I flag essenziali per l'uso quotidiano:
| Flag | Cosa fa |
|---|---|
| `--source` / `--dest` | Cartella di origine e destinazione. |
| `--verify-integrity` | Confronta i checksum sorgente/destinazione a copia finita. |
| `--hash-algo <sha256\|blake3\|xxh3>` | Algoritmo di verifica; `blake3` è 3-5x più veloce di `sha256`. |
| `--dry-run` | Simula senza modificare nulla. |
| `--config <PATH>` | Carica i parametri da un file TOML riutilizzabile. |
| `--backup-type <full\|incremental\|differential>` | Attiva il backup a generazioni. |
**[→ Riferimento completo: tutti i flag e i codici di uscita](docs/cli-reference.md)**
---
## ✨ Funzionalità
- **Verifica di integrità multi-core** — checksum SHA-256, BLAKE3 o xxHash3 parallelizzati con
Rayon su tutte le CPU. `--fast-verify` salta i file già verificati e immutati.
- **Backup a generazioni** — full, incrementale e differenziale in sottocartelle separate, con
ritenzione per cicli (`--keep-generations`) che non orfana mai una catena.
- **Resistente ai dataset enormi** — streaming dell'output di robocopy senza deadlock, logging su
canale limitato, cifratura a blocchi: la memoria di picco non cresce con la dimensione dei dati.
- **Disaster recovery** — `--restore-from` inverte un backup a partire dal suo report JSON;
`--resume-from` riprende un run interrotto da `Ctrl+C`.
- **Cifratura AES-256-GCM** — a blocchi da 1 MiB, con la controparte `--decrypt`.
- **Volume Shadow Copy** — `--vss-snapshot` per leggere file bloccati da altri processi.
- **Automazione** — scheduling via Task Scheduler, servizi Windows, comandi pre/post job,
configurazioni multi-job in TOML.
- **Notifiche** — report JSON, dashboard HTML standalone, webhook HTTP e un **notify-server**
opzionale che li inoltra su più canali.
**[→ Dettaglio del comportamento di ogni funzionalità](docs/cli-reference.md#-comportamento-dettagliato-per-funzionalità)**
---
## 🧪 Sviluppo
```bash
cargo test --locked --workspace --exclude rustcopy-gui --all-targets # 506 test
cargo test --locked --workspace --exclude rustcopy-gui --all-targets --features rustcopy-cli/notify-server # 521 test
```
CI su Windows e Linux, `clippy -D warnings` e `cargo fmt --check` su entrambe le configurazioni di
feature, più un audit RustSec settimanale delle dipendenze. Convenzioni e regole architetturali in
[AGENTS.md](AGENTS.md).
---
## 📄 Licenza
Rilasciato sotto licenza **MIT**.