feat(lesson-ai): проверка отчёта о занятии по шаблону + история версий

Галочка «Проверить по шаблону» в окне отчёта отправляет текст модели: совпал с шаблоном — остаётся как есть (skipped), не совпал — переписывается в деловом виде (done). Обработка идёт в фоне, HTTP-запрос не ждёт модель, оригинал тьютора сохраняется в text_original. - схема: text_original/text_ai/ai_status/ai_checked_at/ai_error в lesson_reports, таблица lesson_report_versions, ensureLessonReportsTable() - настройки lesson_ai_enabled и lesson_ai_prompt (раздел sec-lesson-ai), значения только 'true'/'false' - worker.js: createLessonReportChecker (FOR UPDATE OF lr SKIP LOCKED, до 3 попыток), хук назовён notifyEvent — notify в createPhotoEnhanceWorker уже занят будильником - server.js: wakeLessonAiWorker, onLessonAiDone (версия, аудит с diff, уведомление lesson.ai.formatted, SSE lesson_report_status), маршруты /versions, /versions/:id/restore и /ai/revert - aiComplete вместо aiCorrectText: общий вызов модели с таймаутом - бэкап/восстановление: lesson_reports и lesson_report_versions в payload - фронтенд: openLessonVersions/restoreLessonVersion в admin.js, бейджи статусов в lessons.js, лейблы аудита, renderAuditPager - docs: раздел 3d в AGENTS.md и Agent Workflow, пункт в README - тесты: контракт lesson-report и настройки уведомления в api.smoketest.js
2026-10-04 00:12:24 +03:00
parent a84f33307e
commit b931c0a760
14 changed files with 962 additions and 33 deletions
@@ -227,6 +227,11 @@ CREATE TABLE IF NOT EXISTS lesson_reports (
  lesson_date DATE NOT NULL,
  lesson_time TIME,
  text TEXT NOT NULL,
+  text_original TEXT,
+  text_ai TEXT,
+  ai_status VARCHAR(20) NOT NULL DEFAULT 'none',
+  ai_checked_at TIMESTAMPTZ,
+  ai_error TEXT,
  author_id INT REFERENCES users(id) ON DELETE SET NULL,
  branch_id INT REFERENCES branches(id) ON DELETE SET NULL,
  created_at TIMESTAMPTZ DEFAULT now(),
@@ -236,6 +241,17 @@ CREATE TABLE IF NOT EXISTS lesson_reports (
 CREATE UNIQUE INDEX IF NOT EXISTS idx_lesson_reports_group_date ON lesson_reports(group_id, lesson_date);
 CREATE INDEX IF NOT EXISTS idx_lesson_reports_date ON lesson_reports(lesson_date DESC);

+CREATE TABLE IF NOT EXISTS lesson_report_versions (
+  id SERIAL PRIMARY KEY,
+  lesson_report_id INT NOT NULL REFERENCES lesson_reports(id) ON DELETE CASCADE,
+  text TEXT NOT NULL,
+  source VARCHAR(20) NOT NULL DEFAULT 'manual',
+  author_id INT REFERENCES users(id) ON DELETE SET NULL,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_lesson_report_versions_report ON lesson_report_versions(lesson_report_id, id DESC);
+
 CREATE TABLE IF NOT EXISTS photo_jobs (
  id SERIAL PRIMARY KEY,
  entry_id INT NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
@@ -324,3 +340,28 @@ INSERT INTO settings (key, value) VALUES ('notify_backup_create', 'false')
 ON CONFLICT (key) DO NOTHING;
 INSERT INTO settings (key, value) VALUES ('notify_system_test', 'true')
 ON CONFLICT (key) DO NOTHING;
+
+INSERT INTO settings (key, value) VALUES ('lesson_ai_enabled', 'true')
+ON CONFLICT (key) DO NOTHING;
+INSERT INTO settings (key, value) VALUES ('lesson_ai_prompt', 'Ты — редактор деловых отчётов образовательного центра.
+
+Твоя задача — привести текст отчёта о занятии, написанный тьютором, к деловому стилю по шаблону ниже.
+
+ШАБЛОН ДЕЛОВОГО СООБЩЕНИЯ:
+Отчёт о проведённом занятии
+Дата: <дата занятия>
+Группа: <название группы>
+Темы: <перечень тем>
+Практика: <задания>
+Домашнее задание: <что задано>
+
+ПРАВИЛА:
+1. Сначала сравни исходный текст с шаблоном. Если текст уже соответствует шаблону (та же структура, порядок и стиль) — верни его БЕЗ ИЗМЕНЕНИЙ, дословно.
+2. Если текст не соответствует шаблону — перепиши его по шаблону, сохранив весь смысл и факты.
+3. НЕ выдумывай тем, дат, заданий и оценок, которых нет в исходном тексте. Если данных нет — не добавляй раздел.
+4. Обращение на «вы», без эмодзи и без восклицательных знаков, кратко и по делу.
+5. Не добавляй приветствия, подписи и какие-либо пояснения.
+6. Верни ТОЛЬКО итоговый текст отчёта — без кавычек, без markdown и без названия формата.')
+ON CONFLICT (key) DO NOTHING;
+INSERT INTO settings (key, value) VALUES ('notify_lesson_ai_formatted', 'false')
+ON CONFLICT (key) DO NOTHING;
@@ -320,3 +320,42 @@ CREATE TABLE IF NOT EXISTS lesson_reports (

 CREATE UNIQUE INDEX IF NOT EXISTS idx_lesson_reports_group_date ON lesson_reports(group_id, lesson_date);
 CREATE INDEX IF NOT EXISTS idx_lesson_reports_date ON lesson_reports(lesson_date DESC);
+
+ALTER TABLE lesson_reports ADD COLUMN IF NOT EXISTS text_original TEXT;
+ALTER TABLE lesson_reports ADD COLUMN IF NOT EXISTS text_ai TEXT;
+ALTER TABLE lesson_reports ADD COLUMN IF NOT EXISTS ai_status VARCHAR(20) NOT NULL DEFAULT 'none';
+ALTER TABLE lesson_reports ADD COLUMN IF NOT EXISTS ai_checked_at TIMESTAMPTZ;
+ALTER TABLE lesson_reports ADD COLUMN IF NOT EXISTS ai_error TEXT;
+
+CREATE TABLE IF NOT EXISTS lesson_report_versions (
+  id SERIAL PRIMARY KEY,
+  lesson_report_id INT NOT NULL REFERENCES lesson_reports(id) ON DELETE CASCADE,
+  text TEXT NOT NULL,
+  source VARCHAR(20) NOT NULL DEFAULT 'manual',
+  author_id INT REFERENCES users(id) ON DELETE SET NULL,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_lesson_report_versions_report ON lesson_report_versions(lesson_report_id, id DESC);
+
+INSERT INTO settings (key, value) VALUES ('lesson_ai_enabled', 'true') ON CONFLICT (key) DO NOTHING;
+INSERT INTO settings (key, value) VALUES ('lesson_ai_prompt', 'Ты — редактор деловых отчётов образовательного центра.
+
+Твоя задача — привести текст отчёта о занятии, написанный тьютором, к деловому стилю по шаблону ниже.
+
+ШАБЛОН ДЕЛОВОГО СООБЩЕНИЯ:
+Отчёт о проведённом занятии
+Дата: <дата занятия>
+Группа: <название группы>
+Темы: <перечень тем>
+Практика: <задания>
+Домашнее задание: <что задано>
+
+ПРАВИЛА:
+1. Сначала сравни исходный текст с шаблоном. Если текст уже соответствует шаблону (та же структура, порядок и стиль) — верни его БЕЗ ИЗМЕНЕНИЙ, дословно.
+2. Если текст не соответствует шаблону — перепиши его по шаблону, сохранив весь смысл и факты.
+3. НЕ выдумывай тем, дат, заданий и оценок, которых нет в исходном тексте. Если данных нет — не добавляй раздел.
+4. Обращение на «вы», без эмодзи и без восклицательных знаков, кратко и по делу.
+5. Не добавляй приветствия, подписи и какие-либо пояснения.
+6. Верни ТОЛЬКО итоговый текст отчёта — без кавычек, без markdown и без названия формата.') ON CONFLICT (key) DO NOTHING;
+INSERT INTO settings (key, value) VALUES ('notify_lesson_ai_formatted', 'false') ON CONFLICT (key) DO NOTHING;