培训考核模块 — 方案设计文档

本文档为梅苑颐养中心培训考核模块的完整方案设计，涵盖轻流表单设计、数据流转、MySQL 表结构及报表查询逻辑。核心设计原则是：

• 培训与考核解耦：培训记录单和现有 40+ 张考核表单各自独立运行，不直接关联
• 汇总表作为数据中枢：双方通过「培训场次编号」向同一张汇总表写入数据
• 人员流动兼容：培训时不预锁参训名单，按实际在岗人员提交，避免脏数据
• 现有考核表单零改造：仅增加「培训场次编号」一个字段，其余保持原样

2.1 现有考核体系

轻流中已存在 40+ 张考核表单，覆盖各类护理技能与操作规范。每张考核表包含：

• 被考核人、身份证号、所属部门、岗位
• 10+ 评分维度（如准备工作、操作流程、人文关怀等）
• 各维度 1-5 分评分 + 轻流自动计算总分
• 自动合格判定（合格/需补考/不合格）

2.2 核心痛点

整个体系由 3 张轻流表单（+40张现有考核表改造） + 1 张 MySQL 表 + 2 张前端报表 组成：

3.1 组件清单

4.1 培训侧数据流

4.2 考核侧数据流

4.3 同步脚本机制

# sync_training.py 核心逻辑（伪代码）
# 1. 从轻流 OpenAPI 拉取培训记录单数据
training_data = fetch_qingliu(appKey="培训记录单appKey")

# 2. 插入或更新汇总表（培训侧）
for row in training_data:
    sql = """
        INSERT INTO biz_training_records
            (event_no, id_number, name, org, dept, training_month,
             training_date, form, topic, speaker, attend_status,
             created_at, updated_at)
        VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NOW(), NOW())
        ON DUPLICATE KEY UPDATE
            name=VALUES(name), org=VALUES(org), dept=VALUES(dept),
            attend_status=VALUES(attend_status), updated_at=NOW()
    """
    execute(sql, row)

# 3. 从轻流 OpenAPI 拉取考核表单数据（40+张表批量）
for appKey in assessment_appKeys:
    assess_data = fetch_qingliu(appKey=appKey)
    for row in assess_data:
        if row.event_no:  # 只处理关联了培训的考核
            sql = """
                UPDATE biz_training_records
                SET exam_date=%s, exam_score=%s, exam_result=%s,
                    is_retake=%s, updated_at=NOW()
                WHERE event_no=%s AND id_number=%s
            """
            execute(sql, row)

5.1 培训计划表（管理视角，可选）

用于院长/主任查看月度培训安排，不直接参与报表统计。纯管理备忘用途。

5.2 培训记录单（培训部门操作入口）

培训结束后，培训负责人按实际到场/缺席逐人录入，一人提交一条。提交后轻流工作流自动将数据写入汇总表。

5.3 培训考核汇总表（中枢，被动接收）

不在轻流中直接操作。培训记录单提交后，轻流工作流自动将培训侧字段写入此表；考核表单提交后，工作流按「培训场次编号 + 身份证号」匹配并更新考核字段。

5.4 考核表单（现有表单改造）

现有 40+ 张考核表单仅需新增一个字段，其余保持原样。

6.1 biz_training_records（培训考核汇总表）

