Skip to content

About

Умный Холодильник & Шеф-Планер — офлайн-трекинг сроков годности продуктов (скан штрих-кодов, OCR чеков, локальные пуши) и планировщик меню на неделю с учётом КБЖУ, аллергий и диет. Без аналитики, серверов и аккаунтов.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Smart Fridge & Chef Planner

Умный Холодильник & Шеф-Планер — Flutter-приложение, которое решает две боли сразу: трекинг сроков годности продуктов (сканирование штрих-кодов и чеков + пуш за 1–2 дня до конца срока) и автоматическую генерацию персонального меню на неделю из того, что уже лежит в холодильнике, с учётом калоража, БЖУ, аллергий и диет. Меню и все данные — целиком на устройстве. Android · iOS · offline-first · без аналитики, серверов и аккаунтов.

Статус: активная разработка, v0.6.1 (все релизы — пре-релизы). Релиз идёт поэтапно по ТЗ: Шаг 1 (архитектура + база данных), Шаг 2 (AI-слой: встроенная база рецептов + локальный планировщик меню) и Шаг 3 (экраны, сканер штрих-кодов

  • OCR чеков, локальные пуши о сроках) — готовы. Детали — CHANGELOG.md.

Как это работает

Этап Что происходит
Онбординг профиля (один раз) Суточный калораж и БЖУ → аллергии → диета — можно несколько сразу (веган, пост, вегетарианское, низкоуглеводное, религиозные: халяль, кошер, без говядины/индуизм — ограничения объединяются) → число приёмов пищи в день → напоминания. «Пропустить» сохраняет разумные дефолты
Учёт продуктов Три пути: скан штрих-кода камерой (ML Kit, на устройстве), фото чека (OCR на устройстве — русский и латиница; названия можно поправить перед добавлением) или быстрый ручной ввод с типовым сроком хранения по категории. Новый код автоматически ищется в открытой базе Open Food Facts: название и категория подставляются сами (категория задаёт типовой срок); повторная покупка по тому же коду — «+1 шт» к количеству. QR-обмен: перед показом кода выбираете состав — все несъеденные, только скоропортящиеся (≤3 дней) или отмеченные вручную; один QR если данные влезают, серия — только если продуктов много; без сервера, аккаунтов и интернета (формат страниц Amnezia, до ~3000 продуктов)
Напоминания Локальные пуш-уведомления за 2 и/или 1 день до конца срока в выбранный час (работают офлайн, восстанавливаются после перезагрузки, мгновенно отменяются при съедении/удалении продукта)
Суперпланер (кнопка раз в неделю) Сначала съесть то, что портится → сверка с калоражем/БЖУ/аллергиями/диетами → разнообразие недели. Учитываются ГРАММЫ: ингредиент закрыт, только если продукта хватает по массе. На выходе: меню на 7 дней по приёмам пищи, пошаговые рецепты, суммы БЖУ по дням, список недостающих ингредиентов с оценкой «докупить ≈N г», карточка «почему некоторые рецепты не в меню». Кнопка «Приготовил» списывает использованные продукты из холодильника — скоропортящееся первым, с подтверждением и правкой штук; обнулившиеся уходят в «съедено»
Покупки Недостающие ингредиенты плана собираются в чек-лист с чекбоксами; купленное убирается одной кнопкой

Стадии разработки (поэтапная выдача по ТЗ)

