Files
fitme3070.pt/ASSETS.md
T
andreandClaude Sonnet 5 7482dc98f2 docs: atualiza CLAUDE.md e ASSETS.md pós-migração Bootstrap/Composer
Ficaram desatualizados depois da sessão de fixes: CLAUDE.md ainda
dizia "Bootstrap 4+5 em simultâneo" (já não, ver 1e2068b) e listava
"sem srcset"/"sem create/edit unificado" sem as razões reais por trás
de cada um continuar em aberto. ASSETS.md ainda tinha a tabela de
antes da migração (duas versões de Bootstrap, jQuery duplicado,
"sem Composer") — reescrito para o estado real: Bootstrap 5.3.3
único, jQuery uma cópia, Composer ligado (composer.json/lock),
PHPMailer hand-vendored por decisão documentada (não por falta de
tentar).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-25 22:01:29 +01:00

2.7 KiB

Assets de front-end desta app

Estado real a 25/09/2026 (auditoria em CLAUDE_GITEA/audits/fitme3070-auditoria-2026-09-24.html, ponto 7.4). Composer real desde 25/09 (composer.json/composer.lock, ver PLATFORM_TOOLS.md), mas ainda sem versão no nome das pastas dos ficheiros hand-vendored.

O que está vendorizado e onde

Biblioteca Versão Caminho Usado em
Bootstrap 5.3.3 assets/vendor/bootstrap5/ Site público + backoffice (unificado 25/09)
Bootstrap Icons — assets/vendor/bootstrap-icons/ Backoffice
jQuery 3.7.1 assets/vendor/jquery/jquery-3.7.1.min.js Site público + backoffice (deduplicado 25/09)
Font Awesome Free 5.13.1 site/assets/fonts/fontawesome/ Site público (~18 MB, todo o pacote)
PHPMailer 7.1.1 vendor/PHPMailer/ Envio de email (config/functions_mail.php, partilhado)

assets/vendor/bootstrap/ (a cópia 4.3.1) ficou sem nenhuma referência depois da migração — ainda no disco, ninguém a carrega, por remover (git rm -r, não feito ainda).

Nenhuma pasta hand-vendored tem a versão no nome; para confirmar a versão real de cada uma, ver os comentários de cabeçalho dos .min.css/.min.js ou VERSION/const VERSION no caso do PHPMailer. composer.lock já fixa a versão exata do que o Composer instala.

Porque não segue por completo a convenção da frota

  • PHPMailer continua hand-vendored em vez de vir do Composer da app: shared/platform-tools/ functions_mail.php (partilhado por toda a frota) exige vendor/PHPMailer/src/PHPMailer.php por caminho fixo, não o layout vendor/phpmailer/phpmailer/... que o Composer geraria — mudar isso é código partilhado, fora do alcance de uma app só (mesma razão que a fotografia mantém as duas árvores). composer.json declara a dependência mesmo assim, para composer audit/outdated saberem da versão.
  • Google Fonts ainda vem de CDN (site/includes/include.php) — pendente self-hosting do Roboto (ver fitme-audit-2026-09 na memória do projeto, "Pending for André").

Antes de adicionar ou atualizar uma biblioteca

  1. Preferir Composer sempre que o pacote exista (ver a convenção da frota).
  2. Sem Composer: descarregar uma vez, commitar, e nomear a pasta com a versão (vendor/<lib>-<versão>/), não um nome genérico.
  3. Nunca duplicar a mesma versão em duas pastas — importar de um único sítio.
  4. Atualizar esta tabela.