BDS0.1

Architecture Decision

Uma decisão de arquitetura registrada (ADR): status, data, escopo e o link para o documento.

Revisado 2026-10-28Markdown

Uma linha de Architecture Decision é uma escolha registrada sobre como os sistemas são construídos. Exemplos: qual base é dona de um tipo de registro e como os dados passam entre bases. O tipo é ops:ArchitectureDecision, uma proposta de vocabulário pendente sob bds:Decision. Decisões de negócio não são registradas aqui. A linha guarda status e vínculos; o documento guarda contexto, opções e consequências.

Estado atual

A tabela não tem linhas em 2026-10-28. As decisões de arquitetura ainda ficam em documentos próprios fora do Airtable, junto com um registro corrido de decisões. Dois Work Items decidem o que entra aqui e fazem a carga. Outro aguarda acesso à pasta onde os documentos vão ficar.

Architecture Decision ainda não tem linhas; as decisões ainda ficam em documentos fora do Airtable.

Campos

Campo Tipo Significado
Title Texto, primário A decisão em poucas palavras
ADR Number Número Numeração corrida; nunca reutilizada, nem para decisão rejeitada
Name Fórmula ADR- + número com quatro dígitos + · + Title; só Title quando não há número
Status Seleção única Proposed, Accepted, Rejected, Superseded, Deprecated
Decision Date Data Dia da aceitação, ou da proposta enquanto Proposed
Summary Texto longo O problema e a decisão em duas ou três frases
Document URL O documento que explica a decisão por inteiro
Decided By Vínculos → Membership (mirror) Quem aprovou
Systems Vínculos → System Sistemas cuja estrutura ou comportamento ela muda
Record Types Vínculos → Record Type Tipos de registro que ela cria, move ou remodela
Tags Vínculos → Tags (mirror) Rótulos opcionais
Supersedes / Superseded By Vínculos → Architecture Decision A decisão que ela substitui, e o inverso
System Rules Vínculos → System Rule Inverso de Based On ADR
Work Items Vínculos → Work Item Trabalho que a executa ou que aguarda por ela
Checked / Review Note Caixa de seleção / Texto longo A linha bate com o documento; o que ainda precisa ser visto

Name é a forma de citação, por exemplo ADR-0005 · Field Service owns service visits, mas Title ainda é o campo primário. Os chips de vínculo e os seletores em outras tabelas mostram o Title sem o número até o campo primário mudar. Um Work Item acompanha a troca.

Ciclo de vida

Proposed → Accepted, Rejected, ou depois Superseded ou Deprecated. A construção só começa quando a decisão está Accepted (regra de construção “A proposed ADR does not authorize building”). Quando uma decisão nova substitui uma antiga, vincule a antiga em Supersedes e mude o Status dela para Superseded.

Exemplo

Uma linha fictícia: Title Field Service owns service visits, ADR Number 5, Name ADR-0005 · Field Service owns service visits, Status Proposed, Decision Date o dia em que foi escrita, Systems Field Service e CRM, Record Types Service Visit.

Registrar regras e decisões · System Rule