_OpenSource Web4 agent & app starter kit_

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

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

[Войти](/login)
[Создать учётную запись](/register)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## С чего начать

- На этом компьютере зарегистрируйте первую учётную запись: она станет архитектором узла.
- Подключите свой домен: на временном адресе вход и регистрация закрыты.
- Добавьте ключ 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](https://lagrix.dev) и для любого web2-проекта, которому нужен вход. Лицензия MIT, код — [github.com/Fractera/fractera-auth-starter](https://github.com/Fractera/fractera-auth-starter).

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

**Нужно ли посетителю регистрироваться?**
Нет. Гостевой аккаунт появляется по запросу, и посетитель начинает без пароля; вход спрашивается только там, где он нужен маршруту.

**Как включить Google или Resend?**
Оба уже установлены. Внесите их ключи, и они появятся на экране входа; почта и пароль продолжают работать рядом.

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

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