@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/plugins/DocumentReview/designTokens.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 单据审核插件 - 设计令牌系统
+ * 单一蓝色专业主题（取值对齐保险单证审核原型 document-review2.html 的 :root）
+ */
+export interface DesignTokens {
+    colors: {
+        primary: string;
+        secondary: string;
+        success: string;
+        warning: string;
+        error: string;
+        info: string;
+        background: string;
+        surface: string;
+        surfaceHover: string;
+        textPrimary: string;
+        textSecondary: string;
+        textDisabled: string;
+        border: string;
+        borderFocus: string;
+        divider: string;
+    };
+    typography: {
+        fontFamily: {
+            heading: string;
+            body: string;
+        };
+        fontSize: {
+            h1: string;
+            h2: string;
+            h3: string;
+            body: string;
+            caption: string;
+        };
+        fontWeight: {
+            regular: number;
+            medium: number;
+            semibold: number;
+            bold: number;
+        };
+        lineHeight: number;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    borderRadius: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    shadows: {
+        card: string;
+        cardHover: string;
+        focus: string;
+    };
+    transitions: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    zIndex: {
+        base: number;
+        card: number;
+        header: number;
+        modal: number;
+    };
+}
+/**
+ * 默认设计令牌（单一蓝色专业主题，对齐原型 :root）
+ */
+export declare const defaultTokens: DesignTokens;

package/dist-types/client/src/plugins/DocumentReviewPlugin.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 单据审核「找茬式」主插件 —— 组装总成
+ *
+ * 两栏：中=工具栏+单证(DocumentCard)+(提交后)结果面板+底栏，右=标记清单(MarkListPanel)。
+ * 参考文档由引擎「实训资料」资料栏统一渲染（stepBriefing.referenceDocs），插件不再自带左栏。
+ * 学员点击单证字段标注可疑不符点并选错误类型 → 提交后用 computeDocumentReviewScore 判分，
+ * 揭示参考答案（命中/遗漏/误标）并落 evidenceSummary（业务真相 + 学员得分）给后续步骤消费。
+ *
+ * 高亮笔分流：highlightActive 时点击字段仅切换荧光圈划（highlightedFields），不开弹窗；否则开标记弹窗。
+ */
+declare const DocumentReviewPlugin: React.FC<PluginProps>;
+export default DocumentReviewPlugin;

package/dist-types/client/src/plugins/ProcessOperationPlugin.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 流程操作插件（占位符）
+ * 用于系统录入、业务办理等流程操作场景
+ */
+declare const ProcessOperationPlugin: React.FC<PluginProps>;
+export default ProcessOperationPlugin;

package/dist-types/client/src/plugins/QAPlugin.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 智能答疑插件
+ * 学生可以随时提问业务问题，AI 基于知识库回答
+ * 使用 TUTOR_AGENT（智能答疑智能体）
+ */
+declare const QAPlugin: React.FC<PluginProps>;
+export default QAPlugin;

package/dist-types/client/src/plugins/StrategyLabPlugin.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 策略实验室插件（核心逻辑层）
+ */
+declare const StrategyLabPlugin: React.FC<PluginProps>;
+export default StrategyLabPlugin;

package/dist-types/client/src/plugins/decision-making/DecisionMakingPlugin.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+declare const DecisionMakingPlugin: React.FC<PluginProps>;
+export default DecisionMakingPlugin;

package/dist-types/client/src/plugins/decision-making/DecisionWorkspace.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { DecisionFormState, DecisionGroup, ReasonConfig, MarkerCategory, DecisionMakingInitData, DecisionMakingRuntimeRules } from './types';
+interface DecisionWorkspaceProps {
+    formState: DecisionFormState;
+    decisionGroups: DecisionGroup[];
+    reasonConfig?: ReasonConfig;
+    categories: MarkerCategory[];
+    runtimeRules: DecisionMakingRuntimeRules;
+    initData: DecisionMakingInitData;
+    isSubmitting: boolean;
+    onGoStep: (step: number) => void;
+    onEditMarker: (id: string) => void;
+    onRemoveMarker: (id: string) => void;
+    onAnnotatedClick: (materialId: string, blockId: string) => void;
+    onSelectSingle: (groupId: string, value: string) => void;
+    onToggleMulti: (groupId: string, value: string) => void;
+    onFreeformChange: (groupId: string, fieldName: string, value: any) => void;
+    onReasonChange: (value: string) => void;
+    onSubmit: () => void;
+    showToast: (msg: string, ok?: boolean) => void;
+}
+declare const DecisionWorkspace: React.FC<DecisionWorkspaceProps>;
+export default DecisionWorkspace;

package/dist-types/client/src/plugins/decision-making/MaterialsPanel.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { MaterialTab, MarkerCategory, DecisionMarker } from './types';
+import type { EvidenceSummary } from '@shared/types/index.js';
+interface MaterialsPanelProps {
+    materials: MaterialTab[];
+    categories: MarkerCategory[];
+    previousEvidence?: EvidenceSummary[];
+    activeTab: string;
+    markers: DecisionMarker[];
+    scrollSignal: {
+        blockId: string;
+        ts: number;
+    } | null;
+    onTabChange: (tabId: string) => void;
+    onRequestMarker: (materialId: string, blockId: string) => void;
+}
+declare const MaterialsPanel: React.FC<MaterialsPanelProps>;
+export default MaterialsPanel;

package/dist-types/client/src/plugins/decision-making/logic.d.ts

@@ -0,0 +1,46 @@
+import type { DecisionFormState, DecisionMakingInitData, DecisionMakingRuntimeRules, DecisionMarker } from './types';
+import type { StudentOperationResult, EvidenceSummary } from '@shared/types/index.js';
+export declare function createInitialFormState(initData: DecisionMakingInitData): DecisionFormState;
+export declare function goToStep(state: DecisionFormState, step: number): DecisionFormState;
+export declare function setActiveTab(state: DecisionFormState, tabId: string): DecisionFormState;
+export declare function addMarker(state: DecisionFormState, input: {
+    materialId: string;
+    blockId: string;
+    categoryKey: string;
+    desc: string;
+}): DecisionFormState;
+export declare function updateMarker(state: DecisionFormState, id: string, patch: Partial<Pick<DecisionMarker, 'desc' | 'categoryKey'>>): DecisionFormState;
+export declare function removeMarker(state: DecisionFormState, id: string): DecisionFormState;
+/** 单选：覆盖为单一值 */
+export declare function selectSingleOption(state: DecisionFormState, groupId: string, value: string): DecisionFormState;
+/** 多选：切换某选项 */
+export declare function toggleMultiOption(state: DecisionFormState, groupId: string, value: string): DecisionFormState;
+/** 自由填写字段更新 */
+export declare function updateFreeformField(state: DecisionFormState, groupId: string, fieldName: string, value: any): DecisionFormState;
+export declare function setReason(state: DecisionFormState, reason: string): DecisionFormState;
+/** 去空白字符后的字数 */
+export declare function reasonLength(reason: string): number;
+export interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        type: 'minMarkers' | 'requiredGroup' | 'requiredField' | 'maxLength' | 'requireReason' | 'minReasonLength';
+        groupId?: string;
+        fieldName?: string;
+        message: string;
+    }>;
+}
+export declare function validateForm(state: DecisionFormState, initData: DecisionMakingInitData, rules: DecisionMakingRuntimeRules): ValidationResult;
+export interface RealtimePayload {
+    type: 'markerChange' | 'decisionChange' | 'reasonChange';
+    data: {
+        markers: DecisionMarker[];
+        groupSelections: Record<string, string[]>;
+        freeformFields: Record<string, Record<string, any>>;
+        reason: string;
+    };
+    timestamp: number;
+}
+export declare function buildRealtimePayload(state: DecisionFormState, type: RealtimePayload['type']): RealtimePayload;
+export declare function shouldAutoSave(lastSaved: number, interval?: number): boolean;
+export declare function buildOperationResult(state: DecisionFormState, stepId: string, initData: DecisionMakingInitData): StudentOperationResult;
+export declare function buildEvidenceSummaryFromDecision(state: DecisionFormState, initData: DecisionMakingInitData, stepId: string): EvidenceSummary;

