@pisell/pisellos 2.2.93 → 2.2.95

package/dist/server/modules/resource/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Resource 模块主键类型
+ */
+export type ResourceId = number | string;
+/**
+ * Sales / ScheduleEventResource：预约条目内关联资源（仅 ID 与占用，详情由设备端基准数据解析）
+ * @see 统一 Sales 数据协议 3.4.1 resources
+ */
+export interface ScheduleEventResource {
+    /** 表单 ID。来源：ScheduleEventResource.form_id */
+    form_id: number;
+    /** 关联类型（如 form）。来源：ScheduleEventResource.relation_type */
+    relation_type: string;
+    /** 关联资源 ID（设备端用此 ID 从本地基准数据取资源详情）。来源：ScheduleEventResource.relation_id */
+    relation_id: number;
+    /** 占用容量。来源：ScheduleEventResource.capacity */
+    capacity: number;
+    /** 特殊状态。来源：ScheduleEventResource.like_status */
+    like_status?: string;
+    /** 资源元数据。来源：ScheduleEventResource.metadata */
+    metadata?: Record<string, unknown> | null;
+    /** 子资源（组合资源场景），结构同父级 */
+    children?: ScheduleEventResource[];
+}
+/**
+ * 资源预订数据结构
+ */
+export interface ResourceBooking {
+    id: ResourceId;
+    resource_id?: ResourceId;
+    resourceId?: ResourceId;
+    user_id?: string | number;
+    userId?: string | number;
+    start_time?: string | number;
+    end_time?: string | number;
+    startTime?: string | number;
+    endTime?: string | number;
+    status?: string;
+    notes?: string;
+    metadata?: Record<string, any> | null;
+    [key: string]: any;
+}
+/**
+ * 资源数据结构（兼容历史数据）
+ */
+export interface ResourceData {
+    id: ResourceId;
+    form_record_id?: ResourceId;
+    main_field?: string;
+    form_id?: number | string;
+    capacity?: number;
+    like_status?: 'common' | 'like';
+    type?: string;
+    resourceType?: string;
+    resource_form_id?: number | string | '';
+    schedule?: any[] | '';
+    times?: any;
+    metadata?: Record<string, any> | null;
+    children?: ResourceData[];
+    bookings?: ResourceBooking[];
+    [key: string]: any;
+}
+/**
+ * 查询选项
+ */
+export interface QueryOptions {
+    includeBookings?: boolean;
+    [key: string]: any;
+}
+/**
+ * Resource 模块状态
+ */
+export interface ResourceState {
+    /** 资源列表 */
+    list: ResourceData[];
+    /** 资源 Map 缓存（以 id 为 key，加速查询） */
+    map: Map<ResourceId, ResourceData>;
+    /** 预订列表 */
+    bookings: ResourceBooking[];
+}
+/**
+ * 与 ResourceDataSource 对齐的分页查询参数
+ */
+export interface ResourcePageQuery {
+    'ids[]'?: ResourceId[] | ResourceId;
+    ids?: ResourceId[];
+    num?: number | string;
+    skip?: number | string;
+}
+/**
+ * 与 ResourceDataSource 对齐的分页返回结构
+ */
+export interface ResourcePageResult {
+    list: ResourceData[];
+    count: number;
+    skip: number;
+    size: number;
+}
+/**
+ * ResourceSyncMessage - pubsub 同步消息结构
+ */
+export interface ResourceSyncMessage {
+    module?: string;
+    action?: string;
+    operation?: string;
+    id?: ResourceId;
+    ids?: ResourceId[];
+    body?: Partial<ResourceData>;
+    change_types?: string[];
+    relation_resource_ids?: ResourceId[];
+    _channelKey?: string;
+}
+/**
+ * Resource 模块钩子
+ */
+export declare enum ResourceHooks {
+    onResourcesLoaded = "resource:onResourcesLoaded",
+    onResourcesChanged = "resource:onResourcesChanged",
+    onResourcesSyncCompleted = "resource:onResourcesSyncCompleted",
+    onBookingsChanged = "resource:onBookingsChanged"
+}

package/dist/server/modules/resource/types.js

@@ -0,0 +1,47 @@
+/**
+ * Resource 模块主键类型
+ */
+
+/**
+ * Sales / ScheduleEventResource：预约条目内关联资源（仅 ID 与占用，详情由设备端基准数据解析）
+ * @see 统一 Sales 数据协议 3.4.1 resources
+ */
+
+/**
+ * 资源预订数据结构
+ */
+
+/**
+ * 资源数据结构（兼容历史数据）
+ */
+
+/**
+ * 查询选项
+ */
+
+/**
+ * Resource 模块状态
+ */
+
+/**
+ * 与 ResourceDataSource 对齐的分页查询参数
+ */
+
+/**
+ * 与 ResourceDataSource 对齐的分页返回结构
+ */
+
+/**
+ * ResourceSyncMessage - pubsub 同步消息结构
+ */
+
+/**
+ * Resource 模块钩子
+ */
+export var ResourceHooks = /*#__PURE__*/function (ResourceHooks) {
+  ResourceHooks["onResourcesLoaded"] = "resource:onResourcesLoaded";
+  ResourceHooks["onResourcesChanged"] = "resource:onResourcesChanged";
+  ResourceHooks["onResourcesSyncCompleted"] = "resource:onResourcesSyncCompleted";
+  ResourceHooks["onBookingsChanged"] = "resource:onBookingsChanged";
+  return ResourceHooks;
+}({});

