Завершён

B2C-приложение с ML-анализом селфи

июль 2024 → авг 2026 (NDA)

Приложение для людей с акне. Пользователь снимает селфи с двух ракурсов, ИИ на сервере оценивает состояние кожи, а приложение собирает по результатам персональный план ухода: что наносить и когда, с напоминаниями. Вокруг плана живут уроки, достижения и ежедневные задания.

Я работал над приложением с июля 2024 по август 2026. Мои задачи: камера для селфи, реферальная программа, шторка оценки приложения, пуши и аналитика, доработки плана ухода и обновления платформы. Проект завершён.

Завершён

12:30

🚀305090

12:30

Статус: Проект завершён
Роль: Android-разработчик
Период: июль 2024 → авг 2026 (NDA)
Компания: KODE
Платформа: Android

Что я делал

UI Kit
Шторка, снекбар и WebView
- В проекте уже был UI Kit. Я добавлял в него то, чего не хватало моим фичам, и следил, чтобы новые компоненты выглядели в нём как родные.
- ModalBottomSheet: шторка с затемнением, ручкой и скруглёнными верхними углами. Она открывается в отдельном окне поверх экрана, учитывает вырез и системные панели и закрывается жестом «назад». На ней живёт шторка оценки приложения.
- Снекбар ошибки теперь показывает описание, а заголовок нужен только когда описания нет. Раньше они склеивались в одну длинную строку, и читать её было неприятно.
- Уроки и «Почему план такой?» это веб-страницы, поэтому я доработал WebView-компонент: включил JavaScript, добавил нужные настройки и логирование загрузок и ошибок.
- Потом разбирался, почему страницы иногда открывались пустыми. Сайт отвечает на адрес без слеша редиректом на канонический, а компонент принимал его за уход со страницы и отправлял в браузер. Теперь наружу уходит только то, что покидает хост текущей страницы: ссылка на маркетплейс открывается в браузере, tel: в звонилке, а канонический редирект остаётся внутри.
- Пустой адрес больше не загружается. Раньше WebView переходил на about:blank и прятал индикатор загрузки, пока настоящая страница ещё даже не начала открываться.
- Внешние ссылки открываются через AppLauncher. На телефоне без подходящего приложения теперь появится сообщение, а не падение.
/plan/plan/внутри
/out?to=shopдругой хостбраузер ↗
tel:+7…схема telзвонилка ↗
Камера и ML Kit
Селфи с двух ракурсов и лицо в овале
- Для анализа нужны два снимка: лицом чуть влево и чуть вправо. Приложение подсказывает ракурс и проверяет сам, что голова повёрнута на 10–45 градусов. Овальная маска и общий flow съёмки уже были в приложении.
- Я переписал захват на ProcessCameraProvider: Preview, ImageCapture и ImageAnalysis привязаны к одному жизненному циклу. Готового контроллера больше нет, зато видно, что и когда происходит с камерой, и можно подключиться к её внутренним данным.
- Каждый кадр проходит через ML Kit Face Detection с контуром и ориентирами лица. Контур из 36 точек я пересчитываю в координаты превью с учётом поворота кадра, масштаба и зеркала фронтальной камеры.
- Анализатор работает по стратегии «только последний кадр»: если распознавание не успевает, лишние кадры отбрасываются, а не копятся в очереди.
- В ноябре 2025 я выжимал из снимка максимум: JPEG 100, максимальное разрешение, HDR, шумоподавление и резкость в режиме высокого качества.
- Для отладки сделал скрытую панель поверх превью: контур лица, зоны маски и живые метрики. На ней настраивал пороги, не гоняя приложение по комнатам с разным светом.
bindToLifecycle
PreviewImageCaptureImageAnalysis
ML Kit Face Detection
contour36 pts
angleY+24°−24°
слевасправа
Свет и расстояние
Плохой кадр отсекается до съёмки
- ИИ не разглядит кожу в тёмном или далёком кадре, а до февраля 2026 такие фото уходили на сервер. Я добавил проверки, которые работают, пока человек ещё наводит камеру.
- Освещённость считаю сам. Из метаданных Camera2 (диафрагма, ISO, выдержка) вычисляю EV100. Данные приходят из session capture callback через Camera2 Interop, отдельный датчик света не нужен.
- Кадр считается тёмным, если EV100 ниже 4 или выдержка длиннее 1/15 секунды: с такой выдержкой из рук получается смаз. Тогда кнопка съёмки заблокирована, а в тулбаре написано «Слишком темно! Добавь света».
- Если света маловато, но снять можно (ISO выше 800 или компенсация экспозиции ниже −0,7 EV), кнопка работает, а подсказка мягкая: ИИ может не всё разглядеть.
- Расстояние оцениваю по площади лица: делю её на площадь кадра. Меньше 55% значит «Придвинь камеру ближе», и съёмка снова заблокирована.
- Проверки идут по приоритету: сначала дистанция, потом темнота, потом полумрак и только затем ракурс. Подсказка и цвет овала меняются вместе с состоянием.
- Сами проверки это обычные функции от чисел, без камеры внутри. Поэтому пороги читаются сразу и лежат рядом с формулами.
Придвинь камеру ближеСлишком темно! Добавь светаТемновато! ИИ может не всё разглядетьМожно снимать
лицо / кадр≥ 55%
EV100≥ 4
ISO 1250ISO 4001/15 s
Реферальная программа
Ссылки Branch.io, цели 30 / 50 / 90 и подарки
- Друг ставит приложение по ссылке, регистрируется и получает результаты анализа, а пригласивший копит скидку на продукцию. Условие в приложении сказано прямо: регистрация засчитывается только после первого результата.
- Ссылки делает Branch.io. SDK спрятан в модуле :lib:branch-io (api и impl), и остальное приложение о нём ничего не знает. Ссылка несёт реферальный код, а новый пользователь достаёт его из параметров, сохраняет и подставляет при регистрации.
- Самое тонкое здесь отложенный диплинк: код надо поймать, даже если ссылка сначала привела в магазин, а приложение открылось позже. Для этого я читаю первые параметры установки, а для уже установленного приложения разбираю интент в onStart, как просит документация SDK. Отдельным багом оказалось, что после обновления приложения пользователь мог остаться без кода. Починил.
- Экран программы строится вокруг слайдера, который я нарисовал на Compose Canvas: ракета на старте, подарки на ступенях 30, 50 и 90 и подписи, которые меняются от «Ещё чуть-чуть!» до «КОМБО! Чемпион».
- Цели, награды и даты акции приходят с сервера. Сначала скидки и сроки были зашиты в код, потом я заменил их данными из API.
- Награда это промокод со ссылкой, его можно скопировать прямо на экране. Ссылки на маркетплейс открываются в браузере, правила акции во встроенном WebView.
- Когда акция заканчивается, экран превращается в финальный: правила и список полученных промокодов. Пуш типа referral обновляет данные программы по тапу.
Branch.io
ссылкамагазинзапусккод
🚀🎁30🎁50🎁90
🎟скопировать ⧉
Оценка приложения
Шторка, которая не раздражает
- Просьба оценить приложение быстро надоедает, поэтому правил у неё больше, чем у самого экрана.
- Шторка появляется не сразу. Считаются дни активности, и впервые она показывается примерно на четвёртый день. За один день счётчик растёт один раз, сколько бы раз человек ни открывал приложение.
- Шторку можно отложить: тогда она вернётся не раньше чем через 14 дней. А оценённым приложение считается один раз и навсегда.
- Показ включается флагом в Firebase Remote Config, поэтому шторку можно выключить без релиза.
- Дальше развилка. «Нравится» запускает системный In-App Review Google Play, а затем предлагает поставить пять звёзд в магазине. «Не совсем» ведёт на шаг «Напиши, что именно не так» и открывает письмо с отзывом.
- Так плохой отзыв остаётся у команды и не уходит в магазин. Каждый шаг шлёт событие в AppMetrica: показ, положительная оценка, отрицательная и «отложено». Воронку видно целиком.
- Шаги шторки это три состояния в одном enum, а переходы между ними описаны MVI-автоматом. Добавить ещё один шаг несложно.
1день2день3день4день
Нравится приложение?
НравитсяНе совсем
И это взаимно 💚
⭐⭐⭐⭐⭐
Поставить 5 ⭐
Remote Configотложить: 14 днейодин раз
План ухода
«Почему план такой?» и работа с данными
- На вкладке ухода и экранах со средствами я занимался доработками и чинил то, что всплывало на живых пользователях. Вкладку «Уход» переименовали в «План» и добавили под планами пояснение.
- «Почему план такой?» открывает веб-страницу с объяснением, как собран план. Её нужно показывать самой, но так, чтобы не надоесть. Если объяснение есть, человек сегодня его не видел и ещё не показывали трижды, страница откроется сама. Счётчик и дата хранятся для каждого пользователя отдельно, поэтому второй аккаунт на том же телефоне не наследует чужую историю.
- Кнопка объяснения видна, только пока сервер его присылает. Если в ответе объекта нет, пропадает и кнопка. А у обновлённого плана подпись другая, чтобы было ясно, что в нём изменилось.
- В ссылку на объяснение добавляется промокод пользователя. Логику промокода я вынес из ухода в свой модуль :feature:promocode, потому что им пользуются уже и главная, и вкладка плана.
- Список средств обновляется при возврате на вкладку и после создания, архивации и правки средства. Кэш сбрасывается там, где данные раньше устаревали. Таких мелких, но неприятных багов на вкладке было немало, и я закрывал их по одному.
- В названии средства разрешил эмодзи, а перед проверкой обрезаю пробелы. Правила валидации поправил так, чтобы они не ругались на нормальные значения.
ПнВтСрЧт
Почему план такой?
?promo=…
лимит 3 / 3
счётчик для каждого пользователя0 / 31 / 32 / 33 / 3
Пуши, аналитика, конфиг
PushWoosh, AppMetrica, MyTracker и Remote Config
- PushWoosh я подключил отдельным модулем. Он регистрирует устройство, привязывает пользователя по id и email и при выходе или удалении аккаунта всё чистит. Сделанные привязки помечаются флагами, чтобы не слать одно и то же при каждом запуске.
- Дальше нужны были теги для рассылок: имя, «стартовые миссии пройдены» и название ссылки с объяснением плана. Название, а не саму ссылку. Два события, регистрация и открытие приложения, тоже уходят в PushWoosh.
- AppMetrica получила одиннадцать событий: регистрация, подтверждение селфи, пройденный опрос, завершённые стартовые миссии, шаринг достижения и ссылки на приложение, открытие объяснения плана и четыре события шторки оценки. В релизе регистрации тестовых пользователей отфильтрованы, чтобы они не портили цифры.
- До этого в проекте появился MyTracker. Я его интегрировал, потом убрал лишнее деление на слои и упростил события, а затем привёл аналитику AppMetrica к тому же набору, что и в MyTracker, чтобы данные можно было сравнивать.
- Firebase Remote Config подключил через интерфейс в core: приложение знает про RemoteConfig, а Firebase-реализация лежит в app. Через него, например, включается показ шторки оценки.
Remote Configdisplay_app_rate
app
registrationselfie_confirmsurvey_passedin_app_rate
AppMetrica
MyTracker
PushWoosh tags
Nameстартовые миссииссылка плана
✓ release: тестовые пользователи отфильтрованы
Платформа и сборка
targetSdk, 16 КБ, Billing и публикация сборок
- Подтягивал проект под требования Google Play. targetSdk прошёл путь с 34 до 35 и 36, Gradle поднял до 8.9. Библиотеки обновил до версий, которые работают со страницами памяти по 16 КБ.
- Подключил Google Play Billing и позже обновил его до 8.0.0. Таймауты HTTP-клиента поднял до 60 секунд: стандартных десяти не хватало долгим запросам, и они падали с ошибкой.
- Сборки уходят в Telegram через плагин публикации. Я убрал выгрузку в AppCenter, обновил плагин и чинил имена релизных сборок. Отдельно поправил заголовок с версией приложения, который в debug и release считался по-разному.
- Сделал сплеш-экран на системном Splash Screen API.
- Разбирал крэш в проде: навигационный сервис получал события жизненного цикла, когда активность уже закрывалась. Теперь они отправляются, только если навигация запущена и экран жив, а ошибку состояния мы логируем, а не падаем.
targetSdk
34дек 2024
35июль 2025
36авг 2026
16 KB pagesBilling 8.0.0Gradle 8.9Splash API
релизная сборкаTelegram ✓
if (!started || finishing || destroyed) return

