fix(aihr): version practice session evidence migration

2026-07-15 00:53:52 +08:00
parent d9fec80e6c
commit ef21d4d61b
5 changed files with 110 additions and 3 deletions
@@ -0,0 +1,89 @@
+-- AIHR 对练会话证据字段迁移（MySQL 8.x）
+-- 补齐严格试点门禁要求的 5 个会话证据字段；不写入业务数据，可重复执行。
+
+SET @aihr_practice_session_table_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.TABLES
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+);
+
+SET @aihr_session_annotations_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+    AND COLUMN_NAME = 'annotations_json'
+);
+SET @aihr_session_annotations_ddl := IF(
+  @aihr_practice_session_table_exists = 1 AND @aihr_session_annotations_exists = 0,
+  'ALTER TABLE aihr_practice_session ADD COLUMN `annotations_json` text DEFAULT NULL COMMENT ''逐句标注JSON''',
+  'SELECT 1'
+);
+PREPARE aihr_session_annotations_stmt FROM @aihr_session_annotations_ddl;
+EXECUTE aihr_session_annotations_stmt;
+DEALLOCATE PREPARE aihr_session_annotations_stmt;
+
+SET @aihr_session_review_advice_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+    AND COLUMN_NAME = 'review_advice'
+);
+SET @aihr_session_review_advice_ddl := IF(
+  @aihr_practice_session_table_exists = 1 AND @aihr_session_review_advice_exists = 0,
+  'ALTER TABLE aihr_practice_session ADD COLUMN `review_advice` varchar(1000) DEFAULT NULL COMMENT ''主管复盘建议''',
+  'SELECT 1'
+);
+PREPARE aihr_session_review_advice_stmt FROM @aihr_session_review_advice_ddl;
+EXECUTE aihr_session_review_advice_stmt;
+DEALLOCATE PREPARE aihr_session_review_advice_stmt;
+
+SET @aihr_session_incentive_point_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+    AND COLUMN_NAME = 'incentive_point'
+);
+SET @aihr_session_incentive_point_ddl := IF(
+  @aihr_practice_session_table_exists = 1 AND @aihr_session_incentive_point_exists = 0,
+  'ALTER TABLE aihr_practice_session ADD COLUMN `incentive_point` int DEFAULT NULL COMMENT ''主管人工贡献分''',
+  'SELECT 1'
+);
+PREPARE aihr_session_incentive_point_stmt FROM @aihr_session_incentive_point_ddl;
+EXECUTE aihr_session_incentive_point_stmt;
+DEALLOCATE PREPARE aihr_session_incentive_point_stmt;
+
+SET @aihr_session_satisfaction_score_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+    AND COLUMN_NAME = 'satisfaction_score'
+);
+SET @aihr_session_satisfaction_score_ddl := IF(
+  @aihr_practice_session_table_exists = 1 AND @aihr_session_satisfaction_score_exists = 0,
+  'ALTER TABLE aihr_practice_session ADD COLUMN `satisfaction_score` tinyint DEFAULT NULL COMMENT ''员工训练满意度1-5分''',
+  'SELECT 1'
+);
+PREPARE aihr_session_satisfaction_score_stmt FROM @aihr_session_satisfaction_score_ddl;
+EXECUTE aihr_session_satisfaction_score_stmt;
+DEALLOCATE PREPARE aihr_session_satisfaction_score_stmt;
+
+SET @aihr_session_satisfaction_comment_exists := (
+  SELECT COUNT(*)
+  FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE()
+    AND TABLE_NAME = 'aihr_practice_session'
+    AND COLUMN_NAME = 'satisfaction_comment'
+);
+SET @aihr_session_satisfaction_comment_ddl := IF(
+  @aihr_practice_session_table_exists = 1 AND @aihr_session_satisfaction_comment_exists = 0,
+  'ALTER TABLE aihr_practice_session ADD COLUMN `satisfaction_comment` varchar(500) DEFAULT NULL COMMENT ''员工训练满意度意见''',
+  'SELECT 1'
+);
+PREPARE aihr_session_satisfaction_comment_stmt FROM @aihr_session_satisfaction_comment_ddl;
+EXECUTE aihr_session_satisfaction_comment_stmt;
+DEALLOCATE PREPARE aihr_session_satisfaction_comment_stmt;
@@ -1,5 +1,7 @@
 # BRD 功能审查与未完成项记录

+- 2026-07-15 BRD 4.3/4.4/4.5 生产迁移缺口修复：严格试点门禁要求 `aihr_practice_session` 的 8 个证据字段，但版本化迁移此前只覆盖三项五维字段，`annotations_json`、主管复盘建议、人工贡献分和满意度字段仍可能依赖运行时懒迁移。现新增幂等 MySQL 8 迁移补齐其余 5 列，纳入 Runbook、schema 回归和 `demo-check` marker；仅补结构，不写业务数据，尚未执行生产迁移。
+
 - 2026-07-15 BRD G3/4.7 生产迁移缺口修复：`aihr_knowledge_gap` 与 `aihr_knowledge_answer_feedback` 此前只在 `AihrSopSeedService` 运行时懒建，生产迁移 Runbook 没有对应版本化脚本，可能出现应用启动前结构缺失、反馈/知识缺口审计不可用。现新增幂等 MySQL 8 迁移，兼容旧反馈表补齐 `review_id/reviewer/reviewed_time`，纳入迁移 Runbook、迁移回归测试和 `demo-check` marker；仅补结构，不写业务数据，尚未执行生产迁移。

 - 2026-07-15 BRD 剩余功能复核：重新核对动态难度、案例视频和 SOP 反馈治理三条链路。场景表已有 `difficulty` 但没有 HR 确认的升降级阈值、候选场景映射和人工关闭规则；案例当前能保存/回放脱敏音频，但没有正式预渲染视频样片及对应学习场景契约；SOP 负反馈队列已有问题、片段、评审状态和人工复核入口，但没有经业务批准的纠正内容、版本替换和署名入库规则。本轮不硬编码业务规则、不用音频冒充视频、不把“标记已复核”伪装成知识修复；以上继续作为 P1/发布前输入项跟踪。