Шаг Что входит Статус
1 Архитектура системы, схема БД v1 (products, user_profile), модели, DAO, логика свежести, оболочка приложения, тесты ✅ готов (v0.1.0)
2 AI-слой: встроенная база 541 рецепта (RU+EN), офлайн-планировщик RuleBasedPlanner (скоринг: аллергии/диета/сроки/калораж/разнообразие), IngredientMatcher, схема БД v2 + миграция, сохранение планов и список покупок, каркас локальной Gemma ✅ готов (v0.2.0)
3 Экран «Мой холодильник» с цветовой индикацией и CRUD, сканер штрих-кодов (ML Kit), OCR чеков с подтверждением позиций, экран «Мое меню» и покупки, онбординг профиля, локальные пуши за 1–2 дня, настройки напоминаний ✅ готов (v0.3.0)
3.1 Автопоиск по штрих-коду: название и категория из открытой базы Open Food Facts + локальный кэш (схема БД v3) — офлайн повторные сканы работают ✅ готов (v0.4.0)
3.2 Полировка после Шага 3: учёт граммов в планере, QR-обмен холодильником (без сервера, формат страниц Amnezia), списание «Приготовил» со схемой продуктов, аллергены «большая 14» ЕС и нелюбимые продукты, религиозные диеты, стабильная подпись APK ✅ готов (v0.4.1–v0.5.4)
3.3 Цены Пятёрочки (эксперимент, вкл. в настройках): автоподстановка цены по названию при добавлении продукта — поиск идёт прямо с устройства (5d.5ka.ru), показывается совпавший товар; при VPN/блокировке или без сети цена просто не подставляется ✅ готов (v0.5.5)
3.4 Источники цен по странам: Пятёрочка (Россия) / Kroger (США — официальный Public API, свои ключи пользователя, выбор магазина по ZIP) / Open Prices (весь мир — открытая база цен Open Food Facts по штрихкоду, без ключей); валюта подстановки ₽/$/€ ✅ готов (v0.5.6)
3.5 Расширенный список аллергенов в профиле (14 → 24): мёд, шоколад/какао/кофе, красные и оранжевые плоды, грибы, пряности (чеснок, корица), курица и птица, говядина, свинина, фрукты/крупы/овощи умеренной аллергенности; исключение блюд — по составу рецептов, без перегенерации базы ✅ готов (v0.5.7)
3.6 Источники цен — 6 стран: + Mercadona (Испания — открытый каталог, локальный индекс-кэш, складские цены), Aldi Süd (Германия — публичный поиск api.aldi-sued.de, цены полки), Wegmans (США — официальный API, свой subscription-key пользователя, выбор магазина); общий контракт v0.5.6, честные фолбэки ✅ готов (v0.5.8)
3.7 Лечебные диеты — столы по Певзнеру №1–15: выбор в профиле питания со справочником, жёсткий фильтр меню наравне с аллергиями, запреты по составу рецептов без перегенерации базы, схема БД v7 ✅ готов (v0.5.9)
3.8 Аудит 2026-10-28 (91 находка, волна 1 — 13 P2): CI на push (actionlint), защита базы при откате версии, per-ABI APK, пулы столов 4/12/13/14 и 13 новых безмолочных завтраков (554 рецепта), предупреждения о вырожденных слотах, аллергены ЕС 14/14 (ракообразные и моллюски раздельно, 25 чипов), SQLite вместо prefs для индекса цен, UTC-fallback будильников, переиспользуемый HTTP-клиент, честная маркировка OCR (латиница) ✅ готов (v0.6.0)
3.9 Волна 2 аудита (40 P3): фирменная иконка (adaptive Android + iOS), таймаут обрывает зависшие запросы, ключи Kroger/Wegmans в Keystore/Keychain, ключ Wegmans в заголовке, частичная сборка Mercadona с прогрессом и отменой, валидация QR-приёма, границы слов стоп-слов чека, IndexedStack, валюта в карточке (схема v9), ARB для единиц и ошибок, дисклеймер, флаг неофициальных источников, сброс deviceId, генераторы рецептов в репо, проверка версии в CI ✅ готов (v0.6.1)
3.10 Волна 3 аудита (38 P4) + русский OCR (OCR-1): Tesseract (tessdata_fast rus) как второй движок с автовыбором, валюта/количество/целые цены в парсере чека, детерминированный джиттер планера, живое звено LocalLlmPlanner, границы слов в dislikes, has_fish у ракообразных, гонка открытия БД, created_at профиля, пагинация истории планов, валидация path в URL, Wegmans promo→oldPrice, Aldi тысячи евро, маскировка ключа Wegmans, granted-права пушей, ISO-дата и resync пушей, QR-коллектор против «залипания», пауза автопрокрутки QR, TalkBack-действия, счётчик тестов в CI, UA/gradle/SECURITY/NOTICE актуализированы ✅ готов (v0.6.2)
3.11 Экспорт/импорт данных (Настройки → «Данные»): резервная копия одним JSON-файлом — продукты, профиль, планы с покупками, кэш штрих-кодов, не-секретные настройки; системный шаринг на экспорте, пикер на импорте, валидация до стирания, replace-all одной транзакцией с сохранением id; секреты Kroger/Wegmans в копию не попадают ✅ готов (v0.6.3)
3.12 Техника на кухне (онбординг + профиль): выбор духовки/блендера/тостера; требования выводятся из шагов рецептов на runtime; без техники блюдо предлагается с пометкой замены (духовка → плита, блендер → толкушка, тостер → сухая сковорода), большие духовочные блюда (4+ порций) исключаются жёстко; миграция БД v10 (user_profile.equipment), бэкап formatVersion 2 ✅ готов (v0.6.4)
3.13 Доступ к технике из настроек (репорт «нет вкладки»): отдельная плитка «Техника на кухне» в разделе «Профиль питания» со сводкой текущего списка и компактный экран редактирования (те же чипы v0.6.4, сохраняется только equipment); хотфикс VER-1 — kAppVersion догнала pubspec ✅ готов (v0.6.6)
3.14 Гриль и пароварка в технике (5 чипов) + разбор «всё ли заменяемо кастрюлей со сковородой»: гриль → сковорода, пароварка → кастрюля с крышкой (только пометка, не исключают); нерезервируемых рецептов в базе ровно два (печенье, шарлотка — уже отсекаются порогом 4+ порций); миграция списка техники v1→v2 (старые профили получают гриль/пароварку, новые пишут {"v":2,"owned":[…]} — снятые галочки переживают перезапуск) ✅ готов (v0.6.7)

