Files
buryan-infra/docs
root de65cc088a VPN: выдача доступа новому человеку одной командой админа
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки QR и без пересылки ключей в мессенджерах.

Добавлено:
  !vpn give @логин      — выдать свободный ключ
  !vpn give @логин 08   — выдать конкретный ключ
  !vpn list             — что выдано, что свободно

Доступно только владельцу (@akadmin, @comms_agent); обычному человеку
бот отвечает отказом и пишет попытку в журнал.

Профиль уходит ЛИЧНО получателю: бот заводит с ним личную комнату,
приглашает и отправляет QR и ссылку. Владельцу приходит подтверждение,
что и кому выдано, и это же пишется в состояние (given_by, key).

Два вывода, которые дала проверка на живом получателе:

1. Видимость истории. Первый прогон создал комнату с history_visibility
   "joined". Бот отчитался "отправлено", но получатель — а он в тот
   момент ещё только приглашён — не увидел НИЧЕГО: с этой видимостью
   видны только сообщения после вступления. Исправлено на "shared",
   проверено на новой комнате: приглашённый видит профиль сразу.
   Это выяснилось проверкой, а не из документации.

2. Права бота. Бот не серверный админ: заводить и деактивировать
   учётные записи в Matrix он не может (403). Поэтому !vpn give создаёт
   только комнату, а учётную запись человеку заводит владелец. Записано
   в документации, чтобы это не выглядело недоделкой.

Проверено по-настоящему: временный человек заводился в Matrix, получал
ключ Buryan-10, принимал приглашение и видел у себя картинку QR и
ссылку. Обычному человеку на "!vpn 04" приходит отказ.

Уборка после проверки: временные люди и их комнаты удалены из базы
(пользователей снова 21, событий временных комнат 0). Комнаты чистились
с обнулением зависимостей — event_edges держал события круговой ссылкой.
2026-10-16 20:59:11 +03:00
..

buryan-hub — описание хозяйства

Документы

Документ О чём
PLAN.md Полный план развития: что делаем и в каком порядке
TASKS.md Реестр задач с отметками о состоянии
NIGHT-JOURNAL.md Журнал работ: что и как проверено
NIGHT-REPORT.md Итоговый отчёт по спринту
DATABASE-STANDARD.md Правила работы с базами
COMMANDS.md Справочник команд ботов

Порядок работ

1. Завершить обновления    (4 службы)
2. Сеть и доступ           (вход, DNS, VPS)
3. Звонки и медиа          (Element Call)
4. Сквозная связность      (единый вход, уведомления, наблюдение)
5. Улучшение служб         (по каждой)

Правила работы

Десять правил, выведенных по ходу спринта — часть на своих ошибках. Полный список: PLAN.md, раздел 7.

Главные:

  1. Проверяй записью, а не чтением.
  2. Состояние службы — по живому процессу, а не по состоянию в системе.
  3. Пустой список — это неудача.
  4. Проверяй на настоящих данных.
  5. Никогда не перезапускай Docker массово.
  6. Сбой шага — верни состояние и иди дальше.
  7. Не удаляй без проверенной копии.