DogAgent — Документация

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

DogAgent — это веб-приложение, работающее прямо в браузере. Никакой установки не требуется. Всего три шага для начала работы:

1

Откройте приложение

Перейдите на dashboard.html или нажмите «Открыть приложение» на главной странице. Данные автоматически сохраняются в localStorage вашего браузера.

2

Добавьте питомца

Перейдите в раздел «Мои питомцы» и нажмите «+ Добавить питомца». Укажите имя, породу, возраст и вес.

3

Настройте расписание

В разделе «Расписание» создайте события кормления и прогулок. Система начнёт отправлять напоминания автоматически.

ℹ️

Разрешите уведомления браузера

Для получения push-уведомлений о прогулках и кормлении разрешите уведомления браузера в Настройках → «Разрешить уведомления браузера».

Управление питомцами

Раздел «Мои питомцы» — центральная точка управления вашими животными. Здесь хранится вся информация о каждом питомце и статистика ухода.

Профиль питомца

Каждый питомец имеет следующие атрибуты:

Поле	Тип	Описание	Обязательное
emoji	string	Иконка питомца (выбирается из набора)	Опционально
name	string	Имя питомца	Обязательное
breed	string	Порода или вид животного	Опционально
age	string	Возраст питомца (например: "2 года")	Опционально
weight	number	Вес в килограммах	Опционально
lastWalk	string	Время последней прогулки (ЧЧ:ММ)	Auto
lastFeed	string	Время последнего кормления (ЧЧ:ММ)	Auto

Действия с питомцами

🍖

Кормление

Нажмите «Покормить» на карточке питомца. Система запишет время кормления и увеличит счётчик на 1.

🚶

Прогулка

Нажмите «Прогулка» для записи прогулки с текущим временем. Счётчик прогулок обновится.

🗑️

Удаление

Нажмите ✕ в правом верхнем углу карточки. Система запросит подтверждение.

➕

Добавление

Кнопка «+ Добавить питомца» или кликните на пунктирную карточку в конце списка.

💡

Совет

Для быстрого кормления и прогулки можно использовать раздел «Обзор» → «Быстрые действия» или меню на дашборде.

Расписание

Планировщик событий позволяет создавать повторяющиеся и разовые задачи для каждого питомца. AI анализирует расписание и оптимизирует распорядок дня.

Типы событий

Иконка	Тип	Описание
🚶	Прогулка	Выгул питомца на улице
🍖	Кормление	Плановое кормление по расписанию
💊	Лечение	Приём лекарств и процедуры
🏥	Ветеринар	Визит к ветеринарному врачу
🛁	Купание	Гигиенические процедуры
✂️	Стрижка	Стрижка шерсти и когтей
🎾	Игра	Тренировки и активные игры

Статусы событий

Каждое событие имеет один из трёх статусов:

          Статусы
        
done     → Выполнено (отмечается вручную)
upcoming → Ожидается (запланировано на будущее)
missed   → Пропущено (событие прошло без отметки)

⚠️

Автоматическая проверка расписания

Система проверяет расписание каждую минуту и отправляет уведомления при наступлении времени события. Убедитесь, что уведомления браузера разрешены.

Система уведомлений

DogAgent использует несколько каналов уведомлений для напоминания о событиях. Система работает на основе расписания и AI-анализа поведения питомцев.

Типы уведомлений

🚶

Прогулки

Напоминание при наступлении времени прогулки или если прошло слишком много времени с последней.

🍖

Кормление

Уведомление по графику кормления. За час до события и в момент наступления.

🤖

AI-советы

Ежедневные рекомендации от AI на основе анализа активности и состояния питомца.

💊

Ветеринар

Напоминания о плановых осмотрах, вакцинациях и приёме лекарств.

Настройка уведомлений

В разделе «Уведомления» можно включить или отключить каждый тип уведомлений отдельно. В разделе «Настройки» — задать тихий режим (временной промежуток без уведомлений).

          JavaScript
          
        
// Запрос разрешения на уведомления браузера
if ('Notification' in window) {
  Notification.requestPermission().then(permission => {
    if (permission === 'granted') {
      new Notification('DogAgent', {
        body: '🐾 Время прогулки с Бобиком!',
        icon: 'logo.png'
      });
    }
  });
}

AI-Ассистент

Встроенный AI-ассистент помогает отвечать на вопросы об уходе за питомцами 24/7. Система обрабатывает запросы на естественном языке и даёт персонализированные рекомендации.

Доступные темы

Тема	Ключевые слова	Пример вопроса
Питание	корм, кормление, еда	Сколько раз в день кормить собаку?
Прогулки	прогул, гулять, выгул	Как часто гулять с щенком?
Вакцинация	вакцин, прививк	Какие вакцины нужны кошке?
Здоровье	ест, болезнь, симптом	Признаки болезни у кошки
Воспитание	туалет, щенок, обучен	Как приучить щенка к туалету?
Вес	вес, ожирен, похуд	Как определить нормальный вес?

💡

Используйте быстрые вопросы

В правой панели чата есть кнопки с часто задаваемыми вопросами. Нажмите любую для мгновенного ответа.

API: Авторизация

DogAgent REST API использует Bearer Token авторизацию. Получите токен при регистрации или в настройках аккаунта.

HTTP

Authorization: Bearer your_api_token_here
Content-Type: application/json

POST /api/v1/auth/token Получить токен

Request Body

{
  "email": "user@example.com",
  "password": "your_password"
}

API: Питомцы

Управление профилями питомцев через REST API.

GET /api/v1/pets Список питомцев

