Не стыдно

Веб-тренажер по школьной истории. Проект Дани: он отвечает за стиль, персонажей и шутки, Алена — за техничку и контент, ассистент — за код.

Сейчас: История Средних веков, 6 класс (учебник Мединский, Чубарьян, 2025), главы V–VI.

Запустить локально

Сайт статический, сборки нет. Но вопросы грузятся через fetch, поэтому открывать нужно через сервер, а не двойным кликом по файлу.

Терминал 2 (из папки проекта):

python3 -m http.server 3000

Открыть http://localhost:3000. На телефоне в той же Wi-Fi сети — http://<ip-мака>:3000.

Структура

index.html                 — единственная страница
css/style.css              — стиль «каракули в тетради» (правила в docs/STYLE.md)
js/app.js                  — вся логика: карта, тренировки, подводки, обратная связь, прогресс
js/characters.js           — Опти, Ник, Душка: SVG-дудлы, реплики, костюмы эпох (Даня правит здесь)
content/srednie-veka-6/
  content.xlsx             — ИСТОЧНИК ПРАВДЫ: параграфы (и их части), даты, термины, персоналии, причины, тексты, правда-ложь, главы
  *.json                   — генерируются из xlsx, руками не править
tools/xlsx2json.py         — xlsx → json (запускать после правки таблицы)
tools/build_content.py     — первичная сборка xlsx из авторского источника (разово)
assets/                    — иконки сайта
docs/tasks/                — спеки заданий, одна на этап: YYYY-MM-DD_тема.md
docs/BACKLOG.md            — что решили делать потом
docs/STYLE.md              — гайд по стилю «каракули в тетради», сверяться перед любым новым элементом
manifest.webmanifest       — чтобы на телефоне добавлялось на главный экран

Как добавлять и править контент

1. Открыть content/srednie-veka-6/content.xlsx, править нужный лист (легенда на первом листе). Столбец id не трогать.
2. В терминале из папки проекта: python3 tools/xlsx2json.py
3. Обновить страницу. Закоммитить и xlsx, и json.

Листы: Даты (с ассоциацией assoc и мини-фактом more), Термины, Персоналии, Причины, Тексты (пропуски {0} {1} {2}), Правда-ложь, Уроки (какие даты в каком уроке), Главы.

Как устроено обучение

• Экран = параграф. Сверху плашка с параграфом (тап — список всех по главам). Ниже змейка: тренировки (звезды) → сундук после второй → тренировки → контрольная (лист). Число тренировок зависит от объема параграфа (3–8), длинные параграфы разрезаны на части (§21-22 ·1 и ·2).
• Тренировка = 8 заданий, шесть механик вперемешку: пары, выбор, порядок, вставить слово, напечатать год, правда/ложь. Пройдена от 70%, корона за 100%, любую можно переигрывать.
• Знакомство через подводки: в первых трех тренировках параграфа часть заданий — «первые встречи», где ответ почти очевиден из контекста; через одно задание спрашивают по-настоящему. Первая тренировка открывает вторую при любом результате. Книжка сбоку от карты — весь параграф карточками, на любой момент.
• Сундук — повторение прошлого параграфа, за 70% дает сердце (до трех). Босс главы — отдельный экран (юрта/замок) с тремя уровнями, на третьем жизни = сердца.
• Микс дня — 5 заданий из ошибок и давно не повторявшегося. Обратная связь всегда: «Ты прав / Ты не прав / Почти», при ошибке — ассоциация, мини-факт за кнопкой «хочу все знать».
• Прогресс, XP, стрик, сердца — в браузере телефона (до этапа 2).

Где что править Дане

• Шутки персонажей и реплики — js/characters.js (say), нелепые варианты в подводках — SILLY, строки под списком параграфов — PICKER_FOOT, подсказки по значкам — HINTS (все в js/app.js).
• Персонажи и костюмы эпох — js/characters.js, обычные SVG-пути.
• Вопросы, ассоциации, крючки — content.xlsx, потом python3 tools/xlsx2json.py.
• Стиль — только по docs/STYLE.md.

Этапы

1. Скелет ✓: механики, карта параграфа, подводки, сундуки, боссы, микс дня, персонажи, стиль, сайт на Pages.
2. Аккаунты и прогресс в облаке (Supabase), контент в базу, Google-таблица для наполнения, анимации персонажей, магазин за XP (идея Дани).
3. Шаринг: таблица лидеров, вызов другу.
4. Другие предметы.

Деплой

GitHub Pages: любой пуш в main обновляет сайт через минуту. Адрес: https://bprgsf7927-dev.github.io/ne-stydno/

Авторство

Код открыт, чтобы его можно было посмотреть и поучиться. Контент (вопросы, ассоциации, шутки) и персонажи — авторская работа Дани и Алены; использовать их в других проектах без разрешения нельзя.