package/dist/solution/BookingByStep/index.d.ts

@@ -344,7 +344,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
     };
     setOtherData(key: string, value: any): void;
     getOtherData(key: string): any;
-    getProductTypeById(id: number): Promise<"normal" | "duration" | "session">;
+    getProductTypeById(id: number): Promise<"duration" | "session" | "normal">;
     /**
      * 提供给 UI 的方法，减轻 UI 层的计算压力，UI 层只需要传递 cartItemId 和 resourceCode 即返回对应的 renderList
      *

package/dist/solution/BookingTicket/index.d.ts

@@ -131,7 +131,7 @@ export declare class BookingTicketImpl extends BaseModule implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态

package/dist/solution/Sales/index.d.ts

@@ -0,0 +1,96 @@
+import dayjs from 'dayjs';
+import { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../../modules/BaseModule';
+import type { RequestPlugin } from '../../plugins/request';
+import { SalesState, SalesModuleAPI, Reservation, SalesResourceBookingItem, SalesTimelineHighlights } from './types';
+import type { BookingData } from '../../server/modules/order/types';
+export * from './types';
+/**
+ * Sales 解决方案基础骨架
+ *
+ * 当前阶段仅提供：
+ * - solution 目录结构
+ * - 标准入口导出
+ * - 基础生命周期占位
+ *
+ * 不提前实现 store 编排、初始化流程细节、状态计算逻辑。
+ */
+export declare class SalesImpl extends BaseModule implements Module, SalesModuleAPI {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    protected defaultTimelineBucketMinutes: number;
+    isSolution: boolean;
+    protected store: SalesState;
+    protected options: ModuleOptions;
+    protected otherParams: Record<string, any>;
+    protected request: RequestPlugin;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    /** 获取当前 store 快照 */
+    getState(): SalesState;
+    /** 获取当前选择日期 */
+    getCurrentDay(): dayjs.Dayjs;
+    /** 设置当前选择日期，会自动归一到当天 00:00:00 */
+    setCurrentDay(currentDay: dayjs.ConfigType): dayjs.Dayjs;
+    /** 获取当前预约列表 */
+    getReservationList(): Reservation[];
+    /** 覆盖设置当前预约列表 */
+    setReservationList(reservationList: Reservation[]): Reservation[];
+    /** 重置预约列表为空 */
+    resetReservationList(): Reservation[];
+    destroy(): Promise<void>;
+    /**
+     * 时间轴粒度（分钟）
+     * - 默认 15 分钟
+     * - 可通过 registerModule 时的 options.otherParams.timelineBucketMinutes 覆盖
+     */
+    private getTimelineBucketMinutes;
+    /**
+     * 解析营业日统计窗口：
+     * - 当 operating_day_boundary.type === 'start_time'
+     *   使用「今天 + boundary.time」到「明天 + boundary.time」
+     * - 否则回退自然日（00:00 到次日 00:00）
+     */
+    private getTimelineRangeByOperatingBoundary;
+    /**
+     * 统计时间轴每个时间片的预约数量。
+     * 算法使用差分数组，复杂度 O(n + s):
+     * - n = booking 数量
+     * - s = 时间片数量
+     */
+    getTimelineHighlights(bookingList?: BookingData[], startDateTime?: string, endDateTime?: string): SalesTimelineHighlights;
+    /** dayjs 未启用插件时，手动封装 >= 判断 */
+    private isSameOrAfter;
+    /** dayjs 未启用插件时，手动封装 <= 判断 */
+    private isSameOrBefore;
+    /**
+     * 将 booking 的日期/时间字段统一组装为 dayjs
+     * - date + time 都有：按完整时间解析
+     * - 只有一个字段：按单字段解析（兼容历史数据）
+     * - 都没有：返回 invalid
+     */
+    private toBookingDateTime;
+    /**
+     * 预约状态映射（面向 UI 的统一状态）
+     * 说明：locked 逻辑后续会补业务规则，这里先保留分支占位。
+     */
+    private getBookingStatus;
+    private getResourceId;
+    /**
+     * 资源下 bookings 的返回裁剪策略：
+     * 1) 优先返回当前时刻正在进行中的预约（允许并发返回多条）
+     * 2) 若无 active，返回已超时且仍占用中的预约（允许并发多条）
+     * 3) 若仍无，返回最近一组未来预约（同 start_time 的并发预约全部返回）
+     * 4) 最后兜底返回一条（避免资源有历史预约时完全无反馈）
+     */
+    private pickBookingsForCurrentPoint;
+    /**
+     * 标准化单条 booking：
+     * - 过滤终态（rejected/cancelled/completed）
+     * - 注入 status / isTimeout / reserved_status
+     */
+    private normalizeMatchedBooking;
+    getResourceBookingList(currentTime: string, bookingList?: BookingData[]): Promise<SalesResourceBookingItem[]>;
+}
+export { SalesImpl as Sales };
+export default SalesImpl;