Do desenvolvimento à produção

O guia BASIS define branches principais, auxiliares, pull requests, versionamento semântico e pipeline.

feature/* ─→ dev ─→ rc ─→ main
               │      │      │
            -dev    -rc   versão estável

bugfix/* nasce de rc
hotfix/* nasce de main
  • Branches principais recebem mudança por pull request e revisão.
  • Feature retorna à dev; bugfix retorna à rc; hotfix retorna à main e precisa ser propagado.
  • Tags seguem versionamento semântico e identificadores de pré-lançamento dev/rc.
  • Build deve compilar, testar e executar análise estática antes do release.
  • Release deve manter logs e identificação relacionada à versão implantada.

Qualidade e testes prioritários

Os materiais recomendam Sonar, JUnit 5, AssertJ, fixtures previsíveis e testes determinísticos.

CamadaCasos prioritários no conector
Consulta AGHUVersões 10/11, timestamp, nulos, paginação e massa ausente
MapeamentoCardinalidade, terminologia, referências, datas e identificadores
BundleOrdem, profile, identifier, relatesTo e serialização
TokenCache, expiração, buffer, relógio, concorrência e 401
BatchCarga inicial, D-1, restart, lock e falha parcial
ReprocessamentoIdempotência, duplicidade e seleção delimitada
IntegraçãoTimeout, retry, indisponibilidade e resposta RNDS sintética
Padrão de teste do guia
@Test
@DisplayName("deve rejeitar identifier ausente antes do envio")
void validarBundle_identifierAusente() {
    var bundle = BundleFixtures.semIdentifier();

    assertThat(validar(bundle)).isFalse();
}

Resposta estruturada a incidentes

A sustentação reduz reincidência quando encerra o ciclo além da restauração imediata.

  1. 1
    Detecte

    Confirme sinal, impacto, início e abrangência.

  2. 2
    Contenha

    Evite reenvio em massa, duplicidade e exposição enquanto preserva evidências.

  3. 3
    Diagnostique

    Localize rede, processo, banco, dados, FHIR, autenticação ou RNDS.

  4. 4
    Restaure

    Aplique a menor correção autorizada e valide o funil completo.

  5. 5
    Reconcilie

    Identifique itens não enviados, duplicados, rejeitados e pendentes.

  6. 6
    Previna

    Crie teste, alerta, documentação ou mudança de processo para a causa raiz.

Critério de encerramento

  • Causa e camada proprietária identificadas ou hipótese residual explicitada.
  • Serviço restaurado e caso controlado concluído ponta a ponta.
  • Fila reconciliada e reprocessamento acompanhado.
  • Evidências sanitizadas anexadas ao registro formal.
  • Ação preventiva, responsável e prazo definidos quando aplicável.

Evolução da documentação

O repositório reúne arquitetura, schema, manuais técnicos e materiais transversais, mas também contém inconsistências e duplicidades.

  • Atualize a data, versão e status de cada documento junto da mudança correspondente.
  • Mantenha um único PDF vigente e marque cópias ou históricos explicitamente.
  • Reconcilie a lista de certificados com o inventário operacional.
  • Registre um checklist pós-migração quando declarar compatibilidade completa.
  • Nunca versione credenciais, IPs, tokens ou identificadores clínicos em documentação.