Decisões de arquitetura

Por que esta página existe

Toda decisão técnica não-trivial vira um ADR (Architecture Decision Record) no Solutio Docs. Esta página resume cada ADR aceito em uma frase para leitura executiva.

Para o texto completo, abrir o link da coluna “ADR”.

Decisões aceitas (estado em 16/maio/2026)

#	Tema	Decisão em uma frase	ADR
026.5	Backend canonical	Rails vanilla (sem packwerk, sem app/modules/) é o backend canonical.	adr-026-5
028	Front shell	Sidebar 258px sem header global; alarms-rail sempre + agent-rail toggle (LiveKit-aligned, não Whop).	adr-028
—	TimescaleDB	Postgres + TimescaleDB para alarme/séries; vector DB externo separado.	memória
—	Modernization doctrine	Domínio herdado do sistema atual, implementação reescrita do zero.	doctrine
—	Trunk-based em main	Sem feature branches; commit direto em main; tag por story [PICTOR.MOB.X.Y].	regra interna
—	Pictor stand-alone	Pictor é produto stand-alone (Gabriel), integrado à Solutio como módulo premium via API/SDK.	memória
—	Auth Modelo B	Front nunca loga no Pictor direto; solutio-api faz service-account e emite JWT.	pictor-auth
—	Cloud DOKS	DOKS agora; AWS BR só com trigger comercial específico.	cloud-deployment-plan

Mapa de decisões

mindmap
  root((Arquitetura v2))
    Backend
      Rails canonical
      AR concerns + Pundit
      acts_as_tenant
    Frontend
      Next 16
      Shell LiveKit-aligned
      Solutio Design System
    Mobile
      Expo SDK 54
      Bare conversion futuro
    Mídia ao vivo
      LiveKit self-hosted
      go2rtc + MediaMTX
    Dados
      Postgres 16 + TimescaleDB
      Vector externo Qdrant
    Cloud
      DOKS prod
      Multi-tenant default
    Processo
      Trunk-based em main
      AIOX agents driven
      Stories por epic

Como propor uma nova decisão

1. Abrir uma stub em docs/architecture/decisions/ADR-NNN-titulo.md.
2. Discutir com @architect (Aria) + @dhh (review).
3. Aceite → Atlas atualiza esta tabela em uma frase + link.

Esta página é a “tabela de aceites” para leitura executiva. Não é a fonte canônica — a fonte é o repositório docs/architecture/decisions/.