Ключевые возможности

  • Offline-first и приватность — база SQLite, сканер, OCR и генерация меню целиком на устройстве; без аналитики, аккаунтов и серверов; облачные резервные копии Google отключены (allowBackup=false), перенос на новое устройство — экспорт/импорт резервной копии в Настройках → «Данные» (v0.6.3: один JSON-файл, без облаков). Сетевые запросы — только необязательные автопоиски: штрих-кода в открытой базе Open Food Facts, цены в выбранном магазине (Пятёрочка/Kroger/Open Prices/Mercadona/Aldi Süd/Wegmans — эксперимент, выключен по умолчанию; см. «Приватность и разрешения»); найденное кэшируется, без сети всё работает как раньше.
  • Экран «Мой холодильник» — карточки с цветной полосой свежести (зелёный / жёлтый ≤ 2 дней / красный) и легендой; поиск и сортировка (по сроку / имени / категории); свайп вправо «съел», влево «выбросить / удалить»; что съесть первым — видно сразу.
  • Сканер двух типов — штрих-коды (mobile_scanner + ML Kit: EAN-8/13, UPC, Code 128) и OCR чеков (OCR-1, v0.6.2: на устройстве два движка — Tesseract с русской моделью читает кириллицу, ML Kit latin — латиницу, движок выбирается автоматически по содержимому чека; фото никуда не отправляется); повторная покупка по тому же штрих-коду увеличивает количество «+1 шт»; незнакомый код — автопоиск названия и категории в открытой базе Open Food Facts с офлайн-кэшем (не нашлось — ручной ввод как раньше).
  • Локальные пуши за 1–2 дня до срока — настраиваемые дни и время, канал expiry_warnings, детерминированные идентификаторы (правка продукта мгновенно перестраивает расписание), восстановление после перезагрузки.
  • Цены магазинов (эксперимент, v0.5.6–v0.5.8) — включается в настройках, источник выбирается один: Пятёрочка (Россия — SAP-код магазина, поиск по названию прямо с устройства), Kroger (США — официальный Public API, бесплатные ключи самого пользователя, ZIP → выбор магазина), Open Prices (весь мир — открытая база цен Open Food Facts по отсканированному штрихкоду, без ключей), Mercadona (Испания — открытый каталог без ключей; индекс собирается на устройстве и кэшируется, складские цены), Aldi Süd (Германия — публичный поиск по всему ассортименту, цены полки, без ключей) или Wegmans (США — официальный API, бесплатный subscription-key пользователя, выбор магазина из ~110). Цена подставляется при добавлении продукта (видно, какой товар совпал) и видна в карточке холодильника; символ валюты следует источнику (₽/$/€…). Ввести вручную можно всегда. Неудача (VPN/блокировка/ нет сети/не настроено) — цена просто не подставится.
  • Лечебные столы по Певзнеру (v0.5.9) — в профиле питания можно отметить назначенные врачом столы №1–15 («№5 · Печень, жёлчный», «№9 · Диабет»…): планер исключит блюда с запрещёнными продуктами так же жёстко, как при аллергии, а в справочнике на экране видно, что означает каждый стол и что он исключает. Запреты работают по составу рецептов (без перегенерации базы), ограничения нескольких столов комбинируются. Диету назначает врач — приложение лишь помогает её соблюдать.
  • Локальный AI без ключей — «Суперпланер» работает через детерминированный офлайн-движок на встроенной базе 554 рецепта: сначала блюда с продуктами, у которых истекает срок, затем сверка с калоражем и БЖУ, без повторов блюд и гарниров; каркас локальной модели Gemma (MediaPipe) и платформенного AI (AICore / Apple Intelligence) сохранён в архитектуре провайдеров. Аллергии и диеты фильтрует слой валидации, а не модель — «отравить» меню некорректным ответом LLM нельзя.
  • Список покупок и предупреждения — недостающие ингредиенты плана собираются в чек-лист с чекбоксами; срочные продукты, не вошедшие в меню, выводятся в предупреждениях.
  • RU + EN — весь интерфейс на двух языках, выбор «системный / русский / english»; светлая, тёмная и системная темы Material 3.

