# kadaster/klic-win architecture

> Architecture diagram of the GitHub repository kadaster/klic-win, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kadaster/klic-win
- Repository: https://github.com/kadaster/klic-win

## Overview

This repository is a documentation portal for KLIC technical interfaces and standards, not the KLIC runtime itself. Its README organizes guidance on requesting and receiving area information, updating network data, exchanging administrator information, API access, and IMKL standards. A concrete user-to-result workflow is shown by the OAuth example: obtain or refresh a token, persist it, then call a KLIC API. Other documented capabilities are included as separate branches; their internal runtime relationships are not inferred from directory names.

Main entry points: [`README.md`](https://github.com/kadaster/klic-win/blob/master/README.md) (Technical documentation), [`API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs) (OAuth example client), [`API management/README.md`](https://github.com/kadaster/klic-win/blob/master/API%20management/README.md) (API management), [`API management/Voorbeelden/KlicOauthExample/KlicOauthExample/LocalServerCodeReceiver.cs`](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/LocalServerCodeReceiver.cs) (Browser code receiver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Documentation portal"]
  node_rootreadme["Technical documentation<br/>[README.md]"]
end

subgraph group_access["API access"]
  node_api_docs["API management<br/>[README.md]"]
  node_oauth_program["OAuth example client<br/>[Program.cs]"]
  node_oauth_receiver["Browser code receiver"]
  node_token_state["Token state<br/>[TokenCollection.cs]"]
  node_token_response["Token response model"]
  node_token_store["Token file storage<br/>[TokenRepository.cs]"]
  node_jwt_example["JWT credentials example<br/>[JWTGenerator.java]"]
end

subgraph group_exchange["Information exchange"]
  node_request_docs["Area information requests<br/>[README.md]"]
  node_delivery_docs["Area information delivery"]
  node_provider_updates["Network data updates<br/>[README.md]"]
  node_bmkl_docs["Administrator information exchange<br/>[README.md]"]
  node_sync_docs["Regulator synchronization<br/>[README.md]"]
end

subgraph group_standards["Standards and support"]
  node_imkl_docs["IMKL application guidance<br/>[README.md]"]
  node_standard_management["KLIC standards management<br/>[README.md]"]
  node_viewer_docs["KLIC viewer guidance<br/>[README.md]"]
  node_test_docs["External test environment<br/>[README.md]"]
end

node_user(("KLIC integrator"))

node_user -->|"consults"| node_rootreadme
node_rootreadme -->|"indexes"| node_api_docs
node_rootreadme -->|"indexes"| node_request_docs
node_rootreadme -->|"indexes"| node_delivery_docs
node_rootreadme -->|"indexes"| node_provider_updates
node_rootreadme -->|"indexes"| node_bmkl_docs
node_rootreadme -->|"indexes"| node_sync_docs
node_rootreadme -->|"indexes"| node_imkl_docs
node_rootreadme -->|"indexes"| node_standard_management
node_rootreadme -->|"indexes"| node_viewer_docs
node_api_docs -.->|"documents testing"| node_test_docs
node_oauth_program -->|"receives code"| node_oauth_receiver
node_oauth_program -->|"uses state"| node_token_state
node_oauth_program -->|"deserializes response"| node_token_response
node_oauth_program -->|"loads and saves"| node_token_store
node_oauth_program -->|"prints result"| node_user
node_oauth_program -->|"requests authorization"| node_user

click node_rootreadme "https://github.com/kadaster/klic-win/blob/master/README.md"
click node_api_docs "https://github.com/kadaster/klic-win/blob/master/API%20management/README.md"
click node_oauth_program "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs"
click node_oauth_receiver "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/LocalServerCodeReceiver.cs"
click node_token_state "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenCollection.cs"
click node_token_response "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/RequestTokenResponse.cs"
click node_token_store "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenRepository.cs"
click node_jwt_example "https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauth_CC_JWT_Example/src/main/java/nl/kadaster/jwt/gen/JWTGenerator.java"
click node_request_docs "https://github.com/kadaster/klic-win/blob/master/Aanvragen%20gebiedsinformatie/README.md"
click node_delivery_docs "https://github.com/kadaster/klic-win/tree/master/Uitleveren"
click node_provider_updates "https://github.com/kadaster/klic-win/blob/master/Actualiseren/README.md"
click node_bmkl_docs "https://github.com/kadaster/klic-win/blob/master/BMKL/README.md"
click node_sync_docs "https://github.com/kadaster/klic-win/blob/master/Synchroniseren%20(Rijksinspectie%20Digitale%20Infrastructuur)/README.md"
click node_imkl_docs "https://github.com/kadaster/klic-win/blob/master/Toepassing%20IMKL/README.md"
click node_standard_management "https://github.com/kadaster/klic-win/blob/master/Beheren%20standaarden%20KLIC/README.md"
click node_viewer_docs "https://github.com/kadaster/klic-win/blob/master/Kadaster%20KLIC-viewer/README.md"
click node_test_docs "https://github.com/kadaster/klic-win/blob/master/Externe%20Test%20Omgeving%20(ETO)/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_rootreadme toneBlue
class node_api_docs,node_oauth_program,node_oauth_receiver,node_token_state,node_token_response,node_token_store,node_jwt_example toneAmber
class node_request_docs,node_delivery_docs,node_provider_updates,node_bmkl_docs,node_sync_docs toneMint
class node_imkl_docs,node_standard_management,node_viewer_docs,node_test_docs toneRose
class node_user toneIndigo
```

## Components

### Documentation portal

- [Technical documentation](https://github.com/kadaster/klic-win/blob/master/README.md): `README.md`

### API access

- [API management](https://github.com/kadaster/klic-win/blob/master/API%20management/README.md): `API management/README.md`
- [OAuth example client](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs): `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`
- [Browser code receiver](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/LocalServerCodeReceiver.cs): `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/LocalServerCodeReceiver.cs`
- [Token state](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenCollection.cs): `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenCollection.cs`
- [Token response model](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/RequestTokenResponse.cs): `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/RequestTokenResponse.cs`
- [Token file storage](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenRepository.cs): `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/TokenRepository.cs`
- [JWT credentials example](https://github.com/kadaster/klic-win/blob/master/API%20management/Voorbeelden/KlicOauth_CC_JWT_Example/src/main/java/nl/kadaster/jwt/gen/JWTGenerator.java): `API management/Voorbeelden/KlicOauth_CC_JWT_Example/src/main/java/nl/kadaster/jwt/gen/JWTGenerator.java`

### Information exchange

- [Area information requests](https://github.com/kadaster/klic-win/blob/master/Aanvragen%20gebiedsinformatie/README.md): `Aanvragen gebiedsinformatie/README.md`
- [Area information delivery](https://github.com/kadaster/klic-win/tree/master/Uitleveren): `Uitleveren`
- [Network data updates](https://github.com/kadaster/klic-win/blob/master/Actualiseren/README.md): `Actualiseren/README.md`
- [Administrator information exchange](https://github.com/kadaster/klic-win/blob/master/BMKL/README.md): `BMKL/README.md`
- [Regulator synchronization](https://github.com/kadaster/klic-win/blob/master/Synchroniseren%20(Rijksinspectie%20Digitale%20Infrastructuur)/README.md): `Synchroniseren (Rijksinspectie Digitale Infrastructuur)/README.md`

### Standards and support

- [IMKL application guidance](https://github.com/kadaster/klic-win/blob/master/Toepassing%20IMKL/README.md): `Toepassing IMKL/README.md`
- [KLIC standards management](https://github.com/kadaster/klic-win/blob/master/Beheren%20standaarden%20KLIC/README.md): `Beheren standaarden KLIC/README.md`
- [KLIC viewer guidance](https://github.com/kadaster/klic-win/blob/master/Kadaster%20KLIC-viewer/README.md): `Kadaster KLIC-viewer/README.md`
- [External test environment](https://github.com/kadaster/klic-win/blob/master/Externe%20Test%20Omgeving%20(ETO)/README.md): `Externe Test Omgeving (ETO)/README.md`

### Other components

- **KLIC integrator**

## Connections

- KLIC integrator → Technical documentation: consults (evidence: `README.md`)
- Technical documentation → API management: indexes (evidence: `README.md`)
- Technical documentation → Area information requests: indexes (evidence: `README.md`)
- Technical documentation → Area information delivery: indexes (evidence: `README.md`)
- Technical documentation → Network data updates: indexes (evidence: `README.md`)
- Technical documentation → Administrator information exchange: indexes (evidence: `README.md`)
- Technical documentation → Regulator synchronization: indexes (evidence: `README.md`)
- Technical documentation → IMKL application guidance: indexes (evidence: `README.md`)
- Technical documentation → KLIC standards management: indexes (evidence: `README.md`)
- Technical documentation → KLIC viewer guidance: indexes (evidence: `README.md`)
- API management → External test environment: documents testing
- OAuth example client → Browser code receiver: receives code (evidence: `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`)
- OAuth example client → Token state: uses state (evidence: `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`)
- OAuth example client → Token response model: deserializes response (evidence: `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`)
- OAuth example client → Token file storage: loads and saves (evidence: `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`)
- OAuth example client → KLIC integrator: prints result (evidence: `API management/Voorbeelden/KlicOauthExample/KlicOauthExample/Program.cs`)
- OAuth example client → KLIC integrator: requests authorization
