SofiaPlan: Data Validator

Проектът представлява инструмент за изтегляне, валидиране и отчетност на публични GeoJSON/JSON данни от SofiaPlan Open Data API.

Какво прави проектът

• Изтегля данните от SofiaPlan Open Data API.
• Валидира общата GeoJSON структура.
• Прилага специфични профили за валидация.
• Генерира текстови и HTML отчети.
• Опционално: записва резултатите в PostgreSQL.

Архитектура накратко

SofiaPlan API → raw JSON/GeoJSON → generic validation → profile validation → text/HTML reports → PostgreSQL normalized records → SQL integrity checks

Налични профили за валидация към момента

• ЖП гари и спирки в СО и тяхното натоварване dataset: 602

• Достъпност до метро datasets: 11, 18, 152, 227, 282, 289, 298, 373, 437

Изисквания

• Python 3.12+
• uv Python package
• (Опция) PostgreSQL/Docker

Бърз старт с Git

git clone https://github.com/asentish-dev/sofiaplan-data-validator
cd sofiaplan-data-validator
uv sync
uv run sp-valid --help

Подробна документация

• User Guide
• Architecture