CG-DMF is een open source Document Registratie Component (DRC) voor het Common Ground landschap. Het implementeert de VNG Documenten API 1.5.0 en enkele experimentele functionaliteiten.
De applicatie bestaat uit een backend (Kotlin/Ktor) en een admin portal (Next.js). Documenten worden opgeslagen in S3-compatibele opslag (MinIO, AWS S3) of Azure Blob Storage.
- Volledige implementatie van de VNG Documenten API 1.5.0
- Koppeling met documenten aan willekeurige objecten (niet alleen Zaken)
- S3-compatibele opslag (MinIO, AWS S3) en Azure Blob Storage
- Optionele integratie met Open Notificaties
- Optionele WOPI-host voor in-browser documentweergave en bewerken (bijv. Collabora Online)
- Beheerinterface voor opslag, authenticatie en clientbeheer
Deze DRC implementatie is initieel geschreven in opdracht van de Gemeente Utrecht door Baseflow BV.
Het doel van deze implementatie is het faciliteren van documenten opslag en registratie voor het Werven project en overige afdelingen waarbij documenten over objecten in de fysieke ruimte worden beheerd en bewaard. Hierbij speelt het probleem dat de informatie vaak het resultaat is van een zaak (proces), maar dat de raadpleging en ontsluiting van de informatie en documenten meer object georiënteerd is. We noemen dit ook wel 'objectgericht werken' in plaats van zaakgericht werken. Het IKO of wel Integraal Klant en Objectbeeld is een initiatief van de Gemeente Utrecht om dit te faciliteren.
In het huidige ontwerp van de Common Ground APIs zijn documenten gekoppeld aan Zaken. Maar voor het raadplegen vanuit 'een niet zaak' is dit erg inefficient. Zeker als je nagaat dat bijv. 1 foto makkelijk over 8 fysieke objecten kan gaan, en dat 1 fysiek object soms 10 duizenden documenten kan hebben over duizenden zaken. Veel documenten zijn ook van VOOR een tijd waarbij zaakgericht werd gewerkt.
Deze implementatie wijzigt daardoor wat voor relaties een documentenregistratie kan hebben.
Naast ObjectInformatieObject relaties van het type zaak en/of besluit kan het nu ook relaties van andere types hebben.
Zowel IKO als GZAC kunnen hiervan gebruik maken door in de DRC configuratie te kiezen voor DRC api versie 1.5.0-baseflow.
Voor de API wijzigingen die hiervoor zijn gemaakt zie docs/implementatie.md.
Daarnaast experimenteert de implementatie met het gebruik van de WOPI standaard voor in-browser documentweergave en bewerken. Hiermee kan een gebruiker een document direct openen in de browser zonder dat het eerst gedownload hoeft te worden.
| Onderwerp | Beschrijving |
|---|---|
| Installatie | Productie-installatie: Hel, Docker Compose, Helm |
| Gebruik | Integratie met OpenZaak, GZAC, IKO, notificaties en WOPI |
| Objectkoppelingen | Objectgericht werken — koppelen van documenten aan willekeurige objecten |
| Ontwikkeling | Lokale ontwikkelomgeving, testen, releases |
| Configuratie | Alle omgevingsvariabelen en configuratieopties |
| Documenten API | Implementatiestatus van de API-endpoints |
| Databasemigraties | Migratieworkflow (voor ontwikkelaars) |
| WOPI | In-browser documentweergave en -bewerking via WOPI |
Voor een productie-installatie: zie docs/installatie.md.
Voor lokale ontwikkeling: zie docs/ontwikkeling.md.
Bijdragen zijn welkom via pull requests op github.com/Baseflow/cg-dmf.
Zie CONTRIBUTING.md voor richtlijnen en SECURITY.md voor het melden van beveiligingsproblemen.
Copyright © 2025–2026 Gemeente Utrecht
EUPL-1.2 — zie LICENSE.md