GreenChat

# 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>** —

регистрация не нужна, можно анонимно.

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

| Поле | Что делать |

|---|---|

| **Tracker** | `Bug` — для ошибок; `Feature` — для предложений; `Support` — для вопросов |

| **Subject** | Обязательно. Одна конкретная фраза: *что* сломалось и *где* |

| **Description** | Главное поле — по шаблону ниже |

| **Priority** | `Normal` почти всегда. `High` — падение, потеря данных, безопасность. `Urgent`/`Immediate` — не ставьте |

| **Files** | Скриншот/видео очень помогают (до 5 MB) |

| Status, Assignee, Start/Due date, Estimated time, % Done | **Не трогайте** — это служебные поля команды |

### Шаблон для Description

```text

Шаги:

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 не пришёл — вот это уже баг, репортите с указанием ОС.