Green Chat — памятка бета-тестера¶

Спасибо, что участвуете в бете! Этот документ — 5 минут чтения: что такое
Green Chat, что в нём проверять, что считается багом, а что — задуманным
поведением, и как правильно оставить баг-репорт.

Что это такое¶

Green Chat — self-hosted корпоративный мессенджер (аналог Slack) со
сквозным шифрованием по стандарту MLS (RFC 9420). Ключевое отличие от
Slack/Telegram: сервер не может прочитать ваши сообщения и файлы — он
хранит только зашифрованные блобы и не имеет ключей. Всё шифрование
происходит на вашем устройстве.

Из этого следуют две важные для тестера вещи:

• Никто не «восстановит переписку с сервера»: история живёт на ваших
  устройствах. Потеряете все устройства — потеряете историю. Это не баг,
  это цена E2E.
• Поддержка не видит содержимое сообщений, поэтому в баг-репортах важны
  точное время, название канала и шаги — по ним ищут проблему в логах.

Ключевые возможности (что тестировать)¶

• Каналы и личные сообщения (DM), справочник сотрудников (directory).
• Форматирование текста (rich text), эмодзи, @-упоминания,
  закреплённые сообщения (pins).
• Статусы: presence (online/away/DND), индикатор «печатает», отметки
  sent/delivered у сообщений, счётчики непрочитанного.
• Мультиустройство: вход на второе устройство по паролю (Sign in) или
  по QR-коду (Link device); прочитанность, черновики и список устройств
  синхронизируются между вашими устройствами (тоже E2E).
• Файлы-вложения — отправка в чат, drag-and-drop в окно
  (⚠ на части бета-серверов вложения могут быть отключены — уточните у
  организатора).
• Уведомления: системные попапы, счётчик на иконке приложения, tray,
  настройки уведомлений (per-channel, DND, quiet hours),
  email при офлайн-DM (письмо, если вам написали в личку, а приложение
  полностью закрыто).
• Темы: светлая (по умолчанию) и тёмная.
• Работает на Windows, macOS, Linux.

Что считается багом — а что нет¶

Это баги — репортите обязательно¶

• Падение или зависание приложения.
• Сообщение отправлено (стоит «sent»), но получателю так и не пришло.
• Сообщение отображается как ошибка расшифровки или «кракозябрами».
• На двух ваших устройствах разошлись прочитанность/черновики/история.
• Не пришёл попап о личном сообщении, хотя окно было не в фокусе и
  DND/mute выключены.
• Приложение не переподключилось само после обрыва сети/рестарта сервера.
• Сломанная вёрстка, нечитаемый текст (особенно в тёмной теме), «мёртвые»
  кнопки.
• Ошибки при загрузке/скачивании файлов (если вложения включены).
• Всё, что выглядит как проблема безопасности (видно чужое, вход без
  пароля и т.п.) — репортите с приоритетом High.

Это НЕ баги — так задумано¶

• Нет попапа на обычное сообщение в канале. По умолчанию каналы
  уведомляют только при @-упоминании (как в Slack). Хотите проверить
  попапы — тестируйте через DM или @-mention.
• Число на иконке считает только DM и упоминания; непрочитанное в
  каналах — это «точка», не число.
• Email-уведомление не пришло, если приложение было свёрнуто или в
  tray — вы считаетесь онлайн. Письмо уходит только про DM и только
  когда приложение полностью закрыто (tray → Quit), не чаще 1 письма на
  диалог в 15 минут.
• Нет вкладки «New account» — вход на бета-сервер только по инвайту.
• Windows: предупреждение SmartScreen «неизвестный издатель» — бета-
  сборки пока не подписаны.
• macOS: попапы приходят от имени «Script Editor» — известный
  бета-компромисс до подписания сборок.
• macOS: Gatekeeper может блокировать запуск .dmg — следуйте
  инструкции организатора (снятие quarantine).
• Нет автообновления — новые версии ставятся вручную поверх старой.
• «SPKI pin mismatch» после плановой смены ключа сервера — лечится
  logout и повторным входом (клиент намеренно не принимает новый ключ
  сервера молча).
• Проверка «Send test» в Settings → Notifications шлёт попап в обход всех
  правил — если он приходит, а обычные уведомления нет, дело в настройках
  (DND/mute/фокус окна), а не в поломке ОС.

Сомневаетесь, баг это или нет? Репортите. Лучше лишний репорт, чем
пропущенный баг.

Как оставить баг-репорт¶

Трекер: https://bug.green-lab.space/projects/greenchat/issues/new —
регистрация не нужна, можно анонимно.

Какие поля заполнять¶

Шаблон для Description¶

Шаги:
1. …
2. …
3. …

Ожидал: …
Получил: …

Окружение: ОС и версия (напр. Windows 11 / Ubuntu 24.04 / macOS 15),
версия приложения (внизу страницы Settings → Profile), время события
(с точностью до минуты, с часовым поясом).

Воспроизводится: всегда / иногда / один раз.

⚠ Трекер публичный. Не вставляйте в репорт пароли, коды инвайтов и
скриншоты с конфиденциальной перепиской — замажьте лишнее.

Пример хорошего репорта¶

Subject: DM не доставляется, если получатель офлайн в момент отправки

Description:
Шаги:

1. Коллега полностью закрыл приложение (tray → Quit).
2. Я отправил ему DM «тест 123» в 14:32 (UTC+3), у сообщения появилась
   отметка sent.
3. Коллега открыл приложение в 14:40.

Ожидал: сообщение появится у него при запуске.
Получил: сообщения нет ни в 14:40, ни через час; у меня оно так и висит
как sent, без delivered.

Окружение: у меня Windows 11, приложение 0.1.0; у него Ubuntu 24.04,
тоже 0.1.0. Воспроизвели 2 раза из 2. Скриншоты обеих сторон приложил.

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

Пример плохого репорта¶

Subject: ничего не работает!!!

Description: уведомления не приходят, почините. Priority: Immediate

Почему он плохой: непонятно, какие уведомления (попап? бейдж? email?),
на какой ОС, при каких условиях (канал или DM? окно в фокусе? включён
DND?), когда это было и как повторить. Скорее всего, это вообще не баг —
см. раздел «Это НЕ баги» про уведомления в каналах. Завышенный приоритет
только замедлит разбор.

Быстрая самодиагностика перед репортом об уведомлениях¶

1. Settings → Notifications → Send test. Попап пришёл? Значит ОС в
   порядке — проверьте DND, mute канала, quiet hours и фокус окна.
2. Помните: канал без @-упоминания попап не даёт — это по умолчанию.
3. Если Send test не пришёл — вот это уже баг, репортите с указанием ОС.