Інструкція V2 до генератора Indigo Mental

Інструкція до генератора V2

Ця інструкція пояснює нову тестову сторінку генератора прикладів: які алгоритми доступні, за що відповідають поля, як перевіряти результат і як коректно передати зауваження методисту.

Що таке V2

index2.html - це окрема тестова сторінка нового генератора Indigo Mental. Вона створена, щоб перевіряти нову логіку без ризику зламати поточну стабільну сторінку index.html.

Основна ідея V2: перейти від простого random-генератора до генератора, який орієнтується на правила ментальної арифметики з Markdown-документації в папці опис логіки/Опис логіки МА.

Soroban Small friends Big friends Family Anzan Множення Ділення
V2 вже можна використовувати для тестування інтерфейсу, PDF і прикладів, але методична логіка ще потребує фінального звіряння з таблицями правил.

Швидкий старт

1

Відкрийте index2.html або опубліковану сторінку V2 на Tilda.

2

Оберіть Алгоритм V2, digit/техніку, кількість колонок, рядків і розрядність.

3

Натисніть Згенерувати і перевірте блок Попередній перегляд V2.

4

Для друку натисніть PDF або Друк і у вікні браузера виберіть Зберегти як PDF.

Якщо треба відтворити той самий набір прикладів, не змінюйте Seed. Якщо потрібен новий випадковий набір з тими самими параметрами, натисніть Новий seed.

Поля сторінки

Заголовок

Назва завдання. Вона відображається в інтерфейсі і в PDF поруч із логотипом Indigo Mental.

Опис

Внутрішня примітка: рівень учня, тема заняття або коментар для методиста. На генерацію не впливає.

Алгоритм V2

Головний вибір логіки: простий Soroban, small friends, big friends, family, Anzan, множення або ділення.

Digit / техніка

Цільова цифра або техніка. Наприклад, для small_friends доступні 1-4, для family - 6-9.

Колонок

Скільки прикладів буде в одному блоці таблиці. Для PDF перевірено формат з 10 колонками.

Рядів

Скільки числових рядків буде в кожній колонці. Наприклад, 7 рядків означає 7 чисел для одного прикладу. Якщо обрано 2 рядки, Pro-режим для small/big/family не активується, бо за Markdown-логікою pro потребує довшої послідовності.

Розрядність / places

Складність чисел: 1 цифра, 2 цифри, 3 цифри і далі. Для Anzan і Soroban це впливає на величину чисел.

Кількість блоків у PDF

Скільки окремих таблиць або наборів прикладів створити. Велика кількість блоків автоматично переноситься на наступні сторінки.

Шрифт у таблиці

Розмір цифр у попередньому перегляді і PDF. Якщо таблиця щільна, можна трохи зменшити шрифт.

Seed

Код повторюваності. Однаковий Seed з однаковими параметрами створює однакові приклади.

Кнопки

КнопкаЩо робить
Новий seedСтворює новий випадковий Seed і перегенеровує приклади з поточними налаштуваннями.
Зберегти налаштуванняЗберігає поточні налаштування в браузері користувача. Це локальне збереження, не база даних.
Очистити переглядПрибирає поточний попередній перегляд зі сторінки. Налаштування не видаляє.
ДрукВідкриває стандартне вікно друку браузера.
ЗгенеруватиСтворює новий набір прикладів за поточними параметрами.
CSVЗавантажує таблицю для перевірки у форматі CSV. Її можна відкрити в Excel або Google Sheets.
PDFВідкриває друк. Щоб отримати PDF, у системному вікні оберіть Зберегти як PDF.
Згенерувати PDFКнопка внизу попереднього перегляду. Перегенеровує поточний набір і готує його для друку.

Алгоритми

Elementary

Простий рахунок за elementary rules: без спеціальних переходів small/big/family. Для digit=0 у normal-режимі використовуються цифри 1-4; у pro-режимі можуть використовуватися 1-9.

Small friends

Формули 5-ки для digit 1-4. Тренують ситуації, де використовується 5-bead.

Big friends

Формули 10-ки для digit 1-9. Тренують переходи через 10. При 2 рядках pro-режим автоматично поводиться як normal.

