@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/utils/abilityMapGenerator.d.ts

@@ -0,0 +1,27 @@
+import type { AbilityMap } from '@shared/types/index.js';
+/**
+ * IntentData 接口（从 intentDataSchema 提取）
+ */
+interface IntentData {
+    targetPosition: string;
+    basicSkills?: string[];
+    coreSkills?: string[];
+    comprehensiveSkills?: string[];
+    [key: string]: any;
+}
+/**
+ * 从意图数据生成能力图谱
+ */
+export declare function generateAbilityMapFromIntent(intentData: IntentData): AbilityMap;
+/**
+ * 验证能力图谱的完整性
+ */
+export declare function validateAbilityMap(abilityMap: AbilityMap): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 规范化能力图谱（修正权重）
+ */
+export declare function normalizeAbilityMap(abilityMap: AbilityMap): AbilityMap;
+export {};

package/dist-types/client/src/utils/formUtils.d.ts

@@ -0,0 +1,66 @@
+import { TrainingModel, FormField, FormTemplate } from '../types';
+/**
+ * 在模型中查找指定表单名的字段定义
+ * @param model 训练模型
+ * @param formName 表单名称
+ * @param beforeStepIndex 只查找此索引之前的步骤（可选）
+ * @returns 找到的字段和来源步骤信息，未找到返回 null
+ */
+export declare function findFormFieldsInModel(model: TrainingModel, formName: string, beforeStepIndex?: number): {
+    fields: FormField[];
+    sourceStep: {
+        stageIndex: number;
+        stepIndex: number;
+        stepName: string;
+    };
+    customLayoutCode?: string;
+} | null;
+/**
+ * 计算步骤在模型中的全局索引
+ * @param model 训练模型
+ * @param targetStageIndex 目标阶段索引
+ * @param targetStepIndex 目标步骤索引
+ * @returns 全局索引
+ */
+export declare function getStepGlobalIndex(model: TrainingModel, targetStageIndex: number, targetStepIndex: number): number;
+/**
+ * 获取有效的表单字段列表
+ * - 如果当前步骤有字段定义，直接使用
+ * - 如果是 create 模式且无字段，返回错误
+ * - 如果是 edit 模式且无字段，向前查找同名表单的字段定义
+ *
+ * @param formTemplate 表单模板
+ * @param model 训练模型
+ * @param currentStageIndex 当前阶段索引
+ * @param currentStepIndex 当前步骤索引
+ * @returns 字段列表、来源信息和错误状态
+ */
+export declare function getEffectiveFormFields(formTemplate: FormTemplate, model: TrainingModel, currentStageIndex: number, currentStepIndex: number): {
+    fields: FormField[];
+    isFromCurrentStep: boolean;
+    sourceStep: null;
+    error: null;
+    customLayoutCode: undefined;
+} | {
+    fields: FormField[];
+    isFromCurrentStep: boolean;
+    sourceStep: null;
+    error: "create-mode-empty";
+    customLayoutCode: undefined;
+} | {
+    fields: FormField[];
+    isFromCurrentStep: boolean;
+    sourceStep: {
+        stageIndex: number;
+        stepIndex: number;
+        stepName: string;
+    };
+    error: null;
+    customLayoutCode: string | undefined;
+} | {
+    fields: FormField[];
+    isFromCurrentStep: boolean;
+    sourceStep: null;
+    error: "edit-mode-not-found";
+    customLayoutCode: undefined;
+};

package/dist-types/client/src/utils/rule-engine.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 前端规则引擎工具
+ * 用于客户端快速校验，减少服务器请求
+ */
+import type { RuleCheckResult } from '@shared/types/index.js';
+/**
+ * 格式校验规则
+ */
+export declare const formatRules: {
+    idNumber: (value: string) => RuleCheckResult;
+    phoneNumber: (value: string) => RuleCheckResult;
+    email: (value: string) => RuleCheckResult;
+    amount: (value: number, min?: number, max?: number) => RuleCheckResult;
+    required: (value: any, fieldName: string) => RuleCheckResult;
+};
+/**
+ * 规则检查器
+ */
+export declare class RuleChecker {
+    /**
+     * 批量检查多个字段
+     */
+    static checkFields(fields: Array<{
+        name: string;
+        value: any;
+        rules: Array<(value: any) => RuleCheckResult>;
+    }>): RuleCheckResult[];
+    /**
+     * 检查是否所有规则都通过
+     */
+    static allValid(results: RuleCheckResult[]): boolean;
+    /**
+     * 获取第一个错误
+     */
+    static getFirstError(results: RuleCheckResult[]): RuleCheckResult | null;
+}

