🏛️ Страж Демократії

Моніторинг законів Верховної Ради України IX скликання · ІЕД депутатів · рівень євроінтеграції · детектор синхронних інфоатак

🌐 Дашборд • 🤖 Telegram-бот • GitHub

Що це робить

Страж Демократії автоматично збирає всі законопроєкти ВРУ (15,000+), аналізує їх на ризики за допомогою ШІ, рахує Індекс ефективної діяльності (ІЕД) депутатів, відстежує рівень євроінтеграції України та виявляє скоординовані інформаційні атаки в telegram-каналах — і одразу повідомляє про них у Telegram.

Можливості

Компонент	Опис
🔄 Синхронізація	15,000+ законопроєктів з RADA API: статуси, хронологія, документи, автори, голосування (19,600+)
🧠 LLM-аналіз	Двоетапний Chain-of-Thought аналіз ризиків (процедурний/непроцедурний → ризики), українською, з пост-перевірками
📊 ІЕД депутатів	6 рівних категорій (C1–C6) з опублікованою методологією v2.1 — жодних прихованих ваг
🇪🇺 Євроінтеграція	Гіпотетичний індекс 0–100: переговорний трек (статуси кластерів, авто-детекція відкриттів з RSS ЄК) + гармонізація законодавства
🛡 Детектор інфоатак	Кластеризація постів ~20 деструктивних каналів (список СБУ) + фактчекерів; бьорст-детекція синхронних хвиль → пуш з посиланням на спростування
📱 Telegram	Бот з командами (/bill, /dep, /top, /eu, /attacks, /fakes), персональні підписки на атаки та дайджести, щоденні зведення
📅 Графік	Календар усіх активностей ВРУ: пленарні, комітети, голосування, свята, події ЄС

Архітектура

┌────────────────────── VPS (Python + Node) ──────────────────────┐
│                                                                 │
│  СИНХРОНІЗАЦІЯ (17 systemd timers)                              │
│    sync_bills / sync_bill_passings_html → bills, passings       │
│    sync_votes_bulk → votes, mp_votes (7.5M)                     │
│    sync_mp_factions/stats → mps (460 депутатів)                 │
│    sync_schedule_legacy / sync_committee_schedule → графік      │
│    sync_eu_tracker → статуси кластерів ЄС (авто з RSS ЄК)       │
│    sync_info_monitor → інфопотік (RSS фактчекерів + t.me/s)     │
│    sync_disinfo_channels → щоденне оновлення списку каналів     │
│                                                                 │
│  АНАЛІЗ                                                         │
│    night_batch (21:00–08:00, 3 воркери) → LLM ризики            │
│    calc_kpi_v12 → ІЕД · calc_harmonization → EU index           │
│    detect_attacks (кожні 30 хв) → бьорст-детектор + TG-пуш      │
│    label_narratives (07:15) → LLM-розмітка нарративів дня       │
│                                                                 │
│  API: Express (порт 8788) ── Cloudflare Tunnel ──► api.dino.pp.ua│
└──────────────────────────────┬──────────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│  PostgreSQL 18.4 (192.168.1.244/radacleaner)                    │
│    bills · risk_assessments · mps · mp_votes · eu_cluster_status│
│    info_items · attack_alerts · bot_subscribers · rada_schedule │
└──────────────────────────────┬──────────────────────────────────┘
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│  CLOUDFLARE PAGES — дашборд (Vanilla JS SPA)                    │
│    Дашборд · Закони · Депутати · Графік · EU Alignment ·        │
│    🛡 Інфоатаки · 🤖 Бот                                        │
└─────────────────────────────────────────────────────────────────┘

Стек технологій

Шар	Технологія
Бекенд	Python 3 (syncs/аналіз) + Express/Node.js (API)
База	PostgreSQL 18.4
Фронтенд	Vanilla HTML/CSS/JS (Cloudflare Pages)
LLM	`nvidia/nemotron-3-super-120b-a12b:free` через OpenRouter (+ NVIDIA, Gemini fallback)
Сповіщення	Telegram Bot API
Тести	pytest, 80 тестів (`venv/bin/python -m pytest tests/ -q`)