Family

Складні переходи для digit 6-9, які поєднують логіку 5 і 10. Pro не застосовується при 2 рядках і для digit 6.

Fifty / Hundred

Тренування переходів через 50 або 100.

Negative

Режим, де в колонці має з'явитися негативний проміжний результат.

Anzan

Ментальний рахунок: додавання, віднімання або змішаний режим без видимого абакуса.

Multiply / Divide

Окремі картки прикладів для множення, квадратів і ділення без остачі.

Як працює логіка

У первинній документації логіка описана у Markdown-файлах. Для Soroban там є таблиці правил: який крок можна додати або відняти при конкретному поточному digit, і які операції мають обов'язково з'явитися в прикладі.

V2 працює за моделлю generate -> validate -> retry: генератор створює випадковий приклад, перевіряє його за правилами, і якщо приклад не підходить, пробує ще раз.

Сторінка має кілька audit-перевірок: Markdown-аудит для Soroban-таблиць, Crossing-аудит для 50/100, Anzan-аудит, Problem-аудит для множення/ділення і Algorithm-аудит для спеціальних режимів.

Якщо у відповідному рядку аудиту показано failed 0, генератор не знайшов порушень за поточними Markdown-правилами.

Діагностика і Seed

Після генерації сторінка показує діагностику. Наприклад: Алгоритм: big_friends. Must/target hits: 120/40. Невалідних колонок: 0.

Невалідних колонок: 0 означає, що технічна валідація сторінки не знайшла проблем у згенерованих колонках.

Markdown-аудит: rules failed 0, must failed 0 означає, що для режимів із табличною перевіркою кроки відповідають Markdown-правилам, і потрібні must-операції набрані.

Для інших режимів можуть з'являтися рядки Crossing-аудит, Anzan-аудит, Problem-аудит або Algorithm-аудит. Логіка така сама: failed 0 означає, що перевірка пройдена.

Якщо в будь-якому audit-рядку є failed більше нуля, такий набір не треба використовувати як готове завдання. Його потрібно передати розробнику разом із Seed і параметрами.

Seed потрібен для відтворення. Якщо методист знайшов неправильний приклад, треба записати Seed і всі параметри генерації. Тоді розробник зможе отримати той самий набір.

Для коректного баг-репорту достатньо: алгоритм, digit, pro on/off, columns, rows, places, blocks, Seed, номер блоку і номер колонки.

PDF і CSV

PDF

PDF створюється через стандартний друк браузера. Після натискання PDF або Друк потрібно вибрати Зберегти як PDF. Формат сторінки - A4.

Поточна V2-сторінка перевірена на таблицях з 10 колонками: правий край не обрізається.

CSV

CSV потрібен для перевірки. У ньому можна подивитися приклади й відповіді, відкрити файл в Excel або Google Sheets і передати методисту для аналізу.

Телефон і планшет

Інтерфейс V2 адаптований для вузьких екранів. Налаштування перебудовуються в одну колонку, а сторінка не повинна мати горизонтального роз'їзду.

На телефоні сама таблиця може бути щільною. Для реального друку краще фінально перевіряти PDF на комп'ютері або планшеті.

Що перевіряти методисту

  1. Згенерувати small_friends для digit 1, 2, 3, 4 у normal і pro режимах.
  2. Перевірити big_friends для digit 1-9.
  3. Перевірити family для digit 6-9.
  4. Окремо перевірити fifty, hundred і negative.
  5. Перевірити Anzan: plus, minus і random.
  6. Перевірити множення і ділення: чи відповідають приклади очікуваній складності.
  7. Для кожної помилки записати Seed і параметри генерації.

Важливі обмеження

Поточна V2-сторінка є робочим тестовим генератором з audit-перевірками за Markdown-логікою. Вона вже підходить для передачі методисту на перевірку.

Фінальне методичне підтвердження все одно має зробити методист: автоматична перевірка показує відповідність формальним правилам, але не замінює експертну оцінку навчального матеріалу.

Рекомендований порядок: методист перевіряє V2, фіксує питання з Seed, після цього ми додаємо окремий regression-тест для майбутніх змін.