Кейс розробки telegram бота психологія

Цей проєкт не народився в корпоративній переговорній чи на хакатоні—він почався під час тривожної спіралі о 2-й ночі, коли професійна допомога була недоступна.

Як нейровідмінна людина, я на власному досвіді відчула прірву між "мені потрібна підтримка зараз" і "наступний вільний прийом у психолога через три тижні". Система ментального здоров'я, попри найкращі наміри, працює за графіками, які не співпадають із тим, як насправді відбуваються кризові моменти. Тривога не чекає робочих годин. Флешбеки ПТСР не перевіряють твій календар.

NeuroKit існує, щоб заповнити цю прогалину—не як заміна терапії (це не так, і ніколи не буде), а як співчутливий перший крок, коли людська допомога недоступна негайно.

Чому я це створила:

Нейровідмінна спільнота стикається з унікальними бар'єрами: соціальна тривога робить дзвінки на гарячі лінії жахливими, виконавча дисфункція ускладнює запис на прийом, а стигма навколо ментального здоров'я змушує багатьох вагатися зробити перший крок. Я хотіла створити щось, що зустрічає людей там, де вони є—у звичному месенджері, без осуду, доступно миттєво.

Але доступність не повинна означати жертву безпекою чи етикою. Занадто багато додатків для ментального здоров'я ставляться до даних користувачів як до продукту (75% не відповідають базовим стандартам приватності). Занадто багато AI-чатботів генерують шкідливі поради або емоційно маніпулюють вразливими користувачами. Я не могла совісно додати ще один сумнівний інструмент до цього ландшафту.

Етичний фундамент:

Кожен клінічний тест, інтегрований у NeuroKit, має офіційну згоду правовласників. AI налаштований згідно з фреймворками доказової психології (КПТ, травма-інформовані підходи), а не просто загальними LLM-відповідями. Дані користувачів не збираються, не зберігаються довгостроково і не монетизуються—ніколи. Це не просто маркетинговий текст; це архітектурні рішення, вбудовані в кодову базу з першого дня.

Візія:

NeuroKit створений для трьох аудиторій: людей, які шукають негайної підтримки, фахівців з ментального здоров'я, яким потрібні інструменти для клієнтів між сесіями, та open-source спільноти, зацікавленої в етичній імплементації AI.

Для людей: простір без осуду для оцінки свого стану, отримання стратегій подолання на основі доказів і пошуку шляхів до професійної допомоги.

Для фахівців: інструмент для розширення впливу без збільшення вигорання, автоматизації рутинного скринінгу та надання клієнтам цілодобового доступу до валідованих психологічних фреймворків.

Для розробників: еталонна реалізація, що доводить: технології ментального здоров'я можуть бути водночас складними й етичними.

Open-source філософія:

Проєкт доступний за адресою: https://github.com/ChuprinaDaria/NeuroKit

Я вірю, що інструменти ментального здоров'я мають бути прозорими, перевіреними та належати спільноті. Якщо ви зацікавлені у використанні, адаптації чи розгортанні NeuroKit для вашої практики або спільноти, я буду щиро вдячна за повідомлення (юридично не обов'язково, просто людяність, яка допомагає мені розуміти вплив і покращувати проєкт). Зв'яжіться через GitHub або функцію зворотного зв'язку в боті.

Це створено з турботою людиною, якій це було потрібно. Сподіваюся, це допоможе і тобі. 🐾

NeuroKit побудований на фундаменті продуманих технічних рішень, які ставлять у пріоритет безпеку користувачів, підтримуваність коду та етичну імплементацію AI. Це не proof-of-concept, швидко зібраний на хакатоні—це production-grade система, розроблена для реальної підтримки ментального здоров'я.

Основний технологічний стек:

Бот працює на Python 3.11+ для сучасних можливостей мови та оптимізації продуктивності, використовуючи aiogram v3—найактивніше підтримуваний фреймворк для Telegram Bot API з надійною async підтримкою та чистою FSM (Finite State Machine) архітектурою. Цей модульний FSM-дизайн означає, що кожен діалоговий флоу (вибір тесту, AI-консультація, фідбек) працює незалежно, роблячи кодову базу підтримуваною та розширюваною.

Збереження даних використовує SQLite з критичним обмеженням приватності: ніяка персонально ідентифікована інформація не зберігається. Взаємодії користувачів є stateful під час сесій, але ефемерними після завершення—розмови не логуються, результати тестів не зберігаються на сервері, і немає інфраструктури трекінгу.

Інтеграція клінічних оцінок:

NeuroKit інтегрує валідовані психологічні інструменти оцінки з офіційною згодою правовласників:

