AI-триаж-ассистент

Telegram Web App для первичной оценки симптомов и определения необходимости медицинской помощи.

🚨 Важно: Дисклеймер

Этот бот НЕ ставит диагнозы, НЕ оказывает медицинские услуги и НЕ заменяет врача.

• В экстренной ситуации звоните 103 или 112
• Бот предоставляет только информационные рекомендации
• Ответственность за действия лежит на пользователе

📋 Функциональность

Основные возможности:

• ✅ Первичная оценка симптомов
• ✅ Определение "красных флагов" (опасных признаков)
• ✅ Рекомендации по действиям (скорая/врач/наблюдение)
• ✅ Инструкции по оказанию первой помощи
• ✅ Анонимная статистика использования

Поддерживаемые симптомы:

1. Боль в груди - оценка сердечно-сосудистых рисков
2. Высокая температура - инфекционные заболевания
3. Головная боль - неврологические симптомы
4. Одышка - дыхательная недостаточность
5. Травма - механические повреждения
6. Рвота - желудочно-кишечные проблемы
7. Боль в животе - острые состояния
8. Потеря сознания - неврологические нарушения
9. Аллергия - аллергические реакции
10. Слабость - общие симптомы

🏗️ Архитектура

Triage-Assistant/
├── bot/                    # Telegram бот
│   ├── __init__.py
│   ├── main.py            # Основной файл бота
│   ├── handlers/          # Обработчики сообщений
│   ├── keyboards/         # Клавиатуры и кнопки
│   ├── database/          # Работа с БД
│   └── scenarios/         # Медицинские сценарии
├── webapp/                # Telegram Web App
│   ├── index.html         # Главная страница
│   ├── styles.css         # Стили
│   ├── script.js          # JavaScript логика
│   └── assets/            # Изображения и ресурсы
├── database/              # База данных
│   └── triage.db          # SQLite база
├── config/                # Конфигурация
│   └── settings.py        # Настройки
└── docs/                  # Документация
    └── scenarios.md       # Описание сценариев

🚀 Быстрый старт

1. Установка зависимостей

pip install -r requirements.txt

2. Настройка окружения

Создайте файл .env:

BOT_TOKEN=your_telegram_bot_token
WEBAPP_URL=https://your-username.github.io/Triage-Assistant/webapp/

3. Запуск бота

python bot/main.py

4. Настройка Web App

1. Создайте бота через @BotFather
2. Настройте Web App URL в BotFather
3. Разверните на GitHub Pages

📊 База данных

Структура SQLite:

• users - анонимные пользователи
• sessions - сессии триажа
• symptoms - симптомы и их параметры
• scenarios - медицинские сценарии
• feedback - обратная связь

🏥 Медицинские протоколы

Алгоритм принятия решений:

1. Красные флаги → Немедленно скорая помощь
2. Умеренный риск → Обращение к врачу в течение 24-72 часов
3. Низкий риск → Наблюдение с инструкциями

Примеры красных флагов:

• Боль в груди + одышка + потливость
• Температура >39°C + сыпь
• Травма + кровотечение + деформация
• Потеря сознания
• Сильная аллергическая реакция

🔧 Разработка

Добавление нового симптома:

1. Добавить в scenarios/symptoms.py
2. Создать логику в scenarios/triage_logic.py
3. Добавить кнопки в keyboards/symptoms.py
4. Обновить документацию

Структура сценария:

SYMPTOM_NAME = {
    "questions": [
        {"id": "q1", "text": "Вопрос?", "type": "yes_no"},
        {"id": "q2", "text": "Уточнение?", "type": "multiple_choice"}
    ],
    "red_flags": ["q1_yes", "q2_option3"],
    "recommendations": {
        "emergency": "Вызвать скорую: 103",
        "doctor": "Обратиться к врачу в течение 24 часов",
        "observe": "Наблюдать за состоянием"
    }
}

🛡️ Безопасность

Юридические требования:

• ✅ Дисклеймер в каждом сообщении
• ✅ Нет сбора персональных данных
• ✅ Только информационные рекомендации
• ✅ Запрет медицинских терминов

Техническая безопасность:

• ✅ Валидация входных данных
• ✅ Защита от SQL-инъекций
• ✅ Логирование действий
• ✅ Обработка ошибок

📈 Статистика

Собираемые данные (анонимно):

• Популярные симптомы
• Частота вызовов скорой
• Время использования
• Обратная связь пользователей

🤝 Вклад в проект

1. Fork репозитория
2. Создайте feature branch
3. Внесите изменения
4. Добавьте тесты
5. Создайте Pull Request

📞 Поддержка

• Issues: GitHub Issues
• Документация: /docs
• Примеры: /examples

📄 Лицензия

MIT License - см. файл LICENSE

---

⚠️ Помните: Этот бот не заменяет медицинскую помощь!