Ziekenhuisplatform: notificaties, een Drive met rechten en vergrendelde roosters
Operationele software voor een ziekenhuis in Nederland: roosters en verlof, taken en tickets, patiëntinformatie en een gedeelde Drive voor documenten.
- Rol
- Backend engineer
- Periode
- dec 2025 tot apr 2026
- Status
- Live in een ziekenhuis in Nederland
- Stack
- NestJS, GraphQL, TypeORM, Postgres, S3
- Probleem
- Notificaties bereikten het personeel niet, documenten hadden delen in de stijl van Google Drive nodig dat veilig bleef voor patiëntgegevens, en bevestigde roosters konden nog worden aangepast.
- Wat ik deed
- Als een van twee backend engineers bouwde ik realtime notificaties via GraphQL-subscriptions, herbouwde ik Drive met overgeërfde rechten, extern delen en een activiteitenlog, en voegde ik vergrendeling van roosterperiodes toe met end-to-end tests.
- Resultaat
- Live en in gebruik in het ziekenhuis.
Het systeem
Een ziekenhuis in Nederland draait zijn dagelijkse operatie op dit platform: personeelsroosters en verlof, taken en tickets, patiëntinformatie en een gedeelde Drive voor documenten. Patiëntgegevens en Europese privacywetgeving leggen de lat hoog. Elk bestand en elk record moet zichtbaar zijn voor precies de juiste mensen, en toegang moet herleidbaar zijn.
Ik kwam erbij als een van twee backend engineers in een team van zeven, met twee frontend engineers, een mobiele developer, een QA-engineer en een lead. De backend is NestJS met GraphQL, TypeORM op Postgres en S3 voor bestanden.
Backend engineer, 2025 tot 2026. Ik was eigenaar van het realtime notificatiesysteem, de herbouw van Drive (rechten, delen, activiteitenregistratie en patiëntbestanden) en het vergrendelen van roosterperiodes, en bouwde de modules Patiëntinformatie, tickets en DPIA. Ik documenteerde de API van elke module en werkte tijdens de integratie samen met de frontend-, mobiele en QA-engineers. De code is van de klant, dus deze beschrijving is gebaseerd op mijn werklog en niet op de repository.
- in gebruik in het ziekenhuis
- Live
- systemen in eigendom
- 3
- personen in het team
- 7
De onderdelen waaraan ik werkte. Hover of tik op een node.
Notificaties die de juiste persoon bereiken
Een leidinggevende keurt het verlof van een verpleegkundige goed.
Mijn eerste grote taak was uitzoeken waarom notificaties nooit aankwamen in de rooster- en Drive-onderdelen van de app. Er was helemaal geen realtime pad, dus bouwde ik er een op GraphQL-subscriptions: één gedeelde publisher, een notificationAdded-subscription die alleen events aflevert die aan de ingelogde gebruiker zijn gericht, en ondersteuning voor beide WebSocket-protocollen zodat oudere en nieuwere clients konden verbinden.
Een notificatie opslaan publiceert die één keer. Van daaruit koppelde ik de events waar het personeel echt om geeft: verlofaanvragen en goedkeuringen, dienstwijzigingen en herindelingen, en reacties op tickets, taken en documenten. Een ronde targetingfixes met het frontendteam zorgde ervoor dat elk event precies de mensen bereikte die het aanging.
Een Drive met rechten die je kunt doorgronden
Een verpleegkundige opent een rooster in de map van haar afdeling.
Het documentsysteem moest werken als Google Drive en tegelijk ziekenhuisdocumenten bevatten, dus herbouwde ik het vanaf het datamodel. Afdelingsdrives en een publieke drive zijn gescheiden, en rechten (bekijken, uploaden, bewerken, verwijderen) worden op mappen toegekend en overgeërfd door alles wat erin zit, zodat toegang op één plek wordt bepaald en niet per bestand.
Handelingen die ongemerkt toegang kunnen veranderen, worden gecontroleerd. Het verplaatsen van een map wordt gevalideerd, zodat die niet in zichzelf kan belanden of op een plek waar de gebruiker niet bij kan, en een bestand verplaatsen naar de publieke drive verwijdert de oude rechten behalve bewerken, zodat een verplaatsing nooit per ongeluk toegang verruimt. Daaromheen zitten de alledaagse functies: items met een ster, prullenbak, bestanden en mappen kopiëren, bestandsaantallen over geneste mappen, en een hele map downloaden.
Delen buiten het ziekenhuis, en het weer intrekken
Sommige documenten moeten het gebouw uit. Bestanden en mappen kunnen worden gedeeld via een publieke link, optioneel beveiligd met inloggegevens, of met mensen buiten het systeem. Ik verving de oude vlag voor het toegangstype door deelscopes die beschrijven voor wie een link is, en verwijderde de verouderde kolommen met een migratie, zodat aanmaken, controleren en intrekken van een share één regel volgen.
Een share intrekken sluit externe toegang direct af. Elke share, kopie en hernoeming wordt met context in een activiteitenlog geschreven, samen met aantallen weergaven en downloads, zodat er een spoor is van wie wat met welk bestand deed. Unittests dekken de activiteitenservice en de bijbehorende listener.
Patiënten kregen hun eigen mappen in Drive, zo afgebakend dat bestanden die aan een patiënt gekoppeld zijn alleen zichtbaar zijn voor de mensen die ze mogen zien.
Roosters die vaststaan zodra ze bevestigd zijn
Een bevestigd rooster mag niet per ongeluk veranderen. Ik voegde periodevergrendeling toe: een roosterbeheerder vergrendelt een bevestigde periode, en de API weigert daarna elke dienst die daarbinnen wordt aangemaakt, gewijzigd of verwijderd, zodat de vergrendeling standhoudt ongeacht welke client het verzoek stuurt. Vergrendelde periodes worden in de app alleen-lezen geladen.
Ook schreef ik end-to-end tests voor de kernflows van het rooster: schakelen tussen periodes, open diensten, bulkupload die alles of niets opslaat, terugkerende diensten die per keer of als hele reeks worden bewerkt, vergrendeling, en gecombineerde filters op gebied, ruimte en afdeling, gecontroleerd zodat niemand diensten buiten zijn rechten ziet.
Privacy als feature
Zorg in Europa valt onder de AVG, dus het platform had meer nodig dan toegangscontrole. Ik bouwde de DPIA-module, waarin het ziekenhuis gegevensbeschermingseffectbeoordelingen vastlegt met hun risico's en de maatregelen die ze beperken, gevuld met een eerste set via een migratie.
Ook bouwde ik de module Patiëntinformatie en de ticketfunctie voor het aanvragen van middelen (van datamodel en ER-diagram tot API en documentatie), voegde ik prenataal verlof toe en werkte ik kwetsbare dependencies in het hele project bij.
Keuzes die ik kan verdedigen
Eén publisher, per gebruiker gefilterd
Elke notificatie gaat via hetzelfde kanaal en de subscription filtert op ontvanger, dus een nieuw soort event is één publish-aanroep, geen nieuwe stream.
In-memory pub/sub op één server
De API draaide als één server, dus een publisher binnen het proces was genoeg. Overstappen op een publisher met Redis is de stap voor wanneer er een tweede server bijkomt.
Deelscopes in plaats van een vlag voor het toegangstype
Een scope zegt voor wie een link is, waardoor aanmaken, controleren en intrekken van shares één regel wordt in plaats van een reeks uitzonderingen.
Vergrendelingen afgedwongen in de API
Een vergrendelde periode weigert writes op de server, niet alleen in de interface, dus geen enkele client kan een bevestigd rooster wijzigen.
In hun woorden
When Emjay joined, we had a project with several key features still outstanding, including Drive and patient-facing modules. He took full ownership of those builds and immediately raised our speed of delivery. Day to day, Emjay is highly independent: he owns features end to end, delivers on time, and asks only the questions that matter. I’d recommend him without hesitation for any full-stack development work.
ThankGod Ajayi