1. Описание проекта
Общая идея
Проект представляет собой MVP-версию цифрового продукта Темпо в формате чат-бота. Он сочетает в себе управление задачами и практики восстановления.
Ключевая особенность — фокус не только на продуктивности, но и на состоянии пользователя. Бот помогает не просто планировать дела, а делать это без перегрузки и выгорания.
Решаемая проблема
Большинство таск-менеджеров ориентированы на эффективность и выполнение задач, но не учитывают уровень нагрузки и состояние человека.
В результате пользователи: — перегружают себя задачами; — игнорируют необходимость отдыха; — сталкиваются с выгоранием.
Проект решает эту проблему, добавляя в процесс планирования элементы восстановления в виде практик и напоминаний об отдыхе.
Функциональность
Ведение планера задач: Бот помогает пользователям организовывать задачи, устанавливать приоритеты и сроки выполнения. Все задачи можно быстро просматривать, редактировать и удалять.
Практики восстановления: Встроенная функция напоминаний для перерывов и восстановительных практик, таких как короткие физические упражнения или медитации, чтобы повысить общую продуктивность и благополучие пользователей.
AI-оценка нагрузки (демо-функция): В текущей версии бот анализирует расписание пользователя и помогает понять уровень нагрузки. Это позволяет вовремя заметить перегруз и скорректировать план.
Целевая аудитория
Проект ориентирован на фрилансеров, студентов и офисных работников, которым важно эффективно планировать задачи и не забывать о важности регулярных перерывов для поддержания энергии и мотивации. Бот также подойдёт для небольших команд, где важно синхронизировать задачи и обеспечивать правильный режим работы.
Структура проекта
Проект реализован в виде модульного Telegram-бота. Архитектура построена таким образом, чтобы разделить основные функции по отдельным файлам и упростить дальнейшее масштабирование и доработку.
Основные файлы
{bot.py} главный файл проекта — точка входа Здесь реализована логика взаимодействия с пользователем: обработка команд, маршрутизация сценариев и отправка ответов.
{config.py} файл конфигурации Содержит токены, пути к ресурсам и основные настройки бота. Позволяет централизованно управлять параметрами без изменения основного кода.
{task_manager.py} модуль для работы с задачами Реализует базовые операции: — создание задач — редактирование — удаление — получение списка Данные хранятся в JSON-файле, что упрощает MVP и не требует подключения базы данных.
{reminders.py} отвечает за систему напоминаний. Реализует логику отправки уведомлений пользователю, включая напоминания о задачах и восстановительных паузах.
{ai_analyzer.py} модуль AI-анализа. Используется для оценки нагрузки пользователя на основе списка задач. В MVP реализован в упрощённом виде (демо-логика + возможность подключения внешнего AI API).
Служебные файлы
{requirements.txt} список зависимостей проекта Содержит все используемые библиотеки и их версии. Используется для быстрого развёртывания проекта на сервере или другом устройстве.
{.env} файл переменных окружения Хранит чувствительные данные, такие как токены API и ключи доступа. Не включается в репозиторий для обеспечения безопасности.
{.gitignore} файл исключений Git Определяет, какие файлы и папки не должны попадать в репозиторий (например, .env, временные файлы, кэш).
Хранение данных
{data/data.json} локальное хранилище данных Используется в качестве простой базы данных для MVP.
Содержит: — список пользователей — задачи пользователей — базовую информацию для работы бота
Такое решение позволяет быстро запустить продукт без подключения полноценной базы данных.
Ресурсы проекта
{resources/audio/} аудио-практики восстановления Содержит аудиофайлы (например, дыхательные практики), которые бот отправляет пользователю.
{resources/images/} визуальные материалы Карточки и изображения, используемые для сопровождения практик и улучшения пользовательского опыта.
{resources/pdf/} методические материалы Файлы с чек-листами, трекерами и гайдами, которые пользователь может получить прямо в боте.
Общее назначение структуры
Текущая структура проекта выбрана с учётом разработки MVP и дальнейшего масштабирования.
Она позволяет: — быстро ориентироваться в коде — изолировать функциональные части — упрощать добавление новых модулей — постепенно переходить к более сложной архитектуре (например, с базой данных и API)
Технологический стек
{Python 3.10+} основной язык разработки Выбран из-за высокой скорости прототипирования и удобства работы с внешними библиотеками. Позволил быстро собрать MVP и сосредоточиться на логике продукта.
{python-telegram-bot ≥ 20.7} библиотека для работы с Telegram Используется для обработки сообщений, команд и построения сценариев взаимодействия. Упростила реализацию чат-интерфейса и работу с пользователем.
{JSON} способ хранения данных Применяется как лёгкое локальное хранилище. Позволил обойтись без базы данных на этапе MVP и ускорить разработку. При этом структура данных уже готова к масштабированию.
{OpenAI API (gpt-3.5-turbo)} AI-анализ нагрузки Используется для оценки расписания и определения риска выгорания. В проекте также предусмотрен демо-режим, чтобы бот мог работать без подключения API.
{JobQueue} встроенный планировщик задач Отвечает за регулярные напоминания пользователю. Позволяет реализовать фоновую логику без дополнительных сервисов.
{python-dotenv} управление конфигурацией Используется для хранения токенов и ключей в .env. Повышает безопасность и упрощает перенос проекта между средами.
{bothost.ru} хостинг Выбран как простое решение для быстрого развёртывания бота. Позволил запустить проект без сложной настройки инфраструктуры.
Архитектурные принципы
{Модульность} разделение логики по файлам Проект разбит на отдельные модули (бот, задачи, напоминания, AI-анализ), что упрощает навигацию по коду, поддержку и добавление новых функций без переписывания всей системы.
{Безопасность} изоляция чувствительных данных Токены и ключи API вынесены в .env и не хранятся в коде. Это снижает риск утечки данных и соответствует базовым практикам безопасной разработки.
{Отказоустойчивость} обработка ошибок и демо-режим В проекте предусмотрена обработка типовых ошибок и логирование. Также реализован демо-режим AI, который позволяет боту работать даже без подключения внешнего API.
{Масштабируемость} готовность к росту проекта Структура данных и разделение логики позволяют без серьёзных изменений добавлять новых пользователей, расширять функциональность и подключать дополнительные сервисы (например, базу данных или веб-интерфейс).
{Простота MVP} фокус на быстрой реализации Текущая архитектура сознательно упрощена (JSON вместо БД, polling вместо webhook), чтобы ускорить разработку и быстрее протестировать идею продукта на практике.
История разработки
{Этап 1 — Концепция и ТЗ} формирование основы проекта Запрос к ИИ был направлен на создание Telegram-бота с базовыми требованиями (условия, функции, работа с файлами). В результате получена первоначальная структура проекта и базовый каркас бота.
{Этап 2 — Уточнение идеи} переход от общего бота к продукту Изначальная идея была пересобрана в более узкую задачу — бот, который анализирует расписание и помогает избежать выгорания. Добавлена логика распределения нагрузки и внедрены первые практики восстановления.
{Этап 3 — Библиотека практик} добавление ценности продукта Сформирована база из 5 аудио-практик длительностью около 5 минут. Практики разбиты по категориям (утро, день, вечер, работа, экстренная помощь) и интегрированы в бота вместе с визуальными материалами.
{Этап 4 — УТП и позиционирование} формирование идеи продукта Сформулировано ключевое предложение: «снижение риска выгорания за 5 минут в день». УТП внедрено в тексты бота и конфигурацию, добавлены элементы брендинга.
{Этап 5 — Управление задачами} реализация основного функционала Добавлена полноценная система работы с задачами: — создание — просмотр — редактирование — удаление
Реализован пошаговый ввод и работа с контекстом пользователя.
{Этап 6 — Интеграция AI} интеллектуальный анализ Добавлен модуль анализа расписания. Реализовано два режима работы: — через AI API — демо-режим без API
Добавлена поддержка различных форматов входных данных (текст и файлы).
{Этап 7 — Напоминания} регулярное взаимодействие с пользователем Реализована система уведомлений:
3 фиксированных времени в день разные типы напоминаний (перерыв, движение, отдых) возможность отметить выполнение
{Этап 8 — Отладка и доработка} переход к стабильной версии В процессе разработки были решены ключевые проблемы: — ошибки зависимостей и импортов — некорректная работа с данными — проблемы запуска на хостинге — ошибки конфигурации (.env)
Этап показал важность логирования, проверки данных и корректной структуры проекта.
Итог разработки переход от идеи к работающему MVP Проект прошёл путь от общей идеи Telegram-бота до работающего MVP с задачами, практиками восстановления и элементами AI-анализа. Каждая итерация улучшала продукт и приближала его к реальному применению.
Итоги и выводы
Оценка вклада
{Сгенерировано ИИ ~75%} базовая реализация ИИ использовался для генерации основной структуры проекта, обработчиков команд и типовых функций. Это позволило быстро собрать рабочий каркас бота.
{Ручные доработки ~25%} ключевая логика и доведение до рабочего состояния Вручную дорабатывались критически важные части проекта: бизнес-логика, интеграция модулей, отладка и тестирование.
Ручные доработки и их обоснование
{Конфигурация} настройка окружения и параметров Были настроены пути, токены и переменные (включая УТП). Эта часть требует понимания инфраструктуры и не может быть полностью автоматизирована.
{Бизнес-логика} правила оценки нагрузки Разработана логика анализа риска выгорания. Это специфическая часть проекта, завязанная на идею продукта.
{Отладка} исправление ошибок Исправлялись ошибки типа KeyError и ImportError. Требовался анализ логов и понимание контекста работы программы.
{Тестирование} проверка пользовательских сценариев Проводилось вручную через Telegram. Позволило выявить реальные проблемы взаимодействия, которые невозможно увидеть на этапе генерации кода.
{Интеграция} объединение модулей Настроено взаимодействие между модулями (задачи, AI, напоминания). Требует понимания общей архитектуры системы.
{Контент} тексты и материалы Созданы тексты практик, напоминаний и УТП. Это авторская часть, формирующая ценность продукта.
Ключевые решения
{Polling вместо webhook} упрощение разработки Выбран режим polling, так как он проще в настройке и отладке на bothost.ru.
{Демо-режим AI} независимость от API Реализована возможность работы без API-ключа OpenAI, что делает продукт доступным без дополнительных затрат.
{JSON вместо базы данных} упрощение MVP Используется локальное хранение данных, что ускоряет запуск и снижает сложность разработки.
{Короткие практики (5 минут)} снижение барьера входа Формат практик выбран осознанно, чтобы пользователю было проще начать и не откладывать.
{Фокус на mental health} отличие от аналогов Проект делает акцент не на продуктивности, а на балансе и состоянии пользователя.
Итоги проекта
{Объём разработки} масштаб MVP Реализовано более 1500 строк кода, 5 модулей и более 30 функций.
{Функциональность} возможности бота Поддерживается более 10 команд, включая управление задачами, практики и напоминания.
{Контент} пользовательская ценность Добавлено 5 аудио-практик и 4 типа напоминаний для поддержки пользователя.
{Сроки} скорость реализации Полный MVP разработан примерно за 2 недели.
Извлечённые уроки
{Роль ИИ} ускорение, но не замена ИИ значительно ускоряет разработку, но требует понимания кода для доработки.
{Логирование} критически важный инструмент Без логов невозможно эффективно отлаживать проект, особенно на хостинге.
{Модульность} удобство развития Разделение на модули сильно упрощает внесение изменений и добавление новых функций.
{Демо-режимы} снижение зависимости Позволяют тестировать и использовать продукт без затрат на внешние сервисы.
{Реальное тестирование} обязательный этап Проверка в реальных условиях выявляет проблемы, которые не видны в теории.
Планы развития
{Аналитика} визуализация данных Добавление графиков и статистики (например, через matplotlib).
{Интеграции} расширение возможностей Экспорт расписания в Google Calendar.
{Социальные функции} совместные практики Реализация групповых сессий и взаимодействия между пользователями.
{Здоровье} работа с трекерами Интеграция с устройствами вроде Oura и Fitbit.
{Веб-версия} расширение интерфейса Создание отдельного веб-интерфейса для удобной работы с продуктом.
