#мамавыдохни: напоминания

Модуль проекта #мамавыдохни

Модуль экосистемы содержит раздел с галерей из атмосферных картинок, состоящих из успокаивающей фотографии на фоне и подбадривающими цитатами-аффирмациями поверх. В разделе настроек пользователь настраивает время, в которое ежедневно будут приходить уведомления с цитатой из галереи. При нажатии на пуш-уведомление открывается приложение с картинкой и соответствующей цитатой из пуша. Меню на экране предоставляет возможность сохранять картинки в избранное и сохранять любую картинку в альбом камеры в виде уникальных обоев для телефона.

Tech specs

• MVVM + R + State(два экрана синхронят данные между собой). Элементы Clean architecture
• Каждый экран выделен в отдельную сцену со своим окружением (Configurator, VM, Router)
• DI для каждой сцены со сбокрой через static объект
• Task management для возможности контроля задачи (при необходимости)
• Observing через собственную библиотеку
• Network через собственную библиотеку
• Backend - Supabase
• Local storage - Core data
• Local push notifications api
• UI кодом, UIKit
• Dark mode
• Custom navigation transitions

Features

• Плоский Navigation Flow, по схеме:
  
  Роутер 1 дергает Конфигуратор 2 и передает:

  1. Navigation container
     Обычный рут навигейшн контроллер. При необходимости Конфиг 2 может создать свой поток со своей навигацией, при этом храня или передавая дальше ссылку на рутовый контейнер для обратного Pop.
  2. Repository Container
     Из которого Конфиг 2 самостоятельно достает необходимый ему пул Репозиториев и создает полное окружение Сцены. Такая схема возможна благодаря Clean architecture подходу, где Бизнес сущности оформляются с собственным интерфейсом (Gateways), далее эти интерфейсы реализуют Репозитории, далее репозитории упаковываются в DI Repository Container, который просто хранит состояние и которого просто шарят между сценами.

  Такой подход позволяет исключить недостатки год объектов в виде Coordinator или DI инъектора, которые знают и рулят зависимостями всех сцен.

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

• DTO
  Для работы в репозитории выделены отдельные сущности с необходимым для осуществления локальной логики пулом параметров.

• Error handling
  У каждой бизнес сущности определены собственные Errors исходя из бизнес логики (работаем ли мы с сетью, даем пользователю возможность хранить данные локально, используем системные api и т.п.)
  Начиная с возникновения ошибки в Репозитории далее происходит ее маппинг в Ошибку бизнес слоя, которая далее передается в Презентейшн слой, в котором, в зависимости от сцены могут быть добавлены дополнительные действия (Actions), например - предложить пользователю загрузить данные снова, линк в настройки и т.п.

• Финальный продукт запакован в SPM и инъектися в основной проект, как обычный пакет.
  Практически вся реализация модуля остается приватной для изменений и вызовов из основного проекта. Точка входа - единственный публичный static метод, который возвращает готовый UIViewController

TODO

• Возможность работать полностью оффлайн
• Апнуть нотификации до Remote
• In app handling dark mode

Requirements

iOS 13.0 +
Xcode 13.2.1 +
Swift 5 +

HOW TO USE APP

Для загрузки обоев необходимо наличие интернет-соединения, данные загружаются атоматически.

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

Чтобы добавить новое Push уведомление с цитатой перейдите в настройки, далее раздел 'Уведомления' (требуется разрешить доступ приложения к Push уведомлениям на вашем устройстве). Нажмите на '+' чтобы добавить новое уведомление, цитата будет генерироваться автоматически. Нажав на появившееся окшко вы можете отредактировать время уведомления, а также удалить его. Максимальное количество допустимых уведомлений на устройстве - 30 шт.