package/dist-types/client/src/plugins/decision-making/scoring.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 决策判断——确定性兜底评分
+ *
+ * 目的：评估智能体（LLM）对决策题的判分天然偏宽松，单选选错、多选漏选/多选也可能拿高分。
+ * 本模块只判机器能 100% 确定的事实——single/multi 题组的「学员所选 vs 参考正确选项」是否命中，
+ * 以及必答题是否作答——产出「硬上限 + 强制扣分 + 问题清单」，由评估管线对 LLM 的 totalScore
+ * 做最终封顶与扣减，并把问题清单注入评估 prompt，让 LLM 的叙述与之对齐、避免重复扣分。
+ *
+ * 不做的事（避免误伤）：
+ *  - freeform 题组无确定正确答案，只给参考结论方向，留给 LLM 判读。
+ *  - 标注(markers)、理由(reason) 的质量属语义判断，留给 LLM。
+ *  - 正确选项来自 evaluationRules.decisionReferences（评估专用，学员不可见），不在 initData 暴露。
+ */
+import type { DecisionReference } from '@shared/types/index.js';
+import type { DecisionGroup } from './types';
+/**
+ * 把 decisionReferences 中的 {路径}/[表达式] 按当前案例数据就地解析为具体答案。
+ * 用途：答案是案例数据的清晰函数时（如「年龄≥60 选 R3，否则 R2」），可只在 Step 基线写
+ *   correctOptions: ["[if(customerInfo.age>=60,'R3','R2')]"]，运行时按案例自动算，免逐案例存。
+ * 无引用的纯值（'A'/'R3' 等）原样返回；纯函数（除模板求值外无副作用），可单测。
+ */
+export declare function resolveDecisionReferenceValues(references: DecisionReference[] | undefined, caseData: any, filledData?: Record<string, Record<string, any>>): DecisionReference[] | undefined;
+/** 默认阈值（写死，日后如需可配置再外提） */
+export declare const DECISION_SCORING_THRESHOLDS: {
+    readonly hitRateGarbage: 0.3;
+    readonly capGarbage: 25;
+    readonly requiredMissingRateForCap: 0.5;
+    readonly capHalfRequiredMissing: 35;
+    readonly deductPerSingleWrong: 15;
+    readonly deductPerMultiMissing: 8;
+    readonly deductPerMultiExtra: 8;
+    readonly deductPerRequiredMissing: 12;
+};
+export interface DecisionDeduction {
+    reason: string;
+    points: number;
+}
+export interface DecisionDeterministicScore {
+    /** 分数硬上限，100 表示未触发任何封顶 */
+    hardCap: number;
+    /** 逐项强制扣分 */
+    deductions: DecisionDeduction[];
+    /** 扣分总额 */
+    totalDeduction: number;
+    /** 给评估 prompt / improvements 用的可读问题清单 */
+    findings: string[];
+    /** 可判分题组数（single/multi 且声明了 correctOptions） */
+    gradedCount: number;
+    /** 完全命中的可判分题组数 */
+    correctCount: number;
+    /** 是否存在任何客观问题（决定是否介入分数） */
+    hasObjectiveIssues: boolean;
+}
+/** 解析步骤的决策题组（来自 initData.decisionGroups） */
+export declare function resolveDecisionGroups(step: any): DecisionGroup[];
+/** 解析后的逐题组参考答案（供注入评估 prompt 做对照） */
+export interface ResolvedDecisionReference {
+    groupId: string;
+    title: string;
+    kind: 'single' | 'multi' | 'freeform';
+    /** single/multi：正确选项的显示文案（已由 value 映射为 label） */
+    correctLabels?: string[];
+    /** freeform：参考结论方向 */
+    referenceConclusion?: string;
+    explanation?: string;
+}
+/**
+ * 把 decisionReferences 的正确选项 value 映射为题组 options 的 label，供注入评估 prompt。
+ * @param groups     initData.decisionGroups（用于补 title 与 value→label 映射）
+ * @param references evaluationRules.decisionReferences
+ */
+export declare function resolveDecisionReferences(groups: DecisionGroup[], references: DecisionReference[] | undefined): ResolvedDecisionReference[];
+/**
+ * 对决策判断结果做确定性评分。纯函数，无副作用，可单测。
+ * @param groups     题组定义（initData.decisionGroups）
+ * @param references 逐题组参考答案（evaluationRules.decisionReferences）
+ * @param studentData 学员提交数据：{ groupSelections, freeformFields, ... }
+ */
+export declare function scoreDecisionDeterministically(groups: DecisionGroup[], references: DecisionReference[] | undefined, studentData: any): DecisionDeterministicScore;