Hoe werkt dit: bronnen

Waar een gegeven vandaan komt, stel je zelf in. Elke club heeft de bron de app zelf. Daarnaast kan een bestand (Excel of CSV) of een koppeling met de bond leidend zijn. Een controlebron leest alleen mee en wijzigt nooit iets.

Voor de clubbeheerder en de ledenadministratie

Ga naar /beheer/bronnen:

1. Kies per gegevensgroep de leidende bron. Wisselen verplaatst geen gegevens. Het bepaalt alleen wie wint bij een verschil.
2. Lees een bestand in. Kies de groep en kies het bestand. De app herkent de kolomnamen. Inlezen wijzigt niets: je krijgt een verschillenlijst.
3. Handel de verschillen af: Overnemen, Negeren of Later. Kies je Later, dan blijft het verschil in beeld. Een twijfelgeval verdwijnt dus niet.
4. Maak de koppeling met de bond. Sportlink werkt zodra het ClientID op de server staat. De demobron loopt hetzelfde pad met vaste gegevens, zodat je het scherm nu al kunt zien.
5. Koppel de commissies. Stel één keer in welke commissie in de bron bij welke commissie in de app hoort.
6. Download een lijst als CSV of Excel als je die nodig hebt. Het is een momentopname die klopt, geen tweede administratie.

Een bestand kan de aard van een bezetting, het profiel, vitaal en een handmatig ingevuld contactgegeven niet overschrijven. Die zijn van de club en van de app.

Importeer teams vóór de teambezetting. De app vergelijkt teams op teamcode binnen het actieve seizoen. Neem je een team over, dan blijft het oorspronkelijke seizoen behouden. Teambezetting koppelt de persoon en de functie aan dat team. Een beëindigde bezetting telt niet als huidige bezetting. Verwerk je dezelfde bestaande bezetting opnieuw, dan komt er geen tweede rij bij.

CSV ondersteunt geciteerde velden met meerdere regels. Bij het exporteren zet de app een tab voor tekst die op een formule lijkt (in een geciteerd veld), zodat Excel die als tekst behandelt. Dat werkt niet in ieder spreadsheetprogramma. Kies Excel (XLSX) als de letterlijke tekst zonder CSV-voorvoegsel moet blijven.

De clubbeheerder stelt de bronnen in (module bron_beheer). De ledenadministratie handelt de verschillen af (module bron_verschillen). Beide rechten horen bij een commissie, niet bij een rol.

Voor wie eraan bouwt

Bestand	Doet
src/modules/bron/groepen.ts	Welke groepen uit een bestand kunnen komen en welke velden daarbij horen. Wat van de app is, staat er niet
src/modules/bron/bestand.ts	CSV en xlsx lezen en schrijven (ADR 32)
src/modules/bron/vergelijk.ts	Het bestand naast de app leggen, zonder database, dus goed te testen
src/modules/bron/acties.ts	Instellen, inlezen, verschillen afhandelen
src/modules/bron/koppeling.ts	Ophalen bij de bond en commissies koppelen
src/kern/bron/	Het adapterregister plus de adapters (Sportlink, demo)

Een adapter kent twee functies: ophalen(artikel, parameters) en normaliseren(snapshots). Een tweede bond (LISA voor hockey) is dus een nieuw bestand in src/kern/bron/. De rest verandert niet.

Verschillen controleren

Open Bekijk het verschil om de aangeleverde gegevens te zien. Bij een gewijzigde contactwaarde staan de huidige waarde in de app en de waarde uit de bron onder elkaar. Kies daarna welke open verschillen je wilt verwerken. Kies alle zichtbare open verschillen kiest alleen de open rijen die je ziet. Verwerkte regels en regels buiten de zichtbare lijst blijven buiten de selectie. De teller laat zien hoeveel regels je ziet en hebt gekozen. Wissel je van filter, dan wordt de selectie gewist. Krijg je bij het verwerken een foutmelding, dan blijft de selectie staan, zodat je de oorzaak kunt herstellen.