kadaster-labs / solid-quest

Our journey on SOLID
https://labs.kadaster.nl/cases/Solid-Pods
MIT License
3 stars 1 forks source link

VC issuer Kadaster eigendomsrecht van perceel door Verkoper Vera #34

Closed marcvanandel closed 1 year ago

marcvanandel commented 1 year ago

Als Kadaster wil ik het eigendomsrecht van perceel (met object ID xxx) door Verkoper Vera 'issue'n. Deze wil ik uitgeven aan Verkoper Vera zodat zij deze kan opslaan in haar POD.

kad-busses commented 1 year ago

Wat komt er precies in dit VC te staan? (Enne..., is dit de beste plek om dat te bedenken?). Denk dat https://www.w3.org/TR/vc-data-model-2.0/#extensibility ons hierbij kan helpen.

We gaan een context nodig hebben die de termen voor ons omschrijft. Maar misschien zijn de reeds bestaanden ook wel genoeg 🤔. Eerste aanzetje voor een VC zou zijn:

VC:

{
    "@context": [
        "https://www.w3.org/2018/credentials/v1",
        "https://example.com/contexts/zvg_context.jsonld"
    ],
    "id": "https://kadaster.nl/credentials/3732",
    "type": [
        "VerifiableCredential",
        "ZVGExt01"
    ],
    "issuer": "did:kadastersigning:123",
    "issuanceDate": "2020-03-16T22:37:26.544Z",
    "credentialSubject": {
        "id": "did:brpperson:345",
        "Eigendom": {
            "KadastraleAanduiding": {
                "id": "did:kadasterpeceel:1337"
            }
        }
    }
}

Met een context zvg_context.jsonld van bijvoorbeeld:

{
    "@context": {
        "zvg": "http://kad.zorgeloosvastgoed.nl/id/concept/",
        "Eigendom": "zvg:Eigendom",
        "KadastraleAanduiding": "zvg:KadastraleAanduiding"
    }
}
kad-busses commented 1 year ago

Ik begrijp nog niet helemaal hoe we de taxonomie van ZVG kunnen gebruiken. Ik ben denk ik op zoek naar een (machine leesbare) overzicht van de termen binnen ZVG. Is die ook ergens? De definities op https://taxonomie.zorgeloosvastgoed.nl/ worden telkens per stuk via een API call opgehaald.

Voor de VCs zelf maken we nu bijvoorbeeld gebruik van de @context https://www.w3.org/2018/credentials/v1

kad-busses commented 1 year ago

Of, met andere woorden, hoe kan ik de ZVG LD termen gebruiken / is daar een Namespace voor? 😇

Bij de W3C standaard maken ze overigens gebruik van de JSON-LD Alternate Document Location. Zo kan de documentatie zowel voor mensen als machine gebruikt worden 😄. Een mooie plek daarvoor zou dan https://developer.zorgeloosvastgoed.nl/informatiemodel/ zijn, maar is dat nu niet.

kad-rowla commented 1 year ago

Ik denk dat je op zoek bent naar een gepubliceerde en/of queryable versie van het informatiemodel, toch? Het informatiemodel is hier beschikbaar: https://github.com/bp4mc2/bp4mc2-zvg/blob/master/informatiemodel/rdf/ontologie.ttl

Maar dit is inderdaad niet queryable en voor zover ik weet is er geen queryable versie. Ik kan het in de triplestore publiceren als een experimenteel model als dat je zou helpen(?). Als we eenmaal een demonstrator hebben, moeten we dit zeker vragen bij Arjen.

kad-busses commented 1 year ago

Thanks! Mooi overzicht, dat helpt zeker.

Publiceren hoeft wat mij betreft eerst niet, denk dat het voor de quest niet per se nodig is. Ik voeg nu verwijzingen toe als bijvoorbeeld http://kad.zorgeloosvastgoed.nl/id/concept/Eigendom voor Eigendom. Dan hebben we in elk geval al wel de link naar Zorgeloos Vastgoed 🙂

kad-busses commented 1 year ago

In de demo wordt nu een Eigendoms VC uitgegeven. Heb 'm nog iets uitgebreid, er zit nu ook pand informatie in, waar er eerst alleen perceelinformatie is. Dingen zoals adres zijn iets leesbaarder voor in de demo 😉 Zie ook: https://github.com/kadaster-labs/solid-quest-mock-overheid-server#brk---eigendomcredential

{
    "webID": "http://localhost:3001/verkoper-vera/profile/card#me",
    "eigendom": {
        "perceel": {
            "begrenzingPerceel": "",
            "kadastraleGrootte": "42",
            "identificatie": 10020263270000
        },
        "pand": {
            "adres": "Laan van Westenenk 701",
            "postcode": "7334 DP",
            "woonplaats": "Apeldoorn"
        }
    }
}
kad-busses commented 1 year ago

De exacte inhoud van de Eigendoms VC wordt ook besproken in https://github.com/kadaster-labs/solid-quest/issues/48