Maxim Dolgolyov
eaee79dc8a
Заменены stub'ы 'coming soon' на полноценные drag-and-drop виджеты: §3 Тепловая лавочка (Heat Conductor Bench): - SVG-sandbox 560×300 с горелкой (drop zone) и 4 стержнями (медь λ=400, серебро λ=430, стекло λ=0.8, дерево λ=0.15). - P8Drag.attach на каждый стержень → drop на горелку. - При drop'е sim запускается: P8Anim.raf обновляет цвет каждого сегмента стержня через P8Helpers.thermal.tempColor() по log-нормализованной λ. Тепловая волна идёт по стержню. - Readouts: материал, λ, T дальнего конца. §6 Heat Mixer (Q=cmΔT): - 2 ёмкости (m₁, T₁), (m₂, T₂) — рисуются с цветом по T. - 4 scrubber'a (m₁, T₁, m₂, T₂) с live update SVG. - Кнопка 'Смешать' → tween анимация в 1.2 с → итоговая T через формулу теплового баланса (m₁T₁+m₂T₂)/(m₁+m₂). - Readout T_итог, кнопка 'Сброс'. §8 График плавления (Phase Diagram T(t)): - T-t график 560×280 с осями (-20 до 120°C, 0 до 300 с). - Фазовые области: лёд (синий), вода (голубой), пар (жёлтый). - Реальная симуляция: c_льда=2100, c_воды=4200, λ=330000, r=2300000. P8Anim.raf вычисляет накопление энергии и фазовые переходы — плато на 0°C (плавление) и 100°C (кипение). - Scrubber мощности 100-2000 Вт. Кнопки Старт/Сброс. - Readouts: фаза, T. +10 XP за каждое успешное взаимодействие.
LearnSpace Backend — Фаза 1
Быстрый старт
cd backend
npm install
# 1. Скопировать и заполнить переменные окружения
cp .env.example .env
# 2. Создать базу данных в PostgreSQL
createdb learnspace
# 3. Применить миграции (создать таблицы)
npm run migrate
# 4. Загрузить тестовые вопросы
npm run seed
# 5. Запустить сервер
npm run dev
API
Auth
| Метод | URL | Тело | Описание |
|---|---|---|---|
| POST | /api/auth/register |
{ email, password, name } |
Регистрация |
| POST | /api/auth/login |
{ email, password } |
Вход |
| GET | /api/auth/me |
— | Текущий пользователь |
Предметы
| Метод | URL | Описание |
|---|---|---|
| GET | /api/subjects |
Список предметов |
| GET | /api/subjects/:slug/topics |
Темы предмета |
Сессии тестирования
| Метод | URL | Тело | Описание |
|---|---|---|---|
| POST | /api/sessions |
{ subject_slug, mode, count, topic_id? } |
Начать тест |
| POST | /api/sessions/:id/answer |
{ question_id, option_id, time_spent_sec? } |
Отправить ответ |
| POST | /api/sessions/:id/finish |
— | Завершить тест + разбор |
| GET | /api/sessions/:id/result |
— | Результат завершённого теста |
| GET | /api/sessions/history |
— | История тестов |
Все /api/sessions/* требуют заголовок:
Authorization: Bearer <token>
Добавление вопросов
Создать JSON-файл в data/ по образцу questions-bio.json:
{
"subject": "chem",
"topics": [{ "name": "Органическая химия", "order": 1 }],
"questions": [
{
"topic": "Органическая химия",
"difficulty": 2,
"text": "Текст вопроса",
"options": ["А", "Б", "В", "Г"],
"answer": 0,
"explanation": "Объяснение правильного ответа"
}
]
}
Затем повторно запустить npm run seed.
Структура проекта
backend/
├── data/ ← JSON с вопросами
├── src/
│ ├── server.js ← точка входа
│ ├── middleware/auth.js ← JWT верификация
│ ├── db/
│ │ ├── pool.js ← соединение с PostgreSQL
│ │ ├── migrate.js ← запуск миграций
│ │ ├── seed.js ← загрузка вопросов
│ │ └── migrations/ ← SQL-файлы схемы
│ ├── routes/ ← маршруты
│ └── controllers/ ← бизнес-логика
└── .env.example