Operação e manutenção

Desenvolvimento e CI

A fonte é alterada em branch e worktree com posse confirmada. Testes são escritos antes; execução ocorre após o lote de código. Mudança estrutural do framework exige suíte completa. CI roda unittest em Python 3.11/3.13, alvo Docker real, ShellCheck e Gitleaks; bb verificar confere geração e integridade. Não se desliga check para entregar. O passo bb verificar em CI recebe GH_TOKEN de leitura; o token de automação com escrita não é fornecido ao código do PR.

Publicação oficial

Revisão independente e CI adequadas ao commit precedem merge em main. Tag vX.Y.Z precisa estar em main e bater com VERSION; release gera pacote reprodutível, SHA-256 e atestação. A Wiki fixada deve estar publicada e comunidade válida antes do pacote. Sincronização de develop ocorre por PR; faxina só remove branches seguras depois de produção e CI.

Atualização dos sistemas

bb atualizar 2.0.0 --confirmo-migracao usa a release oficial e mostra os passos de migração. A confirmação nesta opção corresponde à autorização vigente do dono, não à dispensa de trabalho. Configurações e camada do projeto são preservadas; changes gerados e documentação entram no ciclo do PR. Só se remove documentação antiga após publicação confirmada e validada.

Recuperação e limites

A Wiki conserva histórico Git e requer reconciliação de edição concorrente, nunca push forçado. Pacote divergente é recusado. Reexecutar publicação do mesmo SHA é idempotente. Produção de cada sistema mantém seu destino, dados e backup; o framework não cria por si só uma política de backup externo nem simula teste físico de dispositivo.

Runbooks e pilotos · CLI · Matriz.