Telegram bot dla gabinetu psychologicznego

Ten projekt nie narodził się w sali konferencyjnej korporacji ani na hackathonie—zaczął się podczas spirali lękowej o 2 w nocy, kiedy profesjonalna pomoc była niedostępna.

Jako osoba neuroatypowa doświadczyłam osobiście przepaści między "potrzebuję wsparcia teraz" a "następny wolny termin u terapeuty za trzy tygodnie". System zdrowia psychicznego, mimo najlepszych intencji, działa według harmonogramów, które nie pokrywają się z tym, jak naprawdę zdarzają się momenty kryzysowe. Lęk nie czeka na godziny pracy. Flashbacki PTSD nie sprawdzają twojego kalendarza.

NeuroKit istnieje, aby wypełnić tę lukę—nie jako zamiennik terapii (nie jest i nigdy nie będzie), ale jako współczujący pierwszy krok, gdy ludzka pomoc nie jest natychmiast dostępna.

Dlaczego to stworzyłam:

Społeczność neuroatypowa staje przed unikalnymi barierami: lęk społeczny sprawia, że dzwonienie na infolinie jest przerażające, dysfunkcja wykonawcza utrudnia umawianie wizyt, a stygmat związany ze zdrowiem psychicznym sprawia, że wielu waha się zrobić pierwszy krok. Chciałam stworzyć coś, co spotyka ludzi tam, gdzie są—w ich ulubionym messengerze, bez osądu, dostępne natychmiast.

Ale dostępność nie powinna oznaczać poświęcenia bezpieczeństwa czy etyki. Zbyt wiele aplikacji zdrowia psychicznego traktuje dane użytkowników jako produkt (75% nie spełnia podstawowych standardów prywatności). Zbyt wiele chatbotów AI halucynuje szkodliwe porady lub manipuluje emocjonalnie wrażliwymi użytkownikami. Nie mogłam w dobrej wierze dodać kolejnego wątpliwego narzędzia do tego krajobrazu.

Fundament etyczny:

Każdy test kliniczny zintegrowany z NeuroKit ma wyraźną zgodę właściciela praw autorskich. AI jest skonfigurowane według frameworków psychologii opartej na dowodach (CBT, podejścia trauma-informed), nie tylko ogólnych odpowiedzi LLM. Dane użytkowników nie są zbierane, przechowywane długoterminowo ani monetyzowane—nigdy. To nie tylko tekst marketingowy; to decyzje architektoniczne wbudowane w kod od pierwszego dnia.

Wizja:

NeuroKit jest zaprojektowany dla trzech odbiorców: osób poszukujących natychmiastowego wsparcia, specjalistów zdrowia psychicznego potrzebujących narzędzi między sesjami dla klientów oraz społeczności open-source zainteresowanej etyczną implementacją AI.

Dla osób: przestrzeń bez osądu do oceny stanu psychicznego, otrzymywania strategii radzenia sobie opartych na dowodach i znajdowania dróg do profesjonalnej pomocy.

Dla specjalistów: narzędzie do rozszerzenia wpływu bez zwiększania wypalenia, automatyzacji rutynowego screeningu i zapewnienia klientom całodobowego dostępu do zwalidowanych frameworków psychologicznych.

Dla deweloperów: referencyjna implementacja dowodząca, że technologie zdrowia psychicznego mogą być zarówno zaawansowane, jak i etyczne.

Filozofia open-source:

Projekt dostępny pod adresem: https://github.com/ChuprinaDaria/NeuroKit

Wierzę, że narzędzia zdrowia psychicznego powinny być transparentne, audytowalne i należeć do społeczności. Jeśli jesteś zainteresowany użyciem, adaptacją lub wdrożeniem NeuroKit w swojej praktyce lub społeczności, byłabym szczerze wdzięczna za informację (nie jest to prawnie wymagane, po prostu uprzejmość, która pomaga mi zrozumieć wpływ i ulepszać projekt). Skontaktuj się przez GitHub lub funkcję feedbacku w bocie.

