Ga naar inhoud

Hoe werkt dit: wegwijzer

De wegwijzer is het publieke deel van de app. Iedereen kan hem zien, zonder in te loggen. Je stelt een vraag en krijgt de commissie met het adres.

Voor de club

  • / is het zoekveld. Een bezoeker typt waar de vraag over gaat en krijgt de commissie die het doet, met de toelichting en het mailadres. Hoort het onderwerp juist niet bij die commissie, dan staat erbij waar het wel hoort.
  • Is er geen treffer, dan valt de app niet stilzwijgend terug op de voorzitter. Dan verschijnt het vangnetadres van de club (instelling vangnet_email), met Bedoelde je op basis van woordgelijkenis.
  • Een leeg zoekveld toont Veel gezocht (de vijf termen die het vaakst iets opleverden) en alle gepubliceerde commissies.
  • /commissie/<slug> toont de vaste secties: doel, hiervoor wel, hiervoor niet, taken, wie het doet, vacatures, werkt samen met, overleggen, contact en de escalatie. Staat een pagina twaalf maanden zonder bevestiging, dan zegt de pagina dat zelf.
  • /organogram toont het bestuur met de commissies eronder, met vacant, waarneming en interim in beeld.

De club bepaalt wat er publiek staat:

Instelling Werkt zo
commissie.gepubliceerd Alleen gepubliceerde commissies bestaan in de publieke laag (“Staat op de wegwijzer”)
persoon.publiek Zonder dit vinkje (“Naam mag op de publieke wegwijzer”) toont de app de functie en niet de naam
instellingen.publiek_namen Staat dit op false, dan toont de club nergens namen publiek
instellingen.vangnet_email Het adres waar een vraag zonder antwoord heen gaat
werving.gepubliceerd Bepaalt of een vacature publiek zichtbaar is

Hoe de zoekbalk zoekt

De app knipt de vraag in woorden. Woorden die niets zeggen (“ik”, “wil”, “graag”, “worden”) vallen weg. Elk woord dat overblijft, wordt vergeleken met de titel van een onderwerp, de trefwoorden, de toelichting en de naam en het doel van een commissie. De hoogste score telt, met een kleine bonus als meer woorden uit de vraag raak zijn. Eén raak woord is dus genoeg. Een onderwerp dat twee woorden uit de vraag noemt, komt bovenaan.

Voor het onderhoud betekent dit: trefwoorden zijn de woorden die een lid zelf zou typen, en ze hoeven niet compleet te zijn. Wat een lid zoekt en niet vindt, staat in de zoeklog op de commissiepagina. Dat is de werklijst. Staat een onderwerp bij een commissie die nog niet gepubliceerd is, dan vindt de bezoeker wel de verwijzing maar niet de pagina.

Open of besloten

Een commissiepagina is altijd zichtbaar voor de club en, als hij gepubliceerd is, ook voor bezoekers. Een commissie kan haar werk op besloten zetten: het kader, het budget, het mandaat, de taken en het overleg (ADR 71). Die keuze staat op de eigen pagina van de commissie, bij wie de pagina beheert. Eronder staat de clubstandaard in woorden.

Standaard staat alles open. Wil een club dat anders, dan zet je het om bij Instellingen onder Rechten. Een commissie mag daarvan afwijken, in beide richtingen.

Besloten geldt ook voor bezoekers zonder login: het overleg van een gesloten commissie verdwijnt van haar publieke pagina. De pagina zelf, haar onderwerpen en wie er zit blijven staan, want een gesloten commissie is geen geheime commissie. Wie een commissie sluit of opent, staat in de audit.

Voor wie eraan bouwt

De publieke laag is het schema publiek. Dat bestaat uit views die alleen de kolommen tonen die publiek mogen zijn, en alleen rijen van gepubliceerde commissies. Die views draaien als eigenaar en gaan dus langs RLS heen. Daarom filteren ze zelf streng. Een bezoeker zonder login heeft geen rechten op een tabel in public, alleen op deze views en op drie functies:

Functie Doet
publiek.zoek(org, term) Zoekt in onderwerpen en commissienamen. Exacte titel gaat voor, dan titel die de term bevat, dan trefwoord, dan woordgelijkenis (pg_trgm). Geeft ook zwakke treffers terug, zodat “bedoelde je” kan bestaan
publiek.veel_gezocht(org) De vaakst gezochte termen die iets opleverden
zoekterm_loggen(org, term, treffers) Telt een zoekopdracht. Alleen de term en het aantal treffers; geen persoon, ip of sessie

De schermen staan in src/app/(publiek)/ en de query’s in src/modules/wegwijzer/. Het scherm haalt niets rechtstreeks uit een tabel. Alles loopt via die module.

Het werk van je commissie bij elkaar

Open je commissie en kies Werkoverzicht. Bovenaan staan het seizoen en de datum waarop je kijkt. Daaronder vind je de vastgestelde doelen, afspraken en het budget. Via Kader en voorstel openen ga je naar de volledige afspraken of werk je verder aan een voorstel. Een mandaat beschrijft wat is afgesproken. De tekst geeft je geen extra recht om in de app een bedrag goed te keuren.

Mag je financiële details zien, dan staan de bedragen naast hun herkomst: ingediende declaraties, goedgekeurde declaraties, open verzoeken buiten het kader en boekhouding. Tel die bedragen niet op. Een goedgekeurde declaratie kan later ook als boeking terugkomen. Daarom toont dit overzicht geen bedrag dat je nog vrij kunt besteden. Bij boekingen staat de laatste boekdatum. Dat betekent niet dat de boekhouding al bij is.

Onder Wacht op een besluit open je de declaratie of ga je naar de verzoeken. Onder Deze week en eerder staat het open werk tot en met zeven dagen vooruit, inclusief achterstallige taken en taken zonder datum. Afgeronde en vervallen taken staan er niet tussen. Zijn er meer dan vijftig regels, dan staat er dat je voor de rest naar de betreffende werklijst moet. Je ziet steeds alleen het werk waarvoor je al leesrecht hebt.