How sayatyuss/sud works
Sud Parser collects court cases and documents from office.sud.kz, stores them for monitoring, and exposes a web interface for configuration and results. The main run path is web-triggered or direct: main.py orchestrates src/parser.py, which authenticates, searches and downloads documents, then persists case data. The separate PDF library extracts and cleans text into deduplicated JSONL records. The README confirms web access, PostgreSQL configuration, and an optional Telegram integration. Some links are omitted where sampled source does not show the runtime wiring.
Main entry points: parser.py Court parser · main.py Run coordinator · app.py Web interface · extractor.py PDF extraction
Components 20
Collection runtime
- Run coordinator
main.py - Court parser
src/parser.py - Browser automation
src/browser.py
Data processing
- Persistence layer
src/database.py - PostgreSQL
- PDF extraction
pdf-parser-lib/pdf_parser_lib/extractor.py - Text cleaning
pdf-parser-lib/pdf_parser_lib/cleaning.py - Record builder
pdf-parser-lib/pdf_parser_lib/models.py - Decision mapping
pdf-parser-lib/pdf_parser_lib/decision_mapping.py - JSONL writer
pdf-parser-lib/pdf_parser_lib/writer.py
Web operations
- Web interface
src/web/app.py - Web services
src/web/services.py
Shared services
- Case types
src/case_types.py - Case models
src/models.py - Configuration
src/config.py - Stop control
src/parser_stop.py - Telegram notifier
src/telegram_notifier.py
Other components
- Operator
- Court portal
- Telegram
Connections 20
- Operator → Web interface: operates
README.md - Web interface → Run coordinator: launches
src/web/app.py - Run coordinator → Court parser: runs
main.py - Court parser → Court portal: searches and downloads
src/parser.py - Court parser → Case types: resolves types
src/parser.py - Court parser → Persistence layer: persists cases
src/parser.py - Persistence layer → PostgreSQL: reads and writes
src/database.py - Persistence layer → Case models: uses records
src/database.py - Run coordinator → Configuration: loads settings
main.py - Court parser → Configuration: loads settings
src/parser.py - Web interface → Persistence layer: queries results
src/web/app.py - Web interface → Stop control: requests stop
src/web/app.py - Run coordinator → Stop control: checks stop
main.py - Court parser → PDF extraction: processes documents
src/parser.py - PDF extraction → Text cleaning: cleans text
pdf-parser-lib/pdf_parser_lib/extractor.py - PDF extraction → Record builder: builds records
pdf-parser-lib/pdf_parser_lib/extractor.py - PDF extraction → JSONL writer: writes records
- Run coordinator → Telegram notifier: notifies
main.py - Telegram notifier → Telegram: sends updates
- Web interface → Configuration: manages settings
src/web/app.py