CREATE TABLE `biz_training_records` (
    `id`              INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    `event_no`        VARCHAR(32)  NOT NULL COMMENT '培训场次编号，如 PX-2026-06-003',
    `id_number`       VARCHAR(18)  NOT NULL COMMENT '身份证号，关联花名册',
    `name`            VARCHAR(50)  NOT NULL COMMENT '员工姓名',
    `org`             VARCHAR(100) DEFAULT NULL COMMENT '所属机构',
    `dept`            VARCHAR(50)  DEFAULT NULL COMMENT '部门',
    `post`            VARCHAR(50)  DEFAULT NULL COMMENT '岗位',
    `training_month`  VARCHAR(7)   NOT NULL COMMENT '培训月份，如 2026-06',
    `training_date`   DATE         DEFAULT NULL COMMENT '培训日期',
    `form`            VARCHAR(20)  NOT NULL COMMENT '培训形式：技能/理论/演练/选修',
    `topic`           VARCHAR(100) NOT NULL COMMENT '培训主题',
    `speaker`         VARCHAR(50)  DEFAULT NULL COMMENT '主讲人',
    `module`          VARCHAR(50)  DEFAULT NULL COMMENT '学习模块分类',
    `attend_status`   VARCHAR(10)  NOT NULL COMMENT '参训状态：已参训/未参训',
    `exam_date`       DATE         DEFAULT NULL COMMENT '考核日期（考核后补填）',
    `exam_score`      DECIMAL(5,1) DEFAULT NULL COMMENT '考核成绩（0-100）',
    `exam_result`     VARCHAR(20)  DEFAULT NULL COMMENT '考核结果：通过/未通过/补考通过/免考',
    `is_retake`       TINYINT(1)   DEFAULT 0 COMMENT '是否补考：0=否 1=是',
    `remark`          VARCHAR(500) DEFAULT NULL COMMENT '备注',
    `created_at`      DATETIME     DEFAULT CURRENT_TIMESTAMP,
    `updated_at`      DATETIME     DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    UNIQUE KEY `uk_event_idno` (`event_no`, `id_number`),
    KEY `idx_month` (`training_month`),
    KEY `idx_idno` (`id_number`),
    KEY `idx_dept` (`dept`),
    KEY `idx_topic` (`topic`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='培训考核汇总表';

6.2 索引设计说明

7.1 个人学习记录单

按员工身份证号查询，统计个人全年学习情况。

-- 个人统计卡片数据
SELECT
    COUNT(*) AS total_attend,                      -- 累计参训次数
    COUNT(CASE WHEN form='技能' THEN 1 END) AS skill_cnt,
    COUNT(CASE WHEN form='演练' THEN 1 END) AS drill_cnt,
    COUNT(CASE WHEN form='理论' THEN 1 END) AS theory_cnt,
    COUNT(CASE WHEN exam_result IN ('通过','补考通过') THEN 1 END) AS pass_cnt,
    COUNT(CASE WHEN exam_result IS NOT NULL THEN 1 END) AS total_exam,
    AVG(exam_score) AS avg_score,                    -- 平均成绩
    MAX(exam_score) AS max_score,
    MIN(exam_score) AS min_score,
    COUNT(DISTINCT module) AS module_covered       -- 学习模块覆盖数
FROM biz_training_records
WHERE id_number = 'xxx'
  AND attend_status = '已参训'
  AND form != '选修';

-- 个人培训明细（按月份分组）
SELECT
    training_month,
    training_date,
    form,
    topic,
    speaker,
    attend_status,
    exam_score,
    exam_result,
    is_retake
FROM biz_training_records
WHERE id_number = 'xxx'
  AND form != '选修'
ORDER BY training_date DESC;

7.2 院部培训统计表

按月份查询，按部门和培训主题分组统计。

-- 月度统计卡片
SELECT
    COUNT(DISTINCT event_no) AS total_sessions,   -- 培训场次
    COUNT(*) AS total_plan,                           -- 应参训人次
    COUNT(CASE WHEN attend_status='已参训' THEN 1 END) AS total_actual,
    COUNT(CASE WHEN exam_result IS NOT NULL THEN 1 END) AS exam_plan,
    COUNT(CASE WHEN exam_result IN ('通过','补考通过') THEN 1 END) AS exam_done,
    COUNT(CASE WHEN is_retake=1 THEN 1 END) AS retake_cnt
FROM biz_training_records
WHERE training_month = '2026-06'
  AND form != '选修';

-- 按部门+主题分组的明细
SELECT
    dept,
    form,
    topic,
    speaker,
    COUNT(*) AS plan_count,                         -- 应参训人数
    COUNT(CASE WHEN attend_status='已参训' THEN 1 END) AS actual_count,
    COUNT(CASE WHEN exam_result IS NOT NULL THEN 1 END) AS exam_plan,
    COUNT(CASE WHEN exam_result IN ('通过','补考通过') THEN 1 END) AS exam_done,
    COUNT(CASE WHEN is_retake=1 THEN 1 END) AS retake_cnt,
    GROUP_CONCAT(DISTINCT CASE WHEN attend_status='未参训' THEN name END) AS absent_list,
    GROUP_CONCAT(DISTINCT CASE WHEN exam_result='未通过' THEN name END) AS fail_list
FROM biz_training_records
WHERE training_month = '2026-06'
  AND form != '选修'
GROUP BY dept, form, topic, speaker
ORDER BY dept, form;

8.1 培训部门操作流程

8.2 考核部门操作流程

8.3 培训场次编号生成规则

格式: PX-YYYY-MM-###

示例:
  PX-2026-06-001   -- 6月第1场培训
  PX-2026-06-002   -- 6月第2场培训
  PX-2026-06-003   -- 6月第3场培训

规则:
  - PX: 培训固定前缀
  - YYYY-MM: 培训所在年月
  - ###: 当月流水号，从 001 开始递增

注意:
  - 同一场培训（同一主题、同一天）不管多少人参加，只用一个编号
  - 补考视为新的考核事件，但培训编号不变（考核侧更新原记录）
  - 若同一个人同一场培训有多次考核（首次+补考），更新原记录即可

8.4 同步脚本运行时机

9.1 已识别的边界场景

9.2 注意事项

• 缺席人员必须建记录：只有全部人员（含缺席）都有记录，报表才能准确计算应参训人数和参训率
• 身份证号是关联键：确保轻流中填写的身份证号与花名册一致，否则无法自动带出机构/岗位/职级
• 培训场次编号全局唯一：同一场培训的所有参训人必须使用同一个编号
• 考核表单仅需加 1 个字段：不要在现有考核表单中做其他改造，保持原有评分逻辑不变
• 同步脚本需处理分页：轻流 OpenAPI pageSize 上限 200，pageNum 从 1 开始递增

9.3 课时可扩展功能（v1.1 预留）

轻流表单已包含课时字段（培训记录单），当前报表暂未使用。后续可按以下方向扩展，无需改动轻流侧数据结构：