:pencil: Add technical documentation for the Documents API configuration

[sergei-maertens]

• Documented the need for Documents API
• Documented how to configure the authorisations
• Added a list of pre-requisites
• Added a list of known vendors of a Documents API

[sergei-maertens]

@MarcoKlerks sanity check vooral - ik verwacht niet dat je inhoudelijk begrijpt waar het allemaal om gaat :wink:

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests
• JS Bundle Analysis - Avoid shipping oversized bundles

[MarcoKlerks]

@MarcoKlerks sanity check vooral - ik verwacht niet dat je inhoudelijk begrijpt waar het allemaal om gaat 😉

Tsss, je onderschat me. :-)

Het is terecht dat je OpenZaak noemt als een mogelijke oplossing, maar ik geloof zelfs dat dit de meest gebruikte oplossing wordt. Wat mij nog niet helemaal duidelijk is, is of in het ZTC (Catalogi API) nog zaaktypen en/of documenttypen geconfigureerd moeten worden, of dat een document-record direct gekoppeld wordt aan een documenttype c.q. informatiecategorie uit het ODRC. Oftewel, moeten in OpenZaak nog zaaktypen, documenttypen, etc. worden ingericht om de koppeling te laten werken?

[sergei-maertens]

Oftewel, moeten in OpenZaak nog zaaktypen, documenttypen, etc. worden ingericht om de koppeling te laten werken?

Kort antwoord: nee.

Lang antwoord: de opzet waarbij we informatiecategorie gebruiken als documenttype is precies zo gemaakt zodat er geen documenttypen meer hoeven ingesteld te worden in een catalogus want dat is heel erg onproductief.

Het is terecht dat je OpenZaak noemt als een mogelijke oplossing, maar ik geloof zelfs dat dit de meest gebruikte oplossing wordt.

Kan, maar wij implementeren standaarden, niet leveranciers/producten en ik vind onpartijdigheid hierin best wel heel erg belangrijk :wink:

[MarcoKlerks]

Interessant, ik zie hier gelijk kansen in voor het koppelen met een zaaksysteem.

We zouden de API kunnen aanpassen, zodat Documenten API-service, Document-UUID en Documentvergrendelingscode aangeleverd kunnen worden vanuit een zaaksysteem. Zo kunnen documenten "in de bron" blijven staan, zoals sommigen willen. Als de drie velden niet aangeleverd worden, dan geeft de API "informatie terug aan de client zodat de bestandsinhoud geüpload kan worden."

Ik ga dit even in een user story gooien, zodat ik het niet vergeet. Ik heb nog geen idee welke P dit wordt.