Fractera

Вход для каждого элемента вашего узла

Одна служба говорит каждому элементу, кто пришёл и с какими ролями. Почта и пароль работают сразу, гости появляются по запросу, а учётные записи остаются на вашем компьютере.

OpenSource Web4 agent & app starter kit

Как человек входит

  1. Страница спрашивает, кто пришёл

    Элемент передаёт cookie посетителя в /api/session и получает сессию с её ролями или 401.

  2. Служба проверяет вход

    Почта и пароль работают сразу; Google и волшебная ссылка Resend открываются, как только появятся их ключи.

  3. Остальное решают роли

    Четырнадцать ролей и гость, и каждый маршрут элемента сам говорит, кому его открывать.

  4. Элемент на своём домене

    Он впускает людей через единый вход: одноразовый код превращается в билет этого сайта.

Первая учётная запись, зарегистрированная на этом компьютере, навсегда становится архитектором узла.

Работает всегда

Узел никогда не выключает этот элемент: от него зависят остальные. Он запускается вместе с узлом и не засыпает, даже когда памяти мало.

Гости и два готовых провайдера

Гостевой вход встроен: гостевой аккаунт появляется по запросу и помнит, что посетитель делал в этом браузере, например наполовину собранную корзину. Число гостей ограничено: предел на один адрес и общий потолок, при котором первым уходит гость, дольше всех не заходивший.

Google и волшебная ссылка Resend уже установлены. Чтобы их включить, достаточно внести их ключи: код писать не нужно.

Что меняется для вас

Без негоСо службой входа
Каждый элемент строил бы свой входКаждый элемент спрашивает одну службу, кто пришёл
Наполовину собранная корзина посетителя теряетсяГостевой аккаунт помнит, что посетитель делал в этом браузере
Роли переписывают руками в каждое приложениеЧетырнадцать ролей и гость, заданные для каждого маршрута
Учётные записи лежат на чужом сервереОни остаются в одном файле на вашем компьютере, никогда в git

С чего начать

  1. 1

    На этом компьютере зарегистрируйте первую учётную запись: она станет архитектором узла.

  2. 2

    Подключите свой домен: на временном адресе вход и регистрация закрыты.

  3. 3

    Добавьте ключ Google или Resend, когда понадобятся эти способы входа; почте и паролю ничего не нужно.

Все учётные записи узла видны и меняются в ядре, на вкладке «Пользователи» этого элемента. Удаление стирает личные данные и сохраняет идентификатор и журнал.

Спросить, кто пришёл

Элемент узла спрашивает службу с cookie посетителя:

const r = await fetch(`${process.env.AUTH_SERVICE_URL}/api/session`, {
  headers: { cookie: request.headers.get('cookie') ?? '' },
})
const session = r.ok ? await r.json() : null // null — никто не вошёл

Гости появляются по запросу, и их число ограничено: предел на один адрес и потолок гостевых записей, при котором первым уходит гость, дольше всех не заходивший.

Что под капотом

NextAuth 5
Провайдеры, обратные вызовы, сессии и выход
SQLite
Один файл учётных записей, организаций и ролей на этом компьютере, никогда в git
/api/session
Кто пришёл и с какими ролями, или 401
/api/auth/sso
Единый вход для элемента на своём домене
82 языка
Каждый экран входа говорит на языке посетителя, прямо в странице
Приложения
В заводе приложений у каждого приложения свои люди: одна почта в двух приложениях — две учётные записи

Меняйте вход пораньше

Вход лучше менять в начале жизни приложения: это самая рискованная правка. Если вход сломается, никто не откроет защищённые маршруты, даже архитекторы, и восстанавливать его придётся через режим разработки.

Свой строитель в комплекте

Каждый элемент узла приходит со своим агентом Claude Code и может получить свой Telegram-бот. Нужно что-то поменять в этом элементе — напишите его боту с телефона, и агент обновит логику или дизайн.

Агент работает только в папке своего элемента и не читает весь узел, поэтому каждая правка стоит меньше токенов. Платит за неё ваша подписка Claude Code.

  • Бот элемента подключается в ядре, на его странице «Telegram».
  • Агент возвращает коммит; вы смотрите его в «Предпросмотре» и принимаете или отклоняете.
  • За компьютером терминал агента — в ядре, в разделе «Сборка» этого элемента.

Открытый код

Сделано Fractera для протокола Lagrix и для любого web2-проекта, которому нужен вход. Лицензия MIT, код — github.com/Fractera/fractera-auth-starter.

GitHub →

Вопросы и ответы

Нужно ли посетителю регистрироваться?
Нет. Гостевой аккаунт появляется по запросу, и посетитель начинает без пароля; вход спрашивается только там, где он нужен маршруту.
Как включить Google или Resend?
Оба уже установлены. Внесите их ключи, и они появятся на экране входа; почта и пароль продолжают работать рядом.
Кто становится архитектором?
Первая учётная запись, зарегистрированная на этом компьютере, навсегда. Создайте её до того, как подключите свой домен.
Где хранятся учётные записи?
В одном файле на вашем компьютере, никогда в git. Видны и меняются они в ядре, на вкладке «Пользователи» этого элемента.