ippc-model 1.1.0

IPPC Data Model

IPPC Data Model

Verze: 1.1.0  |  Python: ≥ 3.10  |  Licence: GNU AGPL v3
Pydantic v2 datový model pro systém Integrovaného povolení a kontroly znečišťování
© SYSNET s.r.o. | GitHub

---

Co projekt řeší

IPPC Data Model je Python knihovna s kompletním datovým modelem pro informační systém Integrovaného povolení a kontroly znečišťování (IPPC) dle zákona č. 76/2002 Sb.

Pokrývá celý životní cyklus IPPC řízení – od žádosti o povolení přes kontroly a zprávy o plnění až po ukončení provozu nebo sloučení zařízení. Slouží jako sdílená datová vrstva pro aplikace komunikující s registrem IPPC.

Rychlý start

pip install ippc-model

from ippc_model import ContainerType, EquipmentType, IppcDocCodeEnum, MetadataType

# Vytvoření kontejneru řízení
container = ContainerType(
    name="Výroba obuvnických podešví (PUR-PLASTICS s.r.o.)",
    metadata=MetadataType(uuid="550e8400-e29b-41d4-a716-446655440000"),
)
print(container.metadata.uuid)  # → primární identifikátor

# Kódy dokumentů
print(IppcDocCodeEnum.REQUEST.value)   # → 'request'
print(IppcDocCodeEnum.DECISION.value)  # → 'decision'

Instalace pro vývoj

git clone https://github.com/SYSNET-CZ/models.git
cd models/ippc
python -m venv .venv
.venv\Scripts\activate            # Windows
pip install -r requirements.txt
pip install -e ".[dev]"           # pytest a dev závislosti

Spuštění testů

cd D:\development\git\models\ippc
.venv\Scripts\python.exe -m pytest tests/ -v

Závislosti

Balíček	Verze	Účel
pydantic	~2.11.7	Validace dat, typový systém
sysnet-pyutils	>=1.7.2	Sdílené utility a základní typy SYSNET

Dokumentace

Podrobná technická dokumentace je v adresáři docs/:

Soubor	Obsah
docs/architecture.md	Architektura, struktura balíčku, konvence
docs/modules.md	Referenční dokumentace všech modulů a tříd
docs/workflow.md	Stavy, přechody, životní cyklus řízení
docs/testing.md	Testování, pokrytí, spouštění testů

Přehled modulů

ippc_model/
├── __init__.py          # Veřejné API – všechny symboly dostupné přímo z balíčku
├── ippc_common.py       # Výčty, sdílené typy (PermittingType, …), pomocné funkce
├── ippc_activity.py     # Kategorie zařízení (příloha č. 1 zák. 76/2002 Sb.)
├── ippc_equipment.py    # Zařízení IPPC (EquipmentType, EquipmentMigration, …)
├── ippc_container.py    # Kontejnery dokumentů – jedno řízení (ContainerType, …)
├── ippc_document.py     # Dokumenty řízení (DocumentType, DocumentEntryType, …)
└── ippc_expert.py       # Odborně způsobilé osoby – OZO (ExpertType, …)

Konvence identifikátorů

Všechny hlavní datové objekty (ContainerType, EquipmentType, DocumentType, ActivityType, ExpertType) používají jako primární identifikátor:

obj.metadata.uuid   # str (UUID4)

Lehčí varianty (*TypeBase, *TypeListItem) používají metadata: Optional[MetadataTypeBase] se stejným polem uuid. Plné varianty (*Type) používají metadata: Optional[MetadataType] s rozšířenými metadaty (verze, tagy, auditní pole).

Changelog

Viz CHANGELOG.md. Aktuální verze 1.1.0 obsahuje opravy 10 bugů, kompletní testovací sadu (99 testů) a doplnění veřejného API balíčku.