# Changelog

Todas as mudanças notáveis do projeto serão documentadas neste arquivo.

O formato é baseado em Keep a Changelog, e este projeto adere ao Semantic Versioning.

# [0.9.2] - 2026-02-14 (Docs)

# Adicionado

# DPL Language - Fonte da Verdade

Documentação completa (~1070 linhas) da linguagem DPL:

Anatomia do Template

• Estrutura completa com seções obrigatórias e opcionais
• Links para documentação detalhada de cada seção

Inputs

• 5 tipos documentados: string, password, boolean, number, select
• Campo options para tipo select
• Geração automática com 5 charsets: alphanumeric, alpha, numeric, hex, full
• Dependência entre inputs (depends_on)
• Validações com regex e padrões comuns

Condicionais e Interpolação

• Operadores: ==, !=, | empty, | not_empty
• Variáveis: {{inputs.X}}, {{container.name}}, {{network.name}}, {{instance_id}}
• Filtros: default, empty, not_empty, percent, min, multiply

Seções de Configuração

• Ports: campos, condicionais, porta aleatória
• Volumes: persistência, backup, modos rw/ro
• Network: drivers, padrão assets vs applications
• Healthcheck: formatos CMD e CMD-SHELL
• Environment: estático e interpolado
• Key Files: templates Jinja2, examples, filters
• Labels: integração Traefik com condicionais

Ações de Deploy

• Pre-deploy: create_network, pull_image, create_volume
• Post-deploy: wait_healthy, save_secret, run_command, notify

Navegação

• Links bidirecionais com taxonomy, playbooks, templates, manifests, ecology

# Modificado

• playbooks.md e templates.md agora referenciam DPL Language

# [0.9.1] - 2026-02-14 (Docs)

# Adicionado

# Documentação DPL Language (inicial)

• Referência inicial da DPL (DeployAlly Playbook Language)
• Documentação de tipos de input e charsets
• Sintaxe de dependência entre inputs (depends_on)
• Referência de condicionais e operadores (when, empty, not_empty)
• Sintaxe completa de interpolação ({{inputs.X | filter}})
• Integração com Traefik (Labels)
• Documentação de ações pre/post deploy

# [0.9.0] - 2026-02-13 (CLI)

# Adicionado

# Comando self-update

• deployally self-update para atualização automática do CLI
• Suporte a canais stable e rc (release candidate)
• Opção --check para verificar sem baixar
• Opção --force para reinstalar
• Backup automático do binário atual
• Verificação de integridade do binário baixado

# [0.5.1] - 2026-02-13

# Adicionado

• Documentação pública no PimDocs
• Guia de integração com API

# Modificado

• URLs de download via CDN

# [0.5.0] - 2026-01-30

# Adicionado

# Sistema de Versionamento de Templates

• Specs imutáveis versionados com hash SHA256
• Detecção de drift em deployments
• Suporte a deprecation de templates com mensagem customizada

# 14 Templates Pré-configurados

Assets:

• MySQL 8.4 e 5.7 (database)
• Redis 7 Alpine (cache)

Infrastructure:

• Traefik 2.11 (ingress)

Applications:

• phpMyAdmin 5 (dbtools)
• WordPress 6 (cms)
• n8n Standalone e Multi-Worker (workflow)
• Evolution API (WhatsApp)
• Mautic 4, 5 e 6 (marketing automation)
• Mailcow (email server)
• Chatwoot (helpdesk)

# API de Templates

• GET /api/v1/templates - Lista templates do banco de dados
• Suporte a filtros por kingdom, family, species
• Retorno inclui versão, spec hash e metadata completa

# Cliente CLI

• Parâmetro --source para escolher origem dos templates:
  • --source remote (padrão): busca templates da API
  • --source local: usa templates locais em YAML
• Comando list agora suporta --source

# Modificado

• Templates migrados de arquivos YAML para banco de dados
• Estrutura de taxonomia expandida
• Deploy agora registra versão específica do template usado

# Segurança

• Specs imutáveis previnem alterações não rastreadas
• Hash de spec permite auditoria de drift

# [0.4.0] - 2026-01-25

# Adicionado

# API Backend (sys)

• Flask API com SQLAlchemy
• Endpoints de templates, definitions, instances
• Autenticação via API Key
• Sistema de taxonomia (kingdoms, families, species)
• Suporte a MySQL para persistência
• Health check endpoint

# Frontend

• Interface React com Vite
• Página de catálogo de templates
• Sistema de busca e filtros
• Modal de detalhes do template
• Autenticação de usuários

# Client CLI

• Comandos de deploy interativo
• Gerenciamento de manifests locais
• Sincronização com servidor
• Suporte a secrets locais
• Módulo crypto embutido (AES-GCM, Argon2, bcrypt)

# Templates Iniciais

• MySQL 8.4 e 5.7
• PostgreSQL 16
• Redis 7 Alpine
• Traefik 2.11
• Prometheus
• Grafana

# Segurança

• Secrets nunca sincronizados para servidor
• Permissões 0600 em arquivos de secrets
• API Key com rotação suportada
• Vault com criptografia AES-GCM

# [0.3.0] - 2026-01-22

# Adicionado

• Estrutura inicial do projeto
• Boilerplate de API Flask
• Estrutura de diretórios do cliente Rust
• Configuração inicial de Docker

# Formato de Versão

# Download

• Última versão
• Todas as versões