Kaiku

← Вся документация

Open source проекты

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

Что это

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

Публичным можно сделать только open source проект — привязанный к публичному репозиторию на GitHub или GitLab. Трекер открывается для проекта, который мир и так читает, а не как способ публиковать страницы.

Как открыть проект

  1. Привяжите репозиторий: укажите его адрес при создании проекта или откройте меню доски → 🧩 Репозитории… и отметьте на нём Open source: публичный репозиторий этого проекта. Хостинг спрашивается без аккаунта, читает ли репозиторий кто угодно и под какой лицензией; приватный отметить нельзя.
  2. Откройте меню доски → 🌐 Публичный доступ… и нажмите Сделать публичным…. Окно скажет, сколько задач и страниц вики станут видны.
  3. Подтвердите: Да, сделать публичным.

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

  • Подпроект вместе с родителем не открывается: у каждого свой переключатель.
  • Хостинг спрашивается снова каждый день. Если репозиторий стал приватным или пропал, проект сразу закрывается, а руководителю приходит сообщение; если хостинг просто не ответил, ничего не закрывается.
  • Закрыть для всех действует сразу: ссылки перестают открываться для всех, кто не в проекте.

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

Что видит посетитель и чего не видит никогда

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

Не показывается никогда, даже в публичном проекте:

  • адреса почты и список людей компании; наблюдатели — только числом;
  • настройки проекта, вебхуки, окружения и сохранённые секреты;
  • ассистент, агенты и их расход, тариф и деньги, журнал компании;
  • подпроекты и другие проекты компании — связь публичной задачи с закрытой считается, но не называется;
  • коммит и пайплайн деплоя: только окружение и время.

Участие

Вошедший посетитель видит сверху Хочу участвовать и может добавить пару слов о себе. Мейнтейнеры проекта — его владелец и администраторы — получают сообщение и решают в меню доски → 🙋 Заявки на участие…: Пустить или Отклонить. Тому, кто просил, в любом случае приходит письмо; после отказа попроситься снова можно через две недели.

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

Репортёр или комментатор пишет в день ограниченно, каждый проект считается отдельно:

  • в первую неделю в проекте — десять задач и комментариев вместе;
  • потом — тридцать задач и сто комментариев.

День — это последние двадцать четыре часа, удалённый комментарий тоже считается. Сверх лимита запись отклоняется с временем, когда снова можно, — через API это 429. У участников, администраторов и владельца лимита нет.

Чтение через API

Инструмент читает публичный проект через API трекера и API вики вовсе без токена — поиск тоже — и находит только публичное. Чтение снаружи ограничено поминутно — на адрес и на компанию; сверх лимита ответ — 429 с Retry-After. Участников с токеном это ограничение не касается.

MCP-сервер — для аккаунтов: инструмент без токена ничего от него не получит, публичный проект или нет.

Поисковики

По умолчанию выключено: страницы публичного проекта просят поисковики их не индексировать. Владелец включает индексацию в том же окне — Разрешить индексацию поисковиками; тогда задачи, страницы и доска попадают в карту сайта воркспейса. Закрытие проекта сразу убирает их оттуда.

Ссылки на другие сайты в вики публичного проекта помечены nofollow ugc: поисковикам сказано, что мы за них не ручаемся.

Без мест для open source

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

  • Владелец и администраторы занимают место всегда — как и всякий, кто есть ещё и в закрытом проекте, читает закрытый подпроект или получил доступ к закрытой задаче или странице.
  • Хранилище, пакеты, AI Pro и «Нормы» стоят как у всех.
  • Настройки → Оплата показывает, сколько людей не занимают мест.
  • Если проект перестал быть публичным, его люди занимают места со следующего периода. Оплаченный период не трогается; владелец в день закрытия получает письмо — сколько человек и с какого дня, — и экран оплаты говорит то же.

Компания из open source проектов

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

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

  • Владелец компании и тот, кто создал или закрыл проект, получают уведомление с датой. То же говорит форма создания проекта и Настройки → Оплата.
  • Стал публичным вовремя — ничего не меняется.
  • Остался закрытым через три дня — с этого дня компании нужна оплата: начинаются обычные семь дней отсрочки, а после них режим чтения, как описано в Оплата и режим чтения.

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

Злоупотребления

Публичный проект — для работы самого open source проекта. Если его используют для другого — страницы ради ссылок, подделка чужого сайта, — мы закрываем его для всех, и владелец не сможет открыть его снова; окно об этом скажет. Закрытие записывается в журнал компании. Если считаете, что это ошибка, напишите нам.

Чего нет

  • Нет публичной ссылки на одну задачу или страницу закрытого проекта. Для одной вещи откройте её гостю.
  • Нет вступления без мейнтейнера: каждая заявка ждёт решения.
  • Поиск у посетителя пока ничего не находит: он ходит по ссылкам и по доске.
  • Репозиторий на хостинге, кроме GitHub и GitLab, проект open source не делает.

Чего-то не хватает или всё не так, как здесь написано? Напишите на hello@kaiku.tech