Dog Journey: как собрать это в iOS
Интерактивный путь изучения своей собаки — без перегруза. Документ объясняет простым языком, из каких экранов состоит фича, как они работают и что нужно, чтобы их собрать. Все скриншоты — сгенерированные ч/б прототипы.
Одна идея, которую нельзя потерять
Пользователь не «проходит курсы» и не «заполняет разделы». Он шаг за шагом изучает свою собаку, и каждое новое знание сразу превращается в действие внутри приложения: сохранить вес, добавить вакцину, начать курс, записать наблюдение.
В исходной концепции всё это показано как одна большая карта, которую можно таскать и масштабировать. На телефоне так делать не стоит: гигантская карта красива на слайде, но в руке она превращается в мелкие кнопки и вопрос «где я?». Duolingo прошёл этот путь и отказался от свободного дерева навыков в пользу простой вертикальной дорожки — прохождение выросло.
Карта — это данные, а не экран. Граф блоков с зависимостями лежит в JSON. А интерфейс показывает его тремя «окнами» разной подробности: одна карточка «что делать сейчас» → дорожка ветки → обзор всей карты.
«Сегодня»
Главный экран. Одна рекомендованная карточка, ноль выбора. Сюда пользователь возвращается каждый день.
Дорожка ветки
Вкладка Journey. Три ветки, внутри каждой — вертикальный путь из блоков. Обычный скролл, крупные кнопки.
Обзорная карта
Вся карта одним взглядом, только для просмотра. Даёт ощущение масштаба пути — как и хотела команда.
Решение команды «карта видна целиком, включая будущие блоки» сохраняется: будущие блоки видны серыми на дорожке, а весь маршрут — на обзорной карте.
12 экранов, по порядку пользовательского пути
Каждый экран: что видит пользователь → как это работает → из чего собирать. Компоненты названы стандартными средствами SwiftUI — почти всё здесь нативное, без самописной графики. Важно: в блоках нет квизов — вместо них шаг «проверь на своей собаке», три варианта которого показаны на экранах 06–06в.
«Сегодня» — ежедневная точка входа
Что видит пользователь
Одну большую карточку «Recommended now»: какой блок пройти и почему он важен именно для его собаки. Ниже — «Продолжить», если бросил блок на середине, и три тонких полоски прогресса веток.
Как это работает
- Рекомендация всегда одна. Её выбирает простое правило: самая слабая метрика собаки → ближайший доступный блок этой темы.
- Никакого списка «всё, что можно сделать». Одна карточка = ноль паралича выбора.
Из чего собирать
ScrollView + VStack, карточки — обычные RoundedRectangle. Данные: поле recommended_block_id из манифеста карты.
Journey — выбор ветки
Что видит пользователь
Общий прогресс («6 из 21») и три ветки: Health & body, Mind & behavior, Breed & lifestyle. На рекомендованной ветке — метка «Recommended». Внизу — ссылка «View full map».
Как это работает
- Ветки параллельны: можно заниматься здоровьем и поведением одновременно — как зафиксировано в концепции.
- Daily routines в первой версии не отдельная ветка: её действия (питание, уход) встроены в блоки трёх основных веток. Отдельной веткой станет во второй версии.
Из чего собирать
List или VStack из трёх NavigationLink. Прогресс считается из статусов блоков, ничего отдельно хранить не нужно.
Дорожка ветки — сердце фичи
Что видит пользователь
Вертикальный путь из круглых узлов, как в Duolingo. Пройденные — закрашены с галочкой. Текущий — крупнее, с меткой «Now». Будущие — серые пунктирные с замочком, но с видимыми названиями: масштаб пути понятен заранее.
Как это работает
- Тап по любому узлу открывает шторку-превью (экран 04). По заблокированному — шторка объясняет, что пройти сначала.
- Экран открывается со скроллом к текущему узлу, а не к началу.
Из чего собирать
ScrollView + LazyVStack, соединительная линия — простая Shape между узлами. Никакого канваса, зума и физики. Это обычный список с красивыми ячейками — VoiceOver и Dynamic Type работают бесплатно.
Шторка-превью блока
Что видит пользователь
Ровно три строки: что узнает → почему это важно именно для его собаки → какое действие сделает. И кнопка «Start · 4 min» с честной оценкой времени.
Как это работает
- Персональная строка («Impulse Control 22 — самая слабая метрика») подставляется из AI-портрета собаки. Это то самое «почему блок важен для конкретного питомца» из концепции.
- Три строки — жёсткий лимит. Если хочется четвёртую, текст переехал из превью в теорию.
Из чего собирать
.sheet + presentationDetents([.medium]). Самый дешёвый экран документа.
Теория — карточки, а не статья
Что видит пользователь
3–5 карточек по 2–3 предложения, листаются свайпом. Одна мысль — одна карточка. Наверху точки прогресса, всегда виден выход.
Как это работает
- Правило объёма: блок целиком проходится за 3–5 минут. Если теория не влезает — это два блока, а не длинная теория.
- Формулировки — по правилам безопасности из концепции: без диагнозов, без ярлыка «агрессия».
Из чего собирать
TabView со стилем .page. Контент — из CMS/JSON, картинки — простые line-иллюстрации.
Квиз проверяет память («что ты запомнил про собак вообще») и в приложении уже приелся. Вместо него — шаг «Проверь на своей»: пользователь применяет только что изученное к собственной собаке одним тапом или жестом. Понимание проверяется применением, «неправильно» не существует, а каждый ответ становится датированной записью в профиле — растёт та самая «глубина профиля» из концепции. В блоке по-прежнему ровно одно взаимодействие: нагрузка не выросла, наоборот — работает узнавание, а не припоминание.
«Найди у своей» — визуальный самоскрининг
Что видит пользователь
3–4 крупные картинки-эталона из только что изученной теории (силуэты кондиции тела, оттенки дёсен, состояние шерсти) и один вопрос: «Что больше похоже на Q сейчас?» Один тап — готово.
Как это работает
- Это тот же чек понимания: чтобы выбрать, нужно распознать концепт из теории. Но ответ — не балл, а датированное наблюдение в профиле (кондиция тела, состояние шерсти).
- «Неправильно» не существует. Тревожный выбор мягко ведёт дальше: «стоит показать ветеринару на плановом визите» — без красных алармов.
- Обязательная подпись: «Это наблюдение, не диагноз».
Из чего собирать
3–4 переиспользуемых шаблона (карточки-эталоны, живая шкала-слайдер) на весь контент. Выбор пишется в профиль как observation с датой.
«Проверь прямо сейчас» — 30 секунд с собакой
Что видит пользователь
Одну карточку-инструкцию («Зажмите лакомство в кулаке — что сделает Q?», «Потрогайте уши — тёплые или горячие?») и три крупные кнопки-исхода. Любой исход раскрывает интерпретацию: «что это говорит о вашей собаке».
Как это работает
- Сильнейший вариант для Health-ветки: проверка понимания и реальное действие блока сливаются в один шаг — блок становится даже короче, чем с квизом.
- Обязательна честная кнопка «Q не рядом — напомнить позже» без чувства вины: блок сохраняется, вечером приходит мягкий пуш, проверка закрывается одним тапом.
- Только заведомо безопасные проверки; темы здоровья — с подписью «не заменяет ветеринара».
Из чего собирать
Карточка + три кнопки, отложенный пуш через UNUserNotificationCenter. Исход пишется в профиль как поведенческий маркер с датой.
«Прогноз» — сначала предскажи, потом проверь
Что видит пользователь
Один слайдер: «Сколько секунд Q выдержит команду "ждать"?» После ответа раскрывается ориентир для породы и возраста, и кнопка «Проверим?» ведёт прямо в действие блока.
Как это работает
- Прогноз создаёт личную ставку («а я угадал?») — любопытство вместо экзамена. Промах — не фейл, а интрига; большая дельта подаётся тепло: «теперь знаете точно».
- Дельта «ожидание/факт» — уникальные данные: насколько владелец знает свою собаку. Со временем из неё можно собрать отдельную метрику знакомства с питомцем.
- Вопросы — «на перенос» (применение, смежный факт), не дословно из теории, иначе это снова квиз.
Из чего собирать
Slider + карточка-раскрытие. Прогноз и факт пишутся парой в профиль.
Действие — момент, ради которого всё
Что видит пользователь
Нативную форму той функции, про которую только что была теория: сохранить вес, добавить вакцину, загрузить фото. Одно короткое пояснение, крупное поле, одна кнопка.
Как это работает
- Это существующие экраны приложения, открытые в контексте блока. Ничего нового не пишем — переиспользуем формы веса, вакцин, документов.
- Авто-зачёт: если данные уже есть (вес вносили раньше), показываем «Нашли 2 записи — засчитать автоматически». Правило из концепции: не заставлять вводить повторно.
- Без действия блок не считается пройденным — это главное отличие от «просто почитал».
Из чего собирать
Существующие формы + обёртка «шаг блока». Флаг завершения действия пишется в статус блока.
Результат — что изменилось и что дальше
Что видит пользователь
Галочку, список «что изменилось» (курс начат, вес добавлен в историю) и один следующий открывшийся блок с кнопкой «Continue».
Как это работает
- Показываем один следующий шаг, а не три. Хочет выбрать сам — вернётся на дорожку.
- Здесь же назначается отложенный возврат, если блок его предполагает: «взвесьте Q через 2 недели» → пуш → блок Progress review.
Из чего собирать
Простой экран + UNUserNotificationCenter для отложенного пуша. Лёгкая хаптика .success, без конфетти-шоу.
AI-расшифровка — самый первый блок
Что видит пользователь
Карточки-инсайты по метрикам его собаки: «Bond 55 — Q проверяет, где вы, на прогулке: хорошая ориентация на человека». В конце — «Recommended first» и кнопка «Show my path».
Как это работает
- Это первое, что человек видит после онбординга. Правило концепции: карта начинается с нового знания, а не с повтора анкеты.
- Текст генерируется один раз при создании собаки и кешируется. Формулировки проходят правила безопасности (мягкие, без диагнозов).
- Кнопка «Show my path» открывает дорожку — так пользователь впервые попадает на Journey уже понимая, почему маршрут именно такой.
Из чего собирать
Те же карточки-страницы, что и теория (TabView). Контент — один вызов LLM на регистрацию, хранится с профилем.
Обзорная карта — витрина масштаба
Что видит пользователь
Всю карту одним взглядом: три линии веток, закрашенное пройденное, метка «Now», чекпоинт, где ветки сходятся. Подпись «6 of 21 completed».
Как это работает
- Только просмотр: тап по узлу открывает ту же шторку-превью, никакого перетаскивания и зума.
- Это эмоциональный экран («сколько мы уже прошли!») и место, где видны связи между ветками. Открывается по кнопке — не является основной навигацией.
- Во вторую версию: шеринг картинкой — «путь Q за 3 месяца».
Из чего собирать
Один Canvas-рендер по заранее посчитанным координатам из манифеста. Строится за вечер, потому что интерактив минимальный.
Состояния блока
Ровно четыре состояния, как в концепции. Состояние не хранится — оно вычисляется из прогресса и зависимостей.
Флоу одного блока
Каждый блок — законченный мини-сценарий на 3–5 минут. Шесть шагов концепции складываются в пять экранов.
Карта — это один JSON-манифест
Манифест генерируется один раз при регистрации собаки (возраст, порода, метрики портрета) и дальше не перестраивается — меняются только статусы. Это в точности решение команды «карта стабильна».
{
"dog_id": "q-123",
"age_range": "puppy_4_8m",
"recommended_block_id": "impulse-control",
"branches": [
{
"id": "mind",
"title": "Mind & behavior",
"blocks": [
{
"id": "impulse-control",
"title": "Impulse control",
"needs": ["behavior-basics"], // что пройти сначала
"theory": "cms://impulse-101", // карточки теории
"check": {
"type": "predict", // или self_screen, hands_on
"content": "cms://impulse-predict",
"fallback": "self_screen" // если собака не рядом
},
"action": {
"type": "start_course", // или save_weight, add_vaccine...
"course_id": "impulse-course",
"auto_complete_if": "course_started" // правило авто-зачёта
},
"personal_note": "Impulse Control 22 — самая слабая метрика Q"
}
]
}
]
}
Статус блока приложение считает само: completed = теория + проверка «на своей» + действие; locked = не все needs закрыты; recommended = совпал с recommended_block_id; иначе available.
Что в первую версию, что потом
- Один возрастной диапазон (щенки), 3 ветки × 5–7 блоков
- Все экраны, кроме обзорной карты: «Сегодня», ветки, дорожка, шторка, флоу блока с проверками «на своей», AI-расшифровка
- Два шаблона проверки на старте: самоскрининг + проверка руками (прогноз — чуть позже)
- Рекомендация простым правилом (без ML)
- Только существующие функции приложения как действия
- Авто-зачёт, если данные уже есть
- Экран 10: обзорная карта + шеринг пути
- Чекпоинты слияния веток
- Daily routines как отдельная ветка
- Диалог с AI-кинологом внутри блоков
- Ещё форматы проверок: свайп AI-гипотез «Похоже на моего?», мини-сценарии «что сделаешь?», фото-чек с AI-разбором, «если—то» планы в финале ключевых блоков
- Пуш-петля возврата («взвесьте через 2 недели» → Progress review)
- Остальные возрастные диапазоны
Как поймём, что работает
Шесть показателей из концепции, переведённые в конкретные события аналитики.
| Событие | Что измеряет | Показатель из концепции |
|---|---|---|
| journey_opened | Открыл карту / вкладку Journey | Начало пути |
| ai_interpretation_completed | Дочитал AI-расшифровку до конца | Начало пути |
| block_started / block_completed | Начал и завершил блок целиком | Обучение |
| check_completed (type) | Сделал проверку «на своей» (самоскрининг / руками / прогноз); для прогноза пишется дельта ожидание/факт | Обучение + Глубина профиля |
| action_completed (type, first_time) | Сделал действие; first_time — впервые воспользовался функцией через Journey | Изучение функций |
| course_started_from_journey | Начал курс после объяснения проблемы | Практика |
| profile_records_added | Сколько данных о собаке появилось через карту | Глубина профиля |
| journey_return_d7 | Вернулся к карте в течение недели | Возврат |
Пользователь понимает, почему ему предлагают следующий шаг, открывает функции в правильном контексте и постепенно собирает полноценную историю своей собаки. Если действия не делаются (только чтение) — фича не работает, сколько бы блоков ни проходили.
Чеклист следующих шагов
- Утвердить структуру трёх веток и порядок первых 5–7 блоков в каждой (контент уже есть — берём из текущих материалов).
- Написать контент блоков для одного возрастного диапазона: теория-карточки, проверки «на своей» (эталоны-картинки, инструкции 30-секундных проверок, вопросы-прогнозы), персональные строки.
- Согласовать правила безопасных формулировок AI-расшифровки (без диагнозов, без ярлыков).
- Связать каждый блок с конкретным действием и правилом авто-зачёта.
- Собрать кликабельный прототип из этих 10 экранов и прогнать на 5–7 владельцах: понимают ли маршрут, делают ли действия.
- Разработка V1: манифест + дорожка + флоу блока (оценочно 3–4 недели одной паре iOS + бэкенд).
- Запуск на часть аудитории, смотрим воронку block_started → action_completed.