Golf - Juniortävlingar

Dokumentationsportal

Dokumentation / Developer Bundle

Developer Bundle

Developer Bundle är utvecklingsartefakten för Golf - Juniortävlingar. Den används när en ny utvecklingschatt startas eller när extern analys ska göras mot faktisk kodbas.

Syfte

Developer Bundle ska minska antaganden och manuella fel. Den innehåller källkod, dokumentation och projektkontext, men inte driftdata.

Skapas med

cd /opt/golf-juniortavlingar/test/app
./scripts/export_developer_bundle.sh

Resultatet placeras normalt i /home/protectadmin.

Innehåll

  • app/ – källkod, templates, statiska filer, dokumentation och scripts
  • PROJECT_CONTEXT.md – övergripande projektkontext
  • AI_CONTEXT.md – kort startfil för ny utvecklingschatt
  • PROJECT_TREE.md – exporterad projektstruktur
  • DEPENDENCIES.md – beroenden och runtime-information
  • STATISTICS.md – översikt över antal filer, dokument och kodrader
  • GIT_LOG.md – senaste Git-historik
  • manifest.json – maskinläsbar metadata
  • VERSION – aktuell version

Exkluderas

  • .git/
  • data/
  • backups/
  • __pycache__/
  • byggartefakter
  • zip-filer
  • loggar
  • lokala docker-compose.yml

Princip

Developer Bundle är inte ett releasepaket. Det används för utveckling och analys. Releasepaket används för installation och driftsättning.

Developer Bundle format 1.0

Format 1.0 innebär att bundle ska innehålla:

  • faktisk källkod utan Git-metadata,
  • dokumentation,
  • PROJECT_CONTEXT.md,
  • AI_CONTEXT.md,
  • PROJECT_TREE.md,
  • DEPENDENCIES.md,
  • STATISTICS.md,
  • GIT_LOG.md,
  • manifest.json,
  • VERSION.

Följande får inte ingå:

  • .git eller Git worktree-fil,
  • data/,
  • backups/,
  • __pycache__/,
  • lokala Docker Compose-filer,
  • loggar,
  • ZIP- eller byggartefakter.