Стек проекта

Язык

Kotlin

UI

Jetpack Compose
Compose Canvas
Accompanist
Coil
Lottie
WebView
Splash Screen API

Камера и ML

CameraX
Camera2 Interop
ML Kit Face Detection

Архитектура

MVI (Amvi)
Feature-модули: data · domain · routing · ui
Многомодульный Gradle
Coroutines / Flow
Remo
Way

DI

Dagger 2
Anvil

Данные и сеть

Retrofit
OkHttp
kotlinx.serialization
OpenAPI Generator
SQLDelight
Arrow
kotlin-result

Сервисы

Branch.io
PushWoosh
AppMetrica
MyTracker
Firebase Crashlytics
Firebase Remote Config
Google Play Billing
Play In-App Review

Качество и сборка

Detekt
ktlint
Convention-плагины
Публикация сборок в Telegram

Что я делал

UI Kit

Камера и ML Kit

Свет и расстояние

Реферальная программа

Оценка приложения

План ухода

Пуши, аналитика, конфиг

Платформа и сборка

Стек проекта

Язык

UI

Камера и ML

Архитектура

DI

Данные и сеть

Сервисы

Качество и сборка

Что я делал

UI Kit

Камера и ML Kit

Свет и расстояние

Реферальная программа

Оценка приложения

План ухода

Пуши, аналитика, конфиг

Платформа и сборка

Стек проекта

Язык

UI

Камера и ML

Архитектура

DI

Данные и сеть

Сервисы

Качество и сборка