@

feat(quantik-game): фаза 1 — оболочка игры + физ-уровень + прогресс (MVP)

Страница /quantik монтирует уровень-спеку в SimEngine (игровой режим: HUD из
Ф0 + слайдеры закона + play/reset), на победу шлёт результат и показывает
экран успеха (звёзды/время/попытки, inline SVG). Уровень phys-artillery-1
как данные (levels.js): гравитация + запуск тела из угла/скорости, портал,
бонус-звезда. Бэкенд: миграция 076 game_progress (UNIQUE user+level),
/api/game/progress (GET свой / POST upsert best time/stars, attempts++,
auth-only, валидация входа), клиент LS.gameProgress*, пункт сайдбара.
game.test.js 13/13; npm test 251 pass/8 baseline; lint:routes 0.
Уровень проверен на реальном интеграторе (311 выигрышных комбо, 31 на 3★).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@

plans/quantik-game/CONTEXT.md

@@ -11,12 +11,29 @@
   Изменены: `frontend/js/labs/_sim_engine.js`, `backend/src/controllers/customSimController.js`.
   Аддитивно: спека без `goal` ведёт себя ровно как раньше (HUD не создаётся, побед не считается).
   Смоук 40/40; `npm test` 238 pass / 8 baseline fail; lint:routes 0.
+- **Phase 1 реализован** (pending review): сквозной играбельный срез. Страница `/quantik`
+  (`frontend/quantik.html` + `frontend/js/game/quantik-game.js`) монтирует уровень-спеку через
+  `SimEngine.mount`; «игровой режим» = HUD из Ф0 (сам по наличию `goal`) + слайдеры params +
+  play/reset. Уровень `phys-artillery-1` — данные в `frontend/js/game/levels.js`
+  (`window.QuantikLevels`): physics-гравитация + body-запуск под углом θ/скоростью v, портал-цель,
+  бонус-звезда. На победу `onGoal` → `LS.gameProgressSubmit` + DOM-оверлей успеха (звёзды/время/попытки).
+  Прогресс: таблица `game_progress` (мигр.**076**), API `/api/game/progress` (GET/POST,
+  `gameController.js`+`routes/game.js`, смонтировано в `server.js` после `/api/custom-sims`),
+  клиент `LS.gameProgressList/Submit`. Сайдбар: `/quantik` (icon `rocket`) виден всем.
+  Новые: `076_game_progress.sql`, `gameController.js`, `routes/game.js`, `quantik.html`,
+  `js/game/levels.js`, `js/game/quantik-game.js`, `tests/game.test.js`. Изменены: `server.js`,
+  `js/api.js`, `js/sidebar.js`. `npm test` 251 pass / 8 baseline fail (game.test.js 13/13);
+  lint:routes 0; миграция применяется чисто.
 
 ## Key Architecture Decisions
 - **«Атом» = блок `goal` в спеке** (булево SimExpr). Любой уровень = спека SimForge + `goal`.
   Движок вычисляет `goal.when` каждый кадр; победа → result + callback. Нет `goal` → no-op.
 - **Уровни хранятся в `custom_sims`** (cat='game'), а не в новой таблице. Реюз авторинга/шаринга/embed.
   Новые таблицы — только под ПРОГРЕСС игрока и лидерборд (мигр.).
+  - **Уточнение Ф1**: для MVP уровни — ВСТРОЕННЫЕ ДАННЫЕ в `frontend/js/game/levels.js`
+    (`window.QuantikLevels`, форма `{ id, title, subject?, hint?, spec }`), а не записи `custom_sims`.
+    `custom_sims` cat='game' остаётся целевым хранилищем для авторённых уровней (Ф5); реестр тогда
+    станет асинхронным (загрузка опубликованных + слияние со встроенными той же формы записи).
 - **Герой Квантик**: в уровне = engine point с `body` + glow + trail (визуал P2). На карте/в
   диалогах = `PetSprite.render(level, mood, accessories, colorKey, streak, pattern)` (DOM SVG).
 - **Управление = чинить закон**, а не WASD: игрок крутит `params`-слайдеры движка (угол/скорость/