feat: add time conflict check bo/vo and update docs

web/src/api/hq/hallAudit/types.ts

@@ -1,200 +1,39 @@
-export interface HallReservationVO {
-  /**
-   * 主键ID
-   */
-  id: string | number;
-
-  /**
-   * 报告厅ID
-   */
-  hallId: string | number;
-
-  /**
-   * 报告厅名称
-   */
-  hallName: string;
-
-  /**
-   * 开始时间
-   */
-  startTime: string;
-
-  /**
-   * 结束时间
-   */
-  endTime: string;
-
-  /**
-   * 预约用途
-   */
-  reservationPurpose: string;
-
-  /**
-   * 申请人id
-   */
-  applicantId: string | number;
-
-  /**
-   * 申请人姓名
-   */
-  applicantName: string;
-
-  /**
-   * 申请人电话
-   */
-  applicantPhone: string;
-
-  /**
-   * 预约状态
-   */
-  status: string;
-
-  /**
-   * 审核人id
-   */
-  auditBy: number;
-
-  /**
-   * 审核人
-   */
-  auditName: string;
-
-  /**
-   * 审核时间
-   */
-  auditTime: string;
-
-  /**
-   * 审核备注
-   */
-  auditRemark: string;
+import { HallReservationVO } from '../hallReservation/types';
 
+/**
+ * 报告厅预约审核表单
+ */
+export interface HallReservationAuditForm {
+    /** 预约ID列表 */
+    ids: Array<string | number>;
+    /** 审核状态 */
+    status: string;
+    /** 审核备注 */
+    auditRemark?: string;
 }
 
-export interface HallReservationForm extends BaseEntity {
-  /**
-   * 主键ID
-   */
-  id?: string | number;
-
-  /**
-   * 报告厅ID
-   */
-  hallId?: string | number;
-
-  /**
-   * 报告厅名称
-   */
-  hallName?: string;
-
-  /**
-   * 开始时间
-   */
-  startTime?: string;
-
-  /**
-   * 结束时间
-   */
-  endTime?: string;
-
-  /**
-   * 预约用途
-   */
-  reservationPurpose?: string;
-
-  /**
-   * 申请人id
-   */
-  applicantId?: string | number;
-
-  /**
-   * 申请人姓名
-   */
-  applicantName?: string;
-
-  /**
-   * 申请人电话
-   */
-  applicantPhone?: string;
-
-  /**
-   * 预约状态
-   */
-  status?: string;
-
-  /**
-   * 审核人id
-   */
-  auditBy?: number;
-
-  /**
-   * 审核人
-   */
-  auditName?: string;
-
-  /**
-   * 审核时间
-   */
-  auditTime?: string;
-
-  /**
-   * 审核备注
-   */
-  auditRemark?: string;
-
+/**
+ * 时间冲突检查参数
+ */
+export interface TimeCheckParams {
+    /** 报告厅ID */
+    hallId: string | number;
+    /** 预约开始时间 */
+    startTime: string;
+    /** 预约结束时间 */
+    endTime: string;
+    /** 排除的预约ID */
+    excludeId?: string | number;
 }
 
-export interface HallReservationQuery extends PageQuery {
-
-  /**
-   * 报告厅ID
-   */
-  hallId?: string | number;
-
-  /**
-   * 报告厅名称
-   */
-  hallName?: string;
-
-  /**
-   * 开始时间
-   */
-  startTime?: string;
-
-  /**
-   * 结束时间
-   */
-  endTime?: string;
-
-  /**
-   * 开始时间查询参数（字符串格式）
-   */
-  startTimeStr?: string;
-
-  /**
-   * 结束时间查询参数（字符串格式）
-   */
-  endTimeStr?: string;
-
-  /**
-   * 申请人ID
-   */
-  applicantId?: string | number;
-
-  /**
-   * 申请人姓名
-   */
-  applicantName?: string;
-
-  /**
-   * 预约状态
-   */
-  status?: string;
-
-    /**
-     * 日期范围参数
-     */
-    params?: any;
+/**
+ * 时间冲突检查结果
+ */
+export interface TimeCheckResult {
+    /** 是否存在冲突 */
+    hasConflict: boolean;
+    /** 冲突的预约列表 */
+    conflictList: HallReservationVO[];
 }