# 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.