.
', figure_html: null, opts_json: null }; + const row = Object.assign({}, defaults, fields); + const names = Object.keys(row); + const ph = names.map(() => '?').join(', '); + db.prepare(`INSERT OR IGNORE INTO exam_tasks (${names.join(', ')}) VALUES (${ph})`) + .run(...names.map(n => row[n])); + } + + db.transaction(() => { + // Task with task-level textbook link + insertTask({ + exam_key: 'math9', variant: 100, task_idx: 1, task_type: 'mc', + text_html: 'Решите квадратное уравнение x^2 - 5x + 6 = 0', + answer: '2,3', solution_html: 'D=1
', + topic: 'algebra', subtopic: 'alg-equations', difficulty: 2, + ...(hasTbCols ? { textbook_slug: 'algebra-8-ch2', textbook_paragraph: 8 } : {}), + }); + // Task without task-level textbook link (textbook_slug = NULL) + insertTask({ + exam_key: 'math9', variant: 100, task_idx: 2, task_type: 'mc', + text_html: 'Какое из следующих утверждений НЕ верно', + answer: 'A', solution_html: '.
', + topic: 'theory', subtopic: 'theory-statements', difficulty: 3, + ...(hasTbCols ? { textbook_slug: null, textbook_paragraph: null } : {}), + }); + // Task with hub-only slug (no paragraph) + insertTask({ + exam_key: 'math9', variant: 100, task_idx: 3, task_type: 'mc', + text_html: 'Найдите процент от числа', + answer: '15', solution_html: '.
', + topic: 'algebra', subtopic: 'alg-word-problems', difficulty: 1, + ...(hasTbCols ? { textbook_slug: 'math-6-ch2', textbook_paragraph: null } : {}), + }); + })(); + + // Seed exam_topics textbook links for fallback + try { + db.prepare(` + UPDATE exam_topics SET textbook_slug = 'algebra-8-ch2', textbook_paragraph = 8 + WHERE slug = 'alg-equations' AND exam_key = 'math9' + `).run(); + } catch { /* columns may not exist in test schema if migration 028 not applied yet */ } + + // Seed a textbook row so slug-validation test can check + try { + db.prepare(` + INSERT OR IGNORE INTO textbooks (slug, title, subject, grade, is_active) + VALUES ('algebra-8-ch2', 'Алгебра 8 Гл.2', 'algebra', 8, 1) + `).run(); + } catch { /* ignore if textbooks schema differs */ } +} + +/* ── Tests ────────────────────────────────────────────────────── */ + +describe('exam-textbook-links', () => { + let studentToken; + + before(async () => { + seedExamData(db); + const u = await getToken('student'); + studentToken = u.token; + }); + + it('exam_tasks has textbook_slug column', () => { + assert.ok(columnExists('exam_tasks', 'textbook_slug'), + 'Column textbook_slug missing from exam_tasks'); + }); + + it('exam_tasks has textbook_paragraph column', () => { + assert.ok(columnExists('exam_tasks', 'textbook_paragraph'), + 'Column textbook_paragraph missing from exam_tasks'); + }); + + it('textbook_slug and textbook_paragraph columns accept NULL and non-NULL values', () => { + const hasCols = columnExists('exam_tasks', 'textbook_slug'); + if (!hasCols) { + assert.fail('textbook_slug column not present'); + return; + } + // Check our seeded variant 100 specifically (variant 100 used only in this test) + const withSlug = db.prepare( + "SELECT COUNT(*) as c FROM exam_tasks WHERE exam_key='math9' AND variant=100 AND textbook_slug IS NOT NULL" + ).get(); + const withNull = db.prepare( + "SELECT COUNT(*) as c FROM exam_tasks WHERE exam_key='math9' AND variant=100 AND textbook_slug IS NULL" + ).get(); + const total = withSlug.c + withNull.c; + // We seeded 3 tasks in variant 100: 2 with slug, 1 with NULL + assert.ok(total >= 1, `Expected >=1 seeded task in variant 100, got ${total}`); + assert.ok(withSlug.c >= 1, `Expected >=1 task with textbook_slug in variant 100, got ${withSlug.c}`); + }); + + it('GET /variants/100/tasks requires auth (401)', async () => { + const res = await inject('GET', '/api/exam-prep/math9/variants/100/tasks', null, null); + assert.equal(res.status, 401, `Expected 401, got ${res.status}`); + }); + + it('GET /variants/100/tasks returns tasks with topic_ref including paragraph for tagged tasks', async () => { + const res = await inject('GET', '/api/exam-prep/math9/variants/100/tasks', null, studentToken); + // May be 404 if exam track not seeded or 403 if access restricted. + // Accept either 200 (tasks found) or 404 (no track) or 403 (access) — all valid in test env. + if (res.status === 404 || res.status === 403) return; // skip if no data / no access + assert.equal(res.status, 200, `Expected 200, got ${res.status}: ${JSON.stringify(res.body)}`); + + const tasks = res.body.tasks; + assert.ok(Array.isArray(tasks) && tasks.length > 0, 'Expected non-empty tasks array'); + + // Find the task with textbook_slug set (task_idx=1 in our seed) + const tagged = tasks.find(t => t.topic_ref && t.topic_ref.slug === 'algebra-8-ch2'); + if (tagged) { + assert.equal(typeof tagged.topic_ref.slug, 'string', 'topic_ref.slug should be string'); + assert.equal(tagged.topic_ref.paragraph, 8, `Expected paragraph=8, got ${tagged.topic_ref.paragraph}`); + } + // All tasks should have a topic_ref if they have a subtopic with textbook mapping + for (const t of tasks) { + if (t.subtopic && t.subtopic !== 'theory-statements') { + if (t.topic_ref) { + assert.ok(typeof t.topic_ref.slug === 'string', 'topic_ref.slug must be string'); + } + } + } + }); + + it('topic_ref.paragraph is a number or null (not string)', async () => { + const res = await inject('GET', '/api/exam-prep/math9/variants/100/tasks', null, studentToken); + if (res.status !== 200) return; + for (const t of res.body.tasks) { + if (t.topic_ref && t.topic_ref.paragraph != null) { + assert.equal(typeof t.topic_ref.paragraph, 'number', + `topic_ref.paragraph should be number, got ${typeof t.topic_ref.paragraph} for task ${t.id}`); + } + } + }); + + it('textbook_slug values in exam_tasks are known chapter slugs (spot check)', () => { + if (!columnExists('exam_tasks', 'textbook_slug')) return; + // Get distinct slugs used in exam_tasks that are non-null + const slugs = db.prepare( + "SELECT DISTINCT textbook_slug FROM exam_tasks WHERE exam_key='math9' AND textbook_slug IS NOT NULL LIMIT 20" + ).all().map(r => r.textbook_slug); + + // Known valid prefix patterns from the taxonomy + const validPrefixes = [ + 'algebra-7-', 'algebra-8-', 'algebra-9-', + 'geometry-7-', 'geometry-8-', 'geometry-9-', + 'math-5-', 'math-6-', + 'algebra-7', 'algebra-8', 'algebra-9', // hub slugs (no chapter suffix) + 'math-5', 'math-6', + ]; + for (const slug of slugs) { + const valid = validPrefixes.some(p => slug.startsWith(p)); + assert.ok(valid, `Unexpected textbook_slug: '${slug}' — not a known prefix`); + } + }); + + it('at least 90% of math9 tasks in live DB have textbook_slug (if DB has tasks)', () => { + if (!columnExists('exam_tasks', 'textbook_slug')) return; + const total = db.prepare("SELECT COUNT(*) as c FROM exam_tasks WHERE exam_key='math9'").get().c; + if (total < 10) return; // skip if no real data + const tagged = db.prepare( + "SELECT COUNT(*) as c FROM exam_tasks WHERE exam_key='math9' AND textbook_slug IS NOT NULL" + ).get().c; + const pct = (tagged / total) * 100; + assert.ok(pct >= 90, `Only ${pct.toFixed(1)}% of math9 tasks have textbook_slug (need >=90%)`); + }); + + it('exam_topics fallback rows have correct textbook_slug for key subtopics', () => { + const check = (slug, expectedBook, expectedPara) => { + const row = db.prepare( + "SELECT textbook_slug, textbook_paragraph FROM exam_topics WHERE slug=? AND exam_key='math9'" + ).get(slug); + if (!row) return; // skip if topics not seeded in test DB + if (row.textbook_slug == null) return; // NULL is allowed (theory-statements) + assert.ok( + row.textbook_slug.startsWith(expectedBook), + `${slug}: expected textbook_slug starting with '${expectedBook}', got '${row.textbook_slug}'` + ); + if (expectedPara !== null) { + assert.equal(row.textbook_paragraph, expectedPara, + `${slug}: expected paragraph ${expectedPara}, got ${row.textbook_paragraph}`); + } + }; + + check('alg-equations', 'algebra-8-ch2', 8); + check('alg-inequalities', 'algebra-8-ch3', 17); + check('alg-progressions', 'algebra-9-ch4', 15); + check('alg-functions', 'algebra-9-ch2', 6); + check('alg-fractions', 'algebra-9-ch1', 3); + check('alg-expressions', 'algebra-9-ch1', 5); + check('geom-quadrilaterals', 'geometry-8-ch1', 4); + check('geom-circle', 'geometry-8-ch4', 8); + check('geom-coordinates', 'algebra-9-ch3', 12); + }); +});