Управление пользователями через GraphQL

Типичный сценарий

1. Создать заметку с subgraph: name во фронтматтере → синхронизировать → подграф появится в системе
2. createUser(email) → получить userId
3. allSubgraphs → получить subgraphIds
4. createUserSubgraphAccess(userId, subgraphIds) → открыть доступ к контенту
5. При необходимости createAdmin(userId) → полные права администратора

Шаг 1. Создать пользователя

mutation {
  admin {
    createUser(input: { email: "user@example.com" }) {
      __typename
      ... on CreateUserPayload {
        user { id email }
      }
      ... on ErrorPayload { message }
    }
  }
}

В ответе — id нового пользователя. Он нужен во всех последующих мутациях.

Шаг 2. Получить ID подграфов

Подграфы создаются при синхронизации заметки, в которой объявлен подграф во фронтматтере:

---
subgraph: premium
---

Или несколько сразу:

---
subgraphs: [premium, beta]
---

После синхронизации из Obsidian подграф появляется в системе. Получить список подграфов с их ID:

{ admin { allSubgraphs { nodes { id name } } } }

Шаг 3. Открыть доступ к подграфу

mutation {
  admin {
    createUserSubgraphAccess(input: {
      userId: 6
      subgraphIds: [1]
      expiresAt: null
    }) {
      __typename
      ... on CreateUserSubgraphAccessPayload {
        accesses { id userId subgraphId expiresAt }
      }
      ... on ErrorPayload { message }
    }
  }
}

subgraphIds — массив: в одном вызове можно открыть доступ к нескольким подграфам. Чтобы доступ был постоянным, передайте null в expiresAt или не указывайте его вовсе. Для временного доступа — метка времени в формате ISO 8601.

Шаг 4. Назначить администратора (необязательно)

mutation {
  admin {
    createAdmin(input: { userId: 6 }) {
      __typename
      ... on CreateAdminPayload {
        admin { id user { id email } }
      }
      ... on ErrorPayload { message }
    }
  }
}

Статус администратора даёт полный доступ к панели управления и всем GraphQL-мутациям. Используйте его для участников команды, которые управляют сайтом, — но не для обычных подписчиков.

Внимание: заметки без подграфа видны всем авторизованным пользователям

По умолчанию любая заметка без subgraph или subgraphs во фронтматтере доступна каждому вошедшему пользователю — включая тех, кому вы выдали доступ только к одному конкретному подграфу.

Решение: спрятать неназначенные заметки за системный подграф.

Создайте vault-based frontmatter patch (_private.md или аналогичный):

---
type: frontmatter-patch
include: ["**"]
priority: 0
---

if !std.objectHas(meta, 'subgraph') && !std.objectHas(meta, 'subgraphs')
then meta + { subgraph: 'notes_without_subgraph' }
else meta

Это присваивает каждой незамеченной заметке подграф notes_without_subgraph. Поскольку никому не выдаётся доступ к нему, эти заметки невидимы для обычных пользователей. Администраторы видят всё независимо от подграфов.

Полный синтаксис патчей — в ru/user/frontmatter_patches.

Пример: поделиться одной страницей по email

Нужно дать кому-то доступ к одной конкретной заметке — без доступа ко всему сайту. Простой способ:

1. Создайте заметку

shares/alice/intro.md

Фронтматтер:

---
subgraph: alice
---

Синхронизируйте из Obsidian. Подграф alice появится автоматически.

2. Добавьте пользователя

# Создать пользователя
mutation { admin { createUser(input: { email: "alice@example.com" }) {
  ... on CreateUserPayload { user { id } }
} } }

# Получить ID подграфа (ищите name = "alice")
{ admin { allSubgraphs { nodes { id name } } } }

# Выдать доступ
mutation { admin { createUserSubgraphAccess(input: { userId: <id>, subgraphIds: [<subgraphId>] }) {
  ... on CreateUserSubgraphAccessPayload { accesses { id } }
} } }

3. Напишите пользователю

Привет, Алиса!

Я открыл тебе доступ к странице: https://yoursite.com/shares/alice/intro

Перейди по ссылке и войди с этим адресом — на почту придёт одноразовый код, пароль не нужен.

Готово. Алиса видит только подграф alice. Добавляйте новые заметки в shares/alice/ по мере необходимости.

Альтернатива: поделиться без логина

Если контроль доступа не нужен — достаточно ссылки, которую сложно угадать — используйте free: true:

shares/a3f7c2d1-invoice-may.md

---
free: true
created_at: 2026-05-25
expires_at: 2026-06-25
---

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

expires_at — пока только метаданные. В будущем удобно для автоматической очистки: крон скрывает или удаляет просроченные шары.

Вспомогательные запросы

Если id пользователя или подграфа неизвестен, найдите их заранее.

# Найти ID пользователя по email
{ admin { allUsers { nodes { id email } } } }

# Список подграфов с их ID
{ admin { allSubgraphs { nodes { id name } } } }

# Проверить текущие доступы пользователя
{ admin { allUserSubgraphAccesses { nodes { id userId subgraphId expiresAt } } } }