Технічне завдання: Автоматизація Підписання Петицій із Дія.Підпис

1. Мета проєкту

Створити рішення, в якому користувач зможе підтвердити свою особу через Дія та підписати петицію (або звернення) з використанням Дія.Підпис, а підтвердження про підпис має зберігатися в окремому архіві й у базі даних.

2. Опис бізнес-процесу

1. Підтвердження особи:
   • Користувач отримує посилання/кнопку для підтвердження особи через Дія.
   • Після успішної авторизації ми отримуємо дані користувача (ПІБ, дата народження, адреса тощо).
2. Підписання петиції:
   • Користувач бачить доступні петиції/звернення.
   • Обирає одну з них, натискає “Підписати”.
   • Згенерований хеш петиції відправляється на сервер Дія для створення запиту на підписання.
   • Користувач отримує посилання (deeplink) від Дія, за яким переходить у застосунок Дія і підписує петицію.
3. Збереження результатів:
   • Дія надсилає підписаний хеш документа на вказаний нами endpoint.
   • Дані зберігаються у базі (список підписантів), а файли/підписи — в архіві.
   • Користувачу надсилається повідомлення, що петицію успішно підписано.

3. Необхідний функціонал

1. Підтвердження особи через Дія:
   • Надсилання запиту на верифікацію користувача.
   • Отримання результатів (імені, дати народження та інших даних, що вимагаються).
2. Генерація та відправка запиту на підписання:
   • Формування хешу петиції відповідно до ГОСТ 34.311 або іншого алгоритму, підтримуваного Дія (DSTU / ECDSA).
   • Створення пропозиції (offer) та отримання deeplink для підпису.
3. Отримання підписаного хешу:
   • Endpoint для прийому підписаних даних від Дія.
   • Збереження підпису (хеш) і даних користувача.
4. Зворотне повідомлення користувачу:
   • Повідомлення про успішне підписання.
5. Архівування даних:
   • Можливість зберігати підписані дані (хеш) та іншу службову інформацію в окремий архів (наприклад, ZIP).
   • Зв’язок підпису з конкретною петицією.

4. Юридичні та технічні аспекти

• Використання HTTPS для всіх зовнішніх та внутрішніх запитів, щоб гарантувати безпеку.
• Використання офіційного API Дія:
  • Отримання сесійного токена (acquirer_token).
  • Реалізація створення branch, offer та запитів на підписання відповідно до документації.
• Дані користувача (ПІБ, дата народження, адреса) зберігати в базі, де вони будуть використовуватися для підтвердження статусу підписанта.

5. Кінцевий результат

1. Користувач:
   • Легко підтверджує особу через Дія.
   • Підписує петицію за декілька кліків, отримуючи deeplink і переходячи в застосунок Дія.
2. Сервіс:
   • Має endpoint, що отримує підписані хеші від Дія та зберігає їх разом із даними користувача.
   • Забезпечує архів із підписами для кожної петиції (документи+хеші).
3. Адміністрування:
   • База підписантів для кожної петиції.
   • Можливість завантажити архів підписів у будь-який момент.
4. Безпека та прозорість:
   • Підтверджені особи через Дію.
   • Юридично значущий електронний підпис.

6. Коментарі та побажання

• Фрілансер обирає будь-який зручний інструментарій (фреймворк, способи реалізації) — головне, щоб результати відповідали вимогам.
• Застосунок має бути Телеграм-ботом, де користувачеві зручно ознайомитися й підписати петицію.
• Тестування на sandbox-оточенні Дія.
  
  Інструкція з інтеграції з Дія.Підпис