To stworzone z troską przez kogoś, kto tego potrzebował. Mam nadzieję, że pomoże też tobie. 🐾

NeuroKit zbudowany jest na fundamencie przemyślanych decyzji technicznych, które priorytetyzują bezpieczeństwo użytkowników, utrzymywalność kodu i etyczną implementację AI. To nie proof-of-concept szybko złożony na hackathonie—to system production-grade zaprojektowany dla rzeczywistego wsparcia zdrowia psychicznego.

Podstawowy stos technologiczny:

Bot działa na Python 3.11+ dla nowoczesnych funkcji języka i optymalizacji wydajności, używając aiogram v3—najbardziej aktywnie utrzymywanego frameworka Telegram Bot API z solidnym wsparciem async i czystą architekturą FSM (Finite State Machine). Ten modułowy projekt FSM oznacza, że każdy przepływ konwersacji (wybór testu, konsultacja AI, feedback) działa niezależnie, czyniąc bazę kodu utrzymywalną i rozszerzalną.

Trwałość danych wykorzystuje SQLite z krytycznym ograniczeniem prywatności: żadne dane osobowe nie są przechowywane. Interakcje użytkowników są stanowe podczas sesji, ale efemeryczne po zakończeniu—rozmowy nie są logowane, wyniki testów nie są przechowywane po stronie serwera, nie ma infrastruktury śledzenia.

Integracja ocen klinicznych:

NeuroKit integruje zwalidowane narzędzia oceny psychologicznej z wyraźną zgodą właścicieli praw autorskich:

• GAD-7 (Skala zaburzenia lękowego uogólnionego): 7 pytań do screeningu nasilenia lęku, opracowana przez Spitzera et al., zwalidowana w wielu populacjach
• PHQ-9 (Kwestionariusz zdrowia pacjenta-9): Złoty standard screeningu depresji, szeroko stosowany w praktyce klinicznej
• PCL-5 (Lista kontrolna PTSD dla DSM-5): 20 pytań do oceny objawów pourazowych
• HADS (Szpitalna skala lęku i depresji): 14 pytań oceniających lęk i depresję w warunkach medycznych
• DASS-21 (Skala depresji, lęku i stresu): 21 pytań mierzących trzy powiązane negatywne stany emocjonalne
• PSQI (Pittsburgh Sleep Quality Index): Ocena jakości snu w ciągu miesiąca
• Elementy Inwentarza Depresji Becka: Zintegrowane komponenty z jednej z najbardziej zwalidowanych ocen depresji

Każdy test zawiera algorytmy punktacji wierne opublikowanym wytycznym klinicznym, interpretacje oparte na progach (łagodny/umiarkowany/ciężki) i wyraźne zastrzeżenia, że są to narzędzia screeningowe, nie diagnozy.

Integracja AI z etycznymi zabezpieczeniami:

Konsultant AI "Kot Neuron" wykorzystuje OpenAI API z starannie zaprojektowanymi system prompts, które:

• Opierają odpowiedzi na psychologii opartej na dowodach (CBT, ACT, podejścia trauma-informed)
• Odmawiają diagnozowania czy przepisywania leków
• Rozpoznają język kryzysowy i natychmiast pokazują zasoby awaryjne
• Unikają wzmacniania szkodliwych wzorców myślowych lub udzielania porad medycznych

Warstwa AI nie zastępuje ocen klinicznych—uzupełnia je, oferując empatyczną, kontekstowo odpowiednią psychoedukację i strategie radzenia sobie.

Architektura prywatności:

Prywatność nie jest przełącznikiem funkcji—jest osadzona w architekturze:

• Brak analityki: Zero SDK firm trzecich, brak Google Analytics, brak telemetrii zachowań użytkowników
• Infrastruktura Telegram: Wiadomości wykorzystują szyfrowanie klient-serwer Telegram; bot nie przechowuje historii wiadomości
• Sesje bezstanowe: Po zakończeniu testu lub rozmowy nie pozostają żadne dane rezydualne
• Zgodność RODO przez projekt: Brak zbierania danych oznacza brak danych do naruszenia, eksportu czy usunięcia

