Começar
Aparência

Vale na hora e fica lembrada neste navegador.

Decisões

ADR-0001 — Nome e escopo do repositório

Contexto

A arquitetura de stacks vale para toda stack web da Hibex, de qualquer plataforma. O nome do repositório precisa dizer isso e combinar com o nome das stacks (<plataforma>-stack-<produto>). E o repositório precisa deixar claro o que guarda e o que não guarda.

Decisão

  1. O repositório se chama stack-architecture, sem prefixo de plataforma: ele é transversal.
  2. Ele guarda:
    • a documentação da arquitetura (README.md e docs/01–20) e o site gerado dela;
    • as ORGs, em docs/decisoes/organizacao/, e as ADRs deste repositório, em docs/decisoes/;
    • o modelo zerado de uma stack (ADR-0002);
    • os scripts que o acompanham (eng/), incluindo o kit de rabiscos (ADR-0005).
  3. Ele não conhece as stacks que usam o modelo: não lista, não acompanha nem edita nenhuma delas. O que uma stack aprende chega aqui como pedido.

Alternativas consideradas

AlternativaPor que não
enterprise-stack-architecturePor que não: o prefixo prende a arquitetura a uma plataforma
Documentação dentro do repositório do design system ou do toolboxPor que não: assuntos e ritmos diferentes; o design system é uma camada, a plataforma é outra

Consequências

  • A pasta local architecture/ segue até o repositório ser criado no GitHub pelo mantenedor.
  • Quem procura "como toda stack da Hibex funciona" tem um lugar só.