O software já não é um ofício artesanal. É uma técnica.

Do ofício à técnica

Um ofício passa a ser uma técnica no momento em que os seus passos podem ser escritos, repetidos e verificados. O software acaba de ultrapassar essa linha — e, uma vez que algo é uma técnica, uma fábrica vence uma oficina.

A linha, posto a posto

Da primeira formação ao software em funcionamento, posto a posto. Cada um está assinalado: Em produção é o que funciona hoje; Em breve é o que estamos a construir a seguir.

1. 01Em produção

   Começa pela formação

   Antes da linha, as pessoas: os consultores aprendem a aconselhar PME sobre IA e, depois, formam as equipas dos seus clientes com um curso com a sua marca, cujo último passo se torna um novo projeto ou novos requisitos.

   Saber mais →

2. 02Em produção

   Primeiro os requisitos

   Nada é construído a partir de um briefing vago. Uma conversa transforma-se em requisitos, cada um com os respetivos critérios de aceitação, e a linha só constrói o que tiver sido aceite.

3. 03Em produção

   Uma linha contínua

   Assim que os seus requisitos são aceites, um passo de trabalho segue para um agente de programação sem qualquer clique: uma construção de cada vez por projeto, por ordem. Cada passo de trabalho sai como um pull request.

4. 04Em produção

   Controlos em cada alteração

   Cada pull request passa pela CI e pelas análises de segurança do projeto e, depois, por uma revisão de segurança com IA que falha por defeito: sem veredicto, não há merge, e o merge fica fixado à versão exata revista. Uma proteção no ramo principal recusa implantar tudo o que contorne os controlos.

5. 05Em produção

   Prova por critério

   Cada critério de aceitação tem a sua própria execução de teste a partir do CI, registada após a última alteração do requisito ser integrada, e um requisito conta como verificado apenas quando todos passam. Um critério verificado por uma pessoa mostra “Verificação humana pendente” até ser aprovado. A palavra do agente nunca conta.

6. 06Em produção

   Primeiro o teste, do vermelho ao verde

   O teste para cada critério de aceitação é escrito primeiro, no seu próprio commit, e deve falhar no CI antes que o código o faça passar. Antes de uma alteração ser integrada, o gate verifica se o teste de cada critério passou de vermelho a verde e não foi alterado no caminho; o requisito liga ambas as execuções.

7. 07Em produção

   Um ciclo de reparação

   Quando a CI ou a revisão de segurança rejeitam uma alteração, as conclusões voltam à mesma sessão do agente, que as corrige no mesmo pull request, e todos os controlos são executados de novo. No máximo duas reparações por defeito; depois disso, assume uma pessoa.

8. 08Em produção

   Peças padrão

   Cada aplicação parte do modelo da fábrica, com os problemas já resolvidos: início de sessão, inquilinos e funções, páginas legais, layout. Construídas uma vez, reforçadas em produção, nunca reconstruídas.

9. 09Em produção

   A biblioteca da fábrica em cada passo

   Quando um plano de passo de trabalho é aprovado, cada passo vem com as peças padrão escolhidas pelo desenho. Os passos que tocam na base de dados ou noutras áreas sensíveis são construídos com as diretrizes de segurança e de base de dados da biblioteca, e o registo de construção indica quais e porquê.

10. 10Em produção

    Publicação em produção

    Publicar uma versão implanta uma aplicação alojada em produção: primeiro as migrações da base de dados, por ordem, parando no primeiro erro; depois a construção. A versão só mostra Em produção quando o endereço público a serve.

11. 11Em produção

    Um estado honesto

    Enquanto tudo o que está no âmbito não for publicado, um projeto aparece como “Em construção — 3 de 6 passos entregues”, e só depois como “Em produção”. Uma nova aplicação mostra aos visitantes “Em breve” e aos seus utilizadores com sessão iniciada os passos de construção; uma página “O que contém a aplicação” lista as peças com que veio, o que já foi construído e o que falta.

12. 12Em produção

    Registado

    Cada tarefa de construção, cada implantação de versão e cada alteração que chegou ao ramo principal fora dos controlos fica registada. As ações dos nossos operadores vão para um registo de auditoria apenas de acréscimo.

13. 13Em produção

    Chaves com âmbito limitado, alojamento na UE

    Para as aplicações que alojamos, cada construção recebe um token de curta duração apenas para esse repositório, apagado quando a construção termina. As suas chaves de modelos ficam com o seu PP Orchestrator. As instâncias na nuvem funcionam na Alemanha (UE).

“Em produção” significa entregue numa versão do Product Printer e a funcionar nas nossas instâncias geridas. Um posto passa de Em breve a Em produção apenas quando a respetiva versão estiver disponível.