Harden human-first curriculum and assessments

Author: gon7187

.gitignore

@@ -4,3 +4,8 @@ __pycache__/
 .ruff_cache/
 python_path.db*
 *.pyc
+graphify-out/.graphify_*
+graphify-out/cache/
+graphify-out/cost.json
+graphify-out/manifest.json
+graphify-out/memory/

CONTRIBUTING.md

@@ -24,10 +24,12 @@ uv run pytest -q
 - У урока есть лестница от примера и прогноза к воспроизведению, Parsons/изменению и обязательному коду.
 - Ни теория, ни отвлекающие варианты, ни заготовка, ни подсказка, ни скрытый тест не используют инструмент до вводящего урока.
 - Кодовые задания должны быть короткими, детерминированными и совместимыми с учебным раннером.
-- Финальное задание комбинирует текущую тему только с уже знакомыми навыками и проверяет минимум два сценария, когда это возможно.
+- Каждая Python-карточка теории должна быть самодостаточной и явно указывать ожидаемый консольный вывод, включая пустой вывод для определений и присваиваний.
+- Финальное задание комбинирует текущую тему только с уже знакомыми навыками и проверяет минимум два поведенческих сценария. 108 тематических заданий расширенной части и все проекты хранят исполняемый эталон для CI в `reference_solution`; он должен проходить все сценарии и никогда не отдаётся публичным API.
+- Структурный `source`-тест допустим только вместе с поведенческими проверками, когда конкретная форма входит в цель урока.
 - Не добавляйте большие заимствованные фрагменты чужих курсов. Пересказывайте идеи своими словами и ссылайтесь на первоисточник в PR.
 
-Полный норматив и чек-лист автора находятся в [docs/LEARNING_DESIGN.md](docs/LEARNING_DESIGN.md). Любое изменение контента должно сохранять пустой результат `audit_learning_pipeline(LESSONS)`; это проверяется тестами CI.
+Полный норматив и чек-лист автора находятся в [docs/LEARNING_DESIGN.md](docs/LEARNING_DESIGN.md). Любое изменение контента должно сохранять пустой результат `audit_learning_pipeline(LESSONS)`, `audit_projects(PROJECTS, LESSONS)` и `audit_exam_coverage(EXAMS, LESSONS, QUESTION_BY_ID)`; это проверяется тестами CI.
 
 ## Коммиты и PR
 

README.md

@@ -11,8 +11,9 @@ Python Path делает обучение практичным и последо
 
 |  | Сейчас в курсе |
 | --- | --- |
-| 📚 Программа | **32 раздела · 151 урок · 585 заданий** |
+| 📚 Программа | **32 раздела · 151 урок · 585 заданий · 32 экзамена** |
 | 🧠 Практика | Извлечение из памяти, интервалы 1/3/7/14/30, смешанные серии и исправление ошибок |
+| 🛠️ Проекты | **15 инструментов** от открытки до менеджера задач |
 | 🏆 Мотивация | XP, звёзды, стрик, достижения, повторение ошибок |
 | 📱 Интерфейс | Адаптивный, без фронтенд-сборки |
 | ⚙️ Технологии | FastAPI · SQLite · vanilla JavaScript · uv |
@@ -44,7 +45,7 @@ uv run uvicorn app.main:app --host 0.0.0.0 --port 8000
 2. Строки, модули, файлы, JSON/CSV, исключения и ООП.
 3. Типы, стандартная библиотека, регулярные выражения, тесты и Git.
 4. CLI, окружения, HTTP/API, SQL, параллельность и async.
-5. Четыре выпускных мини-проекта: задачи, заметки, API-клиент и релиз приложения.
+5. Выпускной блок: менеджер задач, заметки, API-клиент и подготовка приложения к релизу.
 
 Перед основным курсом есть «Спокойный старт» из 20 микроуроков: `print`, строки, переменные, типы, `len`, f-строки, `input`, преобразования и строковые методы — без перегрузки несколькими новыми идеями сразу. Пороговые темы тоже раздроблены: отдельно изучаются `if`/`else`, цикл/накопитель, `while`/`break`, вызов/параметр/`return`, список/`append`, `split`, `sum`, словарь и множество.
 
@@ -54,17 +55,17 @@ uv run uvicorn app.main:app --host 0.0.0.0 --port 8000
 
 - Каждый урок содержит подробную теорию, исполняемые примеры с выводом и переход от узнавания к самостоятельному коду.
 - Используются выбор, свободное воспроизведение, Parsons-блоки, код и накопительные финальные задачи.
