Lemma — веб-платформа для учителя математики: рабочее пространство (календарь, журнал, КТП, заметки), база задач с семантическим поиском, генераторы вариантов ЕГЭ/ОГЭ и тренажёров, онлайн-тесты для учеников, аналитика результатов, модули геометрии, теории и ТДФ.
Production: l.oipav.ru — учительский интерфейс · student.oipav.ru — ученический · lemma.oipav.ru — лендинг · task-ege.oipav.ru — backend
| Интерфейс | URL (production) | Что делает |
|---|---|---|
| Учительский | l.oipav.ru (закрытый, вход по логину) |
Пространство учителя, задачи, генераторы, выдача тестов, аналитика |
| Ученический | student.oipav.ru |
Тесты по коду/QR, личный кабинет, курсы, достижения |
| Лендинг | lemma.oipav.ru |
Промо-страница |
Моё пространство — учительское фло вокруг реального расписания:
- «Сегодня» — дашборд одного окна: идущий урок, KPI, расписание дня, дедлайны, заметки
- Календарь уроков, дедлайнов и дел; расписание пар и интенсивы, посещаемость
- Классы и группы, журнал сдачи (ученик × выдача), КТП с экспортом в Word/PDF
- Копирование состава группы и сводки теста для чата; назначение тестов группам с напоминанием о сроке на главной ученика
- Журнал класса: ручные и онлайн-результаты, зачёты, экзамены и интенсивы; экспорт текущего вида журнала или отдельной работы в Excel (.xlsx)
- Учебные годы: перевод классов на новый год одним мастером (повышение, выпуск, архив), история членства по годам
- Модерация учеников: профиль, доступ (логин и пароль), статусы «учится / выпустился / выбыл», массовые операции
- Заметки (блочный редактор с LaTeX), дела, библиотека материалов и файлов
- Каникулярные задания — индивидуальные программы на лето с отслеживанием прогресса
В «Журнале класса» выберите класс и нужный период. Меню «Экспорт → Скачать Excel (.xlsx)» сохраняет текущий вид таблицы с учётом фильтров, свёрнутых блоков и выбранного показа баллов, процентов или оценок.
Для отдельной зачётной работы нажмите её заголовок и выберите «Скачать Excel (.xlsx)». Так же выгружаются экзамены и интенсивы. В файл входят ученики, все части работы, включая свёрнутые, и выставленные итоги; выбранный период не обрезает работу. Скрытые колонки включаются, если в журнале включён показ скрытых.
Дробные баллы записываются числами. Плюсы, минусы, дозачёты и отметки «н», «w», «—» сохраняются текстом. Подсказки ещё не выставленных итогов остаются пустыми. В книге закреплены шапка и имена учеников, есть фильтр строк и средние оценки по классу (выбывшие в средних не учитываются).
База задач:
- Каталог с фильтрами (темы / подтемы / теги / сложность / источник / год / изображения)
- LaTeX (KaTeX) + Markdown, GeoGebra-чертежи, числовые прямые
- Импорт из MD/YAML и парсер «Решу ЕГЭ» (ЕГЭ база/профиль, ОГЭ, ВПР — с критериями и чертежами)
- Семантический поиск на эмбеддингах: похожие задачи, поиск дублей, параллельные варианты, подбор «по образцу» / «разные сюжеты» / «анти-дубль», работа над ошибками класса
Генераторы работ:
- Универсальный генератор листов и карточек (A4/A5/A6, варианты, дистракторы)
- Полные варианты ЕГЭ (база — 21 задание, профиль — 19 в двух частях) и ОГЭ (25 заданий со связным блоком 1–5) в стиле КИМ
- Контрольные работы, тесты A/B/C/D с перемешиванием, калькулятор баллов ЕГЭ
- Автопроверка бумажных бланков ответов №1 по фотографии (vision-LLM)
После создания работы откройте её карточку в «Моих работах» и нажмите «Прикрепить к уроку» над вкладками выдачи. Та же кнопка есть в полном редакторе. Найдите урок по классу, дате или теме: список охватывает последнюю неделю и ближайшие 60 дней, отменённые уроки не предлагаются.
Если класс показывает ученикам расписание, выберите способ выдачи: «Решать онлайн», «Только условия», «Писали на бумаге» или «Только мне». Для онлайн-работы и условий можно выбрать классную работу, ДЗ или ДЗ к следующему уроку и указать обязательность. Онлайн-режим использует открытую выдачу; при её отсутствии создаёт новую. Показ условий открывает работу по ссылке. Урок без ученического расписания сохраняет материал только для учителя; скрытый урок сам по себе ученикам не открывается.
Связанные уроки и способ выдачи видны рядом с кнопкой. Крестик у урока открепляет работу, сохраняя саму работу, выдачу и результаты учеников. Материал также доступен для настройки в календаре, в окне урока.
Тригонометрия (11 генераторов): единичная окружность, значения функций, выражения, обратные функции, уравнения (в т.ч. f(kx+b)=a), формулы приведения и сложения, двойной аргумент, шифровки, смешанная работа.
Устный счёт (7 генераторов): арифметика, степени и логарифмы, степени и корни, логарифмы, действия с десятичными и обыкновенными дробями, смешанная работа.
Геймификация: QR-листы, пиксель-арт (одиночный и командный), шифровки, маршрутные листы, марафон защиты задач с live-доской, кроссворды.
Геометрия: собственная база + банк МЦНМО (17,6 тыс. задач с фасетными тегами), GeoGebra-чертежи (живой апплет + PNG/SVG-экспорт), компоновка листов S/M/L/XL, печать с физическими mm/pt.
Листки: 41 лист Гордина (планиметрия и стереометрия, 1641 задача) + редактор собственных листков.
Теория: статьи на Markdown + KaTeX в редакторе CodeMirror, каллауты, палитра формул, GeoGebra-иллюстрации, печать конспектов.
ТДФ (Теоремы, Определения, Формулы): структурированные конспекты по классам, опросники и флешкарты, листы формул, КИМ-стиль печати с двухфазной пагинацией.
Ученики: прогресс, тепловая карта ошибок, достижения (random + conditional), личный кабинет с историей попыток, онлайн-курсы с публикацией уроков и домашних заданий.
Авторизация: роли superadmin / editor / viewer, доступ по секциям, журнал действий, мультиучительство (данные скоупятся по владельцу). См. AUTH.md.
Frontend (ege-tasks/):
- React 18.2 + Vite 5.0, React Router v7 (все страницы через
React.lazy()) - Ant Design 5.12
- KaTeX + react-markdown (GFM)
- CodeMirror 6 (редакторы LaTeX и теории), BlockNote (заметки), Excalidraw
- PocketBase SDK 0.21
- GeoGebra applet API + JSXGraph (SVG export)
- Печать/PDF — только на клиенте:
window.print()+@media print, html2pdf.js - Vitest — 984 теста в 64 файлах
Backend (pocketbase/):
- PocketBase 0.36.4 (SQLite, REST API, Auth, File storage)
- Backend helper на Node.js 20: парсер «Решу ЕГЭ», LLM-нормализация LaTeX, распознавание бланков, векторный поиск (sqlite-vec). PDF не генерирует — серверный Puppeteer выпилен в июне 2026
- Второй PocketBase
pb-files— библиотека материалов и файлов учителя
# 1. Установка зависимостей
git clone https://github.com/evilfaust/lemma.git
cd lemma
cd ege-tasks && npm install && cd ..
# 2. Backend
# По умолчанию фронтенд использует task-ege.oipav.ru.
# Для своего экземпляра задайте VITE_PB_URL в ege-tasks/.env.local.
# 3. Dev-сервер фронтенда
./start.sh # или: cd ege-tasks && npm run dev
# → http://localhost:5173# Сборка production (3 приложения: index.html + student.html + landing.html)
cd ege-tasks && npm run build
# Тесты (Vitest, ~6 сек)
cd ege-tasks && npm test
cd ege-tasks && npm run test:watch
# Пересчёт векторного индекса задач (вручную, требует Ollama на локальной машине)
cd vector-benchmark && npm run indexlemma/
├── ege-tasks/ # Frontend (React + Vite)
│ ├── src/
│ │ ├── components/ # ~260 компонентов
│ │ │ ├── workspace/ # Моё пространство: календарь, журнал, КТП, заметки, дела
│ │ │ ├── auth/ # LoginPage, UserManager, AuditLog, ProtectedRoute
│ │ │ ├── catalog/ # Справочники (темы, теги, источники, дубли)
│ │ │ ├── geometry/ # Модуль геометрии (редактор, чертежи)
│ │ │ ├── listki/ # Листки Гордина + редактор своих
│ │ │ ├── tdf/ # Теоремы, определения, формулы
│ │ │ ├── theory/ # Теория (Markdown + CodeMirror + GeoGebra)
│ │ │ ├── student/ # Ученический интерфейс
│ │ │ ├── trig/ # Тригонометрические подкомпоненты
│ │ │ ├── worksheet/ # Переиспользуемые элементы листов
│ │ │ ├── marathon/ crossword/ mc-test/ pixel-art/ qr-worksheet/ route-sheet/
│ │ │ └── shared/ # MathRenderer, LatexField, CropModal
│ │ ├── contexts/ # ReferenceDataContext, AuthContext
│ │ ├── hooks/ # ~47 custom хуков
│ │ ├── shared/services/pb/ # API по доменам (26 модулей) + barrel pocketbase.js
│ │ ├── utils/ # Helpers (LaTeX, shuffle, QR, normalize, …)
│ │ ├── landing/ # Автономный лендинг (без Ant Design)
│ │ ├── App.jsx # Teacher routes
│ │ └── StudentApp.jsx # Student routes
│ ├── public/ # Static assets (ачивки, логотипы)
│ └── src/__tests__/ # Тесты (Vitest)
│
├── pocketbase/ # Backend
│ ├── pb_migrations/ # Миграции (96 шт.)
│ ├── pb_hooks/ # JS-хуки PocketBase (stats, слияние и модерация учеников)
│ ├── pdf-service.js # Backend helper: sdamgia, LLM, векторный поиск, бланки
│ └── vec-search.js # Векторный поиск (sqlite-vec)
│
├── vector-benchmark/ # Индексатор эмбеддингов (запуск вручную)
├── .github/workflows/ # CI: деплой лендинга (по кнопке)
│
├── README.md # ← вы здесь
├── CHANGELOG.md # История релизов
├── LICENSE / NOTICE # AGPL-3.0 и перечень исключений
└── AUTH.md # Архитектура системы авторизации
- Запустите PocketBase с хуками из
pocketbase/pb_hooks/и примените миграции изpocketbase/pb_migrations/к совместимой базовой схеме. Ранние миграции рассчитаны на существующие коллекции. Создайте первого учителя по инструкции. - Укажите адрес своего сервера в
VITE_PB_URL, соберите фронтенд черезnpm run buildвege-tasks/и опубликуйте содержимоеege-tasks/dist/.
Учительский интерфейс требует логина. Подробно — в AUTH.md.
| Роль | Что может |
|---|---|
superadmin |
Всё + управление пользователями + журнал действий |
editor |
CRUD задач/работ/тестов в разрешённых секциях |
viewer |
Просмотр, генерация, печать, экспорт PDF — без изменений |
Регистрация отключена — пользователей создаёт суперадмин через /app/admin/users.
См. CHANGELOG.md.
Copyright © 2026 Oleg Pavlyuchenko
Код проекта распространяется на условиях GNU AGPL-3.0 (или любой более поздней версии).
Что это значит на практике:
- ✅ Можно изучать код, форкать, использовать и дорабатывать — в том числе в школе и на уроках;
- ✅ Можно развернуть свою копию платформы;
⚠️ Если вы запускаете Lemma (или производную работу) как сетевой сервис, доступный другим людям, вы обязаны предоставить им исходный код своей версии, включая внесённые изменения — это ключевое отличие AGPL от GPL;⚠️ Производные работы распространяются только под той же лицензией AGPL-3.0;⚠️ Указание авторства и сохранение уведомлений об авторских правах обязательны;- ❌ Нельзя закрыть код и продавать его как проприетарный продукт.
Важно: лицензия покрывает только исходный код. Учебный контент (задачи из «Решу ЕГЭ», банка МЦНМО, листков Гордина, ФИПИ), изображения достижений, а также название и логотип «Lemma» под AGPL не подпадают — подробности и перечень исключений в файле NOTICE.
Автор — единственный правообладатель кода и сохраняет право лицензировать его на иных условиях. По вопросам коммерческого лицензирования: oleg.faust@gmail.com