Read in:
Русский

Сеть баз вместо одного общего пространства

Эта страница объясняет идею, на которой в trip2g построена федерация. Обычно командные инструменты складывают заметки всех в одно общее пространство и потом делят его правами. trip2g делает наоборот: у каждого владельца своя база, а базы соединены связями, по которым проходит только то, что владелец выдал. Прочитав страницу, вы сможете решить, одна база вам нужна или несколько, и будете точно знать, что читает сосед после спаривания. Как спаривать базы, описано на странице MCP-федерация.

В этой статье:

Два способа держать общие знания

Одно общее пространство Сеть баз
Где лежат заметки В одном месте, у одного вендора или одного администратора В базе каждого владельца: markdown-файлы и один экземпляр trip2g
Кто решает, что прочитает коллега Администратор пространства, страница за страницей Владелец той базы, которую читают
Что новичок видит по умолчанию То, что пространство показывает участникам У соседа ничего, пока сосед сам не выдаст
Кому мешает неубранный угол Поиску и навигации всех Его владельцу
Как найти нужное Один поиск по всему, что вам доступно Поиск, который спрашивает каждую спаренную базу
Что нужно администрировать Участников и права на страницы Пару ключей на каждые две базы, которые общаются

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

База в trip2g — это один экземпляр со своими заметками, своими читателями и своим администратором. Между двумя экземплярами нет ничего общего, пока оба владельца это не настроят.

Что такое связь

Связь соединяет две базы в одном направлении. Это пара ключей с одним идентификатором: исходящий ключ на базе, которая спрашивает, и входящий на базе, которая отвечает.

  • Что пойдёт по связи, решает отвечающая сторона. Её владелец открывает входящий ключ в админке и отмечает подграфы. Новому ключу не выдано ничего.
  • Каждое направление — отдельная связь. «Продажи читают Разработку» и «Разработка читает Продажи» — это две пары ключей и два отдельных набора подграфов.
  • Сосед знает только о своей связи. Он может спросить, какие подграфы ему выданы, и прочитать их описания. О других ваших соседях ему не сообщают ничего.
  • Выданное проверяется на каждом запросе. Уберите подграф у ключа или отзовите ключ, и уже следующий запрос этого соседа получит меньше.

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

Одно правило доступа для всех

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

Заметка Гость Вошёл, доступа нет Читатель с доступом к другому подграфу Ключ с другим подграфом Читатель или ключ с этим подграфом Администратор
free: true читает читает читает читает читает читает
нет free, нет subgraph закрыто закрыто читает читает — читает
subgraph: specs закрыто закрыто закрыто закрыто читает читает
в подграфе с Require sign-in закрыто читает читает читает читает читает

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

  • Заметка без подграфа не приватна. Первый же подграф, выданный ключу, открывает ему и все заметки без подграфа. Если в базе лежат внутренние заметки, которые никто не пометил, сосед с подграфом public-specs прочитает их все.
  • Подграф с Require sign-in открыт каждому ключу, которому выдан хотя бы один подграф. Он задуман для «любого вошедшего читателя», и ключ с выданным подграфом считается таким читателем.

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

Вторую строку для ключа не закрыть ничем. Держите в подграфе с Require sign-in только то, что можно читать любой спаренной базе.

Пример

Три отдела, три базы. Разработка спаривается с Продажами и выдаёт их ключу один подграф, shared.

Заметки Разработки:

# specs.md
subgraph: shared
# salaries.md
subgraph: internal
# roadmap-draft.md   (frontmatter нет)

Что агент Продаж получает от Разработки:

Заметка До патча После «закрыто по умолчанию»
specs.md читает читает
salaries.md закрыто закрыто
roadmap-draft.md читает закрыто

Черновик Разработка не выдавала. Он стал доступен, потому что у него нет подграфа. Это единственная неожиданность модели, и из-за неё патч стоит применить до первой выдачи, а не после.

Дизайн так же спаривается с Разработкой и выдаёт ей partners. Связи с Дизайном у Продаж нет, поэтому агент Продаж дотягивается до Дизайна только через Разработку. Ограничений два: ключ Продаж должен иметь доступ к KB-заметке Разработки про Дизайн, и вернётся только то, что Дизайн выдал ключу Разработки.

Что проходит по связи сейчас

Агенты проходят. Агент, подключённый к своей базе, ищет в спаренных базах, читает их заметки, идёт по их оглавлениям и забирает вложения через федеративные инструменты. Каждый ответ ограничен тем, что выдано связи, по которой он пришёл. Вопрос расходится и к соседям соседей, по умолчанию на глубину три.

Люди не проходят. У читателя, вошедшего в Продажи, нет сессии в Разработке. Ссылка из ответа агента ведёт на сайт Разработки, и этот сайт встречает читателя как любого посетителя: бесплатная заметка откроется, остальное попросит войти там. Провести человека тем же путём, каким ходит агент, нельзя: это не сделано.

Беспорядок остаётся там, где его устроили

В общем пространстве порядок — дело всех, а значит, часто ничьё: брошенные страницы одной команды всплывают в поиске другой. Сеть никого не делает аккуратным. Она меняет то, кто платит за беспорядок.

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

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

Чего это стоит

  • Доступ выдаётся базе, а не человеку. Каждый на спрашивающей стороне, кому доступна KB-заметка этого соседа, получает всё, что выдано связи. KB-заметка — обычная заметка, поэтому кто это будет, спрашивающая база решает своими подграфами. Чтобы дать двум аудиториям разные части, заведите два ключа с разными подграфами и по KB-заметке на каждый.
  • Единого индекса нет. Поиск спрашивает каждого соседа и сводит ответы. Сосед, не ответивший вовремя, пропускается, поэтому результата может не быть без всякой ошибки. По умолчанию один запрос к соседу обрывается через две секунды.
  • Ключи надо вести. Каждой паре баз, которые общаются, нужен ключ в каждую сторону, и у каждого ключа свой набор подграфов, который стоит пересматривать.
  • Имена местные. Подграф internal на одной базе никак не связан с internal на другой. Сосед видит имя подграфа и описание, которое написал его владелец, поэтому описание стоит написать.
  • Люди останавливаются на границе. См. раздел выше.

Куда идти дальше