DevFlow

Plataforma multi-tenant de governanca do desenvolvimento. Cada tarefa funciona como um dossie tecnico permanente, com historico, comentarios, anexos, testes, commits, versoes e auditoria.

O DevFlow encontra-se em fase de homologacao e ainda nao foi aprovado para uso em producao.

Versao atual: 0.6.34-alpha. Esta revisão finaliza a lista paginada de tarefas com filtro de etapa, ordenação server-side, paginação numérica, densidade e acessibilidade refinadas. Bug/Dev continua derivado exclusivamente do tipo real BUG_REPORT, e o agrupamento permanece individual por usuário e empresa.

Rotas canonicas autenticadas: /dashboard, /task, /task/trash, /team, /clients, /projects, /audit, /settings/security/mfa, /settings/modules/catalogs, /settings/modules/workflows, /settings/server/smtp, /settings/updates, /settings/backups e /profile. As rotas anteriores /, /tasks, /users e /settings redirecionam para os destinos equivalentes.

Instalacao

Requisitos: Ubuntu 22.04/24.04 AMD64 ou ARM64, DNS A apontado para a VPS, portas publicas 80/443 livres, 2 GiB de RAM e 5 GiB livres.

wget -O install.sh https://raw.githubusercontent.com/trinityrrocha/DevFlow/main/scripts/bootstrap.sh
chmod +x install.sh
sudo ./install.sh

Sem argumentos, o bootstrap seleciona a instalacao interativa, solicita dominio e e-mail, executa o preflight e exige duas confirmacoes numericas antes de alterar o host. Para automacao, continuam disponiveis --check, --dry-run, --install e --resume.

O instalador exige confirmacoes numericas; o bootstrap transforma a chamada publica sem argumentos em --install explicito e nunca atualiza uma instalacao concluida. O e-mail informado e a autoridade unica para Super Admin e Let's Encrypt. Depois do health final, o logger e drenado e a senha temporaria e exibida uma unica vez no TTY original; o bloco de credenciais e a ultima saida visivel. O arquivo permanece em /opt/devflow/config/super-admin-temporary-password, root:root 0600, sem aparecer em logs. Sem TTY, os metadados finais ficam somente no log e a senha nao e exibida.

MFA e recomendado, mas opcional por padrao. Quem o habilita continua obrigado a informar o segundo fator no login. O Super Admin pode alterar a politica persistente em Cadastros e configuracao > Politica de autenticacao multifator para optional, admins ou all; a mudanca e protegida por CSRF, auditada e nao desabilita fatores ja cadastrados.

Para uma tentativa parcial, inspecione primeiro o estado e retome:

sudo cat /opt/devflow/state/install-transaction.json
docker ps -a --filter name=devflow
docker volume ls --filter name=devflow
sudo ./install.sh --resume --firewall-confirmed

--resume ignora a etapa historica como fonte de verdade e recalcula o ponto material a partir de certificado, config Nginx, imagens, containers, banco, migration e bootstrap administrativo. Uma falha no estagio 14 ativa a nova release em /opt/devflow/app, recria updater/edge quando necessario e preserva os servicos saudaveis anteriores.

Arquitetura operacional

• devflow-nginx: unico servico publicado nas portas 80/443;
• devflow-frontend: rede de borda, sem porta do host;
• devflow-backend: redes de borda e interna, sem porta do host;
• devflow-worker: consumidor interno da outbox de e-mail, sem porta e sem execucao arbitraria;
• devflow-db: somente rede interna e volume persistente proprio;
• devflow-updater: fila privada assinada, delegacao exclusiva ao update.sh e bloqueio de processamento enquanto state/installation-in-progress existir;
• /etc/letsencrypt: certificado do host montado como somente leitura no Nginx;
• /opt/devflow/config/nginx/nginx.runtime.conf: configuracao gerada somente apos validar o certificado.

Operacao

sudo /opt/devflow/app/scripts/version.sh
sudo /opt/devflow/app/scripts/health.sh
sudo /opt/devflow/app/scripts/repair-installation-state.sh --check
sudo /opt/devflow/app/scripts/diagnose.sh --output /opt/devflow/logs/diagnostic.txt
sudo /opt/devflow/app/scripts/backup.sh
sudo /opt/devflow/app/scripts/update-cli.sh --check
sudo /opt/devflow/app/scripts/update-cli.sh
sudo /opt/devflow/app/scripts/renew-certificate.sh --dry-run
sudo /opt/devflow/app/scripts/uninstall.sh --keep-data

update.sh e o motor nao interativo: valida a allowlist de origin, faz fetch, checkout main e pull --ff-only em checkout isolado, constroi somente imagens allowlisted, aplica migrations, sobe db/backend/worker/frontend/edge e valida o health. O updater em execucao nao e recriado durante o pedido. Nao existe gate de changelog, backup automatico ou container de manutencao no WebUpdater. Em falha apos mutacao, um rollback operacional pequeno restaura a tag normal release-<commit>, o symlink, o estado e os containers anteriores; migrations nao recebem down automatico.

Limitacao de compatibilidade: a release 0.6.26-alpha chama render_runtime_nginx_config dentro do updater logo depois do fast-forward. Esse container nao monta /etc/letsencrypt; o comando retorna 1 e o motor antigo inicia rollback antes do build. Como o shell antigo ja esta em execucao e nao carrega um motor remoto antes desse ponto, e necessaria uma migracao unica pelo bootstrap seguro, sem pipe:

wget -O update-devflow.sh https://raw.githubusercontent.com/trinityrrocha/DevFlow/main/scripts/update-bootstrap.sh
chmod +x update-devflow.sh
sudo ./update-devflow.sh

Para uma instalacao 0.5.3-alpha cujo unico erro seja o estado schema v3, obtenha uma copia limpa da main e execute primeiro sudo scripts/repair-installation-state.sh --check. Use --repair somente depois de revisar o diagnostico. O reparador nao instala, nao constroi imagens, nao executa migrations e nao altera banco, Super Admin, senha ou certificado.

Documentacao

• Instalacao detalhada
• VPS de homologacao
• Infraestrutura
• Update, backup e rollback
• Seguranca
• Notificacoes e e-mail
• Troubleshooting
• Estado de implementacao

Os Documentos 001, 002 e 003 formam a baseline. O Documento 004 ainda nao foi executado.