# Сервис «Быт»

Обвязка для Telegram-агента «Быт» на платформе AI-агентов Timeweb Cloud.
Даёт агенту то, чего у платформы нет: **журнал с цифрами**, **точный православный календарь** и **напоминания по расписанию**.

## Из чего состоит

| Часть | Что делает |
|---|---|
| `app/mcp_server.py` | MCP-сервер «Журнал» — инструменты агента: записать еду/тренировку/отметку, прочитать итог дня, историю, настройки |
| `app/scheduler.py` | Планировщик: вечерний итог, напоминание о тренировке, «завтра постный день», личный график |
| `app/orthodox.py` | Пасха по формуле, посты, сплошные седмицы, двунадесятые праздники |
| `app/db.py` | Журнал в PostgreSQL (или SQLite для локальной проверки) |
| `app/telegram.py` | Отправка сообщений напрямую через Bot API |
| `app/agent.py` | Вызов агента Timeweb, чтобы вечерний итог был написан его голосом |
| `main.py` | Всё вместе: HTTP-сервис на порту 8080, `/mcp` закрыт токеном |

## Переменные окружения

См. `.env.example`. Обязательные: `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`, `MCP_TOKEN`, `DATABASE_URL`.
`AGENT_API_URL` и `AGENT_API_TOKEN` — по желанию: без них вечерний итог уходит сухой сводкой.

## Подключение к агенту

В панели агента → MCP-серверы → добавить: URL `https://<домен приложения>/mcp`,
транспорт Streamable HTTP, авторизация Bearer, токен = `MCP_TOKEN`.

## Расписание

Хранится в таблице `settings` и меняется агентом через инструмент `set_setting` — без перезапуска.
Планировщик проверяет настройки раз в минуту; каждое напоминание уходит один раз в день (таблица `reminders_sent`).

## Локальный запуск

```
pip install -r requirements.txt
MCP_TOKEN=test python main.py
```

Без `DATABASE_URL` журнал пишется в файл `byt.db` рядом.