@hddjs/hdd-cloud-types 1.0.15-SNAPSHOT.1 → 1.0.18

package/hdd-ai-cloud/common/IGetRecommendSchool.d.ts

@@ -66,10 +66,6 @@ export interface IGetRecommendSchool {
    * 省控线
    */
   minControlLine?: number;
-  /**
-   * 排名
-   */
-  rank?: number;
   /**
    * 招生代码
    */
@@ -78,6 +74,10 @@ export interface IGetRecommendSchool {
    * 专业名称
    */
   majorName?: string;
+  /**
+   * 去年最低排名
+   */
+  rank?: number;
   /**
    * 学费
    */
@@ -87,7 +87,11 @@ export interface IGetRecommendSchool {
    */
   hc?: number;
   /**
-   * 冲稳保标识
+   * 排序理由
+   */
+  rankReason?: string;
+  /**
+   * 冲稳保策略标识
    */
   strategyTag?: 'chong' | 'wen' | 'bao';
 }

package/hdd-ai-cloud/common/ILowerCoderForm.ts

@@ -0,0 +1,250 @@
+/**
+ * FieldType
+ * 字段类型
+ */
+export const enum FieldType {
+  /** 文本输入 */
+  TEXT = 'text',
+  /** 数字输入 */
+  NUMBER = 'number',
+  /** 单选框 */
+  RADIO = 'radio',
+  /** 多选框 */
+  CHECKBOX = 'checkbox',
+  /** 开关 */
+  SWITCH = 'switch',
+  /** 滑块 */
+  SLIDER = 'slider',
+  /** 分割线 */
+  DIVIDER = 'divider',
+  /** 标题 */
+  TITLE = 'title',
+  /** 描述文本 */
+  DESCRIPTION = 'description',
+  /**  QuestionBase 风格的字段列表卡片布局（问题在左，答案在右） */
+  QUESTION_BASE_CARD = 'question_base_card',
+  /** 弹窗选项选择器 */
+  POPUP_OPTIONS_SELECTOR = 'popup-options-selector',
+  /** 自定义选择器 前端渲染提前准备的自定义选择器组件 */
+  CUSTOM_COMPONENT = 'custom-component'
+}
+
+/**
+ * 选项接口
+ */
+export interface IBaseOption {
+  /**
+   * 选项值
+   */
+  value?: string | number;
+  /**
+   * 选项标签
+   */
+  label?: string;
+}
+
+/**
+ * 自定义选择器选项接口
+ */
+export interface ICustomSelectorOption extends IBaseOption {
+  /**
+   * 选项描述
+   */
+  description?: string;
+  /**
+   * 图标（font awesome Unicode 字符）
+   */
+  icon?: string;
+  /**
+   * 图标背景色
+   */
+  color?: string;
+}
+
+/**
+ * 自定义验证规则接口
+ */
+export interface ICustomRules {
+  /**
+   * 由于rules由后端下发 所以不能使用函数表达式 只能使用字符串。
+   * 由于跨端限制，执行时候 不能使用eval等方法，需要使用正则替换和专门解析工具来解析rule，为可执行的js代码。
+   * 自定义验证规则可以处理跨字段依赖的验证。
+   * 执行验证时候需要替换字符串为特定值，字符串会使用 ${value} 占位。${}内部为取数路径
+   * ROOT 为根节点，${age} 为根配置中name为age的字段配置;ROOT.${age}.value 为根配置中name为age的字段的值。
+   * e.g.:
+   * ROOT.${age}.value >= 18"
+   * ROOT.${age1}.value >= ROOT.${age2}.value"
+   */
+  rule: string;
+}
+
+/**
+ * 低代码项渲染配置
+ */
+export interface FieldConfig {
+  /**
+   * 字段名称
+   */
+  name?: string;
+  /**
+   * 字段标签
+   */
+  label?: string;
+  /*
+   * 是否必填
+   */
+  required?: boolean;
+  /**
+   * value 字段值
+   */
+  value?: unknown;
+  /**
+   * rules 字段验证规则
+   * 由于rules由后端下发 所以不能使用函数表达式 只能使用字符串
+   * 执行验证时候需要替换字符串为特定值，字符串会使用 ${value} 占位。${}内部为取数路径 如
+   */
+  rules?: ICustomRules[];
+  /**
+   * 字段描述
+   */
+  description?: string;
+  /**
+   * 占位符
+   */
+  placeholder?: string;
+  /**
+   * 字段展示类型
+   */
+  fieldType?: FieldType;
+  /**
+   * 嵌套字段列表
+   */
+  fields?: FieldConfig[];
+  /**
+   * 用于 fieldType = FieldType.TEXT 类型的文本输入配置
+   */
+  textConfig?: {
+    /**
+     * 输入框类型
+     */
+    inputType?: 'text' | 'textArea' | 'password' | 'email' | 'tel' | 'url';
+    /**
+     * 最大长度（用于 textarea 类型）
+     */
+    maxlength?: number;
+  };
+  /**
+   * 用于 fieldType = FieldType.NUMBER 类型的数字输入配置
+   */
+  numberConfig?: {
+    /**
+     * 最小值（用于 number、slider 类型）
+     */
+    min?: number;
+    /**
+     * 最大值（用于 number、slider 类型）
+     */
+    max?: number;
+  };
+  /**
+   * 用于 fieldType = FieldType.RADIO 类型的单选框配置
+   */
+  radioConfig?: {
+    /**
+     * 选项列表
+     */
+    options?: IBaseOption[];
+  };
+  /**
+   * 用于 fieldType = FieldType.CHECKBOX 类型的多选框配置
+   */
+  checkboxConfig?: {
+    /**
+     * 选项列表
+     */
+    options?: IBaseOption[];
+  };
+  /**
+   * 用于 fieldType = FieldType.QUESTION_BASE_CARD 类型的卡片配置
+   */
+  questionBaseCardConfig?: {
+    /**
+     * 卡片标题
+     */
+    title?: string;
+    /**
+     * 卡片图标（Unicode 字符）
+     */
+    icon?: string;
+    /**
+     * 卡片描述
+     */
+    description?: string;
+    /**
+     * 图标背景色（CSS 颜色值或渐变）
+     */
+    iconBackground?: string;
+    /**
+     * 图标颜色
+     */
+    iconColor?: string;
+  };
+  /**
+   * 用于 fieldType = FieldType.SLIDER 类型的开关配置
+   */
+  sliderConfig?: {
+    /**
+     * 最小值
+     */
+    min?: number;
+    /**
+     * 最大值
+     */
+    max?: number;
+    /**
+     * 步长
+     */
+    step?: number;
+  };
+  /**
+   * 当 fieldType = FieldType.CUSTOM_COMPONENT 时，自定义选择器组件配置
+   */
+  customComponentConfig?: {
+    /**
+     * 自定义组件名称（组件需放在 components 目录下）
+     * 所有自定义组件都放在 ./components 目录下
+     * 自定义组件均会提供 confirm:(value: any) => void 和 close:() => void 事件
+     * 例如：'province-selector' 对应 ./components/province-selector/province-selector.vue
+     */
+    componentName: string;
+    /**
+     * 传递给自定义组件的额外配置
+     */
+    componentProps?: Record<string, any>;
+  };
+  /**
+   * 当 fieldType = FieldType.POPUP_OPTIONS_SELECTOR 时，低代码配置选择器配置
+   */
+  popupOptionsSelectorConfig?: {
+    /**
+     * 选择器标题
+     */
+    title?: string;
+    /**
+     * 主描述文本
+     */
+    mainDescription?: string;
+    /**
+     * 副描述文本
+     */
+    subDescription?: string;
+    /**
+     * 选项列表（支持图标、颜色、描述等）
+     */
+    options?: Array<ICustomSelectorOption>;
+    /**
+     * 确认按钮文本
+     */
+    confirmText?: string;
+  };
+}

package/hdd-ai-cloud/common/IReportData.d.ts

@@ -1,3 +1,5 @@
+import { type IGetRecommendSchool } from './IGetRecommendSchool';
+
 /**
  * 高考霍兰德职业兴趣测评报告接口
  * @interface IGaokaoInterestReport
@@ -71,45 +73,7 @@ export interface IGaokaoMajorMatchingReport {
  * @interface IGaokaoVolunteerRecommendationReport
  */
 export interface IGaokaoVolunteerRecommendationReport {
-  recommendations: IRecommendationSchoolItem[];
-}
-
-/**
- * 院校排序等推荐列表项
- */
-export interface IRecommendationSchoolItem {
-  /**
-   * 学校名称
-   */
-  schoolName?: String;
-  /**
-   * 招生代码
-   */
-  enrollmentId?: string;
-  /**
-   * 专业名称
-   */
-  majorName?: string;
-  /**
-   * 去年最低排名
-   */
-  rank?: number;
-  /**
-   * 学费
-   */
-  money?: number;
-  /**
-   * 招生人数
-   */
-  hc?: number;
-  /**
-   * 排序理由
-   */
-  rankReason?: string;
-  /**
-   * 冲稳保策略标识
-   */
-  strategyTag?: 'chong' | 'wen' | 'bao';
+  recommendations: IGetRecommendSchool[];
 }
 
 /**

package/hdd-ai-cloud/common/IReportInfo.d.ts

@@ -10,9 +10,9 @@ import { type SubReportTypeEnum } from './SubReportTypeEnum';
  */
 export interface IReportInfo {
   /**
-   * 会话id
+   * 报告id
    */
-  sessionId?: string;
+  reportId?: string;
   /**
    * 报告类型
    */

package/hdd-ai-cloud/common/IReportList.d.ts

@@ -0,0 +1,46 @@
+import { type ReportTypeEnum } from './ReportTypeEnum';
+import { type IGetRecommendSchool } from './IGetRecommendSchool';
+
+/**
+ * 报告列表
+ */
+export interface IReportList {
+  /**
+   * 报告类型
+   */
+  type?: ReportTypeEnum;
+  /**
+   * 标题
+   */
+  title?: string;
+  /**
+   * 创建时间
+   */
+  createTime?: number;
+  /**
+   * 高考报告
+   */
+  gaokaoReportInfo?: IGaoKaoReportInfo;
+}
+
+/**
+ * 高考报告列表
+ */
+export interface IGaoKaoReportInfo {
+  /**
+   * 分数
+   */
+  grade?: number | null;
+  /**
+   * 排名
+   */
+  rank?: number | null;
+  /**
+   * 分组名称
+   */
+  groupDesc?: string;
+  /**
+   * 推荐院校
+   */
+  recommendSchool?: IGetRecommendSchool[];
+}

package/hdd-ai-cloud/common/ISessionContent.d.ts

@@ -1,3 +1,4 @@
+import { type FieldConfig } from './ILowerCoderForm';
 import { type SessionRoleEnum } from './ISessionRole';
 
 /**
@@ -30,6 +31,16 @@ export interface ISessionContent {
   toolMessage?: IToolMessage;
 }
 
+/**
+ * 系统消息
+ */
+export interface ISystemMessage {
+  /**
+   * 内容
+   */
+  content?: string;
+}
+
 /**
  * 工具消息类型
  */
@@ -92,7 +103,7 @@ export interface IToolMessage {
   /**
    * 工具消息类型
    */
-  type: IToolTypeEnum;
+  type?: IToolTypeEnum;
   /**
    * 工具消息内容
    */
@@ -115,11 +126,16 @@ export interface IToolMessage {
     actionDescription?: string;
   };
   /**
-   * 需要收集非结构化信息
+   * 需要收集结构化信息
    */
   needCollectStructuredInfo?: INeedCollectStructuredInfo;
 }
 
+/**
+ * 系统消息
+ */
+export interface ISystemMessage {}
+
 /**
  * uCharts 图表类型
  */
@@ -153,7 +169,7 @@ export interface IUChartsSeries {
   /**
    * 数据值数组
    */
-  data?: number[] | { value: number; name?: string }[];
+  data?: number[] | number;
   /**
    * 系列颜色
    */
@@ -281,6 +297,8 @@ export interface IUChartsOpts {
     scrollColor?: string;
     scrollBackgroundColor?: string;
     format?: string;
+    min?: number;
+    max?: number;
   };
   /**
    * Y轴配置
@@ -363,6 +381,7 @@ export interface IUChartsOpts {
       opacity?: number;
       max?: number;
       labelShow?: boolean;
+      border?: boolean;
       labelColor?: string;
       labelPointShow?: boolean;
       labelPointColor?: string;
@@ -462,14 +481,32 @@ export const enum IBehaviorAction {
   EndInquiryToGenerateReport = 'endInquiryToGenerateReport'
 }
 
+/**
+ * 结构化表单类型
+ */
+export const enum FormTypeEnum {
+  /**
+   * 高考基础信息
+   */
+  GaokaoBasicInfo = 'gaokaoBasicInfo',
+  /**
+   * 霍兰德性格测试回答
+   */
+  PersonalityAssessment = 'personalityAssessment',
+  /**
+   * 兴趣偏好
+   */
+  GaokaoPreferenceInfo = 'gaokaoPreferenceInfo'
+}
+
 /**
  * 需要收集结构化信息
  */
 export interface INeedCollectStructuredInfo {
   /**
-   * 表单类型
+   * 结构化表单类型
    */
-  type?: string;
+  type?: FormTypeEnum;
   /**
    * 对用户的语言提示
    */
@@ -489,30 +526,5 @@ export interface INeedCollectStructuredInfo {
   /**
    * 需要收集的字段列表
    */
-  fields: {
-    /**
-     * 字段名称
-     */
-    name?: string;
-    /**
-     * 字段标签
-     */
-    label?: string;
-    /**
-     * 字段描述
-     */
-    description?: string;
-    /**
-     * 是否必填
-     */
-    required?: boolean;
-    /**
-     * 选项
-     */
-    options?: string[];
-    /**
-     * 占位符
-     */
-    placeholder?: string;
-  }[];
+  fields: FieldConfig[];
 }

package/hdd-ai-cloud/common/index.d.ts

@@ -27,3 +27,4 @@ export * from './SubReportTypeEnum.d.ts';
 export * from './IReportData.d.ts';
 export * from './IFormatGaokaoBasicInfo.d.ts';
 export * from './IConfigInfo.d.ts';
+export * from './ILowerCoderForm.d.ts';

package/hdd-ai-cloud/controller/index.d.ts

@@ -20,6 +20,8 @@ import { type IGaokaoVolunteerRecommendationReport } from '../common/IReportData
 import { type IGaokaoInterestReport } from '../common/IReportData';
 import { type IGaokaoMajorMatchingReport } from '../common/IReportData';
 import { type IGaokaoFutureDevelopmentReport } from '../common/IReportData';
+import { type IReportList } from '../common/IReportList';
+import { type FormTypeEnum } from '../common/ISessionContent';
 
 /**
  *  千问AI聊天api 请求参数
@@ -204,6 +206,10 @@ export interface IAiGenerateReportReq extends ICommonReq {
    * 报告id
    */
   reportId?: string;
+  /**
+   * 会话id
+   */
+  sessionId?: string;
   /**
    * 报告类型
    */
@@ -254,9 +260,9 @@ export interface IAgentReq extends ICommonReq {
    */
   showGraph?: 'F' | 'T';
   /**
-   * 表单类型
+   * 前端传递的结构化表单类型
    */
-  formType?: 'gaokaoBasicInfo';
+  formType?: FormTypeEnum;
   /**
    * 格式化的表单数据 包括高考数据和报告数据
    */
@@ -387,7 +393,12 @@ export interface IGetInquirySessionListRes extends ICommonRes {
 /**
  * 添加会话内容req
  */
-export interface IAddSessionContentReq extends ICommonReq, ISessionContent {}
+export interface IAddSessionContentReq extends ICommonReq, ISessionContent {
+  /**
+   * 会话id
+   */
+  sessionId?: string;
+}
 
 /**
  * 添加会话内容res
@@ -494,3 +505,15 @@ export interface IGenerateReportInfoRes extends ICommonRes {
 export interface IGetConfigInfoRes extends ICommonRes {
   data?: IConfigInfo;
 }
+
+/**
+ * 获取报告列表req
+ */
+export interface IGetReportInfoReq extends ICommonReq {}
+
+/**
+ * 获取报告列表res
+ */
+export interface IGetReportInfoRes extends ICommonRes {
+  data?: IReportList[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hddjs/hdd-cloud-types",
-  "version": "1.0.15-SNAPSHOT.1",
+  "version": "1.0.18",
   "main": "index.d.ts",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"