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
This commit is contained in:
+154
-2
@@ -178,6 +178,7 @@ const NOTIFY_ICONS = {
|
||||
'backup.create': 'download',
|
||||
'system.test': 'send',
|
||||
'lesson.report': 'notebook-pen',
|
||||
'lesson.ai.formatted': 'file-check',
|
||||
};
|
||||
const NOTIFY_LEVELS = { warning: 'Предупреждение', critical: 'Важно', info: '' };
|
||||
|
||||
@@ -540,7 +541,14 @@ function ensureLessonModal() {
|
||||
placeholder="Например: разобрали циклы for и while, решали задачи на списки, домашнее задание — функции"></textarea>
|
||||
<span class="hint" id="lessonHint">0 / 5000</span>
|
||||
</div>
|
||||
<label class="toggle lesson-ai-toggle" id="lessonAiRow">
|
||||
<input type="checkbox" id="lessonAiCheck" checked>
|
||||
<span class="toggle-track"><span class="toggle-thumb"></span></span>
|
||||
<span class="toggle-text"><b>Проверить по шаблону делового сообщения</b><small>ИИ сверит текст с шаблоном из настроек и, если не совпадёт, оформит его как деловое сообщение</small></span>
|
||||
</label>
|
||||
<div class="lesson-ai-status" id="lessonAiStatus" hidden></div>
|
||||
<div class="card-foot" style="justify-content:flex-end;gap:8px">
|
||||
<button type="button" class="btn-primary ghost" id="lessonVersionsBtn" hidden>История версий</button>
|
||||
<button type="button" class="btn-primary ghost" id="lessonCancel">Отмена</button>
|
||||
<button type="submit" class="btn-primary" id="lessonSubmit">Сохранить</button>
|
||||
</div>
|
||||
@@ -556,6 +564,10 @@ function ensureLessonModal() {
|
||||
textEl.addEventListener('input', () => { hintEl.textContent = `${textEl.value.length} / 5000`; });
|
||||
modal.addEventListener('click', e => { if (e.target === modal) closeLessonModal(); });
|
||||
modal.querySelector('#lessonCancel').addEventListener('click', closeLessonModal);
|
||||
modal.querySelector('#lessonVersionsBtn').addEventListener('click', () => {
|
||||
const id = modal.querySelector('#lessonId').value;
|
||||
if (id) openLessonVersions(id);
|
||||
});
|
||||
groupSel.addEventListener('change', () => prefetchLessonForGroupDate());
|
||||
modal.querySelector('#lessonForm').addEventListener('submit', e => submitLessonModal(e));
|
||||
return modal;
|
||||
@@ -570,6 +582,7 @@ async function submitLessonModal(e) {
|
||||
const timeEl = modal.querySelector('#lessonTime');
|
||||
const textEl = modal.querySelector('#lessonText');
|
||||
const submitBtn = modal.querySelector('#lessonSubmit');
|
||||
const aiCheckEl = modal.querySelector('#lessonAiCheck');
|
||||
const groupId = groupSel.value;
|
||||
const date = dateEl.value;
|
||||
const text = textEl.value.trim();
|
||||
@@ -577,12 +590,13 @@ async function submitLessonModal(e) {
|
||||
if (!date) { showToast('Укажите дату занятия'); return; }
|
||||
if (!text) { showToast('Введите текст отчёта'); textEl.focus(); return; }
|
||||
const id = modal.querySelector('#lessonId').value;
|
||||
const aiCheck = !!aiCheckEl && aiCheckEl.checked;
|
||||
submitBtn.disabled = true;
|
||||
try {
|
||||
const res = await fetch(`${API}/api/lesson-reports${id ? '/' + id : ''}`, {
|
||||
method: id ? 'PUT' : 'POST',
|
||||
headers: hdrJson(),
|
||||
body: JSON.stringify({ group_id: Number(groupId), lesson_date: date, lesson_time: timeEl.value || null, text }),
|
||||
body: JSON.stringify({ group_id: Number(groupId), lesson_date: date, lesson_time: timeEl.value || null, text, ai_check: aiCheck }),
|
||||
});
|
||||
const data = await res.json().catch(() => ({}));
|
||||
if (!res.ok) {
|
||||
@@ -596,7 +610,13 @@ async function submitLessonModal(e) {
|
||||
return;
|
||||
}
|
||||
closeLessonModal();
|
||||
showToast(id ? 'Отчёт о занятии обновлён' : 'Отчёт о занятии сохранён');
|
||||
if (data.ai_status === 'pending' || data.ai_status === 'processing') {
|
||||
showToast('Отчёт сохранён — ИИ проверяет текст по шаблону');
|
||||
} else if (data.ai_status === 'error') {
|
||||
showToast(`Отчёт сохранён, проверка по шаблону не удалась: ${data.ai_error || 'ошибка ИИ'}`);
|
||||
} else {
|
||||
showToast(id ? 'Отчёт о занятии обновлён' : 'Отчёт о занятии сохранён');
|
||||
}
|
||||
if (typeof onLessonReportSaved === 'function') onLessonReportSaved();
|
||||
} catch {
|
||||
showToast('Ошибка сети');
|
||||
@@ -633,10 +653,38 @@ function fillLessonModalFromReport(modal, r) {
|
||||
textEl.value = r.text || '';
|
||||
textEl.dispatchEvent(new Event('input'));
|
||||
}
|
||||
const aiCheck = modal.querySelector('#lessonAiCheck');
|
||||
if (aiCheck) aiCheck.checked = false;
|
||||
updateLessonAiRow(modal, r);
|
||||
modal.querySelector('#lessonModalTitle').textContent = 'Редактирование отчёта';
|
||||
modal.querySelector('#lessonSubmit').textContent = 'Обновить';
|
||||
}
|
||||
|
||||
function lessonAiStatusText(r) {
|
||||
if (!r || !r.ai_status || r.ai_status === 'none') return '';
|
||||
if (r.ai_status === 'pending') return 'ИИ проверяет текст по шаблону…';
|
||||
if (r.ai_status === 'processing') return 'ИИ оформляет текст по шаблону…';
|
||||
if (r.ai_status === 'done' && r.text_ai) return 'ИИ оформил текст по шаблону';
|
||||
if (r.ai_status === 'skipped') return 'Текст уже соответствует шаблону';
|
||||
if (r.ai_status === 'reverted') return 'Возвращена исходная версия текста';
|
||||
if (r.ai_status === 'error') return `Проверка по шаблону не удалась: ${r.ai_error || 'ошибка ИИ'}`;
|
||||
return `Статус ИИ: ${r.ai_status}`;
|
||||
}
|
||||
|
||||
function updateLessonAiRow(modal, r) {
|
||||
const row = modal.querySelector('#lessonAiRow');
|
||||
const status = modal.querySelector('#lessonAiStatus');
|
||||
const versionsBtn = modal.querySelector('#lessonVersionsBtn');
|
||||
if (row) row.hidden = false;
|
||||
const text = lessonAiStatusText(r);
|
||||
if (status) {
|
||||
status.textContent = text;
|
||||
status.hidden = !text;
|
||||
status.classList.toggle('err', !!r && r.ai_status === 'error');
|
||||
}
|
||||
if (versionsBtn) versionsBtn.hidden = !modal.querySelector('#lessonId').value;
|
||||
}
|
||||
|
||||
function resetLessonModalFields(modal) {
|
||||
modal.querySelector('#lessonId').value = '';
|
||||
modal.querySelector('#lessonDate').value = lessonTodayIso();
|
||||
@@ -644,10 +692,114 @@ function resetLessonModalFields(modal) {
|
||||
const textEl = modal.querySelector('#lessonText');
|
||||
textEl.value = '';
|
||||
textEl.dispatchEvent(new Event('input'));
|
||||
const aiCheck = modal.querySelector('#lessonAiCheck');
|
||||
if (aiCheck) aiCheck.checked = true;
|
||||
updateLessonAiRow(modal, null);
|
||||
modal.querySelector('#lessonModalTitle').textContent = 'Что прошли на занятии';
|
||||
modal.querySelector('#lessonSubmit').textContent = 'Сохранить';
|
||||
}
|
||||
|
||||
const LESSON_VERSION_LABELS = {
|
||||
manual: 'Тьютор',
|
||||
ai: 'ИИ по шаблону',
|
||||
restore: 'Восстановлено'
|
||||
};
|
||||
|
||||
let currentLessonVersionId = '';
|
||||
|
||||
function ensureLessonVersionsModal() {
|
||||
let modal = document.getElementById('lessonVersionsModal');
|
||||
if (modal) return modal;
|
||||
modal = document.createElement('div');
|
||||
modal.className = 'modal-overlay';
|
||||
modal.id = 'lessonVersionsModal';
|
||||
modal.innerHTML = `
|
||||
<div class="edit-modal lesson-modal">
|
||||
<h3>История версий отчёта</h3>
|
||||
<div class="lesson-versions" id="lessonVersionsList"><div class="empty">Загрузка…</div></div>
|
||||
<div class="card-foot" style="justify-content:flex-end;gap:8px">
|
||||
<button type="button" class="btn-primary ghost" id="lessonVersionsClose">Закрыть</button>
|
||||
</div>
|
||||
</div>`;
|
||||
document.body.appendChild(modal);
|
||||
modal.addEventListener('click', e => { if (e.target === modal) closeLessonVersions(); });
|
||||
modal.querySelector('#lessonVersionsClose').addEventListener('click', closeLessonVersions);
|
||||
return modal;
|
||||
}
|
||||
|
||||
function closeLessonVersions() {
|
||||
const modal = document.getElementById('lessonVersionsModal');
|
||||
if (modal) modal.classList.remove('open');
|
||||
}
|
||||
|
||||
function lessonVersionItemHtml(v, index) {
|
||||
const label = LESSON_VERSION_LABELS[v.source] || v.source || 'Версия';
|
||||
const who = v.author_name || v.author_username || '';
|
||||
return `
|
||||
<div class="lesson-version${index === 0 ? ' current' : ''}">
|
||||
<div class="lesson-version-head">
|
||||
<span class="lesson-version-label">${esc(label)}</span>
|
||||
<span class="lesson-version-time">${esc(notifyTime(v.created_at))}</span>
|
||||
</div>
|
||||
<div class="lesson-version-text">${esc(v.text || '')}</div>
|
||||
<div class="lesson-version-foot">
|
||||
${who ? `<span class="lesson-version-author">${esc(who)}</span>` : ''}
|
||||
${index === 0 ? '<span class="lesson-badge">текущая</span>' : ''}
|
||||
${index === 0 ? '' : `<button type="button" class="btn-link" data-restore="${v.id}" data-report="${v.lesson_report_id || currentLessonVersionId || ''}">Восстановить</button>`}
|
||||
</div>
|
||||
</div>`;
|
||||
}
|
||||
|
||||
async function openLessonVersions(id) {
|
||||
currentLessonVersionId = String(id || '');
|
||||
const modal = ensureLessonVersionsModal();
|
||||
const list = modal.querySelector('#lessonVersionsList');
|
||||
list.innerHTML = '<div class="empty">Загрузка…</div>';
|
||||
modal.classList.add('open');
|
||||
renderIcons();
|
||||
try {
|
||||
const res = await fetch(`${API}/api/lesson-reports/${id}/versions`, { headers: hdr() });
|
||||
const data = await res.json().catch(() => ({}));
|
||||
if (!res.ok) { list.innerHTML = `<div class="empty">${esc(data.error || 'Не удалось загрузить историю')}</div>`; return; }
|
||||
const items = data.items || [];
|
||||
if (!items.length) { list.innerHTML = '<div class="empty">Версий пока нет</div>'; return; }
|
||||
list.innerHTML = items.map(lessonVersionItemHtml).join('');
|
||||
renderIcons();
|
||||
} catch {
|
||||
list.innerHTML = '<div class="empty">Ошибка сети</div>';
|
||||
}
|
||||
}
|
||||
|
||||
async function restoreLessonVersion(id, versionId, btn) {
|
||||
if (!confirm('Восстановить эту версию отчёта?')) return;
|
||||
if (btn) btn.disabled = true;
|
||||
try {
|
||||
const res = await fetch(`${API}/api/lesson-reports/${id}/versions/${versionId}/restore`, { method: 'POST', headers: hdr() });
|
||||
const data = await res.json().catch(() => ({}));
|
||||
if (!res.ok) { showToast(data.error || 'Не удалось восстановить версию'); return; }
|
||||
closeLessonVersions();
|
||||
showToast('Версия отчёта восстановлена');
|
||||
if (typeof onLessonReportSaved === 'function') onLessonReportSaved();
|
||||
} catch {
|
||||
showToast('Ошибка сети');
|
||||
} finally {
|
||||
if (btn) btn.disabled = false;
|
||||
}
|
||||
}
|
||||
|
||||
document.addEventListener('click', e => {
|
||||
const btn = e.target.closest('[data-restore]');
|
||||
if (!btn) return;
|
||||
e.preventDefault();
|
||||
let id = btn.dataset.report || currentLessonVersionId;
|
||||
if (!id) {
|
||||
const lessonModal = document.getElementById('lessonModal');
|
||||
id = (lessonModal && lessonModal.querySelector('#lessonId').value) || '';
|
||||
}
|
||||
if (!id) return;
|
||||
restoreLessonVersion(id, btn.dataset.restore, btn);
|
||||
});
|
||||
|
||||
async function openLessonModal(opts = {}) {
|
||||
const modal = ensureLessonModal();
|
||||
const groupSel = modal.querySelector('#lessonGroup');
|
||||
|
||||
Reference in New Issue
Block a user