package/dist-types/shared/types/index.d.ts

@@ -0,0 +1,592 @@
+/**
+ * 共享类型定义
+ * 前后端通用的核心数据结构
+ */
+/**
+ * 专业领域类型
+ */
+export type Domain = 'banking' | 'insurance' | 'trade';
+/**
+ * 难度等级
+ */
+export type Difficulty = 'easy' | 'medium' | 'hard';
+/**
+ * 实训层次
+ */
+export type TrainingLevel = 'undergraduate' | 'vocational' | 'technical';
+/**
+ * 插件类型
+ */
+export declare enum PluginType {
+    FORM_FILLING = "form-filling",// 表单填写（单据、合同）
+    DIALOGUE = "dialogue",// 对话交互（客户沟通）
+    DIALOGUE_FORM = "dialogue-form",// 对话式表单（边聊天边填表）
+    PROCESS_OPERATION = "process-operation",// 流程操作（业务办理）
+    DOCUMENT_REVIEW = "document-review",// 单据审核
+    DECISION_MAKING = "decision-making",// 决策判断（风险评估）
+    CASE_ANALYSIS = "case-analysis",// 案例分析
+    STRATEGY_LAB = "strategy-lab",// 策略实验室（决策模拟+推演）
+    KNOWLEDGE_LEARNING = "knowledge-learning"
+}
+/**
+ * 评估维度
+ */
+export interface EvaluationDimension {
+    name: string;
+    weight: number;
+    checkPoints?: string[];
+    requiredFields?: string[];
+}
+/**
+ * 全局规则
+ */
+export interface GlobalRules {
+    stagePassScore: number;
+    stepPassScore: number;
+    timeout: number;
+}
+/**
+ * AI角色配置（角色池）
+ */
+export interface RoleConfig {
+    角色编号: string;
+    角色名称: string;
+    角色类型: string;
+    [key: string]: any;
+}
+/**
+ * 表单填写逐字段参考值（value 准确性评估基准）。
+ * correctValue 可用 {路径} 引用案例数据（运行时按案例/前序表单数据解析）；
+ * 判断式字段写判定口径（如"应为 R3 及以上"）。纯对话采集且无确定答案的字段可不列。
+ */
+export interface FieldReference {
+    fieldName: string;
+    correctValue: string;
+    explanation?: string;
+}
+/**
+ * 决策判断逐题组参考答案（decision-making 判定基准，评估专用，学员不可见）。
+ * - single/multi：用 correctOptions 给正确选项的 value（驱动确定性命中/遗漏/多余判分）；
+ * - freeform：用 referenceConclusion 给参考结论方向（无确定答案，交评估器判读）。
+ */
+export interface DecisionReference {
+    groupId: string;
+    kind: 'single' | 'multi' | 'freeform';
+    correctOptions?: string[];
+    referenceConclusion?: string;
+    explanation?: string;
+}
+/**
+ * 单据审核逐不符点参考答案（document-review 判定基准，评估专用，学员不可见）。
+ * 与 client 插件层 ReferenceDiscrepancy 结构一致（后者 import 本类型以保单一数据源）。
+ * 每条声明「某字段存在某类错误」，运行时由插件 computeDocumentReviewScore 比对学员标记判分。
+ */
+export interface DocumentDiscrepancy {
+    fieldName: string;
+    typeId: string;
+    displayValue?: string;
+    correctValue?: string;
+    explanation: string;
+    weight?: number;
+}
+/**
+ * 评估规则
+ */
+export interface EvaluationRules {
+    dimensions: EvaluationDimension[];
+    businessRules: string[];
+    referenceAnswer?: string;
+    requiredPoints?: string[];
+    fieldReferences?: FieldReference[];
+    decisionReferences?: DecisionReference[];
+}
+/**
+ * 逐案例答案键（per-case 判定基准，评估专用，学员不可见）。
+ * Step 出"考卷 + 评分标准"（题面/选项/维度，案例无关），Case 出"答案键"（该案例的正确答案，案例特定）。
+ * 运行时按 stepId 取 Case.stepAnswers[stepId]，存在则覆盖 Step 同名基线；不存在则用基线。
+ * 覆盖目标依插件而定：
+ *  - decision-making → Step.evaluationRules.decisionReferences
+ *  - form-filling    → Step.evaluationRules.fieldReferences
+ *  - case-analysis   → Step.evaluationRules.referenceAnswer / requiredPoints
+ *  - document-review → Step.runtimeRules.referenceAnswers（自带判分，基线在 runtimeRules）
+ * 答案键字符串字段（correctValue / referenceAnswer / referenceConclusion 等）支持 {路径}/[表达式]，
+ * 运行时按当前案例数据解析；答案是案例数据清晰函数时，可只在 Step 基线写表达式、免逐案例存。
+ */
+export interface StepAnswerKey {
+    decisionReferences?: DecisionReference[];
+    fieldReferences?: FieldReference[];
+    referenceAnswer?: string;
+    requiredPoints?: string[];
+    documentReferenceAnswers?: DocumentDiscrepancy[];
+}
+/**
+ * 步骤
+ */
+export type EntryAnimationType = 'time-skip' | 'scene-change' | 'event-intro' | 'result-summary';
+export interface EntryAnimation {
+    type: EntryAnimationType;
+    narration: string;
+}
+export interface Step {
+    stepId: string;
+    stepName: string;
+    description?: string;
+    learningObjectives?: string[];
+    pluginId: string;
+    pluginType: PluginType;
+    initData: any;
+    runtimeRules: any;
+    evaluationRules?: EvaluationRules;
+    stepBriefing?: StepBriefing;
+    jumpRules?: any;
+    entryAnimation?: EntryAnimation;
+    order: number;
+    targetAbilities?: StepTargetAbility[];
+}
+/**
+ * 步骤资料区——学员理解本步任务所需的全部信息（独立于插件 initData）。
+ * initData 管"插件怎么操作/判分"，stepBriefing 管"学员看什么背景"。
+ * 见 docs/2026年6月4日/公共资料区StepBriefing契约草案.md
+ */
+export interface StepBriefing {
+    /** 场景背景：叙事文本，交代背景 + 实训任务。可含 {字段路径} 引用案例数据，运行时解析。 */
+    scenario?: string;
+    /** 案情资料：本步骤需展示的案例字段引用，运行时按 path 从案例数据取值渲染。 */
+    caseFacts?: CaseFactRef[];
+    /** 参考依据：判断依据库（规则/法规/要点），静态内容，供查阅；给依据不泄答案。 */
+    referenceDocs?: ReferenceDoc[];
+    /** 资料区呈现配置（整体折叠 + 各分栏默认折叠态）。 */
+    display?: BriefingDisplayConfig;
+}
+/** 案情资料的单条字段引用。path 引用案例数据路径，label/type 自带（落地时从 CaseSchema 复制）。 */
+export interface CaseFactRef {
+    path: string;
+    label: string;
+    type?: CaseSchemaField['type'];
+    group?: string;
+    emphasis?: boolean;
+}
+/** 参考文档（判断依据库）。原 client/src/plugins/shared 的 ReferenceDoc 上提至此复用。 */
+export interface ReferenceDoc {
+    id: string;
+    category: string;
+    title: string;
+    summary?: string;
+    content: string;
+}
+/** 资料区呈现配置。 */
+export interface BriefingDisplayConfig {
+    /** 整个「实训资料」侧栏默认折叠：沉浸式插件(dialogue/strategy-lab)设 true，其余默认展开。 */
+    defaultCollapsed?: boolean;
+    /** 各分栏默认展开态。缺省：场景背景/案情资料展开，参考依据/AI答疑折叠。 */
+    sections?: {
+        scenario?: boolean;
+        caseFacts?: boolean;
+        referenceDocs?: boolean;
+        aiQA?: boolean;
+    };
+}
+/**
+ * 阶段评估配置（运行时消费，创建端语义层产出）
+ */
+export interface StageAssessment {
+    consistencyChecks: Array<{
+        name: string;
+        description: string;
+        relatedSteps: string[];
+    }>;
+    deliverableChecks: Array<{
+        deliverable: string;
+        criteria: string[];
+    }>;
+    goalCriteria: string[];
+    passPolicy: {
+        stepWeights: Record<string, number>;
+        passScore?: number;
+    };
+}
+/**
+ * 阶段
+ */
+export interface Stage {
+    stageId: string;
+    stageName: string;
+    description: string;
+    businessType: string;
+    learningObjectives?: string[];
+    stageGoal?: string;
+    deliverables?: string[];
+    entryCriteria?: string[];
+    completionCriteria?: string[];
+    commonMistakes?: string[];
+    stageAssessment?: StageAssessment;
+    steps: Step[];
+    order: number;
+    ValidateMsg?: string;
+}
+/**
+ * 案例
+ */
+export interface Case {
+    caseId: string;
+    name: string;
+    description: string;
+    difficulty: 'easy' | 'medium' | 'hard';
+    scenario: string;
+    customerInfo: any;
+    businessData: any;
+    stepAnswers?: Record<string, StepAnswerKey>;
+    riskPoints?: string[];
+    角色池: Record<string, RoleConfig>;
+}
+export type FieldUsage = 'display' | 'evaluation';
+/**
+ * CaseSchema 字段定义
+ */
+export interface CaseSchemaField {
+    path: string;
+    type: 'string' | 'number' | 'boolean' | 'enum' | 'date' | 'object' | 'array';
+    label: string;
+    purpose: string;
+    usage: FieldUsage[];
+    rule?: string;
+    enumValues?: string[];
+    maxLength?: number;
+    children?: CaseSchemaField[];
+}
+/**
+ * CaseSchema 字段间约束
+ */
+export interface CaseSchemaConstraint {
+    type: 'derived' | 'consistent' | 'conditional';
+    fields?: string[];
+    description?: string;
+    rule?: string;
+    conditionField?: string;
+    conditionValue?: string[];
+    sourceField?: string;
+    targetField?: string;
+}
+/**
+ * CaseSchema - 案例数据结构定义
+ * 在创建流程中由 AI 根据大纲推断，用于指导案例生成
+ */
+export interface CaseSchema {
+    fields: CaseSchemaField[];
+    constraints: CaseSchemaConstraint[];
+}
+/**
+ * 实训模型
+ */
+export interface TrainingModel {
+    modelId: string;
+    name: string;
+    domain: Domain;
+    businessType?: string;
+    targetPosition?: string;
+    description: string;
+    learningObjectives?: string;
+    trainingLevel?: TrainingLevel;
+    trainingType?: string;
+    ideologicalElements?: string;
+    ideologicalRatio?: number;
+    botId?: string;
+    uiConfig?: any;
+    globalRules: GlobalRules;
+    caseSchema?: CaseSchema;
+    cases?: Case[];
+    defaultCaseId?: string;
+    abilityMap?: AbilityMap;
+    stages: Stage[];
+    ValidateMsg?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * 学生操作结果
+ */
+export interface EvidenceSummary {
+    sourceStepId: string;
+    sourceStepName?: string;
+    sourceType: string;
+    title: string;
+    summary: string;
+    keyFacts: Array<{
+        label: string;
+        value: string;
+    }>;
+    riskFlags?: string[];
+    conclusion?: string;
+    rawRef?: string;
+}
+export interface StudentOperationResult {
+    stepId: string;
+    operationType: string;
+    operationData: any;
+    operationLog: any[];
+    timestamp: number;
+    evidenceSummary?: EvidenceSummary;
+    preComputedEvaluation?: EvaluationReport;
+}
+/**
+ * 插件Props标准接口
+ */
+export interface PluginProps {
+    initData: any;
+    runtimeRules: any;
+    onFinish: (result: StudentOperationResult) => void;
+    onRealtimeData?: (data: any) => void;
+}
+/** 扰动触发条件（V2：round / condition / phase 三类可辨识联合） */
+export type DisturbanceTrigger = {
+    type: 'round';
+    round: number;
+} | {
+    type: 'condition';
+    condition: string;
+    deadline?: number;
+} | {
+    type: 'phase';
+    phaseId: string;
+    timing: 'enter' | 'exit';
+};
+/** 剧本预设的扰动事件：dialogue 落地 bot 产出，运行时注入 AI 客户角色演出 */
+export interface Disturbance {
+    id: string;
+    trigger: DisturbanceTrigger;
+    event: string;
+}
+/** 对话阶段（V2）：将对话进程结构化为可感知的阶段，驱动进度可视化与阶段性评估 */
+export interface DialoguePhase {
+    id: string;
+    name: string;
+    goals: string[];
+    requiredTopics?: string[];
+    transitionHint?: string;
+    estimatedRounds?: number;
+}
+/** 分支结果动作（V2）：分支判定命中后的行为指令 */
+export interface BranchOutcome {
+    directive: string;
+    emotion?: string;
+    unlockPhase?: string;
+    triggerDisturbance?: string;
+}
+/** 双向分支规则（V2）：根据学员表现走向不同结局 */
+export interface BranchRule {
+    id: string;
+    condition: string;
+    outcomes: {
+        positive: BranchOutcome;
+        negative: BranchOutcome;
+    };
+    evaluateAfterRound?: number;
+}
+/** 沟通阻力配置（V2）：持续性客户沟通障碍，与离散扰动事件互补 */
+export interface CommunicationResistanceConfig {
+    patterns: string[];
+    intensity: 'low' | 'medium' | 'high';
+    fadeCondition?: string;
+}
+/**
+ * 插件元数据
+ */
+export interface PluginMetadata {
+    pluginId: string;
+    name: string;
+    type: PluginType;
+    description: string;
+    code: string;
+    version: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * AI请求动作类型
+ */
+export type AIAction = 'initSession' | 'enterStep' | 'dialogue' | 'realtimeCheck' | 'evaluateStep' | 'askQuestion';
+/**
+ * AI请求
+ */
+export interface AIRequest {
+    action: AIAction;
+    sessionId?: string;
+    data: any;
+}
+/**
+ * AI响应
+ */
+export interface AIResponse<T = any> {
+    success: boolean;
+    data: T;
+    error?: string;
+    sessionId?: string;
+}
+/**
+ * 评估维度结果
+ */
+export interface DimensionResult {
+    name: string;
+    score: number;
+    feedback: string;
+    errors?: string[];
+    suggestions?: string[];
+}
+/**
+ * 评估报告
+ */
+export interface EvaluationReport {
+    stepId?: string;
+    totalScore: number;
+    dimensions: DimensionResult[];
+    highlights: string[];
+    improvements: string[];
+    nextStepAdvice: string;
+    pass: boolean;
+}
+/**
+ * 阶段评估报告（运行时产出）
+ */
+export interface StageAssessmentReport {
+    stageId: string;
+    totalScore: number;
+    pass: boolean;
+    stepBreakdown: Array<{
+        stepId: string;
+        stepName: string;
+        score: number;
+        weight: number;
+    }>;
+    consistencyIssues: Array<{
+        description: string;
+        relatedSteps: string[];
+        severity: 'info' | 'warning' | 'error';
+    }>;
+    deliverableResults: Array<{
+        deliverable: string;
+        achieved: boolean;
+        comment: string;
+    }>;
+    goalAchievement: {
+        score: number;
+        comment: string;
+    };
+    highlights: string[];
+    improvements: string[];
+}
+/**
+ * 实训案例
+ */
+export interface TrainingCase {
+    caseId: string;
+    caseType: string;
+    difficulty: Difficulty;
+    scenario: string;
+    customerInfo: any;
+    businessData: any;
+    riskPoints?: string[];
+    createdAt?: Date;
+}
+/**
+ * 学生会话
+ */
+export interface StudentSession {
+    sessionId: string;
+    studentId: string;
+    modelId: string;
+    currentStageId: string;
+    currentStepId: string;
+    startTime: Date;
+    endTime?: Date;
+    status: 'active' | 'completed' | 'timeout';
+    context: any;
+}
+/**
+ * 学生能力画像
+ */
+export interface StudentProfile {
+    studentId: string;
+    domain: Domain;
+    abilities: {
+        [key: string]: number;
+    };
+    weakPoints: string[];
+    strengths: string[];
+    totalTrainingCount: number;
+    lastUpdated: Date;
+}
+/**
+ * 规则类型
+ */
+export type RuleType = 'format' | 'business' | 'process';
+/**
+ * 规则定义
+ */
+export interface Rule {
+    ruleId: string;
+    name: string;
+    type: RuleType;
+    condition: any;
+    action: any;
+    priority: number;
+    enabled: boolean;
+}
+/**
+ * 规则检查结果
+ */
+export interface RuleCheckResult {
+    valid: boolean;
+    ruleId?: string;
+    message?: string;
+    severity?: 'info' | 'warning' | 'error';
+    suggestion?: string;
+}
+/**
+ * 能力分类
+ */
+export type AbilityCategory = 'basic' | 'core' | 'comprehensive';
+/**
+ * 能力节点（三层结构：基础/核心/综合）
+ */
+export interface AbilityNode {
+    id: string;
+    name: string;
+    category: AbilityCategory;
+    description?: string;
+    weight: number;
+    children?: AbilityNode[];
+    relatedSteps?: string[];
+}
+/**
+ * 岗位能力图谱
+ */
+export interface AbilityMap {
+    targetPosition: string;
+    version: string;
+    abilities: AbilityNode[];
+    totalWeight: number;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+/**
+ * 步骤目标能力
+ */
+export interface StepTargetAbility {
+    abilityId: string;
+    targetLevel: number;
+    weight: number;
+}
+/**
+ * 能力成长记录
+ */
+export interface AbilityGrowthRecord {
+    timestamp: number;
+    stepId: string;
+    stepName: string;
+    abilityId: string;
+    abilityName: string;
+    oldValue: number;
+    newValue: number;
+    delta: number;
+    reason: string;
+}