{"id":40122569,"url":"https://github.com/informatievlaanderen/municipality-registry","last_synced_at":"2026-03-13T11:04:38.413Z","repository":{"id":33969787,"uuid":"164437600","full_name":"Informatievlaanderen/municipality-registry","owner":"Informatievlaanderen","description":"Reference municipality registry.","archived":false,"fork":false,"pushed_at":"2026-01-14T00:04:56.000Z","size":6758,"stargazers_count":5,"open_issues_count":13,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-01-14T02:51:40.131Z","etag":null,"topics":["base-registries","base-registries-application","eupl"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages?q=MunicipalityRegistry","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Informatievlaanderen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-01-07T13:35:13.000Z","updated_at":"2026-01-06T15:52:04.000Z","dependencies_parsed_at":"2024-01-25T14:49:57.577Z","dependency_job_id":"be26585c-bde3-4be1-a0d3-083ef79a5c20","html_url":"https://github.com/Informatievlaanderen/municipality-registry","commit_stats":{"total_commits":824,"total_committers":19,"mean_commits":43.36842105263158,"dds":0.6905339805825244,"last_synced_commit":"5bc3c1821e419b3e71c802f1193c4221cc215286"},"previous_names":[],"tags_count":334,"template":false,"template_full_name":null,"purl":"pkg:github/Informatievlaanderen/municipality-registry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Informatievlaanderen%2Fmunicipality-registry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Informatievlaanderen%2Fmunicipality-registry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Informatievlaanderen%2Fmunicipality-registry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Informatievlaanderen%2Fmunicipality-registry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Informatievlaanderen","download_url":"https://codeload.github.com/Informatievlaanderen/municipality-registry/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Informatievlaanderen%2Fmunicipality-registry/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28568833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T12:50:50.164Z","status":"ssl_error","status_checked_at":"2026-01-19T12:50:42.704Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["base-registries","base-registries-application","eupl"],"created_at":"2026-01-19T13:00:51.274Z","updated_at":"2026-01-19T13:00:55.349Z","avatar_url":"https://github.com/Informatievlaanderen.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Municipality Registry [![Build Status](https://github.com/Informatievlaanderen/municipality-registry/workflows/Build/badge.svg)](https://github.com/Informatievlaanderen/municipality-registry/actions)\n\n## Goal\n\n\u003e Reference municipality registry.\n\n## Quick contributing guide\n\n* Fork and clone locally.\n* Build the solution with Visual Studio, `build.cmd` or `build.sh`.\n* Create a topic specific branch in git. Add a nice feature in the code. Do not forget to add tests and/or docs.\n* Run `build.cmd` or `build.sh` to make sure everything still compiles and all tests are still passing.\n* When built, you'll find the binaries in `./dist` which you can then test with locally, to ensure the bug or feature has been successfully implemented.\n* Send a Pull Request.\n\n### Getting started\n\n#### Initialisation\n\nTo fill up the database for the first time:\n\n* Run `MunicipalityRegistry.Api.Import` (`MunicipalityRegistry.sln`)\n\n#### Projections\n\nTo start the projections for the first time:\n\n* Run `MunicipalityRegistry.Projector` (`MunicipalityRegistry.sln`)\n* Send a `POST` to `http://localhost:2006/v1/projections/start/all`\n\n### Generating documentation\n\nWe use Structurizr to generate our documentation and populate our architecture decisions. All of this can be found in the [Structurizr](https://github.com/Informatievlaanderen/municipality-registry/tree/master/docs/MunicipalityRegistry.Structurizr) console application.\n\nTo run it, make sure you have an `appsettings.json` with a structurizr.com `WorkspaceId`, `ApiKey` and `ApiSecret`. If you have moved your [adr's](https://github.com/Informatievlaanderen/municipality-registry/tree/master/docs/adr) to another location, don't forget to update `AdrPath`.\n\nThis is how the generated documentation looks: https://structurizr.com/share/37794\n\n### Possible build targets\n\nOur `build.sh` script knows a few tricks. By default it runs with the `Test` target.\n\nThe buildserver passes in `CI_BUILD_NUMBER` as an integer to version the results and `BUILD_DOCKER_REGISTRY` to point to a Docker registry to push the resulting Docker images.\n\n#### NpmInstall\n\nRun an `npm install` to setup Commitizen and Semantic Release.\n\n#### DotNetCli\n\nChecks if the requested .NET Core SDK and runtime version defined in `global.json` are available.\nWe are pedantic about these being the exact versions to have identical builds everywhere.\n\n#### Clean\n\nMake sure we have a clean build directory to start with.\n\n#### Restore\n\nRestore dependencies for `debian.8-x64` and `win10-x64` using dotnet restore and Paket.\n\n#### Build\n\nBuilds the solution in Release mode with the .NET Core SDK and runtime specified in `global.json`\nIt builds it platform-neutral, `debian.8-x64` and `win10-x64` version.\n\n#### Test\n\nRuns `dotnet test` against the test projects.\n\n#### Publish\n\nRuns a `dotnet publish` for the `debian.8-x64` and `win10-x64` version as a self-contained application.\nIt does this using the Release configuration.\n\n#### Pack\n\nPacks the solution using Paket in Release mode and places the result in the `dist` folder.\nThis is usually used to build documentation NuGet packages.\n\n#### Containerize\n\nExecutes a `docker build` to package the application as a docker image. It does not use a Docker cache.\nThe result is tagged as latest and with the current version number.\n\n#### DockerLogin\n\nExecutes `ci-docker-login.sh`, which does an aws ecr login to login to Amazon Elastic Container Registry.\nThis uses the local aws settings, make sure they are working!\n\n#### Push\n\nExecutes `docker push` to push the built images to the registry.\n\n## License\n\n[European Union Public Licence (EUPL)](https://joinup.ec.europa.eu/news/understanding-eupl-v12)\n\nThe new version 1.2 of the European Union Public Licence (EUPL) is published in the 23 EU languages in the EU Official Journal: [Commission Implementing Decision (EU) 2017/863 of 18 May 2017 updating the open source software licence EUPL to further facilitate the sharing and reuse of software developed by public administrations](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv:OJ.L_.2017.128.01.0059.01.ENG\u0026toc=OJ:L:2017:128:FULL) ([OJ 19/05/2017 L128 p. 59–64](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv:OJ.L_.2017.128.01.0059.01.ENG\u0026toc=OJ:L:2017:128:FULL)).\n\n## Credits\n\n### Languages \u0026 Frameworks\n\n* [.NET Core](https://github.com/Microsoft/dotnet/blob/master/LICENSE) - [MIT](https://choosealicense.com/licenses/mit/)\n* [.NET Core Runtime](https://github.com/dotnet/coreclr/blob/master/LICENSE.TXT) - _CoreCLR is the runtime for .NET Core. It includes the garbage collector, JIT compiler, primitive data types and low-level classes._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [.NET Core APIs](https://github.com/dotnet/corefx/blob/master/LICENSE.TXT) - _CoreFX is the foundational class libraries for .NET Core. It includes types for collections, file systems, console, JSON, XML, async and many others._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [.NET Core SDK](https://github.com/dotnet/sdk/blob/master/LICENSE.TXT) - _Core functionality needed to create .NET Core projects, that is shared between Visual Studio and CLI._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [.NET Core Docker](https://github.com/dotnet/dotnet-docker/blob/master/LICENSE) - _Base Docker images for working with .NET Core and the .NET Core Tools._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [.NET Standard definition](https://github.com/dotnet/standard/blob/master/LICENSE.TXT) - _The principles and definition of the .NET Standard._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Entity Framework Core](https://github.com/aspnet/EntityFrameworkCore/blob/master/LICENSE.txt) - _Entity Framework Core is a lightweight and extensible version of the popular Entity Framework data access technology._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [Roslyn and C#](https://github.com/dotnet/roslyn/blob/master/License.txt) - _The Roslyn .NET compiler provides C# and Visual Basic languages with rich code analysis APIs._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [F#](https://github.com/fsharp/fsharp/blob/master/LICENSE) - _The F# Compiler, Core Library \u0026 Tools_ - [MIT](https://choosealicense.com/licenses/mit/)\n* [F# and .NET Core](https://github.com/dotnet/netcorecli-fsc/blob/master/LICENSE) - _F# and .NET Core SDK working together._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [ASP.NET Core framework](https://github.com/aspnet/AspNetCore/blob/master/LICENSE.txt) - _ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n\n### Libraries\n\n* [Paket](https://fsprojects.github.io/Paket/license.html) - _A dependency manager for .NET with support for NuGet packages and Git repositories._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [FAKE](https://github.com/fsharp/FAKE/blob/release/next/License.txt) - _\"FAKE - F# Make\" is a cross platform build automation system._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Structurizr](https://github.com/structurizr/dotnet/blob/master/LICENSE) - _Visualise, document and explore your software architecture._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [xUnit](https://github.com/xunit/xunit/blob/master/license.txt) - _xUnit.net is a free, open source, community-focused unit testing tool for the .NET Framework._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [Autofac](https://github.com/autofac/Autofac/blob/develop/LICENSE) - _An addictive .NET IoC container._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [AutoFixture](https://github.com/AutoFixture/AutoFixture/blob/master/LICENCE.txt) - _AutoFixture is an open source library for .NET designed to minimize the 'Arrange' phase of your unit tests in order to maximize maintainability._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [FluentAssertions](https://github.com/fluentassertions/fluentassertions/blob/master/LICENSE) - _Fluent API for asserting the results of unit tests._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [.NET Topology Suite](https://github.com/NetTopologySuite/NetTopologySuite/blob/develop/License.md) - _A .NET GIS solution that is fast and reliable for the .NET platform._ - [BSD](https://choosealicense.com/licenses/bsd-3-clause/)\n* [Serilog](https://github.com/serilog/serilog/blob/dev/LICENSE) - _Simple .NET logging with fully-structured events._ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n* [CloudEvents](https://github.com/cloudevents/sdk-csharp) - _CSharp SDK for CloudEvents_ - [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n\n### Tooling\n\n* [npm](https://github.com/npm/cli/blob/latest/LICENSE) - _A package manager for JavaScript._ - [Artistic License 2.0](https://choosealicense.com/licenses/artistic-2.0/)\n* [semantic-release](https://github.com/semantic-release/semantic-release/blob/master/LICENSE) - _Fully automated version management and package publishing._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/changelog](https://github.com/semantic-release/changelog/blob/master/LICENSE) - _Semantic-release plugin to create or update a changelog file._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/commit-analyzer](https://github.com/semantic-release/commit-analyzer/blob/master/LICENSE) - _Semantic-release plugin to analyze commits with conventional-changelog._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/exec](https://github.com/semantic-release/exec/blob/master/LICENSE) - _Semantic-release plugin to execute custom shell commands._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/git](https://github.com/semantic-release/git/blob/master/LICENSE) - _Semantic-release plugin to commit release assets to the project's git repository._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/npm](https://github.com/semantic-release/npm/blob/master/LICENSE) - _Semantic-release plugin to publish a npm package._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/github](https://github.com/semantic-release/github/blob/master/LICENSE) - _Semantic-release plugin to publish a GitHub release._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [semantic-release/release-notes-generator](https://github.com/semantic-release/release-notes-generator/blob/master/LICENSE) - _Semantic-release plugin to generate changelog content with conventional-changelog._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [commitlint](https://github.com/marionebl/commitlint/blob/master/license.md) - _Lint commit messages._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [commitizen/cz-cli](https://github.com/commitizen/cz-cli/blob/master/LICENSE) - _The commitizen command line utility._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [commitizen/cz-conventional-changelog](https://github.com/commitizen/cz-conventional-changelog/blob/master/LICENSE) _A commitizen adapter for the angular preset of conventional-changelog._ - [MIT](https://choosealicense.com/licenses/mit/)\n\n### Flemish Government Frameworks\n\n* [Be.Vlaanderen.Basisregisters.AggregateSource](https://github.com/informatievlaanderen/command-handling/blob/master/LICENSE) - _Lightweight infrastructure for doing command handling and eventsourcing using aggregates._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.Api](https://github.com/Informatievlaanderen/api/blob/master/LICENSE) - _Common API infrastructure and helpers._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.CommandHandling](https://github.com/informatievlaanderen/command-handling/blob/master/LICENSE) - _Lightweight infrastructure for doing command handling and eventsourcing using aggregates._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.EventHandling](https://github.com/Informatievlaanderen/event-handling/blob/master/LICENSE) - _Lightweight event handling infrastructure._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.ProjectionHandling](https://github.com/Informatievlaanderen/projection-handling/blob/master/LICENSE) - _Lightweight projection handling infrastructure._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.Projector](https://github.com/Informatievlaanderen/projector) - _Generic projection runner infrastructure._ - [MIT](https://choosealicense.com/licenses/mit/)\n\n### Flemish Government Libraries\n\n* [Be.Vlaanderen.Basisregisters.Build.Pipeline](https://github.com/informatievlaanderen/build-pipeline/blob/master/LICENSE) - _Contains generic files for all Basisregisters Vlaanderen pipelines._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.Testing.Infrastructure.Events](https://github.com/informatievlaanderen/infrastructure-tests/blob/master/LICENSE) - _Infrastructure unit-tests to validate assemblies._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.DataDog](https://github.com/Informatievlaanderen/datadog-tracing/blob/master/LICENSE) - _A C# Implementation of Data Dog Tracing._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.Shaperon](https://github.com/Informatievlaanderen/shaperon/blob/master/LICENSE) - _Lightweight dbase and shape record handling._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.Crab](https://github.com/Informatievlaanderen/crab/blob/master/LICENSE) - _Common Crab functionality._ - [EUPL-1.2](https://choosealicense.com/licenses/eupl-1.2/)\n* [Be.Vlaanderen.Basisregisters.GrAr](https://github.com/Informatievlaanderen/grar-common/blob/master/LICENSE) - _Common code for all GR/AR base registries._ - [EUPL-1.2](https://choosealicense.com/licenses/eupl-1.2/)\n* [Be.Vlaanderen.Basisregisters.Aws.DistributedMutex](https://github.com/Informatievlaanderen/aws-distributed-mutex) - _A distributed lock (mutex) implementation for AWS using DynamoDB._ - [MIT](https://choosealicense.com/licenses/mit/)\n* [Be.Vlaanderen.Basisregisters.MessageHandling.Kafka.Producer](https://github.com/Informatievlaanderen/message-handling/) - _Lightweight message handling infrastructure._ - [MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finformatievlaanderen%2Fmunicipality-registry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finformatievlaanderen%2Fmunicipality-registry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finformatievlaanderen%2Fmunicipality-registry/lists"}