sysnet-sekm-model

Pydantic 2 domain models and Beanie/MongoDB persistence layer for SEKM — the Czech System of Evidence of Contaminated Sites (Systém Evidence Kontaminovaných Míst).

This library is the shared data layer for any service that reads or writes SEKM data from MongoDB. It has no dependency on Elasticsearch; migration tooling lives in the companion package sysnet-sekm-migrate.

Installation

pip install sysnet-sekm-model

Requirements

• Python ≥ 3.12
• MongoDB instance (no Elasticsearch required)
• .env file with MONGO_HOST, MONGO_PORT, MONGO_USERNAME, MONGO_PASSWORD, MONGO_DB

Quick start

from sysnet_sekm_model.config import MongoSettings
from sysnet_sekm_model.db import init_mongo, close_mongo
from sysnet_sekm_model.models.persistence import AreaSourceDoc

# Initialise Beanie (reads credentials from .env / environment variables)
settings = MongoSettings()
client = await init_mongo(settings.mongo_uri, settings.mongo_db)

# Query
doc = await AreaSourceDoc.find_one(AreaSourceDoc.sekm_id == "12345678")

# Shutdown
await close_mongo(client)

What's inside

Domain models (sysnet_sekm_model.models.domain)

Pydantic 2 models for all 21 SEKM entities — validation and business logic only, no MongoDB awareness:

Persistence models (sysnet_sekm_model.models.persistence)

Beanie documents backed by sysnet-docversion's VersionedDocument for entities that carry audit history. Each document stores:

• sekm_id — SEKM business key (unique index)
• current_version — version counter managed by sysnet-docversion
• migration_meta — provenance metadata (source ES index, migrated_at, batch ID)

MongoDB connection (sysnet_sekm_model.db)

from sysnet_sekm_model.db import init_mongo, close_mongo, ALL_DOCUMENT_MODELS

init_mongo(uri, db) initialises Beanie with all document models and creates indexes. Uses pymongo.AsyncMongoClient directly — Motor is not used.

Settings (sysnet_sekm_model.config)

from sysnet_sekm_model.config import MongoSettings

MongoSettings is a Pydantic BaseSettings subclass that reads MONGO_* variables from the environment or .env.

Documentation

License

AGPL-3.0