• GAD-7 (Шкала генералізованого тривожного розладу): 7 питань для скринінгу тяжкості тривоги, розроблена Spitzer et al., валідована на багатьох популяціях
• PHQ-9 (Опитувальник здоров'я пацієнта-9): Золотий стандарт скринінгу депресії, широко використовується в клінічній практиці
• PCL-5 (Чеклист ПТСР для DSM-5): 20 питань для оцінки посттравматичних симптомів
• HADS (Госпітальна шкала тривоги та депресії): 14 питань для оцінки тривоги та депресії в медичних умовах
• DASS-21 (Шкала депресії, тривоги та стресу): 21 питання, що вимірює три пов'язані негативні емоційні стани
• PSQI (Піттсбурзький індекс якості сну): Оцінка якості сну за місяць
• Елементи Шкали депресії Бека: Інтегровані компоненти з однієї з найбільш валідованих оцінок депресії

Кожен тест включає алгоритми підрахунку, вірні опублікованим клінічним рекомендаціям, інтерпретації на основі порогів (легкий/помірний/важкий), та явні застереження, що це скринінгові інструменти, а не діагнози.

AI-інтеграція з етичними обмеженнями:

AI-консультант "Кіт Нейрон" використовує OpenAI API з ретельно розробленими system prompts, які:

• Базують відповіді на доказовій психології (КПТ, ACT, травма-інформовані підходи)
• Відмовляються діагностувати чи призначати ліки
• Розпізнають кризову мову й негайно показують екстрені ресурси
• Уникають підсилення шкідливих патернів мислення або надання медичних порад

AI-шар не замінює клінічні оцінки—він доповнює їх, пропонуючи емпатичну, контекстуально відповідну психоосвіту та стратегії подолання.

Архітектура приватності:

Приватність—не функціональний переключач, а вбудована в архітектуру:

• Відсутність аналітики: Нуль сторонніх SDK, немає Google Analytics, немає телеметрії поведінки користувачів
• Інфраструктура Telegram: Повідомлення використовують client-server шифрування Telegram; бот не зберігає історію повідомлень
• Stateless сесії: Після завершення тесту чи розмови не залишається залишкових даних
• GDPR compliance by design: Відсутність збору даних означає відсутність даних для витоку, експорту чи видалення

Генерація PDF-звітів:

Бот використовує FPDF для створення чистих PDF-звітів результатів тестів. Вони включають:

• Сирі бали та клінічну інтерпретацію
• Візуальні шкальні представлення
• Рекомендації щодо наступних кроків (терапія, ресурси самодопомоги, кризові контакти)
• Дата-штамп для записів користувача

PDF генеруються на вимогу та доставляються через Telegram—ніколи не зберігаються на серверах.

Основні моменти модульної архітектури:

• Обробники діалогів: Окремі модулі для тестів, AI-чату, фідбеку, адмін-функцій
• FSM-стани: Чисті переходи станів запобігають витоку контексту між діалоговими флоу
• Inline keyboard навігація: Інтуїтивний UX з кнопковими взаємодіями
• Адмін-панель: Розсилка повідомлень, модерація користувачів, аналітика (тільки агрегована, без PII)
• Система довірених користувачів: Верифіковані користувачі можуть додавати контент без ручного схвалення
• Управління банами: Тимчасові/постійні бани з grace periods для випадкових порушень

Безпека контенту:

Усі повідомлення підтримки та стратегії подолання курує людина (я), а не автогенерує AI. Це забезпечує контроль якості та запобігає регургітації ботом потенційно шкідливих LLM-галюцинацій.

Деплоймент:

Кодова база розроблена для self-hosting—клініки чи організації зі строгими вимогами до резиденції даних можуть розгорнути NeuroKit на власній інфраструктурі. Без vendor lock-in, без рекурентних SaaS-платежів, повний контроль над потоками даних.

Що це демонструє:

З погляду портфоліо, NeuroKit показує:

• Складне управління станами в conversational AI
• Етичний prompt engineering для AI
• Healthcare compliance (GDPR, анонімність, згода)
• Інтеграцію валідованих клінічних інструментів
• Масштабовану Python-архітектуру
• User-centric дизайн для вразливих популяцій

Це не просто чатбот—це еталонна імплементація того, як технології ментального здоров'я мають будуватися: прозоро, етично, з щирою турботою про людей, які їх використовують.

NeuroKit демонструє функціонуючу систему підтримки ментального здоров'я, що вирішує критичні прогалини індустрії. Бот валідує технічну можливість privacy-first дизайну в сфері, де 75% додатків не відповідають базовим стандартам відповідності. Імплементуючи архітектуру без збору даних, він доводить, що етичні технології ментального здоров'я досяжні без жертв функціональністю.

Автоматизована система скринінгу показує потенціал для ~30% зменшення адміністративного навантаження терапевтів—значне полегшення в професії з масовим вигоранням. Цілодобова доступність вирішує кризу доступності, де середній час очікування перевищує 2-3 місяці в багатьох регіонах.

Open-source реліз дозволяє адаптацію спільнотою, даючи клінікам зі строгими вимогами до резиденції даних можливість self-host замість покладання на комерційні рішення з непрозорими практиками приватності. Проєкт викликав інтерес фахівців, які шукають інструменти автоматизації, що відповідають їхнім етичним зобов'язанням.

Найважливіше—NeuroKit доводить, що складні технології ментального здоров'я можна будувати прозоро, етично й доступно—кидаючи виклик домінуючій моделі дорогих, data-harvesting комерційних додатків.