Не стыдно
Веб-тренажер по школьной истории. Проект Дани: он отвечает за стиль, персонажей и шутки, Алена — за техничку и контент, ассистент — за код.
Сейчас: История Средних веков, 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 — чтобы на телефоне добавлялось на главный экран
Как добавлять и править контент
- Открыть
content/srednie-veka-6/content.xlsx, править нужный лист (легенда на первом листе). Столбец id не трогать.
- В терминале из папки проекта:
python3 tools/xlsx2json.py
- Обновить страницу. Закоммитить и 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.
Этапы
- Скелет ✓: механики, карта параграфа, подводки, сундуки, боссы, микс дня, персонажи, стиль, сайт на Pages.
- Аккаунты и прогресс в облаке (Supabase), контент в базу, Google-таблица для наполнения, анимации персонажей, магазин за XP (идея Дани).
- Шаринг: таблица лидеров, вызов другу.
- Другие предметы.
Деплой
GitHub Pages: любой пуш в main обновляет сайт через минуту. Адрес: https://bprgsf7927-dev.github.io/ne-stydno/
Авторство
Код открыт, чтобы его можно было посмотреть и поучиться. Контент (вопросы, ассоциации, шутки) и персонажи — авторская работа Дани и Алены; использовать их в других проектах без разрешения нельзя.
