Law Graph Documentation

This documentation is optimized for contributors working on download, ingest, storage, and delta pipelines.

Start Here

If you need answers quickly, start with these pages:

1. Who owns what?
   • Architecture Map
2. How do I extend safely?
   • Extension Playbooks
3. What is the real Normattiva behavior today?
   • Normattiva Pipeline

Contributor Path (10 minutes)

1. Read Extension Playbooks for setup and extension workflow.
2. Read Architecture Map.
3. Use the relevant section in Extension Playbooks.
4. Confirm operational limits in Normattiva Pipeline.

Core Principles

• SQL repositories own table-oriented primitives only.
• Stores own orchestration, policy, locking, and unit-of-work boundaries.
• Runtime code does not run migrations; migrations are external scripts.
• Makefile commands are the single supported local workflow.

Common Commands

make setup
make backend-test
make backend-check
make backend-docs-build