Структура репозитория

Путь Назначение
lib/core/ Константы (пороги свежести, дни пушей) и логика свежести
lib/data/models/ Модели: Product, UserProfile, Recipe, GeneratedPlan + словари категорий/диет/аллергенов
lib/data/ Открытие БД, схема v6 и политика миграций; DAO продуктов, профиля, планов и кэша штрих-кодов
lib/ai/ Планировщик меню: RuleBasedPlanner, IngredientMatcher, RecipeRepository, каркас LocalLlmPlanner
lib/notifications/ Локальные пуши: чистая логика напоминаний, контракт планировщика + реализация, синхронизация desired ↔ pending
lib/scan/ Парсер чеков для OCR (эвристики строк, цены, количества, дубликаты); автопоиски: barcode_lookup (Open Food Facts) и pyaterochka_lookup (цены, эксперимент)
lib/state/ SettingsController (тема/язык/напоминания), ProductController, ProfileController, PlanController
lib/ui/ Экраны: холодильник, сканер, чек, меню, покупки, настройки, профиль, онбординг
assets/data/recipes.json Встроенная база рецептов (554 блюда, RU+EN, КБЖУ и аллергены)
lib/l10n/ ARB-источники RU/EN + сгенерированные локализации
docs/ARCHITECTURE.md Архитектура системы и дизайн AI-слоя и слоя уведомлений
docs/DATABASE.md Схема БД v9: таблицы, индексы, даты, миграции
test/ 512 тестов: данные (вкл. резервное копирование), планировщик, напоминания, парсер чеков, OCR-движки, автопоиски, контроллеры (реальная SQLite через sqflite_common_ffi). TEST-3, v0.6.2: фактическое число публикует CI — артефакт test_count
.github/workflows/ci.yml CI: analyze --fatal-infos + test --coverage; счётчик тестов — артефакт test_count (TEST-3)
.github/workflows/release.yml Релиз по тегу v*: analyze + тесты → три per-ABI APK SmartFridge-<версия>-<архитектура>.apk → GitHub Release (пре-релиз)
.github/workflows/codeql.yaml CodeQL (code scanning): security-анализ воркфлоу Actions, еженедельно + на пуш; Dart не поддерживается CodeQL и проверяется flutter analyze в CI
.github/social_preview.png Social preview репозитория; загружена в Settings → General → Social preview (GitHub рекомендует 1280×640 и сам масштабирует большие файлы, лимит 1 МБ)

Сборка из исходников

Требуется Flutter stable.

# 1. Клонировать
git clone https://github.com/RVMXL/SmartFridge-Chef.git
cd SmartFridge-Chef

# 2. Зависимости и локализация
flutter pub get
flutter gen-l10n

# 3. Запуск на устройстве/эмуляторе
flutter run

# 4. Юнит-тесты (реальная SQLite, эмулятор не нужен)
flutter test

# 5. Анализ
flutter analyze --fatal-infos

Платформы: Android 7.0+ (API 24), iOS 15.5+ (минимум ML Kit text recognition). Разрешения запрашиваются по мере появления соответствующих шагов: CAMERA — сканер и фото чеков, POST_NOTIFICATIONS — напоминания о сроках (Android 13+), точные будильники — с честным фолбэком на неточные.

Релизы

Новая версия: поднять version в pubspec.yaml → коммит → тег v* → пуш тега. Сборка и публикация пре-релиза происходят автоматически (Actions → Release): analyze и тесты, затем три APK по архитектурам в GitHub Release — качайте под своё устройство:

Файл Для чего Размер
SmartFridge-<версия>-arm64-v8a.apk большинство телефонов (2016+) ~49 МБ (с v0.6.2: +Tesseract OCR)
SmartFridge-<версия>-armeabi-v7a.apk старые устройства ~39 МБ (с v0.6.2: +Tesseract OCR)
SmartFridge-<версия>-x86_64.apk эмуляторы и ПК ~52 МБ (с v0.6.2: +Tesseract OCR)

С 0.5.10 универсальный APK (~104 МБ, все архитектуры сразу) больше не собирается: --split-per-abi кладёт в каждый файл только одну архитектуру.

git tag v0.5.5
git push origin v0.5.5

Приватность и разрешения

