1.8 KiB
Registo de decisões técnicas
ADR-001 — Monólito modular Laravel/Inertia
Data: 2026-08-04
Estado: aceite
Usar Laravel 13 com React/TypeScript através de Inertia no mesmo projeto. Mantém autenticação, autorização, filas e transações numa única unidade operacional, sem impedir separação por domínio.
ADR-002 — PostgreSQL como garantia de conflitos
Data: 2026-08-04
Estado: aceite
Usar PostgreSQL e períodos semiabertos [início, fim). A lógica aplicacional melhora a mensagem ao utilizador; uma restrição de exclusão GiST garante que concorrência ou um erro aplicacional não cria sobreposição bloqueante.
ADR-003 — Cache local, sem replicação total do Snipe-IT
Data: 2026-08-04
Estado: aceite
Guardar apenas os campos de ativos necessários ao catálogo e reservas. A sincronização desativa registos ausentes em vez de os apagar. A base de dados do Snipe-IT nunca é acedida diretamente.
ADR-004 — Registo público desativado
Data: 2026-08-04
Estado: aceite
Contas são criadas por administrador, convite ou identidade institucional verificada. Mantêm-se recuperação de palavra-passe, verificação de email, 2FA e passkeys do starter kit.
ADR-005 — Ambiente reproduzível em Docker Compose
Data: 2026-08-04
Estado: aceite
Desenvolvimento e primeira instalação utilizam serviços separados para Nginx, PHP-FPM, PostgreSQL, Redis, Vite, filas, scheduler e Mailpit. Produção deve usar imagens imutáveis, HTTPS e gestão externa de segredos, mantendo a mesma topologia lógica.
ADR-006 — Português de Portugal na interface
Data: 2026-08-04
Estado: aceite
Textos funcionais são escritos em português europeu. Nomes de código, eventos e tabelas permanecem em inglês para consistência técnica.