| 项目 | 内容 |
|---|---|
| 日期 | 2026-08-22 |
| 对拍物 | 《v0.2样例JSON.md》（P0 交付；字段以该文件为准） |
| 结构要点 | 《设计说明书-v0.2.md》§4.2 / §6.3 |
| Schema | prisma/schema.prisma + 迁移 20260822014730_v02_models |
| JSON 存储 | Prisma 5.22 SQLite 连接器不支持 Json 类型；一律用 String 存 JSON 文本（schema 文件头与字段注释写明结构） |
结论：与样例 JSON 字段名全部一致（95/95 静态对拍通过；17/17 入库回读通过）。
教案 / PPT / 材料不拆成三张子表，写入 lesson_plans.draft_content 与 lesson_plans.confirmed_content（草稿与定稿分存），JSON 形状为：
{ "plan": { /* 样例一 */ }, "ppt": { /* 样例二 */ }, "materials": { /* 样例三 */ } }问卷题目写入 questionnaires.questions（数组）。学号不是题目，见第 5 节。
lesson_plan（样例一 → draft_content.plan / confirmed_content.plan）| 样例字段 | 落点 | 结果 |
|---|---|---|
lesson_title | JSON 键 | 一致 |
lesson_type | JSON 键 | 一致 |
class_profile_summary | JSON 键 | 一致 |
objectives[] | JSON 数组 | 一致 |
objectives[].id | JSON 键 | 一致 |
objectives[].text | JSON 键 | 一致 |
objectives[].bloom | JSON 键 | 一致 |
objectives[].literacy_dim | JSON 键 | 一致 |
objectives[].success_criteria | JSON 键 | 一致 |
objectives[].course_outcome_ids | JSON 键（引用 course_outcomes.code，如 "O1-2"） | 一致 |
core_plan.{core,scaffold,extension} | JSON 对象 | 一致（以样例 core_plan 为准，不用 core_plus_extension 作键名） |
lesson_events[] | JSON 数组 | 一致 |
lesson_events[].phase | pre | in | post | 一致 |
lesson_events[].duration | JSON 键 | 一致 |
lesson_events[].teacher_move | JSON 键 | 一致 |
lesson_events[].student_task | JSON 键 | 一致 |
lesson_events[].interaction | JSON 键 | 一致 |
lesson_events[].prompt_questions | JSON 键 | 一致 |
hook | JSON 键 | 一致 |
relevance_to_major | JSON 键 | 一致 |
formative_checks | JSON 键 | 一致 |
sizheng_integration[] | JSON 数组（非单对象） | 一致 |
sizheng_integration[].element / role / organic_link / student_dilemma / position / avoid_preaching | JSON 键；role 与库表 knowledge_point_sizheng.role 同为 content | infusion | 一致 |
case_plan.{case_id,usage,discussion_ladder} | JSON 对象 | 一致 |
timeline_check.{total_minutes,lesson_minutes,overload} | JSON 对象 | 一致 |
citations[] | JSON 数组 | 一致 |
citations[].source_type | 闭集：case | knowledge_point | hotspot | teacher_url | textbook_section | 一致 |
citations[].source_id | JSON 键 | 一致 |
citations[].claim_unverified | JSON 键 | 一致 |
difficulty_notes | JSON 键 | 一致 |
adaptation_log[{evidence,decision}] | 教案 JSON 内保留同名字段；表另有列 lesson_plans.adaptation_log（确认页只读） | 一致 |
课时知识库目标 lessons.objectives 使用同一套键（id/text/bloom/literacy_dim/success_criteria/course_outcome_ids），另含 type（知识/能力/价值-伦理），与 A1/M4.1 章—课时目标结构对齐。
slides（样例二 → draft_content.ppt / confirmed_content.ppt）| 样例字段 | 落点 | 结果 |
|---|---|---|
theme | JSON 键 | 一致 |
lesson_type | JSON 键（样例为 case_discussion；§6.3 顶层误写 slide_type，以样例为准） | 一致 |
slides[] | JSON 数组 | 一致 |
slides[].slide_type | cover | agenda | concept | diagram | case | compare | quiz | sizheng | summary | activity | 一致 |
slides[].title | JSON 键 | 一致 |
slides[].bullets | JSON 键 | 一致 |
slides[].visual | JSON 键 | 一致 |
slides[].speaker_notes | JSON 键 | 一致 |
slides[].diagram_spec | 可选对象 | 一致 |
diagram_spec.kind | flow | compare | pros_cons | 一致（样例含 flow、compare） |
diagram_spec.nodes | flow 型 | 一致 |
diagram_spec.left / right | compare 型 | 一致 |
schema 注释超集（§6.3 有、样例未出现，不构成字段名冲突）：highlight、takeaway。
materials（样例三 → draft_content.materials / confirmed_content.materials）| 样例字段 | 落点 | 结果 |
|---|---|---|
cases[] | JSON 数组 | 一致 |
cases[].case_id / title / summary / discussion_questions / sizheng_angle / citations | JSON 键 | 一致 |
exercises[] | JSON 数组 | 一致 |
exercises[].task_type | 样例：recall | explain | case_ruling | authentic_task | 一致 |
exercises[].question | JSON 键 | 一致 |
exercises[].options | 可选（再认题） | 一致 |
exercises[].answer | JSON 键 | 一致 |
exercises[].rubric[{criterion,level}] | 裁决/真实性任务 | 一致 |
exercises[].tier | 样例：required | extension | 一致 |
exercises[].objective_ids | 挂接教案目标 id（如 "o1"） | 一致 |
exercises[].difficulty | easy | medium | hard | 一致 |
exercises[].knowledge_point | JSON 键 | 一致 |
schema 注释超集（§6.3 / M4.12，样例未出现）：task_type=classroom_speech、tier=optional、evidence_type、attachments[]。
案例库表 cases 另有结构化列：case_type / dilemma / stakeholders / teaching_note / time_needed / literacy_focus / source_case_id；知识点与模板改为关联表 case_knowledge_points、case_templates（不再用 JSON 承担参照完整性）。
questionnaires.questions）| 样例字段 | 落点 | 结果 |
|---|---|---|
title / description | 表列 questionnaires.title / description；蓝图 JSON 亦可含同名字段 | 一致 |
module_ids | 蓝图顶层；必测 A–F | 一致 |
questions[].id | JSON 键 | 一致 |
questions[].module_id | ∈ {A,B,C,D,E,F} | 一致 |
questions[].profile_field | 如 misconception_agency | 一致 |
questions[].blueprint_locked | 布尔；A–F 锁定不可删 | 一致 |
questions[].type | single | multi | scale | text | 一致 |
questions[].question | JSON 键 | 一致 |
questions[].options | 可选 | 一致 |
questions[].required | JSON 键 | 一致 |
| 学号 | questionnaire_responses.student_no 可空独立列，不在 questions[] | 一致 |
样例全部 9 题的 profile_field 均不是 student_no。表另有 status / token / expires_at / max_submissions（及 v0.1 保留的 deadline）。
course_outcomes（literacy_dim / is_core）| 样例/设计字段 | 落点 | 结果 |
|---|---|---|
目标编码（如 O1-2） | 列 course_outcomes.code；教案 course_outcome_ids 引用编码 | 一致 |
literacy_dim | 列 literacy_dim（素养五维之一） | 一致 |
is_core | 列 is_core（BOOLEAN；core 不可删） | 一致 |
text | 列 text | 一致 |
三级目标：课程级走 course_outcomes 表；章级走 chapters.objectives JSON；课时级走 lessons.objectives JSON（禁止纯自由文本作为唯一目标）。
写入 lesson_plans.draft_content、questionnaires.questions、course_outcomes、questionnaire_responses.student_no=NULL 后读回：
| 检查 | 结果 |
|---|---|
draft.plan.objectives[].course_outcome_ids | 通过 |
draft.plan.lesson_events[0].phase === "pre" | 通过 |
draft.plan.sizheng_integration[0].role === "infusion" | 通过 |
draft.plan.citations[0].source_type === "case" | 通过 |
draft.ppt.slides[0].slide_type === "cover" | 通过 |
draft.ppt 含 diagram_spec.kind === "flow" | 通过 |
draft.materials.exercises[0].task_type === "recall" | 通过 |
rubric / tier=required / objective_ids=["o1"] | 通过 |
questions[0].module_id === "A" | 通过 |
questions[0].profile_field === "misconception_agency" | 通过 |
questions[0].blueprint_locked === true | 通过 |
course_outcomes.literacy_dim === "概念理解" | 通过 |
course_outcomes.is_core === true | 通过 |
student_no 可空（NULL） | 通过 |
users.admin 仍在 | 通过 |
临时对拍数据已删除，库中无残留。
| 项 | Schema | 结果 |
|---|---|---|
知识点 content_depth / bloom_range / misconceptions | knowledge_points 列 | 有 |
knowledge_prereq(from_kp_id, to_kp_id) | 表 + 唯一约束 | 有 |
思政 theme / natural_example / forbidden_example | sizheng_elements | 有 |
knowledge_point_sizheng.role = content | infusion | 列 + 唯一(kp, element, role) | 有 |
major_templates.default_content_depth / default_ppt_theme | 列（原 default_depth 改名） | 有 |
template_rules PCK：literacy_focus / omit_items / permitted_tools / expected_student_performance / preferred_lesson_type / media_strategy | 列 | 有 |
classes.profile 版本化 + profile_revision_log | String JSON | 有 |
chaoxing_course_id / chaoxing_class_id | 可空列 | 有 |
lesson_plans 七态 | not_started → plan_draft → plan_confirmed → ppt_draft → ppt_confirmed → materials_draft → completed | 有 |
draft_content / confirmed_content 分存 | 两列 | 有 |
teacher_edits_summary / why_changed / adaptation_log / generation_meta | 列 | 有 |
course_outlines.version / confirmed_at / assessment_plan | 列 | 有 |
feedbacks 最小四字段 + effect_rating | goal_achievement / difficulty / case_sparked_discussion / next_lesson_suggestion | 有 |
generation_tasks.type 扩充 | 含 questionnaire / profile_report / knowledge_extract / hotspot_analyze | 有 |
hotspots.analysis 合规键 + raw_text 短摘录 | 注释含 sizheng_confidence / suggest_patch / compliance_check | 有 |
knowledge_patches / sys_config / user_export_prefs / rss_sources | 表 | 有 |
highlight / takeaway / classroom_speech / optional / evidence_type / attachments）写入 schema 注释，样例未强制出现。exports 表：v0.2 ER「LessonPlan 1──N Export」与 v0.1 §4.2 均有，v0.2 未删除，一并建表（任务清单未点名，但是完整模型）。generation_tasks.created_by：可选 FK，便于按教师隔离任务；原 v0.1 表无此列。feedbacks.notes / chaoxing_metrics：四字段之外的补充与预留粘贴列。questionnaires.deadline：v0.1 字段保留，与 v0.2 expires_at 并存（截止展示 vs token 过期）。以上均不改变样例 JSON 的字段名。
对拍结论：全部一致。