Приложение не имеет аналитики, рекламы, серверов и аккаунтов: всё хранится только в приватной папке приложения; облачные резервные копии Google отключены (allowBackup=false, данные не покидают устройство — включая перенос через Google). Сеть используется только для необязательных автопоисков: GET-запрос штрих-кода к открытой базе Open Food Facts, цены в выбранном магазине — по названию (Пятёрочка: 5d.5ka.ru прямо с устройства; Kroger: api.kroger.com с вашими личными ключами, созданными на developer.kroger.com и хранящимися только на устройстве; Mercadona: tienda.mercadona.es, каталог кэшируется на устройстве; Aldi Süd: api.aldi-sued.de, без ключей) или по штрихкоду (Open Prices — открытая база проекта Open Food Facts, без ключей) или с личным subscription-key (Wegmans: api.wegmans.io, ключ создаётся бесплатно на developer.wegmans.io и хранится только на устройстве). Наружу не передаётся ничего кроме текста запроса и анонимного идентификатора (Пятёрочка), который генерируется приложением и хранится локально; найденное сохраняется в локальную базу, без сети или при блокировке цена просто не подставляется. Товар не найден или сети нет — форма заполняется вручную, как раньше. Сканер и OCR работают локально (ML Kit), фото чека никуда не отправляется.

Разрешение Зачем
CAMERA Сканер штрих-кодов и фотографирование чеков; распознавание выполняется на устройстве (ML Kit)
INTERNET Необязательные автопоиски: штрих-кода в открытой базе Open Food Facts; цены в выбранном магазине — Пятёрочка (эксперимент, по умолчанию выключен; запрос с устройства, без ключей), Kroger (с личными ключами пользователя) или Open Prices (по штрихкоду, без ключей); результат хранится локально
POST_NOTIFICATIONS Локальные уведомления «срок истекает» за 1–2 дня (Android 13+)
RECEIVE_BOOT_COMPLETED Восстановление расписания напоминаний после перезагрузки
SCHEDULE_EXACT_ALARM / USE_EXACT_ALARM Точное время напоминаний; при запрете — неточный будильник без потери функции

Фото чеков и результаты OCR обрабатываются только в памяти и локальной базе устройства.

Права

© 2026 RVMXL. Исходный код публичного репозитория открыт для изучения, ознакомления и аудита; права коммерческого использования, распространения и создания производных работ вне функциональности GitHub не предоставляются. Скачиваемые APK — freeware для личного использования; обновления ставятся поверх предыдущих. Форки и пулл-реквесты допустимы условиями GitHub ToS (§D.5 — лицензия на использование контента через функциональность сервиса); иные способы использования согласуйте с автором. История лицензий: до переключения в v0.3.1 действовала Apache-2.0 — копии, полученные в том окне, сохраняют права Apache-2.0 (отзыв лицензии не ретроактивен). LEG-7 (v0.6.2): схема «личный ключ пользователя» для Kroger/Wegmans соответствует условиям их developer-программ (ключ создаётся и вводится самим пользователем, хранится только на его устройстве). LEG-10 (v0.6.2): при коммерциализации названия «Умный Холодильник» требуется проверка по реестру товарных знаков (Роспатент) — классы МКТУ 9/42 могут быть заняты; для freeware-релиза ограничений нет.

Приложение предоставляется «как есть», без каких-либо гарантий; автор не несёт ответственности за любой ущерб или проблемы, возникшие при использовании приложения.

  • Локальная модель Gemma (опционально, каркас подключён в архитектуре провайдеров) используется по условиям Google Gemma Terms of Use; файл модели не распространяется в репозитории.
  • В приложении используются сторонние библиотеки и компоненты (все — стандартные пакеты pub.dev / Flutter SDK): sqflite, provider, shared_preferences, path, http (MIT / BSD-3-Clause), mobile_scanner, google_mlkit_text_recognition, image_picker, flutter_local_notifications, qr_flutter, flutter_timezone, intl, flutter_localizations (BSD / Apache-2.0, правообладатели — Google LLC, Flutter team, Dart project authors, AlexTekartik, Remi Rousselet, Luke Freeman и др.). Полный список с лицензиями и условиями внешних источников данных — NOTICE.
  • Данные Open Food Facts — ODbL; цены Пятёрочки получаются напрямую с устройства пользователя (функция опциональна и выключена по умолчанию), приложение не аффилировано с X5 Group; товарные знаки Android, iOS, Google и X5 принадлежат их правообладателям.

Этот репозиторий — не форк; исходный код написан с нуля по ТЗ проекта.

About

Умный Холодильник & Шеф-Планер — офлайн-трекинг сроков годности продуктов (скан штрих-кодов, OCR чеков, локальные пуши) и планировщик меню на неделю с учётом КБЖУ, аллергий и диет. Без аналитики, серверов и аккаунтов.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages