PHP bestandsbeleid

/civ-city/governance/positionpapers/php-bestandsbeleid

CIV-CITY_PP_P001 php-bestandsbeleid concept

CIV-CITY_PP_P001 — PHP bestandsbeleid

Executive Summary

Deze position paper legt het beleidskader vast voor stabiele PHP-bestandsnamen binnen CIV-CITY. De kernregel is dat versiebeheer niet in de bestandsnaam van PHP-bestanden wordt verwerkt, maar in de bestuurlijke pagina’s, versielogs en auditdocumentatie rond die bestanden.

1. Bestendige bestandsnamen

PHP-bestanden behouden een stabiele functionele naam, zodat implementaties, overrides, koppelingen en federatieve uitwisseling niet onnodig fragiel worden.

2. Versie op pagina

Versies worden beschreven op de canonieke WXR-pagina’s en niet in de PHP-bestandsnaam. Daardoor blijven bronbestanden rustig en blijft bestuurlijke evolutie toch navolgbaar.

3. Relatie met documentbeheer

Dit beleid sluit aan op de regels voor documentcodes, versielogs, archivering en export. Samen zorgen deze elementen ervoor dat zowel techniek als governance beheersbaar blijven.

4. Federatieve betekenis

Voor federatieve partners is stabiele naamgeving cruciaal: zij kunnen een bestand functioneel herkennen zonder bij iedere wijziging hun lokale implementatie opnieuw te moeten hernoemen.

Update-informatie

  • Versie v0.2 — 11-04-2026: relationeel genormaliseerd en canoniek geconsolideerd in bundel 1.2.