FamilyTech «Ниточка»

Персональный навигатор по ребёнку для родителей.

О проекте

Когда родитель сталкивается с трудностями в общении, обучении или воспитании ребёнка, часто непонятно: это лень? плохой характер? или что-то ещё? Импульсивность, рассеянность, сопротивление — всё это легко списать на «плохое поведение», но за этим могут стоять особенности развития исполнительных функций.

«Ниточка» помогает родителю увидеть реальную картину ребёнка — его природные склонности, сильные стороны и зоны уязвимости — и даёт конкретные рекомендации по взаимодействию.

Не диагноз, а понимание. Продукт не заменяет психолога и не ставит ярлыки — он даёт язык и рамку для понимания индивидуальных особенностей ребёнка.

Двухслойная модель анализа

Система объединяет два подхода:

1. BaZi (китайская метафизика) — анализ природных склонностей на основе даты и времени рождения. Определяет элемент личности, баланс энергий, потенциальные сильные и слабые стороны.

2. Executive Skills (опросник Peg Dawson) — 33 вопроса об исполнительных функциях ребёнка: торможение реакции, рабочая память, эмоциональный контроль, устойчивое внимание, планирование, организация, управление временем, целенаправленность, гибкость, метакогниция.

AI-агент сопоставляет данные обоих слоёв через Cross-Reference Matrix, выявляет совпадения и противоречия между природными склонностями и текущим поведением, и формирует персонализированный отчёт.

Структура отчёта

Отчёт состоит из 12 секций:
1. Кто ребёнок по природе (элемент личности, ключевые черты)
2. Баланс элементов (распределение по сферам жизни)
3. Сильные стороны (что получается легко)
4. Зоны внимания (где нужна поддержка)
5. Внутренний конфликт (противоречия в карте или между BaZi и наблюдениями)
6. Сложности (в учёбе, общении, поведении)
7. Конкретные рекомендации (практические действия)
8. Как использовать сильные стороны
9. Чего избегать (типичные ошибки родителей)
10. Главное резюме для родителей

Архитектура

Проект состоит из трёх независимых компонентов:

┌─────────────┐    webhook JSON     ┌───────────────────────────────┐
│   Чатбот    │ ─────────────────▶  │        LLM Pipeline           │
│  (Telegram) │   EST + BaZi data   │                               │
└──────┬──────┘                     │  📊 EST Prompt                │
       │                            │         ▼                     │
       │                            │  🔮 BaZi Prompt               │
       │                            │         ▼                     │
       │                            │  🔗 Cross-Reference Prompt    │
       │                            │                               │
       │                            └───────────────┬───────────────┘
       │    callback: отчёт готов                   │
       └────────────────────────────────────────────┤
                                                    ▼
                                              ┌───────────┐
                                              │    БД     │
                                              └─────┬─────┘
                                                    │
                                                    ▼
                                              ┌───────────┐
                                              │ Mini-App  │
                                              │ (отчёты)  │
                                              └───────────┘

1. Чатбот (Telegram)

• Онбординг и согласие на обработку данных
• Сбор данных: класс ребёнка → EST-опросник (33 вопроса) → данные рождения
• Отправка данных на webhook LLM-сервиса
• Уведомление о готовности отчёта

2. LLM Pipeline (три промпт-функции)

Последовательность из трёх структурированных промптов для LLM:
- EST Prompt — обрабатывает ответы опросника, формирует промежуточный анализ исполнительных функций
- BaZi Prompt — рассчитывает карту по данным рождения, извлекает релевантные интерпретации из базы знаний
- Cross-Reference Prompt — сопоставляет EST и BaZi через матрицу соответствий, выявляет противоречия, генерирует финальный отчёт

3. Mini-App (Лендинг)

• Авторизация через Telegram
• Галерея отчётов пользователя
• Просмотр полного отчёта (HTML)

Возможности

• Опросник EST с 6 возрастными категориями (дошкольники, 1-3, 4-5, 6-9, 9-11 классы, взрослые)
• Подсказки для родителей к каждому вопросу
• Сохранение прогресса — можно продолжить незавершённый опрос
• Сбор данных о рождении ребёнка (имя, дата, место, время)
• Персонализированный отчёт с перекрёстным анализом
• Система обратной связи (оценка отчёта)

Технологии

• Python 3.11+
• python-telegram-bot v22 — Telegram Bot API
• aiosqlite — асинхронная работа с SQLite
• httpx — HTTP-клиент для вебхуков
• aiohttp — сервер для callback-уведомлений
• LLM — генерация отчётов через структурированные промпты
• Docker — контейнеризация

Как запустить

Локально

# Клонировать репозиторий
git clone https://github.com/AI-Talent-Camp-2026/familytech.git
cd familytech

# Создать виртуальное окружение
python -m venv venv
source venv/bin/activate  # Linux/macOS
# или venv\Scripts\activate  # Windows

# Установить зависимости
pip install -r requirements.txt

# Настроить переменные окружения
cp .env.example .env
# Отредактировать .env, указав TELEGRAM_BOT_TOKEN

# Запустить бота
python -m src.main

Docker

docker-compose up -d

Структура проекта

src/
├── bot/
│   ├── handlers/      # Обработчики команд и сообщений
│   ├── keyboards.py   # Клавиатуры (inline)
│   └── messages/      # Тексты сообщений
├── models/            # Модели данных (сессии, enum'ы)
├── persistence/       # Работа с базой данных
├── questions/         # Вопросы опросника (JSON)
├── services/          # Вебхуки, callback-сервер
└── main.py            # Точка входа

Контакты

• Telegram Bot: "Ниточка"-Бот
• Elena Dmitruk: @Dmicreator
• Dmitry Tarasov: @DMITRII_td8_travel
• Konstantin Gerasimov: @Konscig