Generowanie raportów PDF:

Bot używa FPDF do tworzenia czystych, drukowalnych raportów PDF wyników testów. Zawierają:

• Surowe wyniki i interpretację kliniczną
• Wizualne reprezentacje skal
• Rekomendacje kolejnych kroków (terapia, zasoby samopomocy, kontakty kryzysowe)
• Oznaczenie datą dla dokumentacji użytkownika

PDF są generowane na żądanie i dostarczane przez Telegram—nigdy nie przechowywane na serwerach.

Najważniejsze elementy architektury modułowej:

• Handlery rozmów: Osobne moduły dla testów, czatu AI, feedbacku, funkcji admina
• Stany FSM: Czyste przejścia stanów zapobiegają wyciekom kontekstu między przepływami rozmów
• Nawigacja inline keyboard: Intuicyjny UX z interakcjami przyciskowymi
• Panel admina: Rozgłaszanie wiadomości, moderacja użytkowników, analityka (tylko zagregowana, bez PII)
• System zaufanych użytkowników: Zweryfikowani użytkownicy mogą dodawać treści bez ręcznej akceptacji
• Zarządzanie banami: Bany tymczasowe/stałe z okresami grace dla przypadkowych naruszeń

Bezpieczeństwo treści:

Wszystkie wiadomości wsparcia i strategie radzenia sobie są kuratorowane przez człowieka (mnie), nie autogenerowane przez AI. Zapewnia to kontrolę jakości i zapobiega regurgitacji przez bota potencjalnie szkodliwych halucynacji LLM.

Wdrożenie:

Baza kodu zaprojektowana jest dla self-hostingu—kliniki czy organizacje ze ścisłymi wymaganiami rezydencji danych mogą wdrożyć NeuroKit na własnej infrastrukturze. Bez vendor lock-in, bez opłat SaaS, pełna kontrola nad przepływami danych.

Co to demonstruje:

Z perspektywy portfolio, NeuroKit pokazuje:

• Złożone zarządzanie stanami w conversational AI
• Etyczny prompt engineering dla AI
• Zgodność healthcare (RODO, anonimowość, zgoda)
• Integrację zwalidowanych narzędzi klinicznych
• Skalowalną architekturę Python
• Projektowanie user-centric dla wrażliwych populacji

To nie tylko chatbot—to referencyjna implementacja tego, jak technologie zdrowia psychicznego powinny być budowane: transparentnie, etycznie, z prawdziwą troską o ludzi, którzy ich używają.

NeuroKit demonstruje funkcjonujący system wsparcia zdrowia psychicznego rozwiązujący krytyczne luki branży. Bot waliduje techniczną wykonalność projektu privacy-first w dziedzinie, gdzie 75% aplikacji nie spełnia podstawowych standardów zgodności. Implementując architekturę bez zbierania danych, dowodzi, że etyczne technologie zdrowia psychicznego są osiągalne bez poświęcania funkcjonalności.

Zautomatyzowany system screeningu pokazuje potencjał ~30% redukcji obciążenia administracyjnego terapeutów—znaczącą ulgę w zawodzie borykającym się z masowym wypaleniem. Dostępność 24/7 rozwiązuje kryzys dostępności, gdzie średni czas oczekiwania przekracza 2-3 miesiące w wielu regionach.

Wydanie open-source umożliwia adaptację społeczności, pozwalając klinikom ze ścisłymi wymaganiami rezydencji danych na self-hosting zamiast polegania na komercyjnych rozwiązaniach z nieprzejrzystymi praktykami prywatności. Projekt wzbudził zainteresowanie specjalistów poszukujących narzędzi automatyzacji zgodnych z ich obowiązkami etycznymi.

Najważniejsze—NeuroKit dowodzi, że zaawansowane technologie zdrowia psychicznego można budować transparentnie, etycznie i dostępnie—rzucając wyzwanie dominującemu modelowi drogich, data-harvesting komercyjnych aplikacji.