Polski B1
Подготовка к государственному сертификационному экзамену по польскому
языку, уровень B1 (grupa dostosowana do potrzeb osób dorosłych).
15 минут в день, 182 дня, адаптивные упражнения и интервальное повторение.
Local-first: бэкенда нет, всё работает в браузере и офлайн.
pnpm install && pnpm dev
→ подробно в GETTING_STARTED.md
Что это
Приложение решает одну конкретную задачу: довести человека до сдачи
экзамена, а не «научить языку вообще». Отсюда два следствия, определяющие
всю архитектуру:
- Порог 50% считается по каждому модулю отдельно. Провалил
аудирование — провалил экзамен, даже со 100% в остальных четырёх.
Поэтому система максимизирует минимальный модуль, а не средний балл.
- Целевая аудитория — русскоязычные. Польский близок, и основная
работа не «выучить», а «перестать переносить русский». 22 из 66
грамматических правил помечены высоким риском интерференции — под них
пишутся точечные дриллы.
Статус
| Этап | Что | Статус |
|---|
| 1 | Исследование: экзамен, ресурсы, лицензии, алгоритмы | ✅ готово |
| 2 | Граф грамматики — 66 правил, валидатор | ✅ готово |
| — | Скелет приложения: Next 16, i18n, тема, TTS, вход Google | ✅ готово |
| 3 | Карта компетенций и программа на 182 дня | ✅ готово |
| 4 | Словарь: ядро 327 единиц, модель стоимости, раскладка по дням | ✅ готово |
| 5 | FSRS, mastery-модель, генератор занятия — 22 теста | ✅ готово |
| 6 | Движок упражнений: 7 типов, морфология SGJP — 42 теста | ✅ готово |
| 7 | Экран прогресса, навигация, оценка готовности — 47 тестов | ✅ готово |
| 8 | Postgres + Drizzle, гостевые сессии, вход через Google с проверкой токена на сервере | ✅ готово |
| 9 | Календарь, личный словарь, Chrome-расширение | ⏳ следующий |
Документация
Читать в этом порядке:
| Документ | О чём |
|---|
| docs/PLAN.md | План работ и 22 ключевых решения с обоснованиями. Начинать отсюда |
| docs/RESEARCH.md | Требования экзамена из нормативного акта, обзор ресурсов, лицензии, FSRS, честная оценка реалистичности |
| docs/DEV_RULES.md | Правила разработки: инкапсуляция стилей, границы слоёв, React, i18n, звук |
| docs/ARCHITECTURE.md | Многоязычная модель данных, слои, LanguagePlugin, стек, i18n |
| docs/CURRICULUM.md | Программа на 182 дня: фазы, ритм, бюджеты и честный расчёт, сколько слов помещается |
| docs/VOCABULARY.md | Словарь: разметка прозрачности, модель стоимости слова, измеренная вместимость |
| docs/SPACED_REPETITION.md | Две модели памяти, очередь с потолком, пропущенные дни, готовность к экзамену |
| docs/EXERCISE_ENGINE.md | 7 типов упражнений, дистракторы из парадигм SGJP, разбор ошибок |
| docs/UX_UI.md | Адаптивность на четырёх размерах экрана, темы, PWA |
|
Структура
apps/web/ Next 16, App Router, output: 'export'
packages/engine/ FSRS + mastery + генератор занятия. Без единого 'pl'
packages/ui/ дизайн-система. ТОЛЬКО здесь живут Tailwind-классы
content/pl-b1-ru/ учебный контент — данные, не код
scripts/ валидаторы контента
tools/ tts-test.html — ручная проверка синтеза речи
docs/ документация
Проект спроектирован многоязычным с первого дня: три независимые оси —
что изучаем, на каком языке объясняем, к какому экзамену готовим.
Критерий приёмки — добавление нового языка не меняет ни строки в
packages/engine.
Важные ограничения
Названы честно, потому что от них зависят обещания пользователю:
- 182 × 15 минут = 45,5 часа. Cambridge оценивает путь с нуля до B1 в
350–400 часов. Для русскоязычного цифра существенно ниже, но
45 часов с абсолютного нуля до B1 — не обещание, которое можно давать.
Отсюда диагностика на входе и три трека. Подробности —
docs/RESEARCH.md §8
- Аудирование весит 40 баллов и имеет отдельный порог, а синтез речи
не воспроизводит спонтанную речь. Это главный риск проекта
- ~800 слов, а не 2500. Измерено, а не прикинуто: словарь в 2500 активных
единиц стоит больше, чем весь бюджет курса.
docs/VOCABULARY.md §3
- Экзаменационные материалы Комиссии можно использовать как эталон
формата, но нельзя встраивать в приложение
Лицензии используемых данных
| Ресурс | Лицензия | Как используется |
|---|
| Текст rozporządzenia (перечни требований) | нормативный акт | основа учебной программы |
| SGJP / Morfeusz 2 | 2-clause BSD | 8316 форм для упражнений. Копирайт обязан быть в «О приложении» |
| Leipzig Corpora | CC BY 4.0 | частотное ранжирование лексики |
| Wikimedia Commons | CC BY-SA 4.0 | записи произношения (опционально, v2) |