ІЕД — Індекс ефективної діяльності (v12)

6 рівних категорій, без ваг: ІЕД = (C1+C2+C3+C4+C5+C6) / 6 × 100

#	Категорія	Джерело
C1	Дисципліна (явка, голосування, дисципліна фракції)	mp_votes
C2	Законотворчість (якість, ризик, документи, авторство)	risk_assessments
C3	Результативність (прийняття своїх законів)	bill_sponsors
C4	Комітет (публічна монотонна шкала ролей 40–100)	committee_members
C5	Звернення (депутатські запити + відповіді)	itd.rada.gov.ua
C6	Вплив (низький ризик + євроінтеграційний слід)	risk_assessments + EU

Методологія v2.1 повністю опублікована на дашборді (футер кожної сторінки) — разом із дослівним промптом ШІ-аналізу. При зміні формул — bump версії.

🇪🇺 EU Integration Index v1 (гіпотетичний)

INDEX = 0.5 × Перемовини + 0.5 × Гармонізація
Перемовини  = статуси 6 кластерів (не відкритий=0, відкритий=50, закритий=100)
              — авто-детекція відкриттів з RSS Єврокомісії
Гармонізація = частка прийнятих законів серед EU-релевантних

Станом на серпень 2026: 23.9% (відкриті кластери 1 «Основи» 15.06.2026 та 6 «Зовнішні відносини» 14.07.2026). Методологія опублікована на дашборді.

🛡 Детектор синхронних інфоатак

Ключова фішка проєкту: швидкість — хвилини замість денного циклу фактчекерів.

Збір (кожні 30 хв): 5 RSS фактчекерів (ЦПД, VoxCheck, StopFake, Детектор медіа, SPRAVDI) + ~20 каналів зі списку СБУ через публічний t.me/s (MTProto не використовуємо — ToS Telegram)
Кластеризація: simhash + token-Jaccard (union-find, чистий Python)
Бьорст-правило: ≥4 різних TG-каналів, ≥8 постів, вікно ≤24 год → алерт
Пуш: наратив + масштаб + приклад + посилання на спростування фактчекерів + номер закону з нашої БД. Дисклеймер: вердикт — за фактчекерами
Щодня 07:15: LLM-розмітка нарративів дня + ТОП перевірок → вкладка «🛡 Інфоатаки»

Список каналів оновлюється щодня автоматично (джерело СБУ через 5.ua, резолвинг нових каналів через власний SearXNG, prune мертвих).

Структура проєкту (ключове)

radacleaner/
├── src/                        # llm_client, d1_client, prompts, telegram_notifier
├── worker/api-server.js        # Express API (порт 8788, PostgreSQL)
├── dashboard/index.html        # Дашборд (SPA, 7 вкладок)
├── systemd/                    # усі unit-файли (17 таймерів + 4 демони)
├── migrations/                 # PostgreSQL міграції (025)
├── tests/                      # pytest (80 тестів)
├── data/disinfo_channels.json  # канали моніторингу детектора
├── sync_*.py                   # синхронізації (bills, votes, mps, schedule, EU, info)
├── calc_kpi_v12.py             # ІЕД
├── calc_harmonization.py       # гармонізація + EU Integration Index
├── detect_attacks.py           # бьорст-детектор інфоатак
├── label_narratives.py         # нічна LLM-розмітка нарративів
├── night_batch.py              # нічний LLM-аналіз (3 воркери)
├── daily_digest_llm.py         # щоденний дайджест (детермінований, без LLM)
├── weekly_digest.py            # щотижневий дайджест (пн 08:00)
├── monitor.py                  # Telegram-сповіщення з change_log
└── telegram_bot.py             # інтерактивний бот + персональні підписки

API (ключові ендпоінти)

Ендпоінт	Опис
`GET /api/bills`, `/api/bills/:id`	Закони: пошук, деталі, ризики, хронологія
`GET /api/deputies`, `/api/deputies/:name`	Депутати + ІЕД v12
`GET /api/eu-alignment`	EU Integration Index + кластери + таймлайн + новини
`GET /api/schedule`, `/api/activity-calendar`	Графік ВРУ + активності
`GET /api/info-digest`	Нарративи дня, атаки, ТОП фактчеків
`GET /api/dashboard`	Уніфікований блок головної

