94 lines
5.8 KiB
Markdown
94 lines
5.8 KiB
Markdown
# AIHR BRD 生产迁移 Runbook
|
||
|
||
本文件只覆盖 AIHR 阶段一 BRD 已落地代码所需的 MySQL 8 结构和内置内容迁移。它不执行正式组织同步、试点训练、人工校准、SOP 评审、案例导入或满意度补录；这些属于业务数据和正式验收，必须单独审批。
|
||
|
||
## 当前生产已确认的差距
|
||
|
||
2026-07-14 生产只读复核发现：
|
||
|
||
- `aihr_practice_scenario`、`aihr_practice_rubric`、`aihr_practice_rubric_dimension` 不存在；
|
||
- `aihr_case_record` 缺 `media_oss_id`、`media_url`；
|
||
- 对练五维、每日三题评分模式、SOP 提问主体/版本、组织入职日期字段尚未全部迁移；
|
||
- `aihr_prompt_template` 表存在，但内置模板数量为 `0`；
|
||
- 这些事实不能由应用启动时的懒迁移或页面 fallback 代替。
|
||
|
||
## 发布前置条件
|
||
|
||
1. 确认发布窗口、DB 备份和回滚负责人；迁移脚本包含 `ALTER TABLE`，不能在无备份状态执行。
|
||
2. 先执行 `scripts/release-preflight.sh` 的只读检查；生产静态资源、后端包和当前提交必须一致。
|
||
3. 确认迁移目标库、租户和字符集为 MySQL 8 / `utf8mb4`；脚本只允许在目标业务库执行。
|
||
4. 生产组织同步凭据、AI 供应商留存/费用口径和正式试点窗口仍未闭合时，不要把迁移完成宣称为 BRD 验收完成。
|
||
|
||
## 执行顺序
|
||
|
||
在生产数据库连接上按以下顺序执行，每个脚本执行后记录退出码和关键表结构。所有脚本均设计为可重复执行，但仍应按顺序执行。
|
||
|
||
```bash
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_practice_catalog_schema_mysql8.sql
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_practice_brd_scenarios_mysql8.sql
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_brd_sop_seed_mysql8.sql
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_prompt_template_seed_mysql8.sql
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_practice_evidence_mysql8.sql
|
||
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
|
||
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260714_org_hire_date_mysql8.sql
|
||
```
|
||
|
||
顺序原因：场景补充依赖三张场景/Rubric 基础表；五维迁移依赖场景和 Rubric；其余字段迁移依赖既有业务表但不写正式业务行。住宅 SOP 和 Prompt 迁移只补内置内容，不代表内容已完成业务复核。
|
||
|
||
## 迁移后只读核验
|
||
|
||
执行后只读检查结构和内置内容，不修改业务数据：
|
||
|
||
```sql
|
||
SELECT table_name
|
||
FROM information_schema.tables
|
||
WHERE table_schema = DATABASE()
|
||
AND table_name IN (
|
||
'aihr_practice_scenario', 'aihr_practice_rubric', 'aihr_practice_rubric_dimension',
|
||
'aihr_practice_audio', 'aihr_practice_audio_upload', 'aihr_practice_calibration',
|
||
'aihr_knowledge_gap', 'aihr_knowledge_answer_feedback'
|
||
)
|
||
ORDER BY table_name;
|
||
|
||
SELECT table_name, column_name
|
||
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', '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')
|
||
)
|
||
ORDER BY table_name, column_name;
|
||
|
||
SELECT COUNT(*) AS built_in_prompt_templates
|
||
FROM aihr_prompt_template
|
||
WHERE tenant_id = '000000'
|
||
AND code IN ('summary_card', 'sop_answer', 'mentor_rewrite', 'review_annotation', 'prep_card', 'supervision_image_analysis_maintenance');
|
||
```
|
||
|
||
预期是三张场景/Rubric 表、三张证据表和两张知识治理表均存在，会话证据字段为 `8/8`，字段查询覆盖所有列，内置 Prompt 数量为 `6`。这只证明 schema/seed 迁移完成，不证明正式试点完成。
|
||
|
||
## 迁移后应用回归
|
||
|
||
1. 重启 `wygj-aihr.service`，确认状态为 `active`。
|
||
2. 检查根站、`/h5/`、租户接口和员工首页 API 的 HTTP 与业务码均为 `200`。
|
||
3. 用正式测试账号完成员工端训练、主管复盘和管理端场景/Prompt 只读检查；不要使用开发固定验证码验证生产安全策略。
|
||
4. 迁移完成后再按同一正式时间窗运行：
|
||
|
||
```bash
|
||
AIHR_PILOT_TENANT_ID=000000 \
|
||
AIHR_PILOT_START_DATE=YYYY-MM-DD \
|
||
AIHR_PILOT_END_DATE=YYYY-MM-DD \
|
||
AIHR_PILOT_STRICT=true ./scripts/demo-check.sh
|
||
```
|
||
|
||
严格门禁中的校准、SOP 可用率、完训率、满意度、正式组织身份和案例数量仍必须来自真实业务数据；不允许用本 runbook 的内置 seed 或开发库样本替代。
|