# Versiehistorie

De lijst "wat is er nieuw" die onder **Versiehistorie** staat, op de website (pop-up vanaf het
overzicht) en in de app (onderaan het startscherm), staat in de database. Een nieuwe regel vraagt
daarom **geen nieuwe versie van de app** in de Play Store of App Store, en je houdt het op één
plek bij.

## Hoe het werkt

* Tabel `version_history`: één rij per regel, met `datum`, `versie` (mag leeg), `kop` (het vette
  kopje), `tekst`, `zichtbaar`. Gewone tekst, geen opmaak. Dezelfde kop op dezelfde dag kan maar
  één keer voorkomen.
* De website leest de tabel rechtstreeks (`VersiehistorieService.ZichtbaarAsync`). De app vraagt
  hem op bij de server met de actie `app.versiehistorie` (zie `Socketprotocol.md`) en toont een
  melding als dat niet lukt.
* Volgorde: nieuwste dag bovenaan, binnen één dag in de volgorde van invoer. Opeenvolgende regels
  met dezelfde dag en versie komen onder één kop te staan ("20 oktober 2026 · versie 1.1").
* Beheren doet een beheerder op de website: **Beheer > Versiehistorie beheren**. Toevoegen,
  wijzigen, verbergen en verwijderen; elke wijziging komt in het auditlogboek
  (`VersiehistorieBeheerd`). Een verborgen regel zien lezers niet meer, maar is niet kwijt.

## Wat erin hoort

Nieuwe of wezenlijk gewijzigde functies: "wat kan ik nu wat ik eerst niet kon". Geen bugfixes,
geen tekstuele correcties, geen opmaak die is rechtgezet.

## Uitrollen

1. `db\22_versiehistorie.sql` via de databasescripts van SideKick (maakt de tabel; verandert niets
   aan bestaande gegevens en is opnieuw te draaien).
2. Als root: `mysql -u root -p < db\02_applicatiegebruiker.sql` (rechten voor `mijnbesluit_app`
   op de nieuwe tabel) en `mysql -u root -p mijnbesluit < db\handmatig\22b_versiehistorie_startrijen.sql`
   (de bestaande regels; `INSERT IGNORE`, dus opnieuw draaien is veilig).
3. Daarna pas de website en de SocketServer uitrollen. Andersom leest de nieuwe code een tabel
   die er nog niet is, of waar de applicatiegebruiker nog niet bij mag.

## Oudere apps

De tekst van de versiehistorie zat tot en met appversie 1.1 (versiecode 3) in de app zelf. Die
apps lezen de tabel nooit en tonen dus hun ingebakken tekst, ook als je hier iets bijzet. Vanaf
versiecode 4 haalt de app de lijst op bij de server.