proc.checkdewet.nl User Guide

Documentation and links for the Lawbook Importer tools.

Upload / Import Dashboard

Open Interface

The primary interface for ingesting new law texts into the system. Supports multiple ingestion methods:

  • KOOP API (BWBR ID): Fetch the latest XML data for a specific legal text directly from the government API.
  • XML URL: Provide a direct link to an official `data.xml` or manifest file.
  • Manual Text Upload: Upload legacy `.txt` files to be parsed dynamically.

Note: All new imports initially populate the active Database Collection, which can be configured via the DB Manager.

Database Manager

Open Interface

Manage the lifecycle of imported lawbooks across staging and production environments.

  • Target DB Selection: Choose whether imports should go to `dev_lawbooks` (Sandbox), `check_lawbooks` (Staging), or `lawbooks` (Testing).
  • Promote & Demote: Move approved collections from the Testing environment into the Production (`books`) collection safely in batches.
  • KOOP Debug Import: A specialized pipeline for importing specific BWBR IDs with real-time logs generated and stored for troubleshooting.

Important: The books collection is the live Production collection served to end-users.

Visual Diff Tool

Open Interface

A structural comparison tool to analyze changes across different database environments before promoting a book.

  • Hierarchical View: Highlights added, removed, or changed articles based on their titles and metadata.
  • Side-by-Side Comparison: Compare `dev_lawbooks` against Production `books` to identify exactly what has changed in an update.
  • Lazy Loading: Full text (`inhoud`) is loaded on demand to conserve bandwidth and prevent memory issues on large books.

Technical Documentation

For a deep dive into the system architecture, AI parsing integration, and Firestore database schemas, please refer to the main design document.

Checkdewet Import Bot Technical Design Document

Stored locally at Checkdewet_import_bot_Technical_Design_Document.md and docs/technical_design.md in the repository root.