Vocabulary — исходный контекст
Марина хочет создать веб-приложение для заучивания английских и латинских слов для сына Лёши (13 лет, 7 класс Gymnasium). Оно должно работать на телефоне, планшете и ноутбуке, Лёша занимается в нём сам примерно по 10 минут в день.
Сейчас
Есть простое самописное приложение с карточками «знаю / не знаю», слова прогоняются по кругу.
Проблема
- Лёша торопится и отправляет в «знаю» слова, в которых сомневается.
- Слов задают много, при этом большую часть он уже знает с урока (английский ~70%, латынь ~50%). Гонять известное долго и демотивирует.
- Нет возврата к сложным словам в следующие дни.
- Новые слова надо вносить вручную с распечаток.
Принятые решения
Режимы и данные
- Вход по паролю:
Alex(детский режим, пароль хранится в браузере) илиparent. Переключатель вверху справа. - English / Latein: переключатель вверху, у каждого языка своя цветовая тема и своя база слов.
- У слова: слово, перевод, дата, unit, бандл, статус, счётчик сложности.
- Parent: загрузка до 10 фото распечаток, Terra (Codex headless) распознаёт слова. Одна загрузка = один бандл, unit задаётся вручную. Можно править слова и вручную вернуть слово в «незнакомые», есть статистика.
Игра
- Показываем немецкое слово, Лёша вспоминает иностранное. Кнопки «знаю» / «лоадинг» / «не знаю».
- Проверка «знаю»: ответы «знаю» идут блоками по 3, в каждом одна проверка на случайной позиции. Момент проверки предсказать нельзя.
- После ошибочного «знаю» следующие 5 «знаю» проверяются все (VAR). На втором круге «знаю» проверяется всегда.
- Проверка — ввод перевода, после 3 букв появляются 4 варианта автодополнения.
- Очки:
- «знаю»: +1;
- «знаю» с проверкой: +3;
- ошибочное «знаю»: −10;
- «лоадинг» с верным ответом: +2, ошибка без штрафа;
- «не знаю»: 0.
- Сессия идёт по кругу, пока не выучен весь бандл. «Лоадинг», «не знаю» и ошибки возвращаются в круг. Получается естественный баланс: честный «лоадинг» выгоден по очкам, но удлиняет сессию.
- В начале сессии разминка: 2–3 самых сложных слова из прошлых дней.
- На экране прогресс бандла (
15/20), прогресс-бар и очки за день.
Мотивация
- Каждые 5 верных ответов — короткое «молодец» от футбольного персонажа или крипера.
- За законченный бандл выпадает случайная карточка известного футболиста. Карточки хранятся в отдельной вкладке-коллекции.
Отложено — не входит в MVP
- режим «перед тестом» с выбором бандлов и подготовкой за 2–3 дня;
- обмен очков на V-Bucks или сезон;
- рейтинг сессии;
- латинские формы;
- редкость карточек и наборы по клубам.
Открытые вопросы из исходного обсуждения
- Когда слово получает статус «выучено»? Решено 20.11.2026: после правильного активного ответа в три разных дня.
- Как именно снижается сложность слова после успеха в другой день? Решено 20.11.2026: на 1 за первый успешный активный ответ в новый день.
Дополнения от 20.11.2026
- Старое приложение используется как источник базы слов, но игровая механика создаётся заново.
- Правильный ответ после «лоадинг» всё равно возвращает слово в круг.
- Проверка написания должна быть мягкой, с допустимыми вариантами и небольшими опечатками.
- Домен:
vocabulary.softdock.de. - Исходные фотографии распечаток можно удалять после подтверждённого импорта.
- Реальные изображения карточек Марина добавит позже; до этого используются пять плейсхолдеров.
Публикация и приоритет устройств
- Сайт опубликован по адресу https://vocabulary.softdock.de.
- Пока главная страница пустая; в футере размещена ссылка на сводную страницу документации из всех Markdown-файлов проекта.
- Интерфейс mobile-first: в основном приложение будет использоваться на телефоне и планшете, но оно также должно полноценно работать на ноутбуке.
Agent.md — правила работы над Vocabulary
Назначение проекта
Vocabulary — mobile-first веб-приложение для самостоятельного ежедневного заучивания Лёшей английских и латинских слов. Оно должно объективно проверять знания, не заставлять повторять уже знакомое и возвращать сложные слова в следующие дни.
Пользователи:
Alex: ребёнок, 13 лет; короткая игровая сессия примерно 10 минут в день; интерфейс на немецком;parent: Марина и родители; загрузка и проверка слов, управление бандлами, исправления и статистика; интерфейс на русском.
Источники правды
Перед изменениями прочитай в таком порядке:
Info.md— исходная постановка и формулировки Марины;Spec.md— требования и критерии приёмки;Desigions.md— принятые и временные решения;Tasks.md— порядок реализации и текущее состояние.
Исходники старого интерфейса сохранены в legacy/,
а извлечённая из них база — в
data/legacy-vocabulary.json. Старую игровую механику
не переносить: она служит только референсом данных.
Если документы расходятся, приоритет: последнее подтверждённое
решение пользователя → Desigions.md →
Spec.md → Info.md. Не превращай
временное решение в подтверждённое без согласования.
Продуктовые принципы
- Сессия должна быть короткой: первая полезная карточка появляется сразу, без настройки со стороны ребёнка.
- Нельзя полагаться только на самооценку «знаю»; система периодически требует активный ввод ответа.
- Уже знакомые слова уходят из текущего круга быстро, сложные возвращаются сегодня и в будущие дни.
- Игра мотивирует честный ответ «лоадинг» и делает поспешное ложное «знаю» невыгодным.
- Родитель всегда может исправить OCR, слово, перевод, unit, бандл и учебный статус.
- Английский и латынь логически разделены: отдельные темы, бандлы, статистика и словари автодополнения.
- Не добавлять функции из раздела «не MVP», пока MVP не работает целиком.
UX и доступность
- Проектировать от ширины 360 px; основные действия доступны большим пальцем.
- Основные кнопки имеют область нажатия не меньше 44×44 px.
- Не кодировать состояние только цветом: использовать подпись, иконку или форму.
- Поддерживать портретный телефон, планшет и ноутбук без горизонтального скролла.
- Во время игры не показывать лишние переходы, настройки и родительские элементы.
- После нажатия давать мгновенную визуальную обратную связь; не блокировать игру AI-запросом.
- Все игровые правила, начисление очков и проверка прогресса выполняются на сервере; клиент не является источником правды.
Данные, безопасность и AI
- Не хранить пароль открытым текстом в браузере или базе. Для
запоминания входа использовать безопасную серверную сессию в
HttpOnly,Secure,SameSitecookie. - Роль определяется сервером. Детский режим не должен получать родительские API и статистику через скрытые элементы интерфейса.
- Фото распечаток могут содержать школьные данные: хранить локально на VPS, не публиковать и удалять сразу после успешного подтверждения импорта.
- Terra/Codex headless используется асинхронно только для распознавания и структурирования загрузки. Результат всегда проходит экран проверки родителем до попадания в активный бандл.
- Не отправлять персональные данные во внешние сервисы без отдельного решения.
- Логи не должны содержать пароли, cookie или полные изображения загрузок.
Инженерный процесс
- Перед кодом проверь фактическую структуру проекта и локальные инструкции.
- Делай небольшие, проверяемые изменения; не перезаписывай пользовательские изменения.
- Любое изменение игровой механики сопровождай тестами автомата состояний и начисления очков.
- Для миграций базы предусматривать обратимость или резервную копию.
- После завершения задачи обновляй
Tasks.md; архитектурные и продуктовые решения записывай вDesigions.md. - Перед деплоем проверяй mobile viewport, авторизацию обеих ролей, восстановление незавершённой сессии и резервное копирование базы.
- Деплой на Softdock делать только после определения домена, runtime и способа резервного копирования.
- После изменения любого корневого Markdown-файла пересобирай и
публикуй документацию командой
./scripts/deploy-site.sh.
Definition of Done для функции
Функция считается готовой, когда:
- выполнены критерии приёмки из
Spec.md; - есть тесты критической логики и проверены ошибки/пустые состояния;
- интерфейс проверен минимум на 360×800, планшете и desktop;
- роли и API-права проверены отдельно;
- обновлены документация и статус задачи;
- изменение безопасно разворачивается на VPS и не требует ручной правки данных.
Spec.md — спецификация Vocabulary MVP
1. Цель
Сделать веб-приложение, в котором Лёша самостоятельно за примерно 10 минут в день:
- быстро отсеивает слова, которые действительно знает;
- объективно подтверждает часть ответов «знаю»;
- повторяет сомнительные и незнакомые слова до завершения бандла;
- встречает сложные слова снова в следующие дни;
- получает понятный прогресс и лёгкую игровую награду.
Родитель должен за несколько минут загрузить фотографии распечатки, проверить распознавание и выдать новый бандл без ручного перепечатывания каждого слова.
2. Границы MVP
Входит
- две роли: Alex и parent;
- два языка: English и Latein;
- бандлы слов, unit и дата;
- загрузка до 10 фотографий в один импорт;
- асинхронное OCR/структурирование через Terra (Codex headless);
- обязательное подтверждение результата импорта родителем;
- игровой круг с тремя самооценками и непредсказуемыми проверками;
- очки за день;
- разминка из сложных слов прошлых дней;
- долгосрочный статус слова и сложность;
- короткие мотивационные реакции;
- случайная футбольная карточка за завершённый бандл;
- коллекция полученных карточек;
- родительская статистика;
- адаптивный mobile-first интерфейс;
- публикация на Softdock.
Не входит
- подготовка к тесту по выбранным бандлам;
- V-Bucks, магазин, сезоны и рейтинг сессии;
- редкости, клубные наборы или обмен карточками;
- отдельная тренировка латинских форм;
- нативные приложения и офлайн-режим;
- полноценная платформа «ИИ-репетитор» по другим предметам.
3. Роли и навигация
Alex
После запомненного входа видит:
- переключатель
English / Lateinсверху; - текущий или следующий незавершённый бандл;
- кнопку начала/продолжения сессии;
- очки за сегодняшний день;
- вкладку коллекции карточек;
- переключение в parent через повторную авторизацию.
Интерфейс и игровые тексты — на немецком. Рабочие подписи трёх
кнопок до отдельного UX-решения: Weiß ich,
Unsicher, Weiß ich nicht; внутреннее
название loading не показывается пользователю.
Parent
Видит:
- список бандлов по языку и unit;
- создание импорта и его статус;
- экран проверки распознанных пар;
- создание и редактирование слова;
- активацию/архивацию бандла;
- возврат слова в изучение;
- статистику по дням, бандлам и сложным словам;
- переход в детский режим без раскрытия родительских функций.
Родительский интерфейс — на русском.
4. Основные сущности данных
User
id;login;role:alex | parent;password_hash;locale;created_at,last_login_at.
Language
code:en | la;display_name:English | Latein;theme.
Unit
id,language_code,name,created_at.
Bundle
id,language_code,unit_id;title;source_date;status:draft | ready | active | completed | archived;created_at,completed_at;- ссылка на импорт-источник, если он есть.
Word
id,language_code;prompt_de: немецкое слово/значение, которое показывается Лёше;answer_primary: основной английский или латинский ответ;answer_variants: допустимые варианты ответа;unit_id,source_date;learning_status:new | learning | learned;difficulty: целое число, минимум0;active,created_at,updated_at.
Связь слова и бандла должна позволять не дублировать одну словарную запись при повторном появлении и при этом хранить её участие в разных бандлах.
ImportJob
id,language_code,unit_name;- до 10 локальных файлов;
status:uploaded | processing | review | failed | confirmed;- сырой структурированный результат и сообщение ошибки;
created_by, timestamps.
Session / SessionItem / Attempt
Session хранит язык, основной бандл, разминку, состояние круга, очки и возможность продолжить после перезагрузки. Attempt хранит:
- слово и время;
- круг;
- выбор
know | unsure | dont_know; - потребовалась ли проверка;
- введённый/выбранный ответ;
- правильность;
- изменение очков и сложности;
- основание проверки:
random_block | var | second_round | unsure | warmup.
RewardCard / UserCard
RewardCard хранит футболиста, изображение и служебный
идентификатор. UserCard хранит дату получения и бандл-источник. В
MVP повторное выпадение допустимо или запрещено согласно решению
D-014 в Desigions.md.
5. Импорт слов
- Parent выбирает язык, вводит unit и выбирает 1–10 фото.
- Сервер проверяет число, тип и размер файлов, сохраняет их вне публичного каталога.
- Создаётся фоновая задача Terra/Codex headless.
- Распознавание возвращает пары
немецкое → английское/латинское, сохраняя пометки о неуверенности. - Parent видит таблицу проверки: может исправить, удалить, добавить строку и отметить сомнительное место.
- При подтверждении создаётся один новый draft-бандл и слова/связи с ним.
- Только после явной активации бандл доступен Alex.
- При сбое можно повторить обработку без повторной загрузки и без создания дублей.
Критерии приёмки:
- нельзя загрузить 0 или больше 10 фото;
- частично распознанный результат не активируется автоматически;
- подтверждение идемпотентно и не создаёт второй бандл при повторном запросе;
- родитель может полностью исправить результат до активации.
6. Игровая сессия
6.1 Старт
- Система продолжает незавершённую сессию либо предлагает следующий active-бандл выбранного языка.
- До основного бандла показывает 2–3 доступных слова с наибольшей сложностью из прошлых дней. Одно и то же слово не должно попадать в разминку чаще установленного интервала.
- Разминка не увеличивает знаменатель прогресса основного бандла.
6.2 Карточка
На карточке показано немецкое значение. Иностранное слово скрыто. Доступны три крупные кнопки:
Знаю / Weiß ich;Лоадинг / Unsicher;Не знаю / Weiß ich nicht.
Термин «лоадинг» — продуктовое имя механики; немецкую подпись подтверждает Марина.
6.3 План проверок «знаю»
- Сервер группирует последовательные нажатия «знаю» в скрытые блоки по три.
- До начала каждого блока сервер случайно выбирает одну позицию
1..3для проверки. - Клиент не получает будущую позицию проверки.
- Неполный блок в конце сессии сохраняется и продолжается после перезагрузки.
- После неверной проверки «знаю» включается VAR: следующие 5 нажатий «знаю» требуют проверки.
- Каждая новая ошибка во время VAR заново устанавливает счётчик в 5.
- Начиная со второго появления слова в текущей сессии (второй круг), любое «знаю» требует проверки.
6.4 Ввод ответа
- Для
Unsicherпроверка открывается всегда. - Для проверяемого
Weiß ichоткрывается тот же ввод. - До ввода трёх символов варианты не показываются.
- После трёх символов показываются до четырёх вариантов из словаря того же языка; один из них — правильный, если префикс/поиск позволяет.
- Можно допечатать ответ вручную и подтвердить его.
- Сравнение мягкое: нормализует регистр, Unicode, пробелы, типографские апострофы/дефисы и конечную пунктуацию; для латыни макроны необязательны; учитывает явно заданные варианты ответа.
- Небольшая опечатка принимается: до 1 редакционного изменения для ответа от 5 символов и до 2 для ответа от 10 символов. Короткие ответы до 5 символов должны совпасть после нормализации, чтобы не принимать другое слово.
- Нечётко принятый ответ отмечается как
fuzzy_matchв истории, но считается верным и не штрафуется. - После ответа показывается правильный вариант и короткая обратная связь.
6.5 Очки
| Событие | Очки |
|---|---|
| «знаю» без проверки | +1 |
| «знаю» с верной проверкой | +3 |
| «знаю» с неверной проверкой | −10 |
| «лоадинг» с верным ответом | +2 |
| «лоадинг» с неверным ответом | 0 |
| «не знаю» | 0 |
- Очки начисляются на сервере и привязаны к календарному дню в согласованном часовом поясе.
- Дневной счёт может быть отрицательным.
- Повторная отправка одного ответа не должна начислять очки второй раз.
6.6 Возврат в круг и завершение
dont_know, неверныйunsureи любая ошибка проверки возвращают слово в хвост круга.- Верный
unsureтакже возвращает слово в круг: это промежуточное знание, а не завершение слова. - Непроверенное
knowили верно проверенноеknowзавершает слово для текущего бандла в этой сессии. - На повторном появлении завершить слово можно только верной
проверкой
know. - Бандл завершён, когда все его слова завершены для текущего прохождения.
- При завершении сохраняется результат, бандл получает
completed, а награда выдаётся одной атомарной операцией.
6.7 Прогресс и мотивация
- Всегда видны
завершено / всего, progress bar и очки за день. - Каждые 5 верных проверенных ответов в рамках дня показывается реакция на 1–2 секунды; она не перекрывает управление надолго.
- Реакции чередуют футбольного персонажа и визуально оригинального «крипера», не копируя защищённый игровой арт.
- После завершения бандла показывается полученная футбольная карточка и кнопка перехода в коллекцию/домой.
7. Долгосрочное обучение — правило MVP
Используется простая объяснимая модель, подтверждённая Мариной:
new— слово ещё не завершало бандл;learning— слово завершило бандл, но не подтверждено в разные дни;learned— слово верно введено в активном воспроизведении в 3 разных календарных днях, причём последняя такая попытка не содержит ошибки в этот день;- неверное «знаю» увеличивает
difficultyна 2; dont_knowили неверныйunsureувеличиваетdifficultyна 1;- первая верная активная проверка слова в новый день уменьшает
difficultyна 1, но не ниже 0; - родитель может вручную вернуть слово в
learning, установив минимальную сложность 1; - слова
learnedмогут появляться в разминке, если их сложность выше 0 или давно не было успешной проверки.
Это правило должно быть изолировано в конфигурации/доменном сервисе, чтобы его можно было изменить без миграции истории попыток.
8. Статистика parent
MVP показывает:
- занятия по дням: длительность, попытки, очки, завершённые бандлы;
- прогресс каждого бандла;
- число
new / learning / learnedпо языку; - список самых сложных слов;
- ошибки ложного «знаю»;
- последнюю активность;
- историю конкретного слова.
Статистика не должна превращаться в публичный рейтинг или наказывать за пропущенный день.
9. Нефункциональные требования
- responsive web: телефон от 360 px, планшет, ноутбук;
- поддержка актуальных Safari iOS/iPadOS, Chrome Android и desktop Chrome/Safari;
- первая карточка после открытия готовой сессии — без AI-запроса;
- игровое действие после ответа сохраняется устойчиво к обновлению страницы;
- серверные операции идемпотентны там, где повтор возможен из-за сети;
- изображения импорта недоступны без parent-сессии;
- ежедневное резервное копирование базы и проверяемое восстановление;
- структурированные логи и health endpoint без персональных данных;
- часовой пояс для «очков за день» и дат обучения задаётся конфигурацией;
- домен, TLS и служба запуска оформляются в инфраструктуре Softdock.
10. События аналитики MVP
Хранить доменные события без стороннего трекера:
- session_started / resumed / completed;
- answer_self_rated;
- verification_requested / passed / failed;
- var_started / completed;
- bundle_completed;
- reward_granted;
- import_started / failed / confirmed;
- word_status_changed.
Главные продуктовые показатели: медианная длительность сессии, доля завершённых бандлов, доля ошибочных «знаю», число слов, которые возвращаются в следующие дни, и удержание без принудительных streak-механик.
11. Сквозные критерии приёмки MVP
MVP готов к семейному использованию, если:
- Parent загружает фото, исправляет результат и активирует бандл без работы с базой/терминалом.
- Alex на телефоне входит один раз, выбирает язык и завершает бандл с корректными кругами, VAR и очками.
- Перезагрузка страницы не теряет сессию и не дублирует очки/награду.
- Сложные слова появляются в разминке в другой день, а история объясняет почему.
- English и Latein не смешивают данные, темы и автодополнение.
- Parent видит статистику и может вернуть слово в изучение.
- Завершение бандла ровно один раз выдаёт карточку.
- Интерфейс пригоден на телефоне, планшете и ноутбуке.
- База резервируется, приложение поднимается после рестарта VPS и работает через HTTPS на Softdock.
Desigions.md — журнал решений
Имя файла сохранено в написании, которое задала Марина. Статусы: принято, временно, открыто, отложено.
D-001. Один адаптивный веб-интерфейс
- Статус: принято
- Решение: одно mobile-first веб-приложение для телефона, планшета и ноутбука.
- Причина: основное использование — телефон и планшет; отдельные нативные приложения не нужны для проверки MVP.
D-002. Две серверные роли
- Статус: принято
- Решение: роли
Alexиparent, переключатель роли сверху справа. Доступ к parent требует родительской авторизации. - Уточнение реализации: запоминается защищённая сессия, а не открытый пароль в браузере.
D-003. Языки разделены
- Статус: принято
- Решение: English и Latein имеют свои темы, бандлы, слова, статистику и словарь подсказок.
D-004. Немецкий — вопрос, иностранный — ответ
- Статус: принято
- Решение: показывать немецкое значение и просить вспомнить английское или латинское слово.
D-005. Три самооценки
- Статус: принято
- Решение: «знаю», «лоадинг», «не знаю».
- UX-уточнение: для Alex временно использовать немецкие подписи
Weiß ich,Unsicher,Weiß ich nicht; термин «лоадинг» оставить внутренним до подтверждения текста.
D-006. Скрытая проверка «знаю»
- Статус: принято
- Решение: в каждом блоке из трёх «знаю» одна случайная позиция проверяется активным вводом; будущая позиция неизвестна клиенту.
D-007. VAR после ошибки
- Статус: принято
- Решение: после ошибочного «знаю» следующие пять «знаю» проверяются. Новая ошибка перезапускает окно из пяти. Со второго круга каждое «знаю» проверяется.
- Причина: быстро обнаружить и временно пресечь стратегию поспешного нажатия.
D-008. Система очков
- Статус: принято
- Решение:
+1за непроверенное «знаю»,+3за верную проверку «знаю»,−10за ошибочную,+2за верный «лоадинг»,0за ошибочный «лоадинг» и «не знаю».
D-009. Повтор внутри сессии
- Статус: принято
- Решение: «лоадинг», «не знаю» и ошибки возвращают слово в круг. Верный «лоадинг» тоже возвращает слово: он даёт очки, но должен закончиться уверенным проверенным знанием.
D-010. Завершение слова в текущем бандле
- Статус: временно
- Решение: на первом появлении слово завершается непроверенным
knowили верным провереннымknow; после любого возврата — только верным провереннымknow. - Причина: сохранить быстрый отсев известных слов и при этом объективно закрывать серую зону.
D-011. Сравнение ответа
- Статус: принято
- Решение MVP: проверять не строго. Нормализовать регистр, Unicode, пробелы, апострофы/дефисы и конечную пунктуацию; для латыни считать макроны необязательными; учитывать явные варианты ответа.
- Небольшие опечатки: расстояние редактирования до 1 для ответа от 5 символов и до 2 для ответа от 10 символов. Ответы короче 5 символов после нормализации должны совпадать точно.
- Нечёткое совпадение считается правильным, но сохраняется как
fuzzy_matchдля возможной последующей настройки.
D-012. Долгосрочный статус и сложность
- Статус: принято
- Решение:
learnedпосле верного активного воспроизведения в 3 разных дня. Ошибочноеknowдаётdifficulty +2;dont_knowили неверныйunsure—+1; первая верная активная проверка в другой день —−1. - Причина: простой и объяснимый старт без преждевременной сложной spaced-repetition модели.
- Требование: хранить полную историю попыток и вынести формулу в заменяемую доменную политику.
D-013. Разминка
- Статус: принято, алгоритм временно
- Решение: перед бандлом давать 2–3 самых сложных доступных слова из прошлых дней; они не входят в прогресс бандла.
- Открыто: интервал, после которого уже выученное слово снова допустимо в разминку.
D-014. Футбольные карточки
- Статус: принято, детали временно
- Решение: за завершённый бандл выдаётся одна случайная карточка. В MVP сначала выдавать неполученную карточку; после заполнения набора разрешить дубли и показывать их количество.
- До загрузки настоящих изображений использовать пять
нейтральных SVG-плейсхолдеров из
карточки/. Марина загрузит изображения позже. - Перед публичным использованием настоящих фото проверить право на их использование; не копировать дизайн официальных коллекционных карточек.
D-015. Мотивационная реакция
- Статус: принято
- Решение: каждые пять верных проверенных ответов — короткая реакция футбольного персонажа или оригинального зелёного персонажа в духе крипера, без копирования Minecraft-ассетов.
D-016. Импорт через Terra/Codex headless
- Статус: принято
- Решение: одна загрузка из 1–10 фото создаёт один импорт и после родительского подтверждения — один бандл. Unit вводится вручную. Обработка идёт асинхронно.
D-017. Human-in-the-loop для OCR
- Статус: принято
- Решение: распознанные слова никогда не становятся активными автоматически; родитель может исправить, добавить или удалить строки.
D-018. Изображения распечаток
- Статус: принято
- Решение: хранить вне публичного каталога и удалять сразу после успешного подтверждения импорта; структурированный результат и история сохраняются.
D-019. Стек приложения
- Статус: открыто
- Решение по legacy: приложенный
vocabeltest.htmlиспользуется только как источник слов; игровая механика переписывается. - Предложение для нового приложения: небольшой серверный монолит + SQLite, фоновый worker для Codex headless, PWA-capable frontend. Конкретный язык/фреймворк ещё нужно выбрать.
D-020. Публикация
- Статус: принято
- Решение:
vocabulary.softdock.deна VPS/Softdock, HTTPS, системная служба, резервные копии. Отдельный Basic Auth поверх входа приложения не требуется, если приложение корректно защищает обе роли.
D-021. Часовой пояс дня
- Статус: временно
- Решение:
Europe/Berlinдля очков за день, дат повторения и статистики.
D-022. Отложенные функции
- Статус: отложено
- Решение: не включать в MVP подготовку перед тестом, V-Bucks/сезоны, рейтинг сессии, латинские формы, редкости и клубные наборы.
D-023. Перенос слов из старого приложения
- Статус: принято
- Решение: оригинал хранить без изменений в
legacy/vocabeltest.html; использовать нормализованную выгрузкуdata/legacy-vocabulary.jsonкак миграционный источник. - Результат извлечения: 105 латинских и 222 английских слова с немецкими значениями, русскими подсказками, грамматическими пометками и разделами.
- Старое состояние «убрано/выучено» хранится только в
localStorageконкретного браузера и в приложенном HTML отсутствует; начинать импортированные слова без переноса этого статуса.
Подтверждения Марины от 20.11.2026
Все восемь первоначальных вопросов закрыты. Настоящие изображения карточек будут загружены позже; до этого используются плейсхолдеры.
Tasks.md — план реализации Vocabulary
Легенда
[ ]не начато[~]в работе[x]готово[?]ждёт решения
0. Продуктовая фиксация
1. Аудит и технический фундамент
Результат этапа: пустое, но запускаемое приложение с тестами и зафиксированной архитектурой.
2. UX-прототип
Результат этапа: согласованный кликабельный или HTML-прототип ключевого потока.
3. База и авторизация
Результат этапа: обе роли входят и видят только разрешённые экраны/API.
4. Словарь и бандлы parent
Результат этапа: parent может полностью подготовить бандл вручную.
5. Игровой движок
Обязательные тест-кейсы:
Результат этапа: весь бандл можно честно пройти на мобильном экране.
6. Междневное обучение
Результат этапа: сложное слово возвращается в другой день, а статус объясним из истории.
7. OCR через Codex headless
Результат этапа: родитель превращает фотографии в проверенный бандл без терминала.
8. Награды и коллекция
Результат этапа: завершение бандла даёт одну карточку, коллекция сохраняется.
9. Статистика parent
Результат этапа: Марина видит, что Лёша делал и какие слова требуют внимания.
10. Качество и пилот
Результат этапа: подтверждено, что реальная сессия укладывается примерно в 10 минут и не раздражает.
11. Деплой Softdock
Результат этапа: приложение стабильно доступно на Softdock и переживает перезапуск VPS.