# GovTech SDK

> Відкриті Python-бібліотеки та конвенції для побудови українських державних
> реєстрів і сервісів: ID.GOV.UA, Трембіта, КЕП/Дія.Підпис, форми з аудитом,
> ролі, кабінети, бізнес-процеси. Ліцензія MIT. Мейнтейнер — RaccoonGang.
> Позиціонування: усі переваги low-code платформ, але артефактом лишається
> код у вашому репозиторії.

Стек: Python 3.11+, Django 5.0+, PostgreSQL. Ядро (id, trembita, signature,
registry) не залежить від Django і працює у FastAPI.

## Статус цього файлу

Сайт документації ще не опублікований, тому окремих сторінок `/docs/*.md` поки
не існує. Повний технічний опис лежить у [/llms-full.txt](/llms-full.txt) —
його достатньо, щоб написати інтеграцію. Посилання на сторінки зʼявляться тут
разом з релізом доків (Q4 2026).

## Модулі

- govtech-id: авторизація ID.GOV.UA, чотири схеми (КЕП, Дія.Підпис, BankID), розшифрування encryptedUserInfo. Статус: stable
- govtech-signature: серверна перевірка КЕП — ланцюжок до ЦЗО, OCSP, мітка часу TSP. Статус: stable
- govtech-trembita: клієнт Трембіти (X-Road), mTLS, заголовок X-Road-Client, ASiC-контейнери. Статус: stable
- govtech-registry: ДРФО, ЄДР, ЄІС МВС на токені ID.GOV.UA без окремого підключення до ШБО. Статус: stable
- govtech-audit: незмінюваний журнал дій, диф полів, прив'язка до підпису. Статус: stable
- govtech-forms: Django Forms з аудитом, перевіркою прав і хуками підпису. Статус: beta
- govtech-rbac: ролі, реалми, скоупи по підрозділу. Статус: beta
- govtech-workflow: бізнес-процеси як Python-класи, кроки, SLA. Статус: beta
- govtech-cabinet: кабінети заявника й посадової особи, флоу погоджень. Статус: beta
- govtech-notify: пуш у Дію, email, вхідні в кабінеті. Статус: beta
- govtech-testing: моки ID.GOV.UA, Трембіти, КЕП для CI. Статус: beta
- govtech-cli: `govtech new`, `govtech doctor`, `govtech agent install`. Статус: beta
- govtech-docs: витяги в PDF/DOCX з печаткою та QR. Статус: roadmap Q1 2027
- govtech-edebo: ЄДЕБО та АІКОМ. Статус: roadmap Q2 2027

## Пастки, на яких падають інтеграції

- ID.GOV.UA не є OIDC: немає discovery-документа і немає id_token.
- Код авторизації живе 30 секунд і згорає після першого використання.
- access_token одноразовий — повторний запит з тим самим токеном поверне помилку.
- Дані користувача приходять зашифрованими на сертифікаті КНЕДП; потрібна ДСТУ-криптографія на бекенді.
- Трембіта вимагає коректного заголовка X-Road-Client і двосторонньої TLS; ASiC-контейнер відповіді є юридичним доказом обміну і має зберігатись.

## Що SDK не робить

- Не скорочує юридичний трек: договір з ДП «ДІЯ», розгортання ШБО, сертифікати від КНЕДП — 1–3 тижні календарно.
- Не дає КСЗІ. Атестується система, а не бібліотека.
- Не дає складання форм без розробника. Форму пише розробник — за годину, а не за тиждень.

## Ресурси

- [Повний технічний опис](/llms-full.txt): модулі, приклади, пастки — одним файлом
- [Огляд](https://govtech.stepanok.com/): позиціонування, порівняння з low-code, дорожня карта
- [RaccoonGang на GitHub](https://github.com/raccoongang): мейнтейнер. Публічний
  репозиторій `govtech-sdk` відкриваємо разом з першим релізом; поки що всі
  питання — на hello@raccoongang.com