Files
fitme3070.pt/PLATFORM_TOOLS.md
T
andreandClaude Sonnet 5 a9cda24de3 docs(platform-tools): regista o deploy-on-push ligado (webhook Gitea id 6)
Master passa a deployar-se sozinho a cada push — webhook criado no
fitme3070.pt, AUTO_UPDATE_SECRET no .env do servidor,
system_settings.auto_update_enabled = 1. Fecha "produção sem
deploy-on-push" da auditoria (1.13/resumo Médio).

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

2.5 KiB

shared/platform-tools is a git submodule (again)

Was vendored as a plain committed directory from 2026-09-24 to 2026-09-25 (VENDORED.md, since removed — its content is folded in below). Switched back to a proper submodule on 2026-09-25 once the two concrete problems that broke it the first time were fixed:

  • .gitmodules now pins branch = main explicitly. The old submodule had no branch, so "Atualizar submódulo" fell back to refs/remotes/origin/HEAD — a ref a plain server-side clone never creates — and failed with Unable to find refs/remotes/origin/HEAD revision.
  • The submodule URL is ../platform-tools.git (relative, resolves to https://git.andmore.pt/andre/platform-tools.git), not http://. The old one used http://, which the origin answers with 523.

The third original reason ("the site is deployed by uploading files, so a submodule is invisible to it") doesn't apply to fitme's actual deploy method — deploy.sh does git pull --ff-only — so it no longer justifies staying vendored once the other two are fixed. deploy.sh now runs git submodule update --init --recursive after the pull, matching every other config/-based platform in the fleet (fotografia, dsa, moremio, tickets).

Before converting back (2026-09-25): verified the vendored copy was byte-identical to upstream platform-tools@12f26fd (the SHA it was frozen at) — only difference was CRLF→LF normalization in four social/ files, already noted in the old VENDORED.md. Nothing site-specific was hand-patched into the vendored copy, so nothing was lost by re-pointing at the submodule pinned to that same commit.

To bump the submodule to a newer platform-tools commit: git submodule update --remote shared/platform-tools && git add shared/platform-tools && git commit (see the platform-tools README, "Wiring up a platform", step 6) — same as fotografia.

Deploy-on-push

master now deploys itself: Gitea webhook id 6 on fitme3070.pt (push, branch master) POSTs to api/platform.php?endpoint=auto_update (the router — no per-file api/auto_update.php stub needed, since the router's default target for that endpoint already resolves to the same shared/platform-tools/api/auto_update.php a stub would have required). AUTO_UPDATE_SECRET is in .env on the VPS (not in git — see CLAUDE_GITEA/.auto-update-secrets on Andre's machine), and system_settings.auto_update_enabled = '1'. Toggle it off from Sistema → Atualizar plataforma if a push needs to land without auto-deploying.