Response
{
  "pets": [
    {
      "id": 1,
      "name": "Бобик",
      "breed": "Лабрадор ретривер",
      "age": "3 года",
      "weight": 28,
      "lastWalk": "14:30",
      "lastFeed": "13:00"
    }
  ]
}

POST /api/v1/pets Создать питомца

Request Body
{
  "name": "Мурка",          // Обязательное
  "breed": "Британская",    // Опционально
  "age": "2 года",          // Опционально
  "weight": 4.5,            // Опционально
  "emoji": "🐈"            // Опционально
}

PUT /api/v1/pets/{id} Обновить питомца

DELETE /api/v1/pets/{id} Удалить питомца

POST /api/v1/pets/{id}/feed Отметить кормление

POST /api/v1/pets/{id}/walk Отметить прогулку

API: События

Управление расписанием событий для питомцев.

GET /api/v1/events Список событий на день

POST /api/v1/events Создать событие

Request Body
{
  "type": "walk",        // walk | feed | vet | med | bath
  "petId": 1,
  "title": "Вечерняя прогулка",
  "time": "18:00",
  "repeat": "daily"     // once | daily | weekly
}

PUT /api/v1/events/{id}/complete Отметить выполненным

DELETE /api/v1/events/{id} Удалить событие

API: Уведомления

GET /api/v1/notifications Список уведомлений

PUT /api/v1/notifications/{id}/read Отметить прочитанным

PUT /api/v1/notifications/read-all Все прочитанными

PUT /api/v1/notifications/settings Настройки уведомлений

Request Body
{
  "walk": true,     // Уведомления о прогулках
  "feed": true,     // Уведомления о кормлении
  "ai": true,       // AI-советы
  "vet": false,    // Уведомления о ветеринаре
  "quietFrom": "22:00", // Начало тихого режима
  "quietTo": "08:00"    // Конец тихого режима
}

Коды ответов

Код	Значение
200	Успех
201	Создано
400	Неверный запрос
401	Не авторизован
404	Не найдено
429	Слишком много запросов
500	Ошибка сервера

Часто задаваемые вопросы

Почему уведомления не приходят? ▼

Убедитесь, что вы разрешили уведомления браузера в Настройках → «Разрешить уведомления браузера». Также проверьте настройки уведомлений операционной системы и что вкладка с DogAgent открыта.

Мои данные сохраняются? ▼

Данные сохраняются в localStorage вашего браузера автоматически. Они сохраняются между сессиями, но привязаны к конкретному браузеру и устройству. Для синхронизации между устройствами используйте облачный аккаунт (Pro и Premium планы).

Сколько питомцев можно добавить? ▼

Бесплатный план: 1 питомец. Pro план: до 5 питомцев. Premium план: неограниченное количество питомцев. Обновить план можно в разделе Настройки → Тарифный план.

Как работает AI-ассистент? ▼

AI-ассистент анализирует ваш запрос на естественном языке и определяет тему вопроса. Ответы основаны на базе знаний о содержании питомцев, составленной совместно с ветеринарами. AI учитывает данные ваших питомцев для персонализированных рекомендаций.

Как настроить тихий режим? ▼

Перейдите в Настройки → блок «Уведомления». Укажите время начала и окончания тихого режима. В этот промежуток уведомления будут копиться и доставляться после его окончания.

Можно ли удалить аккаунт? ▼

Для удаления аккаунта обратитесь в поддержку через раздел «Поддержка» на главной странице. Все данные будут безвозвратно удалены в течение 30 дней.

История версий

v2.1.0 New

Март 2026

Добавлен улучшенный AI-ассистент с персонализированными ответами
Тёмная тема с медными акцентами и glassmorphism интерфейсом
Система быстрых действий на дашборде
Минимальный календарь в разделе расписания
Анализ активности питомцев с графиками

v2.0.0

Январь 2026

Полный редизайн интерфейса
Добавлена поддержка нескольких питомцев
Push-уведомления в браузере
REST API для интеграций

v1.5.0

Октябрь 2025

AI-ассистент первой версии
Базовые уведомления о кормлении
Профили питомцев

v1.0.0

Июль 2025

Первый публичный релиз
Базовое расписание кормления
Один питомец на аккаунт

DogAgent
Документация

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

API Reference

FAQ

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

Откройте приложение

Добавьте питомца

Настройте расписание

Разрешите уведомления браузера

Управление питомцами

Профиль питомца

Действия с питомцами

Кормление

Прогулка

Удаление

Добавление

Совет

Расписание

Типы событий

Статусы событий

Автоматическая проверка расписания

Система уведомлений

Типы уведомлений

Прогулки

Кормление

AI-советы

Ветеринар

Настройка уведомлений

AI-Ассистент

Доступные темы

Используйте быстрые вопросы

API: Авторизация

API: Питомцы

API: События

API: Уведомления

Коды ответов

Часто задаваемые вопросы

История версий

DogAgentДокументация

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

API Reference

FAQ

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

Откройте приложение

Добавьте питомца

Настройте расписание

Разрешите уведомления браузера

Управление питомцами

Профиль питомца

Действия с питомцами

Кормление

Прогулка

Удаление

Добавление

Совет

Расписание

Типы событий

Статусы событий

Автоматическая проверка расписания

Система уведомлений

Типы уведомлений

Прогулки

Кормление

AI-советы

Ветеринар

Настройка уведомлений

AI-Ассистент

Доступные темы

Используйте быстрые вопросы

API: Авторизация

API: Питомцы

API: События

API: Уведомления

Коды ответов

Часто задаваемые вопросы

История версий

DogAgent
Документация