Bouw medewerkerselectie en Vandaag/Alle open klussen met compacte kaarten. Laat vanuit mobiel detail starten, een notitie toevoegen en afronden. Voorgangers: T05 (taak 243)
02 — Werkwijze en schermen
Van nieuwe klantaanvraag naar afgeronde klus. Gebruikersrollen, schermen, statussen, mobiele bediening en fictieve voorbeeldgegevens.
Maak statusaantallen, zoekfunctie, filters, duidelijke lege toestanden en een detailpagina. Houd verlopen, gepland en ongepland werk herkenbaar. Voorgangers: T03 (taak 241)
Bouw het Nederlandstalige formulier met fictieve voorbeeldwaarden, veldvalidatie en heldere bevestiging. Verwijs na opslaan naar de aanvraag in de eigen planning. Voorgangers: T02 (taak 240)
Breid de bestaande live ServiceOverzicht-app uit volgens kennis 175: een Lijst/Kaart-wissel in Planning met dezelfde servermatige selectie, filters voor medewerker en urgentie, klikbare markeringen/popup naar het bestaande klusdetail, acht vaste fictieve locaties rond Utrecht en een optionele locatiekeuze in aanvraag en detail. Maak mobiel, ontbrekende locaties, gedeelde locaties en kaartuitval goed bruikbaar. De huidige app en Spoedklussen (T13, taak 265) zijn live; inspecteer de bestaande code en actuele deployment. Oude open T01–T12-taken zijn geen opdracht om opnieuw te bouwen. Bouw, test en publiceer via de bestaande deployment op https://serviceoverzicht.salomons.nl/, behoud actieve demosessies en schrijf de feitelijke oplevering terug in Buildory. Lees eerst de volledige specificatie 175, deze taakvelden en de hieronder via constraints aangewezen context. De lijst blijft standaard; kaart is aanvullende weergave. Lever echte desktop- en mobiele screenshots voor Henks demonstratie van ChatGPT → Buildory → Codex → live app → bijgewerkt projectgeheugen.
Voeg de uitbreiding 'Spoedklussen' toe aan de bestaande ServiceOverzicht-app en publiceer haar op https://serviceoverzicht.salomons.nl/. De volledige nieuwe specificatie staat in kennis 165. Bouw een spoedmarkering met verplichte korte reden in het plannerdetail, label/teller/filter/sortering in Planning en dezelfde markering met reden in Mijn werk. Pas één voorbeeldklus aan voor verse/resetdemo's. Rond gerichte tests, publieke rooktest en echte screenshots af. Gebruik de bestaande repository, data en deployment. Controleer de huidige code voordat je op achterlopende statusvelden uit de oorspronkelijke backlog afgaat. Het doel is één uitbreiding van de bestaande app; geen nieuwe appbasis.
Build Log
3 entriesT14 kaartweergave live: release, acceptatie en screenshots
T14 / taak 269 (specificatie 175) is op 30 september 2026 gebouwd en live gezet op https://serviceoverzicht.salomons.nl/ (planning: /planning?view=kaart). Code-release: GitLab commit 7c63896c49cf8f125a6a31ad2517c272a77de9d7; actieve, gezonde productie-image heeft exact deze SHA. Bewijs/screenshots en gestabiliseerde browserproef: vervolgcommit 49fd57e op main; dit is alleen documentatie/testcode en verandert de productie-app niet. Werkelijk geleverd: server-side kaart-/lijstschakelaar met gedeelde zoek-, status-, medewerker-, datum- en urgentiefilters en behoud van filtercontext bij openen/terugkeren; tellingen gevonden/op kaart/zonder locatie, inclusief lege en niet-gelokaliseerde resultaten; acht vaste fictieve demo-locaties A–H met optionele selectie bij nieuwe aanvraag en bewerkbare/verwijderbare locatie in het detail; nieuwe of teruggezette demo's krijgen A–H, bestaande dossiers krijgen geen automatische locatie; gegroepeerde, toetsenbordbereikbare markers met kluslinks en zichtbare spoedmarkering; mobiel bruikbare kaart en steeds toegankelijke HTML-lijst. Leaflet 1.9.4 is lokaal meegeleverd; normale OpenStreetMap-tegels, zichtbare bronvermelding en privacytekst, plus lijst en waarschuwing bij tegeluitval. De locatie verandert de bestaande werk-/spoedstatus niet. Acceptatie en feitelijke resultaten: Rails-suite 15 tests / 280 assertions / 0 failures, 0 errors, 0 skips. Zeitwerk-check en productie-assetcompilatie geslaagd; Brakeman 0 waarschuwingen. Additieve migratie ook getest op gevulde SQLite: dossiers/sessies/spoed bleven staan, nieuwe locatiekolom NULL. Vóór deployment waren 16 aanvragen en 2 sessies aanwezig; direct erna opnieuw 16/2, 0 automatisch gelokaliseerd, migratiekolom aanwezig. Een bestaande publieke demo-cookie gaf vóór en na deployment dezelfde acht aanvraag-ID's in dezelfde volgorde (84,89,86,87,88,85,91,90), en in die oudere demo correct 0 op de kaart / 8 zonder locatie. Consistente pre-release SQLite-back-up gecontroleerd: integrity_check ok, 16 aanvragen en 2 sessies. Oude release voor rollback: 4331de493bdbe1345fcbd91e58a7bd7b9da91cdb. Publieke controles na deployment: HTTPS/TLS geldig en HTTP 200 voor startpagina, /up en /planning?view=kaart; kaartresponse heeft Referrer-Policy strict-origin-when-cross-origin. Echte Chrome-browserproef op de publieke URL: nieuwe demosessie met 8 locaties, 8 markers en 8/0-telling; filters, lijst/kaart, popup en detail/terugkeer; extra aanvraag op locatie A geeft één groepsmarker met twee afzonderlijke kluslinks; tegelverzoeken opzettelijk geblokkeerd en waarschuwing plus HTML-lijst bleven bruikbaar; toetsenbordmarker en 360/390px mobiel zonder horizontale scroll of afgesneden popup geslaagd. Bestaande spoed-/planningroute opnieuw publiek doorlopen: urgentiereden/-telling, medewerkerplanning, Mijn werk, afronden en nieuwe aanvraag geslaagd op desktop en 360/390px mobiel. Een tweede normale publieke browseropname met echte kaarttegels en zichtbare OSM-attributie leverde de screenshots op. Sessiescheiding is tevens afgedekt in Rails-integratietests en publiek zichtbaar aan het verschil tussen ongewijzigde oude demo (0/8) en nieuwe demo (8/0). Screenshots: Buildory artifact #27 “T14 kaartweergave — planning desktop” en #28 “T14 kaartweergave — planning mobiel”; dezelfde PNG's staan in GitLab onder docs/screenshots/kaart-planning-desktop.png en docs/screenshots/kaart-planning-mobiel.png (commit 49fd57e). Alleen fictieve gegevens. Geen LinkedIn-bericht gepubliceerd. Operationele kanttekening: oude actieve demo's behouden hun data en hebben totdat de bezoeker zelf een locatie kiest of zijn demo terugzet geen markers; de gefilterde HTML-lijst blijft dan volledig bruikbaar. OSM-tegels zijn een externe best-effort dienst en bij uitval blijft de lijst werken.
T13 — definitieve productierelease en hercontrole
Aanvulling op bouwlog 4062: de definitieve release 4331de4 staat live op https://serviceoverzicht.salomons.nl/. De laatste correctie houdt na een ongeldige spoedreden de opgeslagen spoedstatus zichtbaar, terwijl de ingevoerde reden in het formulier blijft staan. De Kamal-uitrol is geslaagd; de actieve productiecontainer draait versie 4331de4 en de negen bestaande fictieve demo-aanvragen waren na de heruitrol behouden. Publieke HTTPS-homepage en /up: HTTP 200 met geldig TLS-certificaat. De volledige publieke Chrome-route slaagde opnieuw: verse demo, spoedmarkering, teller en planning, Mijn werk, afronden, nieuwe aanvraag en mobiele controle op 360 en 390 px zonder horizontale scroll. Lokale tests: 8 tests, 102 assertions, 0 fouten. Twee echte screenshots van de publieke site staan in repository docs/screenshots/spoed-planning-desktop.png en docs/screenshots/spoed-mijn-werk-mobiel.png (commit 95d8d66); in Buildory gekoppeld aan taak 265 als artefact 25 en 26. Er is geen LinkedIn-bericht geplaatst.
T13 — Spoedklussen gebouwd, live getest en screenshots vastgelegd
T13 Spoedklussen gerealiseerd in de bestaande Rails-demo. Coderelease 0f2c0fc: additieve urgent/urgent_reason-migratie, verplichte reden (5–200 tekens), wijzigen/opheffen met versiecontrole en alleen bij echte wijziging een historievermelding; sessiegebonden spoedtegel, teller, gecombineerde filters en sortering; label en reden in detail en Mijn werk; nieuwe/resetdemo met alleen SO-1001 als spoed. Een afgesloten klus vereist expliciet Heropen; herplannen behoudt In uitvoering. Verificatie 23-09-2026: lokaal bin/rails test 8 tests, 101 assertions, 0 fouten; Zeitwerk check geslaagd. De migratie is apart op een niet-lege in-memory SQLite-database uitgevoerd: bestaand record bleef behouden en kreeg urgent=false, reden=NULL. Chrome op lokale testpoort 3101: verse demo, spoedmarkering, planning, Mijn werk, notitie, afronden en nieuwe aanvraagroute; landing, lijst, formulier, detail en Mijn werk op 360/390 px zonder horizontale scroll; veldlabels en Tab-focus gecontroleerd. Automatische integratietests dekken twee onafhankelijke sessies, vreemde detail-/mutatie-ID's, lokale reset, tellingen, filters, sortering, redenvalidatie, HTML-escaping, verouderd formulier, afronden/heropenen en Vandaag/Alle open werk. Productie: vóór migratie gecontroleerde databasebackup; release 0f2c0fc gepubliceerd op https://serviceoverzicht.salomons.nl/. HTTPS landing en /up gaven 200. Echte Chrome-rooktest vanaf de publieke URL: verse sessie toont één spoedvoorbeeld; tweede klus als spoed gemarkeerd en vandaag voor Sam ingepland (teller 1→2), mobiele reden zichtbaar, gestart/notitie/afgerond (teller 2→1); daarnaast nieuwe aanvraag → plannen → starten → afronden geslaagd. Voor de screenshots is uitsluitend fictieve demodata gebruikt. Twee live screenshots staan als Buildory-projectbestanden gekoppeld aan T13: artifact 25 ‘Spoedklussen — planning desktop’ (1400×861) en artifact 26 ‘Spoedklussen — Mijn werk mobiel’ (390×700). Ze staan ook in de repository op docs/screenshots/spoed-planning-desktop.png en docs/screenshots/spoed-mijn-werk-mobiel.png, vastgelegd in commit 95d8d66. Er is geen LinkedIn-bericht gepubliceerd.
Knowledge
4 items## Opdracht, basis en resultaat Henk vraagt op 30 september 2026 om een kaartweergave voor ServiceOverzicht met filters voor medewerker en spoed, doorklikken naar een klus, fictieve locaties en bruikbare mobiele bediening. Dit is de complete specificatie voor de volgende uitbreiding; de functie is nog niet gebouwd. De bestaande demo staat op https://serviceoverzicht.salomons.nl/. De projectsamenvatting en bouwlogs 4062/4063 bevestigen de bestaande Rails/SQLite-app, Kamal-deployment en gerealiseerde spoedklussen. Controleer de actuele repository en release lokaal. Oudere plannen 134, 137 en 140 bevatten inmiddels achterhaalde uitspraken over een nog te bouwen app, databasekeuze of onbevestigde hostname. Gebruik daarvoor de huidige repo/configuratie en latere bouwlogs. Begin niet opnieuw met T01–T12 vanwege achterlopende taakstatussen. ## Doel en afbakening Een planner kan op een echte interactieve achtergrondkaart zien waar de fictieve klussen liggen, op medewerker en urgentie filteren, en een klus openen. De locatie is die van de klus; er worden geen medewerkers gevolgd. Eén responsive uitbreiding binnen de bestaande app. Geen routeoptimalisatie, reistijden, navigatiedienst, GPS-toestemming, live tracking, geocoder, adreszoeker, betaalde dienst of nieuwe productieaccounts. De Buildory-plugin dient alleen voor de ontwikkelwerkwijze, niet als runtime-afhankelijkheid van de demo. ## 1. Lijst en kaart in Planning Voeg binnen Planning een duidelijke wissel Lijst / Kaart toe; Lijst blijft de bestaande standaard. Gebruik een GET-route of weergaveparameter passend bij de app. Behoud alle aanwezige filters bij het wisselen: zoeken, status, medewerker, geplande datum en urgentie. De kaart gebruikt dezelfde servermatige selectie en defaults als de lijst. Voeg geen verborgen statusfilter toe: ook afgeronde klussen zijn zichtbaar wanneer de huidige selectie die bevat. Medewerker omvat Alle medewerkers, Niet toegewezen en de drie medewerkers Sam/Noor/Alex uit de eigen sessie. Voeg Niet toegewezen zo nodig aan beide weergaven toe. Urgentie blijft Alle / Normaal / Spoed. Combinaties moeten identiek werken. Wis filters behoudt de gekozen weergave. De actie Bekijk open spoed houdt de huidige weergave aan en toont, zoals in kennis 165, alle open spoedklussen terwijl andere filters worden gewist. Detail openen en teruggaan bewaren de kaartweergave en filters via veilige interne parameters/URL's; accepteer geen willekeurige externe return-URL. Na een wijziging opnieuw filteren: een klus die niet meer aan de selectie voldoet verdwijnt terecht. Behoud de bestaande globale open-spoedteller en de betekenis van andere tellers. Voeg bij de kaart een aparte samenvatting toe: bijvoorbeeld 6 klussen gevonden · 5 op de kaart · 1 zonder locatie. Tellingen gaan over klussen, niet over unieke markerposities. ## 2. Interactieve kaart en klussenlijst Toon boven de kaart: Fictieve voorbeeldlocaties — geen echte klantadressen. Markeringen zijn herkenbaar en aanklikbaar. Normale klussen krijgen het bestaande petrol accent; spoed een oranje/rood accent plus een herkenbaar uitroepteken en tekst Spoed in popup/lijst. Betekenis mag niet alleen van kleur afhangen. Een afgeronde spoedklus blijft als Afgerond herkenbaar en telt niet als open spoed. Popup: aanvraagnummer, fictieve klantnaam, locatie-etiket, status, toegewezen medewerker of Niet toegewezen, eventueel geplande datum, spoedlabel en een duidelijke link Open klus. Geen e-mail, notities of andere onnodige gegevens in de kaartdata. Een klik/tik opent de popup; Open klus opent het bestaande detail. Gebruik veilige DOM-tekst/escaping, geen ongeschoonde HTML-interpolatie. Nieuwe klussen mogen dezelfde demolocatie delen. Toon op die plek één markering met het aantal klussen en een popup met afzonderlijke veilige links en status/spoed per klus; geen klus mag onbereikbaar achter een andere marker liggen. Groepsmarkering krijgt het spoedsymbool als ten minste één weergegeven open klus spoed heeft. Eerste kaartweergave en een ingediende filterwijziging passen het kaartbeeld op de gevonden locaties aan, met begrensde maximale zoom. Eén locatie krijgt een bruikbare straat/wijkzoom; nul locaties een rustige vaste regio rond Utrecht en een duidelijke melding. Opnieuw centreren gebeurt via een knop Toon alle gevonden locaties; normaal scrollen/interactie mag het beeld niet steeds terugzetten. Toon onder de kaart altijd een compacte servergerenderde lijst van alle gevonden klussen, inclusief die zonder locatie, met dezelfde volgorde als de bestaande planning. Elke rij heeft de essentiële gegevens en Open klus. Hierdoor blijven toetsenbord, ontbrekende locatie en een kapotte kaart bruikbaar. Bij nul resultaten: Geen klussen gevonden met deze filters, met Wis filters. Bij resultaten zonder enige locatie: Geen locaties om op de kaart te tonen, met de klussenlijst eronder. Er worden geen punten verzonnen voor ontbrekende locaties. ## 3. Opgeslagen fictieve locatie en bewerken Bewaar per ServiceRequest een optionele demo_location_key (of gelijkwaardig veld volgens bestaande conventies), default NULL. Gebruik een gedeelde, servermatig beheerde catalogus voor sleutel, etiket en coördinaten. Geen vrij invoerbare adressen of coördinaten in deze demo. Nieuwe aanvraag krijgt één optionele selectielijst Demo-locatie met Geen locatie gekozen en de acht onderstaande opties. Geen locatie gekozen is standaard; bestaande verplichte velden en aanvraagflow blijven geldig. In het plannerdetail is de huidige locatie zichtbaar en met dezelfde selectielijst te wijzigen of te wissen via een expliciete opslagactie. Een knop Locatie kiezen kan naar deze sectie verwijzen. Locatie wijzigen mag ook bij afgeronde klussen zonder hun werkstatus te wijzigen. Een locatiekeuze verandert nooit medewerker, urgentie, status of plandatum. Opslaan/wissen gebruikt de bestaande CSRF-, sessie- en versiecontrole. Alleen een werkelijke wijziging maakt een eenvoudige historiegebeurtenis met oud/nieuw locatie-etiket. Bewaar gewijzigde invoer bij fouten. Geen onbekende catalogussleutels accepteren; initiale locatie wordt als deel van aanmaak vastgelegd. Server bepaalt de coördinaten uit de sleutel; accepteer geen lat/lon of client-sessie-ID als alternatieve waarheid. Een onverwachte oude/onbekende opgeslagen sleutel resulteert defensief in Locatie onbekend en geen marker; nieuwe invoer blijft strikt gevalideerd. Locatie-etiket mag in Mijn werk en het bestaande mobiele detail worden getoond. Een aparte medewerkerkaart of nieuwe mobiele app valt buiten deze taak. ## 4. Catalogus en seed Gebruik de volgende bewust gekozen fictieve markerposities rond Utrecht. Ze vertegenwoordigen geen echte klant, vestiging of adres; geen reverse geocoding of echte adreslabels toevoegen. | Sleutel | Etiket | Breedtegraad | Lengtegraad | Nieuwe/resetdemo | |---|---|---:|---:|---| | A | Demo-locatie A | 52.1165 | 5.1100 | SO-1001 | | B | Demo-locatie B | 52.1020 | 5.0720 | SO-1002 | | C | Demo-locatie C | 52.0830 | 5.0920 | SO-1003 | | D | Demo-locatie D | 52.0890 | 5.1270 | SO-1004 | | E | Demo-locatie E | 52.0750 | 5.1510 | SO-1005 | | F | Demo-locatie F | 52.0590 | 5.1070 | SO-1006 | | G | Demo-locatie G | 52.1060 | 5.1560 | SO-1007 | | H | Demo-locatie H | 52.1300 | 5.1390 | SO-1008 | Behoud de acht bestaande klanten, medewerkers, relatieve datums en workflowtoestanden uit kennis 135, met de latere SO-1001-spoedwijziging uit kennis 165. Voeg uitsluitend de bovenstaande locatiekoppeling toe aan nieuwe/resetdemo's. Migratie is additief en laat alle bestaande actieve bezoekersrecords en keuzes intact. Bestaande records blijven zonder locatie totdat de bezoeker die kiest of zijn eigen demo bewust reset. Geen stille backfill, reset of productieseed over actieve sessies. Bij een verse ongefilterde demo zijn er 8 gelokaliseerde klussen op 8 posities. Een open-statusselectie sluit de afgeronde klussen uit; medewerker- en spoedfilters volgen de bestaande data. ## 5. Technische richting en kaartachtergrond Gebruik Leaflet voor de interactieve kaart, tenzij de repo al een passende kaartbibliotheek bevat. Gebruik een actuele stabiele release die lokaal wordt gecontroleerd en vastgezet; geen alpha/beta uitsluitend omdat die nieuwer is. Lever JS/CSS via de bestaande assetaanpak van de app; sluit netjes aan op Turbo/Stimulus en ruim kaartinstanties op bij navigatie om dubbele initialisatie te voorkomen. Voorkeur voor de kleine online demo: OpenStreetMap Standard rastertegels rechtstreeks vanuit de browser. Geen API-key, geocoding of betaalde provider toevoegen. Houd tile-URL en attributie configureerbaar zodat later van provider kan worden gewisseld. Vóór implementatie de actuele tilepolicy controleren. Gebruik https://tile.openstreetmap.org/{z}/{x}/{y}.png, zichtbare © OpenStreetMap contributors-attributie met copyrightlink, normale browsercaching en een geldig Referer. Geen bulkdownload, offlinecache/prefetch, cachebusting of verborgen attributie. Een restrictieve Referrer-Policy mag de vereiste Referer niet blokkeren; gebruik voor cross-origin een origin-only beleid. Beperk eventuele CSP-uitbreiding tot werkelijk noodzakelijke tilehosts. Automatiseer tests met gestubde tileverzoeken; geen headless pan/zoom om tiles te downloaden. Kaartdienst is best-effort; documenteer vervangbaarheid. De kaartbibliotheek hoeft niet op gewone lijst-, formulier- of landingpagina's geladen te worden. Alle filtering en data-autorisatie blijft op de server; slechts minimaal benodigde gegevens naar de browser. Werk de bestaande privacy/toelichting kort bij: bij het openen van de kaart haalt de browser kaartbeelden op bij OpenStreetMap; die ontvangt daarbij technische verbindingsgegevens. Klantnamen, e-mail, notities, sessiecookies en aanvraag-ID's worden niet naar een kaart/geocoder-API gestuurd; markers worden lokaal over de tiles getekend. Geen uitspraak dat er helemaal geen externe verzoeken plaatsvinden. Bij netwerk-, tile- of JS-uitval blijft de HTML-klussenlijst werken. Toon bij tile-uitval een rustige melding Kaartachtergrond tijdelijk niet beschikbaar; je kunt de klussen hieronder openen. Geen eindeloze laadstatus of geblokkeerde navigatie. Bronnen gecontroleerd op 30-09-2026: - https://leafletjs.com/ - https://operations.osmfoundation.org/policies/tiles/ - https://www.openstreetmap.org/copyright ## 6. Mobiel en toegankelijkheid Controleer minimaal 360 en 390 px breedte plus desktop. Filters stapelen; kaart heeft een bruikbare begrensde hoogte zodat lijst en bediening bereikbaar blijven. Geen horizontale paginascroll. Popups blijven binnen het scherm met goed bereikbare Open klus- en sluitbediening. Circa 44 px tikdoelen waar mogelijk; duidelijke focus en labels. Markeringen/bediening hebben betekenisvolle toegankelijke namen, en alle klussen blijven via de HTML-lijst bereikbaar zonder een kaart te moeten bedienen. Voorkom dat de kaart gewoon scrollen door de pagina onnodig vastzet; geef geen locatiepermissieprompt. Controleer tikken, verslepen/zoomen, filterindiening, wissel lijst/kaart en terugkeer uit detail op smalle schermen. ## 7. Acceptatie en bewijs 1. Verse/resetdemo toont de acht juiste cataloguslocaties, actuele SO-1001-spoedstatus en tekst over fictieve locaties. 2. Medewerker Alle/Niet toegewezen/Sam/Noor/Alex en urgentie Alle/Normaal/Spoed werken afzonderlijk en gecombineerd; bestaande zoek/status/datumfilters matchen exact de lijst. Wis filters en Bekijk open spoed behouden de weergave. 3. Marker → popup → juiste detail werkt. Terugkeer behoudt filters/weergave. Gedeelde locatie blijft volledig bereikbaar via groepspopup en HTML-lijst. 4. Aanvraag met en zonder locatie; locatie wijzigen/wissen; ongeldige sleutel; verouderd formulier; veilige tekstweergave. Alleen echte wijzigingen krijgen historie; status/urgent/medewerker/datum blijven intact. 5. Ontbrekende locatie, nul resultaten, één punt en meerdere punten tonen correcte tellingen en kaartuitsnede. Geen default (0,0)-punten. 6. Twee onafhankelijke demosessies: kaart-HTML/JSON, detail, locatie-update, filtering, tellingen en reset blijven geïsoleerd. Manipulatie van request/employee/session-ID geeft geen vreemde gegevens prijs. 7. Migratie tegen een bestaande niet-lege database bewaart records/keuzes. Bestaande sessie blijft zonder locatie bruikbaar; alleen bewuste reset geeft nieuwe seed. 8. Desktop en 360/390 px bruikbaar met klik/tik/toetsenbord, leesbare labels, geen horizontale scroll; herhaald navigeren met Turbo geeft geen dubbele kaartinstantie. Bij ontbrekend JS/tiles blijft de klussenlijst toegankelijk. 9. Bestaande aanvraag → plannen → starten → afronden en de spoedroute blijven werken. Geen routing/GPS/geocodingverzoeken. Attributie zichtbaar; privacytoelichting en tileverzoeken kloppen. Gebruik bestaande tests met gerichte integratie-/modelcontroles; stub kaarttiles voor geautomatiseerde browsercontroles en bekijk de echte kaart via normale interactieve rooktest. Noteer werkelijk uitgevoerde controles en beperkingen, geen verzonnen testclaims. ## 8. Publicatie, terugschrijven en demonstratiemateriaal De lokale Codex bouwt en publiceert op de bestaande https://serviceoverzicht.salomons.nl/ via de bestaande deployment. Lees AGENTS.md, README en DEPLOYMENT.md, inspecteer werkboom/release en respecteer ander lokaal werk. Geen nieuwe app, hostname, hostingdienst of vervanging van andere applicaties. Leg vorige release vast, maak een bruikbare databasebackup vóór de migratie en noteer herstel. Een rollback naar vorige appcode mag de additieve locatiekolom laten staan om invoer te behouden. Controleer na deployment publieke HTTPS-homepage/health, echte kaart met filters, detail/terugkeer, verse én bestaande demosessie, mobiel en de bestaande hoofdroute. Alleen een lokale preview is geen publicatiebewijs. Schrijf commit/release, publieke URL, werkelijke tests, live rooktest, eventuele beperking en screenshots terug in Buildory. Markeer taak pas done na geslaagde live controle. Bij echte blokkade: blocked met concrete reden en wat nog nodig is. Maak echte screenshots van de live desktopkaart en de mobiele kaart met popup; bewaar in docs/screenshots/kaart-planning-desktop.png en kaart-planning-mobiel.png en koppel als Buildory-artefacten aan de taak indien upload beschikbaar. Fictieve gegevens, zichtbare attributie, geen secrets. Voor Henks LinkedIn-demonstratie moet de keten achteraf navolgbaar zijn: oorspronkelijke wens → deze specificatie/bouwtaak in Buildory → Codex leest taak → live kaart → resultaat terug in Buildory. Henk kan de stappen opnemen; Codex levert feitelijk resultaat en screenshots en claimt geen niet-gemaakte video. Geen social post publiceren of berichten versturen binnen deze opdracht.
## Opdracht en status Henk heeft op 23 september 2026 gevraagd om één duidelijke extra functie voor ServiceOverzicht te bepalen, waarna zijn lokale Codex deze bouwt en publiceert. Gekozen uitbreiding: spoedklussen zichtbaar maken en behandelen. Dit document is een nieuwe specificatie, geen verslag van een reeds gebouwde functie. De bestaande app staat op https://serviceoverzicht.salomons.nl/. Buildory bevat nog achterlopende taakstatussen; inspecteer de bestaande implementatie voordat je werk opnieuw bouwt. ## Doel Een planner ziet direct welke aanvragen eerst aandacht vragen. Een medewerker ziet op mobiel waarom een toegewezen klus spoed heeft. De demonstratie kan in circa 45–60 seconden een zichtbare wijziging van aanvraag tot uitvoering tonen. ## Aanvulling op het bestaande plan Lees kennis 132 (schermen), 133 (bedrijfsregels), 134 (sessies), 135 (seed), 136 (acceptatie), 137 (publicatie) en 140 (Codex-werkwijze). Deze uitbreiding wijzigt uitsluitend de hieronder beschreven onderdelen, waaronder de sortering uit 132 en één seedvoorbeeld uit 135. De overige afspraken blijven gelden. De bestaande repo en deployment zijn het uitgangspunt; de eerdere voorkeur voor een nog te bepalen database is inmiddels ingehaald door de gemaakte implementatiekeuze. ## 1. Spoed instellen in het plannerdetail Bij een open aanvraag staat een actie 'Markeer als spoed'. Daarbij vult de planner een korte reden in; label 'Waarom is dit spoed?', 5–200 tekens na trimmen. Sla vlag, reden en historie samen op. Een spoedaanvraag toont een opvallend label 'Spoed' plus een klein herkenbaar icoon. Gebruik een rustig rood/oranje accent, voldoende contrast en gewone tekst; geen knipperen. De planner kan de reden wijzigen of met 'Spoed opheffen' de markering verwijderen. Opheffen wist de actuele reden; de beperkte wijzigingshistorie bewaart de verandering. Na opslaan: een korte bevestiging. Veldfouten behouden de ingevulde reden. Bij afgeronde aanvragen zijn urgentie en reden alleen leesbaar; heropenen via de bestaande statusactie maakt wijzigen weer mogelijk. Nieuwe aanvragen beginnen standaard als normaal. Het klantformulier krijgt in deze uitbreiding geen spoedkeuze. De rolweergaven blijven een demo, zonder nieuwe productieaccounts te suggereren. ## 2. Planning en filters Toon een compacte tegel 'Open spoedklussen' met het aantal aanvragen met spoed én status Nieuw, Ingepland of In uitvoering in de eigen demosessie. Deze totaalteller is onafhankelijk van actieve lijstfilters. Een actie 'Bekijk open spoed' toont alle open spoedklussen van de huidige sessie en wist andere lijstfilters. Laat de actieve selectie zichtbaar zien. Bij nul blijft de knop bruikbaar met een nette lege toestand. Voeg bij de bestaande lijstfilters 'Urgentie' toe: Alle / Normaal / Spoed. Dit filter combineert met zoeken, medewerker, status en datum, en 'Wis filters' neemt urgentie mee. Via de gewone filters blijven ook afgeronde spoedklussen vindbaar. Plaats het label naast de aanvraagtitel; laat de spoedreden in het detail zien om de lijst rustig te houden. Sorteer binnen de gekozen filters: open spoedklussen eerst, daarna overige open klussen, daarna afgeronde klussen. Binnen beide open groepen geldt de bestaande volgorde: verlopen planning, eerstvolgende planning, ongepland op ouderdom. Gebruik een stabiele extra sortering op ID bij gelijke waarden. Afgeronde spoedklussen komen dus niet boven open normaal werk. ## 3. Mijn werk op mobiel Toon hetzelfde tekstlabel en de spoedreden bij toegewezen spoedklussen in Mijn werk en in het mobiele detail. Behoud de bestaande medewerkerkeuze en Vandaag / Alle open klussen. Toon alleen records die binnen die selectie vallen; spoed trekt een toekomstige klus niet automatisch naar Vandaag. Binnen de selectie staan open spoedklussen boven normaal werk. Gewone acties zoals starten, notitie toevoegen en afronden blijven werken. Geen aparte spoedstatus of nieuwe mobiele app. ## 4. Bedrijfsregels en gegevens Voeg een opgeslagen boolean urgent toe (default false, niet null) en een optionele urgent_reason, of gebruik een reeds aanwezige gelijkwaardige structuur. Pas namen aan de bestaande codeconventies aan. Bestaande aanvragen worden bij migratie normaal; bestaande actieve demosessies blijven bruikbaar en verliezen geen data. De nieuwe reden is verplicht als urgent=true. Weiger of normaliseer inconsistentie servermatig; vertrouw niet alleen op UI-validatie. Behandel de reden als gewone ge-escapete tekst. Spoed verandert nooit automatisch werkstatus, medewerker, voorkeursdatum of geplande datum. Er is geen belofte van responstijd, capaciteit of notificatie. Afronden bewaart de spoedvlag en reden als context, maar verwijdert de klus uit de open-spoedteller. Heropenen laat een nog gemarkeerde klus weer meetellen. Log werkelijke wijzigingen van urgentie/reden in de bestaande beperkte historie met tijd en demo-weergave. Ongewijzigd opslaan levert geen extra gebeurtenis op. Sluit aan op de bestaande bescherming tegen gelijktijdige updates. Alle lees-, tel-, filter- en mutatieacties blijven strikt beperkt tot de servermatig bepaalde demosessie. Geen extra betaalde dienst, AI-aanroep of uitgaande berichten toevoegen. ## 5. Voorbeeldgegevens Behoud de acht voorbeeldklussen. Maak alleen voor nieuw gestarte of teruggezette demo's SO-1001 een open spoedklus: - Klant blijft Demo Bakkerij Haven. - Omschrijving: 'De achterdeur van de voorraadruimte sluit niet meer.' - Spoedreden: 'De voorraadruimte moet vandaag afsluitbaar zijn.' - Status Nieuw; geen medewerker of geplande datum. - Voorkeursdatum vandaag, relatief aan de lokale kalenderdag. De overige zeven voorbeelden beginnen normaal. Voeg een consistente fictieve historie toe. Verander tijdens deployment geen door bezoekers gewijzigde records. Een bestaande actieve demosessie krijgt de nieuwe seed pas na een bewuste reset. ## 6. Demo voor de volgende LinkedIn-bijdrage Start een verse demo en laat de reeds aanwezige spoedtegel zien. Open een andere normale voorbeeldklus, markeer die met een korte reden als spoed en laat zien dat teller en overzicht meeveranderen. Plan haar voor Sam op vandaag. Open Mijn werk voor Sam, toon label en reden en rond de klus via de bestaande route af. De teller daalt met één. Maak na implementatie echte screenshots: het planningsoverzicht met de spoedtegel en een goed leesbare mobiele spoedkaart. De gekoppelde bouwtaak plus resultaat laten zien hoe Buildory een volgende wijziging draagt. Publiceer of verstuur geen social bericht als onderdeel van deze bouwtaak. ## 7. Acceptatie en publicatie Controleer gericht: 1. Normaal → spoed → reden aanpassen → spoed opheffen, inclusief te korte/te lange reden en veilige tekstweergave. 2. Sortering, gecombineerde filters, teller, afronden/heropenen en gedrag bij nul open spoedklussen. 3. Twee onafhankelijke demosessies: A kan spoedrecords van B niet lezen/wijzigen en B beïnvloedt A's telling niet. Reset blijft lokaal. 4. Bestaande gegevens blijven na migratie normaal en bewaard; nieuwe/resetdemo heeft precies één spoedvoorbeeld. 5. De hoofdroute werkt op desktop en 360/390 px mobiel, met toetsenbord en zonder horizontale scroll. Gebruik het bestaande testframework en een korte handmatige rooktest. Voer de controles echt uit en noteer eventuele beperkingen. Publiceer via de bestaande deployment op dezelfde bevestigde URL. Controleer eerst de huidige release en deployinstructie, pas de additieve migratie toe en zorg voor herstelmogelijkheid. Controleer na deployment de spoedroute én de bestaande aanvraag/planning/afrondingsroute vanaf de publieke URL. Schrijf commit/release, werkelijke tests, screenshots/verwijzingen en het resultaat terug in Buildory. Markeer de nieuwe taak pas done na geslaagde live controle. Werk aantoonbaar verouderde projectbeschrijving/taakstatussen op basis van feitelijke verificatie bij; open oude taken betekenen niet automatisch dat de app opnieuw opgebouwd moet worden.
## Bedrijf en personen Noord Onderhoud is uitsluitend een fictieve werknaam voor dit demonstratieproject; geen klantreferentie. Medewerkers: Sam (algemeen onderhoud), Noor (installaties), Alex (service). De labels geven herkenning, geen certificering of beroepsbevoegdheid. Klantnamen en situaties hieronder zijn verzonnen. Gebruik adressen [email protected] t/m [email protected]. Geen echte adressen, telefoonnummers of foto's van klanten. ## Acht seedaanvragen SO-1001 | Demo Bakkerij Haven | 'De deur naar de voorraadruimte sluit stroef. Graag nakijken.' | Nieuw | niet toegewezen | voorkeursdatum +3 dagen SO-1002 | Demo Kantoor West | 'Een plafondplaat zit los in de vergaderruimte.' | Nieuw | niet toegewezen | geen voorkeur SO-1003 | Demo Winkel Esdoorn | 'Het scharnier van een kastdeur moet worden gesteld.' | Ingepland | Sam | gepland vandaag SO-1004 | Demo Studio Linde | 'De kraan in de kitchenette drupt na het dichtdraaien.' | In uitvoering | Noor | gepland vandaag SO-1005 | Demo Fietsenzaak Brug | 'Een plank in de opslag moet opnieuw worden bevestigd.' | Ingepland | Alex | gepland morgen SO-1006 | Demo Praktijk Duin | 'Het slot van de archiefkast loopt stroef.' | Ingepland | Sam | gepland gisteren (bewust verlopen) SO-1007 | Demo Atelier Morgen | 'Het deurhandvat van het magazijn zit los.' | Afgerond | Alex | gepland -2 dagen SO-1008 | Demo Lunchroom Park | 'De ladegeleider van een kast hapert.' | Afgerond | Noor | gepland -3 dagen ## Aanmaak en weergave Bereken relatieve datums bij het seeden op basis van de Nederlandse kalenderdag. Voeg logische fictieve aanmaakmomenten toe, eerder dan geplande afronding. Maak voor reeds ingeplande/uitgevoerde klussen een minimale consistente seedhistorie; presenteer die uitdrukkelijk als voorbeeldhistorie. Twee korte voorbeeldnotities: 'Ingang aan de zijkant gebruiken — fictieve instructie.' en 'Materiaal gecontroleerd — voorbeeldnotitie.' Nooit veiligheidsadviezen of echte klantinformatie toevoegen. Nieuwe nummers volgen na SO-1008 binnen de sessie. Dezelfde nummers mogen in een andere sessie voorkomen. Terugzetten levert dezelfde acht scenarios op met datums ten opzichte van de resetdag. ## Hoofdscenario voor demonstratie Open de demo → maak een nieuwe fictieve aanvraag → open die in Planning → kies Sam en morgen → sla op als Ingepland → open Mijn werk voor Sam → toon Alle open klussen → start uitvoering → voeg een notitie toe → rond af → vind de klus via filter Afgerond. Extra korte routes: verlopen klus herkennen; planning ongedaan maken; afgeronde klus heropenen; demo terugzetten. De app stuurt geen berichten en boekt geen echte afspraak. Dit is tijdens het proberen steeds zichtbaar.
## Toegang en betekenis van rollen De publieke demo start met 'Probeer de demo' en maakt een eigen oefenomgeving aan. Bovenin staat: 'Interactieve demo • fictieve gegevens'. Binnen deze omgeving zijn Klantaanvraag, Planning en Mijn werk bereikbaar. Dit zijn gezichtspunten in een demo, geen productie-rollen met echte autorisatie. De formulierweergave laat geen interne notities zien. Een echte klantomgeving en accountrechten zijn vervolgwerk. ## 1. Landing Titel: 'Van klantaanvraag naar ingeplande klus.' Tekst: 'Ontvang aanvragen, verdeel het werk en houd de voortgang bij. Probeer het met een fictief onderhoudsbedrijf.' Primaire knop: 'Probeer de demo'. Secundair: 'Bekijk hoe dit is gebouwd', pas koppelen zodra een verifieerbare openbare project-URL beschikbaar is. Een rustig productbeeld mag later uitsluitend uit de werkende app komen; de projectcovers zijn illustraties. ## 2. Nieuwe aanvraag Velden: naam (verplicht), e-mailadres (verplicht), omschrijving (verplicht), voorkeursdatum (optioneel). Gebruik vooraf ingevulde fictieve voorbeelden die de bezoeker mag wijzigen. Geen telefoonnummer of volledig adres nodig voor deze demo. Zichtbare tekst: 'Gebruik alleen verzonnen gegevens. Er wordt geen bericht verstuurd.' Succes: aanvraagnummer en 'Je demo-aanvraag staat in het overzicht.' Daarna knop 'Bekijk in de planning'. Bij fout: Nederlandse fouttekst bij het veld én behoud van invoer. Voorkeursdatum heet nooit afspraakdatum. ## 3. Planning Tellingen per status; lijst met nummer, klant, korte omschrijving, medewerker, geplande datum en status. Zoek op nummer, naam en omschrijving; filter op status, medewerker en plandatum; knop om filters te wissen. Open werk eerst: verlopen geplande datum, vervolgens eerstvolgende geplande datum, daarna ongepland op ouderdom. Afgerond is via filter zichtbaar, maar verdringt open werk niet. Geen drukke kalender of drag-and-drop nodig. Lege toestand geeft een passende vervolgstap. ## 4. Aanvraagdetail Klantvelden, voorkeursdatum, geplande datum, medewerker, status, interne notities en een eenvoudige wijzigingshistorie. Planner kan datum/medewerker wijzigen; medewerker kan de uitvoering starten of afronden. Alle veranderingen worden servermatig gevalideerd. Notities toevoegen als aparte gedateerde regels; niet stilzwijgend overschrijven. Historie vermeldt de demo-weergave, geen verzonnen identiteit. 'Nieuwe aanvraag' blijft beschikbaar. Duidelijke teruglink naar de gefilterde lijst. ## 5. Mijn werk op mobiel Kies één van de drie fictieve medewerkers; toon diens open klussen met Vandaag / Alle open klussen. Medewerkerkeuze is een demo-filter, geen beveiligde login. Kaarten tonen het belangrijkste zonder horizontaal scrollen. Per klus: detail openen, uitvoering starten, notitie toevoegen, afronden. Toekomstige klus starten is toegestaan na bewuste actie; datum is planning, geen toegangsregel. ## 6. Demobeheer en vormgeving 'Zet demo terug' vraagt bevestiging en raakt alleen de huidige oefenomgeving. Bij verlopen sessie: duidelijke melding en een nieuwe demo. Nederlandse interface, datums dd-mm-jjjj, tijdzone Europe/Amsterdam voor tonen en 'vandaag'. Rustige off-white achtergrond, donkerblauwe tekst, bescheiden petrol accent, duidelijke statuslabels; nooit betekenis via kleur alleen. Toetsenbordbediening, zichtbare focus, echte labels, bruikbaar vanaf 360 px; gangbare handelingen met circa 44 px hoge tikdoelen. Geen animatie nodig om de werking te begrijpen.