{"id":20065389,"url":"https://github.com/nens/brostar-api","last_synced_at":"2025-08-30T15:06:06.228Z","repository":{"id":222137388,"uuid":"751919650","full_name":"nens/brostar-api","owner":"nens","description":"BROSTAR vereenvoudigd het aanleveren van gegevens aan de Basis Registratie Ondergrond (BRO)","archived":false,"fork":false,"pushed_at":"2025-07-25T12:45:54.000Z","size":4123,"stargazers_count":3,"open_issues_count":9,"forks_count":1,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-07-25T19:25:59.647Z","etag":null,"topics":["adviseursite","basisregistratieondergrond","bro","grondwater"],"latest_commit_sha":null,"homepage":"https://www.brostar.nl","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nens.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-02T16:06:08.000Z","updated_at":"2025-07-25T12:45:58.000Z","dependencies_parsed_at":"2024-05-14T07:54:17.457Z","dependency_job_id":"94844d2f-5873-4a79-a8d6-355fd3757426","html_url":"https://github.com/nens/brostar-api","commit_stats":null,"previous_names":["jjflorian/brohub"],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/nens/brostar-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nens%2Fbrostar-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nens%2Fbrostar-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nens%2Fbrostar-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nens%2Fbrostar-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nens","download_url":"https://codeload.github.com/nens/brostar-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nens%2Fbrostar-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272864671,"owners_count":25006044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["adviseursite","basisregistratieondergrond","bro","grondwater"],"created_at":"2024-11-13T13:49:57.522Z","updated_at":"2025-08-30T15:06:06.223Z","avatar_url":"https://github.com/nens.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BROSTAR API\n\nAanleveren aan de Basis Registratie Ondergrond is niet altijd even makkelijk. Om het lever proces te vereenvoudigen, en zodat het wiel niet iedere keer opnieuw hoeft uitgevonden te worden. Op https://www.brostar.nl vind je de SaaS, met product informatie. Deze front-end geeft doormiddel van formulieren de mogelijkheid om zonder programmeer ervaring toch wijzigingen te doen in de BRO.\n\n\n## Introduction\n\nBROSTAR is a data management product for the Dutch *Basis Registratie Ondergrond* (BRO). The code for the backend is stored in this repository. It consists of an API for importing, storing, and delivering data. The backend is open source, and can be self-hosted. The frontend is developed and hosted by Nelen \u0026 Schuurmans. This is a web application created on top of the API, making the data management of BRO data very accessible. Interested? Contact [info@nelen-schuurmans.nl](mailto:info@nelen-schuurmans.nl).\n\n\n## Project description\n\nThe backend consists of an API with:\n\n- An import task endpoint. This can import all current data from a BRO domain based on a KvK and project number.\n\n- An upload task endpoint. This can send data to the BRO, with a JSON input of all relevant data. The API handles the transformation to XML format and the message traffic to and from the BRO.\n\n- Endpoints for all assets imported from the BRO.\n\n## Backend development instructions\n\nTo install for development:\n\n    $ docker compose build\n    $ docker compose pull\n    $ pip install pre-commit  # Just needed once for your laptop.\n    $ pre-commit install # Just needed once to make sure that pre-commit runs on each commit for this project\n\nThe development setup includes a postgres database and redis.\n\nSome instructions:\n\n    $ docker compose up  # Starts the site on localhost:8000\n    $ docker compose run --rm web pytest\n    $ docker compose run --rm web python manage.py migrate\n    $ pre-commit run --all  # runs the formatter, checks, etc.\n\nDo the regular django \"migrate\", \"createsuperuser\" stuff.\n\n7) Create an organization, fill in the KvK, and optionally fill in authentication details.\n\n8) Create a user profile for the superuser.\n\nIf a requirement has changed (either dependency in `pyproject.toml` or an extra development package in `requirements.in`:\n\n    $ docker compose run --rm web pip-compile --extra=test \\\n      --output-file=requirements.txt dev-requirements.in pyproject.toml\n    $ docker compose run ...same command... --upgrade  # to grab new versions\n\n\n## Internal N\u0026S server installation notes\n\nThis is a public project, so the actual server deployment scripts with the passwords and so are safely hidden away in https://github.com/nens/brostar-site :-) We're installed with docker compose on https://staging.brostar.nl and https://www.brostar.nl . See the readme of `brostar-site` for the internal deployment documentation.\n\nMake releases with \"zest.releaser\" (`pip install zest.releaser` to install it). \"fullrelease\" updates the release date, does a `git tag` and updates the version number.\n\n    $ fullrelease\n\n\n## Build the documentation\n\nWe use mkdocs for documenting BROSTAR. To build the docs locally:\n\n    $ cd docs\n    $ python3 -m venv .venv\n    $ .venv/bin/pip install -r requirements.txt\n    $ mkdocs serve\n\nThe docs are then available on http://127.0.0.1:8000/`.\n\nGithub automatically builds the docs from `main` branch and uploads them to\nhttps://docs.brostar.nl/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnens%2Fbrostar-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnens%2Fbrostar-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnens%2Fbrostar-api/lists"}