Русский
Сеть баз вместо одного общего пространства
Эта страница объясняет идею, на которой в 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на другой. Сосед видит имя подграфа и описание, которое написал его владелец, поэтому описание стоит написать. - Люди останавливаются на границе. См. раздел выше.
Куда идти дальше
- MCP-федерация: спарить две базы, сменить и отозвать ключи, федеративные инструменты.
- Подграфы: как помечать заметки и патч, который закрывает непомеченные.
- Кто может прочитать заметку: таблица доступа целиком и что показывает закрытая заметка.
- База знаний организации: сколько баз нужно компании и кто пишет в каждую.