РУБРИК · портал

Рубрик — руководство тестировщика

Для человека, который видит проект впервые. Читать сверху вниз: сначала что это такое и из чего состоит, потом словарь, потом тест-кейсы.

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

Часть 1. Что это за продукт

Рубрик — образовательный робототехнический набор для школ. Ребёнок собирает робота и пишет для него программу: сначала из блоков (как в Scratch), потом на настоящем Python.

Аналог LEGO EV3, но «мозг» робота — не специальный блок, а обычный Android-телефон.

Из чего состоит одна работающая связка

Ноутбук ученика  ──Bluetooth──▶  Телефон на роботе  ──USB-кабель──▶  Модуль робота
   (пишет программу)               (выполняет её)                    (крутит моторы)

Ноутбук учителя  ──Wi-Fi класса──▶  ноутбуки учеников
   (класс, ученики, курсы)

Четыре разные программы, и тестируются они по-разному:

Это руководство — про приложение ученика и его связку с учительским. Телефон и модуль нужны только там, где сказано явно.

Три вещи, которые важно понять до тестов

1. Интернет не нужен. Совсем. Урок обязан идти в классе без сети: ребёнок пишет программу, запускает её на роботе, видит результат. Сеть нужна только учителю — чтобы видеть класс. Если что-то ломается без интернета, это баг.

2. Ноутбук общий. За одним компьютером сидят разные дети в разные дни. Поэтому приложение никогда не запоминает, кто вошёл, — каждый урок ребёнок выбирает себя заново.

3. Устройство один раз спрашивают, где оно стоит. «В классе» — ученики и курсы придут от учителя. «Самостоятельно» — всё хранится локально. Вопрос задают ровно один раз за устройство.

Часть 2. Словарь

Термины встречаются в интерфейсе и в отчётах о багах. Пользуйся ими — так тебя поймут.

Слова, которые в интерфейсе быть НЕ должны

Правило проекта: строка живёт, только если меняет следующее действие читателя. Если видишь такое — это находка, сообщай:

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

Проверка одной строкой: закрой её пальцем. Если следующий клик не изменился — строка мёртвая.

Часть 3. Подготовка

Что нужно

• ноутбук (macOS или Windows);
• для веток C и D — второй ноутбук или второе приложение на этом же (учительское);
• телефон и модуль — не нужны, всё проверяется на виртуальном роботе.

Установка

Установщики лежат на портале, вход не нужен: https://rubrick.beys.tech/downloads

Там два приложения — «Рубрик» (ученик) и «Рубрик — учитель». Для веток A, B, E, F хватит ученического; для C и D нужны оба.

• Windows: student-<версия>-win-x64.exe. Windows покажет «Неизвестный издатель» — это ожидаемо, подпись ещё не куплена. Нажми «Подробнее» → «Выполнить в любом случае»;
• macOS: student-<версия>-mac-arm64.dmg на Apple Silicon, …-mac-x64.dmg на Intel. Перетащить в «Программы». При первом запуске macOS тоже поругается на неизвестного разработчика — правой кнопкой по программе → «Открыть».

Учительское приложение называется так же, но начинается с teacher-.

Рядом с каждым установщиком лежит файл .rbu — это не установщик, а пакет обновления для раздачи с флешки. Для установки он не нужен, качай .exe или .dmg.

Остальные документы (включая этот) — https://rubrick.beys.tech/docs

Если тестируешь из исходников, тебе дадут команды отдельно.

Сброс к «первому запуску»

Многие проверки начинаются с чистого устройства. Закрой приложение, потом удали базу.

macOS:

rm -f ~/Library/Application\ Support/student-app/rubrick.db

Windows (PowerShell):

Remove-Item "$env:APPDATA\student-app\rubrick.db" -ErrorAction SilentlyContinue

⚠️ Файл db.key.enc рядом не трогать — это ключ шифрования. Без него новая база не откроется.

⚠️ Не удаляй базу при запущенном приложении — оно этого не переживёт.

Часть 4. Тест-кейсы

Шесть веток. A и B — без учителя. C и D — с ним. E и F — отдельные ситуации.

Ветки A–D начинаются со сброса базы: вопрос про режим задают один раз за базу.

Как отмечать: каждый шаг — «прошёл» или «не прошёл». Если не прошёл, пиши: что сделал → что ожидал → что увидел, и прикладывай скриншот. Расхождение с колонкой «ожидание» — это находка, даже если кажется мелочью.

Ветка A — самостоятельный режим (учитель не нужен)

Домашний сценарий: ребёнок с ноутбуком и без школы.

Ветка B — работа без робота и без сети

Продолжается из A, базу не сбрасывать. Проверяет, что автономное устройство самодостаточно.

Ветка C — класс, учитель работает

Главный школьный сценарий. Сбросить базу. Запустить учительское приложение.

Ветка D — класс, учителя ещё нет

Ноутбук привезли в класс раньше преподавателя. Сбросить базу. Учительское приложение не запускать.

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

Ветка E — смена режима задним числом

Базу не сбрасывать, продолжение любой ветки.

Ветка F — повреждённая база

Единственная ветка, которую надо подстроить руками. Закрыть приложение.

macOS:

printf 'мусор' > ~/Library/Application\ Support/student-app/rubrick.db

Windows (PowerShell):

Set-Content "$env:APPDATA\student-app\rubrick.db" "мусор"

Отдельный заход — проход глазами по текстам

Без кликов по функциям: пройти все экраны и искать мёртвые строки по правилу из Части 2.

Дополнительно смотреть на вёрстку — её не ловит ни один автотест:

• углы прямые везде (это требование брендбука; скруглений быть не должно);
• поле ввода и кнопка рядом — одной высоты;
• иконки внутри рамок — по центру и по размеру;
• карточка на экране — по центру окна, не прижата к углу;
• ничего не срезано краем окна.

Часть 5. Мини-справочник по учительскому приложению

Нужен только для веток C и D. Полного теста учительского в этом этапе нет.

Запускается отдельно, на том же или соседнем ноутбуке. Вкладки сверху:

Для ветки C нужны только Классы (создать класс и учеников) и Подключение (открыть сопряжение, потом подтвердить устройство).

PIN показывают один раз. Записывай сразу — второй раз приложение его не покажет, только сбросит на новый.

Первый запуск на Windows попросит разрешение сети. Разрешать обе галочки — и частные, и общественные сети. Школьный Wi-Fi обычно считается общественным, и без этой галочки ученики не подключатся, а учитель будет видеть зелёный индикатор. Это известная слабость, о ней уже знают.

Часть 6. Как сообщать о находках

Одна находка — одно сообщение. В нём:

• Ветка и шаг — например «C7».
• Что сделал — по шагам, чтобы можно было повторить.
• Что ожидал — из колонки «Ожидание».
• Что увидел — фактически.
• Скриншот — обязательно для всего, что видно глазами.
• Окружение — Windows или macOS, версия приложения (Настройки → «О приложении»).

Мёртвую строку из Части 2 можно прислать одной строкой: сам текст и на каком экране.

Что НЕ является багом

• карточка без PIN — так задумано;
• два ученика с одинаковым именем — законно;
• «Виртуальный робот» вместо настоящего — полноценный режим, а не заглушка;
• отсутствие интернета — норма, приложение обязано работать без него;
• «Неизвестный издатель» при установке на Windows — подпись пока не куплена;
• Windows спрашивает про сеть при первом запуске учительского приложения — так и должно быть, разрешать и частные, и общественные сети, иначе ученики не подключатся.

Часть 7. Чего этот этап не проверяет

Честный список, чтобы не искать несуществующее:

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