Встановлення

git clone https://github.com/Dinollee/radacleaner.git
cd radacleaner
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # DB_HOST, TG_BOT_TOKEN, OPENROUTER_API_KEY...
venv/bin/python -m pytest tests/ -q

Деплой дашборда: npx wrangler pages deploy dashboard --project-name radacleaner-dashboard

Ліцензія

MIT

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
dashboard		dashboard
data		data
migrations		migrations
research		research
scripts		scripts
src		src
systemd		systemd
tests		tests
worker		worker
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
ARCHITECTURE.md		ARCHITECTURE.md
README.md		README.md
RESEARCH.md		RESEARCH.md
analyze_api.py		analyze_api.py
analyze_bill.py		analyze_bill.py
backfill_citizen_impact.py		backfill_citizen_impact.py
backfill_interest_sectors.py		backfill_interest_sectors.py
calc_bill_quality.py		calc_bill_quality.py
calc_deputy_portraits.py		calc_deputy_portraits.py
calc_eu_llm.py		calc_eu_llm.py
calc_harmonization.py		calc_harmonization.py
calc_interest_profiles.py		calc_interest_profiles.py
calc_kpi_v12.py		calc_kpi_v12.py
calc_msi_kpb.py		calc_msi_kpb.py
calc_voting_clubs.py		calc_voting_clubs.py
daily_digest_llm.py		daily_digest_llm.py
detect_attacks.py		detect_attacks.py
enrich_company_sectors.py		enrich_company_sectors.py
eu_alignment.py		eu_alignment.py
label_narratives.py		label_narratives.py
monitor.py		monitor.py
night_batch.py		night_batch.py
rada-endpoints.md		rada-endpoints.md
requirements.txt		requirements.txt
scrape_sponsors.py		scrape_sponsors.py
setup.py		setup.py
sync_all.py		sync_all.py
sync_bill_passings.py		sync_bill_passings.py
sync_bill_passings_html.py		sync_bill_passings_html.py
sync_bills.py		sync_bills.py
sync_committee_members.py		sync_committee_members.py
sync_committee_schedule.py		sync_committee_schedule.py
sync_deputy_requests.py		sync_deputy_requests.py
sync_disinfo_channels.py		sync_disinfo_channels.py
sync_eu_tracker.py		sync_eu_tracker.py
sync_holidays.py		sync_holidays.py
sync_info_monitor.py		sync_info_monitor.py
sync_lobbying_registry.py		sync_lobbying_registry.py
sync_mp_bills.py		sync_mp_bills.py
sync_mp_dates.py		sync_mp_dates.py
sync_mp_factions.py		sync_mp_factions.py
sync_mp_stats.py		sync_mp_stats.py
sync_nazk_declarations.py		sync_nazk_declarations.py
sync_period.py		sync_period.py
sync_schedule_legacy.py		sync_schedule_legacy.py
sync_votes.py		sync_votes.py
sync_votes_bulk.py		sync_votes_bulk.py
telegram_bot.py		telegram_bot.py
weekly_digest.py		weekly_digest.py
новий], tracked: номер		новий], tracked: номер

Navigation Menu

Repository files navigation

🏛️ Страж Демократії

Що це робить

Можливості

Архітектура

Стек технологій

ІЕД — Індекс ефективної діяльності (v12)

🇪🇺 EU Integration Index v1 (гіпотетичний)

🛡 Детектор синхронних інфоатак

Структура проєкту (ключове)

API (ключові ендпоінти)

Встановлення

Ліцензія

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🏛️ Страж Демократії

Що це робить

Можливості

Архітектура

Стек технологій

ІЕД — Індекс ефективної діяльності (v12)

🇪🇺 EU Integration Index v1 (гіпотетичний)

🛡 Детектор синхронних інфоатак

Структура проєкту (ключове)

API (ключові ендпоінти)

Встановлення

Ліцензія

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages