ADR 0001 — PHP SSR sem framework

• Status: aceito
• Data: 2026-07 (reforçado em 2026-09)

Contexto

O portal nasceu como PHP procedural servido pelo Apache, com uma página (arquivo) por tela. Havia pressão para “virar Laravel/SPA”, mas o time é pequeno, o domínio (taxas, credenciamento, RBAC) já está no PHP, e o hospedeiro original era compartilhado.

Decisão

Manter PHP 8.1+ renderizado no servidor, sem framework, sem front controller e sem SPA. Cada URL pública mapeia para um .php físico. JavaScript é Vanilla/IIFE; CSS é Tailwind compilado à parte.

Consequências

• Onboarding simples para quem já mexe em PHP legado; roteamento óbvio.
• Endpoints e views proliferam (backend/api ~191 arquivos).
• Testar unidade é difícil (funções globais, require_once, $GLOBALS).
• PSR-4 ficou plano paralelo (../plano-migracao-psr4.md), não pré-requisito de feature.