Первоначальная настройка

Когда вы впервые входите на app.engram.page, Engram проводит вас через короткий мастер настройки, прежде чем открыть хранилище. Мастер нужен потому, что Engram требует принятия Условий и действующего состояния подписки, прежде чем станут доступны конечные точки хранилища.

Что охватывает мастер

Мастер состоит из двух шагов:

Соглашение. Примите Условия использования и Политику конфиденциальности. Это фиксируется в серверной таблице user_agreements для действующей на данный момент версии Условий. Актуальная версия определяется динамически из таблицы terms_versions (с запоминанием в Engram.Legal.VersionCache), а не задана константой при компиляции.
Оплата. Выберите план и завершите оплату через Paddle (или выберите Free, который полностью обходит Paddle). О том, что входит в каждый план, см. Оплата → Тарифы.

Когда оба шага завершены, вы попадаете в обозреватель хранилища.

Почему это закрывает доступ к хранилищу

Сервер оборачивает /api/notes, /api/search и /api/folders плагином RequireOnboarding, который проверяет:

Что последние Условия приняты этим пользователем
Что подписка в порядке (либо самостоятельный хостинг, который полностью обходит эту проверку)

Если любая из проверок не пройдена, API возвращает 403, и веб-приложение перенаправляет обратно в мастер. Так вы не можете случайно оказаться в сломанном наполовину настроенном состоянии: проверка либо пропускает вас, либо показывает экран, на котором решается недостающий шаг.

Пропуск мастера (самостоятельный хостинг)

При самостоятельном хостинге оплата по умолчанию выключена (нет PADDLE_API_KEY → config :engram, :billing_enabled равно false). Мастер пропускает шаг выбора плана. Условия вы всё равно принимаете один раз.

Повторный запуск мастера

Запустить его повторно вручную нельзя; после принятия вы его уже прошли. Если Условия меняются, Engram повышает версию на сервере, и следующий вызов API возвращает 403; приложение снова показывает только шаг принятия Условий. Смена плана происходит на странице Оплата, а не в мастере.