# BackupAlly

Framework backup-as-code para backups automatizados e seguros.

# Visão Geral

BackupAlly é um framework backup-as-code desenvolvido em Rust, projetado para automatizar backups de bancos de dados e arquivos com segurança enterprise-grade e configuração declarativa.

# Objetivos do Projeto

# Objetivo Principal

Fornecer uma solução de backup que seja:

1. Declarativa: Configuração como código (TOML)
2. Segura: Criptografia end-to-end por padrão
3. Flexível: Suporte a múltiplos drivers e storages
4. Automatizada: Agendamento inteligente com condições
5. Observável: Logs estruturados e métricas

# Objetivos Específicos

# Simplicidade Operacional

• Instalação em um comando
• Configuração sem curva de aprendizado íngreme
• Hot-reload de configurações sem downtime

# Segurança por Padrão

• Criptografia RSA-4096 + AES-256-GCM em todos os backups
• Secrets nunca expostos em logs ou configurações
• Key fingerprinting para disaster recovery

# Eficiência de Recursos

• Cada run é um arquivo completo e autocontido — restore de um arquivo só
• Empacotamento em streaming: nenhum arquivo passa inteiro pela memória
• Compressão Zstd (padrão) ou Gzip

# Flexibilidade de Integração

• Múltiplos drivers de banco de dados
• Múltiplos backends de storage
• API MCP para integração com assistentes de IA

# Hipótese de Solução

# Problema

Soluções de backup existentes apresentam:

1. Complexidade: Configuração complexa e pouco intuitiva
2. Vendor lock-in: Dependência de um único storage provider
3. Segurança opcional: Criptografia como feature adicional
4. Monitoramento limitado: Difícil integração com observabilidade

# Solução Proposta

BackupAlly resolve esses problemas através de:

# Arquitetura Modular

┌─────────────────────────────────────────────────────┐
│                     CLI / MCP                       │
├─────────────────────────────────────────────────────┤
│                   Core Engine                       │
│  ┌─────────┐  ┌──────────┐  ┌─────────────────┐    │
│  │Scheduler│→ │TaskManager│→ │    Executor     │    │
│  └─────────┘  └──────────┘  └─────────────────┘    │
├─────────────────────────────────────────────────────┤
│                    Pipeline                         │
│  ┌─────────┐  ┌──────────┐  ┌─────────────────┐    │
│  │Collector│→ │  Packer  │→ │  Notification   │    │
│  └─────────┘  └──────────┘  └─────────────────┘    │
├─────────────────────────────────────────────────────┤
│     Drivers          │         Storage              │
│  ┌────────────────┐  │  ┌─────────────────────┐    │
│  │MySQL, Postgres │  │  │ Local, S3, B2, MinIO│    │
│  │MongoDB, SQLite │  │  │                     │    │
│  │ClickHouse      │  │  │                     │    │
│  └────────────────┘  │  └─────────────────────┘    │
├─────────────────────────────────────────────────────┤
├─────────────────────────────────────────────────────┤
│                 Security Layer                      │
│  RSA-4096 + AES-256-GCM + Secrets + TLS Pinning    │
│  SPKI pin verification + Anti-replay + NTP check   │
└─────────────────────────────────────────────────────┘

# Configuração Declarativa

# Backup como código - versionável, auditável, reproduzível
[task]
id = "mysql-prod"
schedule = "0 2 * * *"

[target]
kind = "database"
driver = "mysql"
password = "${secret:mysql_password}"  # Nunca em plaintext

[[storage]]
driver = "s3"
retention = "daily 7, weekly 4, monthly 6"

# Segurança por Design

# Multi-Storage

Backups enviados simultaneamente para múltiplos destinos:

Backup → Storage 1 (Local)     → Retenção 7 dias
      → Storage 2 (S3)         → Retenção 30 dias
      → Storage 3 (B2 Archive) → Retenção 1 ano

# Validação da Hipótese

# Versionamento

# Política de Versões

BackupAlly segue Semantic Versioning:

MAJOR.MINOR.PATCH[-SUFIXO]

MAJOR: Breaking changes na API ou configuração
MINOR: Novas funcionalidades compatíveis
PATCH: Correções de bugs
SUFIXO: rc (release candidate), beta

# Histórico de Versões

# v0.31-0.35 - Ponte com integrações (Atual)

# v0.23-0.30 - Operação e prevenção

# v0.17-0.22 - Confiabilidade e diagnóstico

# v0.11-0.16 - Restore, criptografia e consistência

# v0.10.x - Security Hardening + Multi-arch

# v0.9.x - Estabilização

# v0.8.x - Security Features

# v0.7.x - Modular Tasks

# v0.6.x - Storage Backends

# v0.5.x - Database Drivers

# Roadmap

# v1.0.0 - GA (General Availability)

• Web UI para monitoramento
• Kubernetes operator
• Métricas Prometheus
• Documentação completa

# v1.1.0 - Enterprise Features

• Multi-region replication
• Continuous Data Protection (CDP)
• Binary diff para incrementais
• Azure Blob e Google Cloud Storage

# Compatibilidade

# Breaking Changes Policy

• Breaking changes apenas em versões MAJOR
• Deprecation warnings por 2 versões MINOR antes de remoção
• Migration guides para todas as mudanças breaking

# Compatibilidade de Configuração

# Requisitos

# Sistema

# Dependências Runtime

• Nenhuma (binário statically linked com musl desde v0.10.0)
• Compatível com qualquer Linux: Ubuntu 18.04+, Debian 10+, CentOS 7+, Alpine

# Plataformas Suportadas

# Dependências de Build (desenvolvimento)

• Rust 1.75+
• Docker (para cross-compilation via cross)
• OpenSSL dev headers (build nativo extrai TLS pins)

# Suporte

# Canais

# SLA

# Próximos Passos

• Instalação e Primeiro Backup - Configure em 5 minutos
• Referência CLI - Todos os comandos disponíveis
• Configuração - Opções de configuração
• Guias Práticos - Tutoriais por caso de uso