@@ -32,6 +32,7 @@ mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aih
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_case_media_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_case_learning_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_practice_five_dimensions_mysql8.sql
+mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260715_practice_session_evidence_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_daily_drill_score_mode_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_sop_requester_identity_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260715_knowledge_feedback_mysql8.sql
@@ -60,7 +61,7 @@ FROM information_schema.columns
 WHERE table_schema = DATABASE()
  AND (
    (table_name = 'aihr_case_record' AND column_name IN ('media_oss_id', 'media_url', 'learning_points', 'supervisor_comment'))
-    OR (table_name = 'aihr_practice_session' AND column_name IN ('dim_task_completion', 'dim_response_timeliness', 'response_latency_ms'))
+    OR (table_name = 'aihr_practice_session' AND column_name IN ('dim_task_completion', 'dim_response_timeliness', 'response_latency_ms', 'annotations_json', 'review_advice', 'incentive_point', 'satisfaction_score', 'satisfaction_comment'))
    OR (table_name = 'aihr_practice_assignment' AND column_name IN ('score', 'score_mode'))
    OR (table_name = 'aihr_sop_answer_review' AND column_name IN ('prompt_version', 'requester_ext_party_id'))
    OR (table_name = 'aihr_org_snapshot' AND column_name = 'hire_date')
@@ -73,7 +74,7 @@ WHERE tenant_id = '000000'
  AND code IN ('summary_card', 'sop_answer', 'mentor_rewrite', 'review_annotation', 'prep_card', 'supervision_image_analysis_maintenance');
 ```

-预期是三张场景/Rubric 表、三张证据表和两张知识治理表均存在，字段查询覆盖所有列，内置 Prompt 数量为 `6`。这只证明 schema/seed 迁移完成，不证明正式试点完成。
+预期是三张场景/Rubric 表、三张证据表和两张知识治理表均存在，会话证据字段为 `8/8`，字段查询覆盖所有列，内置 Prompt 数量为 `6`。这只证明 schema/seed 迁移完成，不证明正式试点完成。

 ## 迁移后应用回归

@@ -539,6 +539,7 @@ contains backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/service
 contains frontend/src/views/train/practice.vue "label: '任务完成度'"
 contains backend/script/sql/aihr_practice_mysql8.sql "task_completion"
 contains backend/script/sql/update/aihr_20260714_practice_five_dimensions_mysql8.sql "aihr_brd_rubric_codes"
+contains backend/script/sql/update/aihr_20260715_practice_session_evidence_mysql8.sql "annotations_json"
 contains backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/domain/AihrPracticeDto.java "MistakeAggregateResponse"
 contains mobile-uni/src/pages/supervisor/team/index.vue "团队错题本"
 contains mobile-uni/src/types/api.ts "PracticeMistakeAggregate"
@@ -95,6 +95,20 @@ mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260715_knowledge_feedb
 feedback_review_columns="$(mysql "$DB" -N -B -e "SELECT GROUP_CONCAT(column_name ORDER BY ordinal_position) FROM information_schema.columns WHERE table_schema='$DB' AND table_name='aihr_knowledge_answer_feedback' AND column_name IN ('review_id','reviewer','reviewed_time');")"
 test "$feedback_review_columns" = 'review_id,reviewer,reviewed_time'

+mysql "$DB" <<'SQL'
+CREATE TABLE aihr_practice_session (
+  id bigint NOT NULL AUTO_INCREMENT,
+  session_id varchar(100) NOT NULL,
+  total_score int,
+  ai_comment varchar(1000),
+  PRIMARY KEY (id)
+) ENGINE=InnoDB;
+SQL
+mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260715_practice_session_evidence_mysql8.sql"
+mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260715_practice_session_evidence_mysql8.sql"
+practice_session_evidence_columns="$(mysql "$DB" -N -B -e "SELECT COUNT(*) FROM information_schema.columns WHERE table_schema='$DB' AND table_name='aihr_practice_session' AND column_name IN ('annotations_json','review_advice','incentive_point','satisfaction_score','satisfaction_comment');")"
+test "$practice_session_evidence_columns" = '5'
+
 mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260714_practice_evidence_mysql8.sql"
 mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260714_practice_evidence_mysql8.sql"
 evidence_tables="$(mysql "$DB" -N -B -e "SELECT GROUP_CONCAT(table_name ORDER BY table_name) FROM information_schema.tables WHERE table_schema='$DB' AND table_name IN ('aihr_practice_audio','aihr_practice_audio_upload','aihr_practice_calibration');")"
@@ -126,4 +140,4 @@ mysql "$DB" < "$ROOT_DIR/backend/script/sql/update/aihr_20260714_org_hire_date_m
 org_columns="$(mysql "$DB" -N -B -e "SELECT GROUP_CONCAT(column_name ORDER BY ordinal_position) FROM information_schema.columns WHERE table_schema='$DB' AND table_name='aihr_org_snapshot' AND column_name='hire_date';")"
 test "$org_columns" = 'hire_date'

-echo "PASS: AIHR legacy schema migrations are idempotent, including case media, learning, and knowledge feedback fields"
+echo "PASS: AIHR legacy schema migrations are idempotent, including practice evidence and knowledge feedback fields"