-- Подсказки исчезают постепенно: направление → план → почти готовая форма.
-- Следующий урок открывается после успешного прохождения предыдущего.
-- Урок нельзя сдать, пропустив обязательный код; контрольная точка требует 70% и практические задания.
+- Подсказки открываются постепенно: направление → инструмент → алгоритм → почти готовая форма. Последняя доступна только после своей попытки, а решение с подсказкой не считается самостоятельным повторением.
+- Если забыл точное имя, каждое задание с редактором даёт справочник нужных уже изученных функций, методов и конструкций с формой вызова, объяснением и нейтральным примером.
+- Урок нельзя сдать, пропустив обязательный код; порог урока — 75%. Новый раздел откроется только после экзамена предыдущего. В экзамене код получает отдельный, ранее не показанный поведенческий сценарий и может быть написан любым эквивалентным способом.
 - Практика берёт только завершённые уроки, чередует форматы и распределяет повторения по интервалам 1/3/7/14/30 дней.
 - Ошибка попадает в мягкий режим повторения и исчезает из слабых мест после двух последовательных верных решений.
-- Код проверяется в изолированном Python-процессе с AST-фильтром и двухсекундным лимитом.
+- Код проверяется в отдельном Python-процессе с AST-фильтром и двухсекундным лимитом. Доступны виртуальные файлы, SQLite, `argparse`, async, очереди и до четырёх потоков.
 - `input()` работает через безопасный симулятор: ответы вводятся под редактором, по одной строке для каждого вызова.
 - Вкладка «Песочница» даёт свободный редактор с историей запусков и консолью: можно экспериментировать без проверки задания.
 - После сдачи урока и серии практики показывается реальный консольный вывод выполненного кода.
-- В разделе «Проекты» есть шесть мини-инструментов: они открываются по конкретным prerequisite-урокам и проверяются на нескольких входных сценариях.
-- Curriculum-linter проверяет метаданные, скрытые тесты и запрет незнакомых конструкций до объяснения.
+- В разделе «Проекты» есть 15 инструментов: они открываются по конкретным prerequisite-урокам и проверяются на нескольких сценариях.
+- Curriculum-linter проверяет метаданные, все видимые поверхности, эталонные решения, скрытые тесты и запрет незнакомых конструкций до объяснения.
 - Один пользователь, локальный SQLite: можно заниматься без регистрации и облака.
 
 ## Как устроена практика
@@ -76,7 +77,7 @@ uv run uvicorn app.main:app --host 0.0.0.0 --port 8000
 3. **Смешанная серия** — чередовать выбор, воспроизведение, Parsons и код из разных изученных тем.
 4. **Выбранный раздел** — тренировать все завершённые уроки раздела, а не только последний.
 
-У каждого задания есть план решения, а после серии показывается результат и понятный следующий шаг.
+У каждого кодового задания есть план решения и тот же справочник инструментов, что в уроке: практика не требует помнить наизусть, что `.lower()` меняет регистр, `.split()` возвращает список, а `.get()` умеет дать запасное значение. После серии показывается результат и понятный следующий шаг.
 
 ## Личный прогресс и тесты
 
@@ -99,9 +100,12 @@ uv run pytest -q
 app/
   main.py                 # FastAPI-приложение и JSON API
   content.py              # базовые уроки и объединение программы
+  gentle_start.py         # первые 19 коротких уроков без перегрузки
   foundation_expansion.py # плавные микроуроки и накопительные задачи
   extended_curriculum.py  # 108 уроков расширенной части
+  advanced_practice.py    # 108 уникальных тематических кодовых заданий
   learning_design.py      # метаданные, интервалы и curriculum-linter
+  projects.py             # 15 проектов и их исполняемые спецификации
   evaluator.py            # проверка ответов и учебного кода
   db.py                   # SQLite-прогресс
   static/                 # адаптивный интерфейс

SECURITY.md

@@ -2,7 +2,9 @@
 
 ## Учебный раннер
 
-Python Path выполняет только короткий код для учебных задач. Перед запуском код проверяется по AST, импорт ограничивается allowlist, а файлы доступны только через временную виртуальную папку (`open`/безопасный `pathlib`). Выполнение идёт отдельным Python-процессом с ограниченным набором встроенных функций и завершается по таймауту. Системные, процессные и произвольные сетевые операции закрыты.
+Python Path выполняет только короткий код для учебных задач. Перед запуском код проверяется по AST, импорт ограничивается allowlist, а выполнение идёт отдельным Python-процессом с ограниченным набором builtin-функций и двухсекундным таймаутом.
+
+Учебные `open()`, `pathlib.Path` и SQLite перенаправлены в одну временную папку; SQLite запрещает `ATTACH`, загрузку расширений и файловые функции. `argparse` не читает аргументы из файлов, `sys` отдаёт только безопасные учебные поля, а одновременно можно запустить не более четырёх потоков. Дочерние процессы, произвольные сетевые операции и доступ к хостовым файлам закрыты.
 
 Это снижает риск для локального тренажёра, но не заменяет инфраструктурную изоляцию. Не размещайте текущую версию как публичный сервис, в котором чужие пользователи могут исполнять произвольный код.