@acorex-platform/module-maintenance-management-client 0.0.69 → 1.0.1

package/types/acorex-platform-module-maintenance-management-client-contracts.d.ts

@@ -11,9 +11,11 @@ declare const AXMMaintenanceManagementCommandKeys: {
         readonly FillCompletion: "MaintenanceManagement.WorkReport:FillCompletion";
         readonly OpenFromWorkOrder: "MaintenanceManagement.WorkReport:OpenFromWorkOrder";
     };
+    readonly MaintenanceIntervalCheck: "MaintenanceManagement:MaintenanceInterval:Check";
     readonly WorkflowActivity: {
         readonly ResolveWorkOrder: "workflow-activity:resolve-work-order";
         readonly ResolvePersonUserId: "workflow-activity:resolve-person-user-id";
+        readonly CreateWorkOrderFromPlan: "workflow-activity:create-work-order-from-plan";
         readonly CreateOrGetWorkReportDraft: "workflow-activity:create-or-get-work-report-draft";
         readonly UpdateWorkOrderInProgress: "workflow-activity:update-work-order-in-progress";
         readonly ValidateWorkOrderCompletion: "workflow-activity:validate-work-order-completion";
@@ -22,6 +24,7 @@ declare const AXMMaintenanceManagementCommandKeys: {
         readonly UpdateWorkOrderCompleted: "workflow-activity:update-work-order-completed";
     };
 };
+declare const AXM_MAINTENANCE_INTERVAL_CHECK_COMMAND_KEY: "MaintenanceManagement:MaintenanceInterval:Check";
 
 declare const AXMMaintenanceManagementFeatureKeys: {
     readonly Management: "MaintenanceManagement:Feature:Management";
@@ -333,7 +336,7 @@ declare const AXM_MAINTENANCE_INTERVAL_WIDGET = "maintenance-interval-editor";
  * Same stored values as `AXMAssetIntervalKind`.
  * Combinations are multiple entries, not extra kinds.
  */
-declare const AXM_MAINTENANCE_INTERVAL_KINDS: readonly ["date", "distance", "operating-hours", "operation-count"];
+declare const AXM_MAINTENANCE_INTERVAL_KINDS: readonly ["schedule", "date", "distance", "operating-hours", "operation-count"];
 declare const METER_KINDS: readonly ["distance", "operating-hours", "operation-count"];
 type AXMMaintenanceIntervalKind = (typeof AXM_MAINTENANCE_INTERVAL_KINDS)[number];
 type AXMMaintenanceMeterKind = (typeof METER_KINDS)[number];
@@ -353,11 +356,19 @@ interface AXMMaintenanceIntervalConfig {
     triggerLogic: AXMMaintenanceIntervalTriggerLogic;
     triggers: AXMMaintenanceIntervalTrigger[];
 }
-type AXMMaintenanceIntervalTrigger = AXMDateIntervalTrigger | AXMMeterIntervalTrigger;
-/** Date intervals reuse the maintenance template scheduler-picker value. */
+type AXMMaintenanceIntervalTrigger = AXMScheduleIntervalTrigger | AXMDateIntervalTrigger | AXMMeterIntervalTrigger;
+/** Recurring calendar configuration from the scheduler picker. */
+interface AXMScheduleIntervalTrigger {
+    kind: 'schedule';
+    schedule: AXMMaintenanceManagementMaintenanceTemplateSchedule;
+}
+/**
+ * Single date. Older rows stored a scheduler value on `schedule` before Schedule was its own kind.
+ */
 interface AXMDateIntervalTrigger {
     kind: 'date';
-    schedule: AXMMaintenanceManagementMaintenanceTemplateSchedule;
+    date?: string;
+    schedule?: AXMMaintenanceManagementMaintenanceTemplateSchedule;
 }
 interface AXMMeterIntervalTrigger {
     kind: AXMMaintenanceMeterKind;
@@ -372,11 +383,14 @@ interface AXMMaintenanceIntervalMeterDraft {
 /** Editable form state. Disabled or invalid kinds are omitted from {@link buildAXMMaintenanceIntervalConfig}. */
 interface AXMMaintenanceIntervalDraft {
     triggerLogic: AXMMaintenanceIntervalTriggerLogic;
-    dateEnabled: boolean;
+    scheduleEnabled: boolean;
     schedule: AXMMaintenanceManagementMaintenanceTemplateSchedule | null;
+    dateEnabled: boolean;
+    /** Calendar date `YYYY-MM-DD`. Not a recurring schedule. */
+    date: string | null;
     meters: Record<AXMMaintenanceMeterKind, AXMMaintenanceIntervalMeterDraft>;
 }
-type AXMMaintenanceIntervalErrorCode = 'schedule' | 'interval' | 'integer';
+type AXMMaintenanceIntervalErrorCode = 'schedule' | 'date' | 'interval' | 'integer';
 interface AXMMaintenanceIntervalFieldError {
     kind: AXMMaintenanceIntervalKind;
     code: AXMMaintenanceIntervalErrorCode;
@@ -391,6 +405,8 @@ declare function defaultAXMMaintenanceIntervalUnit(kind: AXMMaintenanceMeterKind
 declare function isAXMMaintenanceIntervalUnitForKind(kind: AXMMaintenanceMeterKind, unit: AXMMaintenanceIntervalUnit): boolean;
 declare function emptyAXMMaintenanceIntervalConfig(): AXMMaintenanceIntervalConfig;
 declare function emptyAXMMaintenanceIntervalDraft(): AXMMaintenanceIntervalDraft;
+/** Calendar day stored on a date interval, as `YYYY-MM-DD`. */
+declare function readIntervalDate(value: unknown): string | null;
 /**
  * Builds the value object emitted by the interval editor.
  * Unsupported, disabled, and invalid triggers are left out.
@@ -601,6 +617,15 @@ declare const RootConfig: {
             icon: string;
         };
     };
+    /**
+     * Hourly usage-threshold check. Date intervals stay on work-order sign-off.
+     * One run per tenant; an open generated work order blocks a second insert.
+     */
+    maintenanceIntervalCheck: {
+        providerKey: string;
+        defaultCron: string;
+        idempotencyKeyTemplate: string;
+    };
 };
 
 /**
@@ -1107,6 +1132,13 @@ interface AXMMaintenanceManagementWorkOrderEntityModel {
     scheduledEnd?: string;
     startedAt?: string;
     completedAt?: string;
+    /**
+     * Meter readings copied from the asset when this work order first becomes completed.
+     * Sign-off uses this snapshot and does not read later live usage.
+     */
+    completionUsageReadings?: AXMWorkOrderCompletionUsageReading[];
+    /** Set after a successful sign-off has applied this order's readings to the plan. */
+    intervalStatesProgression?: AXMWorkOrderIntervalStatesProgression;
     assignedToId?: string;
     assignedTo?: {
         id: string;
@@ -1128,6 +1160,20 @@ interface AXMMaintenanceManagementWorkOrderEntityModel {
     sourceType?: AXMWorkOrderSourceType;
     autoGeneratedWorkOrder?: boolean;
 }
+/** One meter reading frozen at work-order completion. */
+interface AXMWorkOrderCompletionUsageReading {
+    kind: AXMMaintenanceMeterKind;
+    currentValue: number;
+    unit: AXMMaintenanceIntervalUnit;
+    /** ISO timestamp of the completion that captured this reading. */
+    capturedAt: string;
+}
+/** Durable marker so a signed-off work order cannot advance plan interval state twice. */
+interface AXMWorkOrderIntervalStatesProgression {
+    planId: string;
+    /** ISO timestamp of the sign-off that applied the readings. */
+    appliedAt: string;
+}
 
 interface AXMMaintenanceManagementWorkPackageEntityModel {
     id: string;
@@ -1199,5 +1245,5 @@ interface AXMMaintenanceManagementWorkReportEntityModel {
     finalizedAt?: string | null;
 }
 
-export { AXMFailureRegisterStatus, AXMMaintenanceIntervalTriggerLogic, AXMMaintenanceIntervalUnit, AXMMaintenanceManagementCommandKeys, AXMMaintenanceManagementFeatureKeys, AXMMaintenanceManagementMenuKeys, AXMMaintenanceManagementPermissionKeys, AXMWorkOrderSourceType, AXMWorkOrderStatus, AXM_MAINTENANCE_INTERVAL_KINDS, AXM_MAINTENANCE_INTERVAL_STATE_ERRORS, AXM_MAINTENANCE_INTERVAL_STATE_KINDS, AXM_MAINTENANCE_INTERVAL_WIDGET, AXPAssetsMaintenancePermissionKeys, MM_CATALOG_SCOPE_MN, MaintenanceManagementManifest, RootConfig, buildAXMMaintenanceIntervalConfig, defaultAXMMaintenanceIntervalUnit, draftFromAXMMaintenanceIntervalConfig, emptyAXMMaintenanceIntervalConfig, emptyAXMMaintenanceIntervalDraft, isAXMMaintenanceIntervalKind, isAXMMaintenanceIntervalUnitForKind, isAXMMaintenanceMeterKind, readMaintenanceIntervalStates, readMaintenancePlanCalendarSchedule, resolveMaintenanceIntervalStates };
-export type { AXMDateIntervalTrigger, AXMMaintenanceIntervalBuildResult, AXMMaintenanceIntervalConfig, AXMMaintenanceIntervalDraft, AXMMaintenanceIntervalErrorCode, AXMMaintenanceIntervalFieldError, AXMMaintenanceIntervalKind, AXMMaintenanceIntervalMeterDraft, AXMMaintenanceIntervalState, AXMMaintenanceIntervalStateIssue, AXMMaintenanceIntervalStateKind, AXMMaintenanceIntervalTrigger, AXMMaintenanceManagementActivityTypeAssetTypeEntityModel, AXMMaintenanceManagementActivityTypeEntityModel, AXMMaintenanceManagementActivityTypeResourceEntityModel, AXMMaintenanceManagementActivityTypeResourceType, AXMMaintenanceManagementActivityTypeSchedule, AXMMaintenanceManagementFailureCauseEntityModel, AXMMaintenanceManagementFailureDetectionEntityModel, AXMMaintenanceManagementFailureEffectEntityModel, AXMMaintenanceManagementFailureMechanismEntityModel, AXMMaintenanceManagementFailureModeAssetTypeEntityModel, AXMMaintenanceManagementFailureModeEntityModel, AXMMaintenanceManagementFailureModeMechanismEntityModel, AXMMaintenanceManagementFailureModeSolutionEntityModel, AXMMaintenanceManagementFailureRegisterCauseEntityModel, AXMMaintenanceManagementFailureRegisterEffectEntityModel, AXMMaintenanceManagementFailureRegisterEntityModel, AXMMaintenanceManagementFailureRegisterMechanismEntityModel, AXMMaintenanceManagementFailureSeverityEntityModel, AXMMaintenanceManagementFailureTypeEntityModel, AXMMaintenanceManagementMaintenancePlanEntityModel, AXMMaintenanceManagementMaintenancePlanSchedule, AXMMaintenanceManagementMaintenanceTemplateActivityTypeEntityModel, AXMMaintenanceManagementMaintenanceTemplateEntityModel, AXMMaintenanceManagementMaintenanceTemplateFailureModeEntityModel, AXMMaintenanceManagementMaintenanceTemplateMetaDataList, AXMMaintenanceManagementMaintenanceTemplateResourceEntityModel, AXMMaintenanceManagementMaintenanceTemplateResourceType, AXMMaintenanceManagementMaintenanceTemplateSchedule, AXMMaintenanceManagementMaintenanceTemplateWorkflowConfig, AXMMaintenanceManagementMaintenanceTypeEntityModel, AXMMaintenanceManagementWorkOrderCostType, AXMMaintenanceManagementWorkOrderCostValueObject, AXMMaintenanceManagementWorkOrderEntityModel, AXMMaintenanceManagementWorkPackageEntityModel, AXMMaintenanceManagementWorkReportEntityModel, AXMMaintenanceMeterKind, AXMMeterIntervalTrigger, AXMWorkReportAssessmentReference };
+export { AXMFailureRegisterStatus, AXMMaintenanceIntervalTriggerLogic, AXMMaintenanceIntervalUnit, AXMMaintenanceManagementCommandKeys, AXMMaintenanceManagementFeatureKeys, AXMMaintenanceManagementMenuKeys, AXMMaintenanceManagementPermissionKeys, AXMWorkOrderSourceType, AXMWorkOrderStatus, AXM_MAINTENANCE_INTERVAL_CHECK_COMMAND_KEY, AXM_MAINTENANCE_INTERVAL_KINDS, AXM_MAINTENANCE_INTERVAL_STATE_ERRORS, AXM_MAINTENANCE_INTERVAL_STATE_KINDS, AXM_MAINTENANCE_INTERVAL_WIDGET, AXPAssetsMaintenancePermissionKeys, MM_CATALOG_SCOPE_MN, MaintenanceManagementManifest, RootConfig, buildAXMMaintenanceIntervalConfig, defaultAXMMaintenanceIntervalUnit, draftFromAXMMaintenanceIntervalConfig, emptyAXMMaintenanceIntervalConfig, emptyAXMMaintenanceIntervalDraft, isAXMMaintenanceIntervalKind, isAXMMaintenanceIntervalUnitForKind, isAXMMaintenanceMeterKind, readIntervalDate, readMaintenanceIntervalStates, readMaintenancePlanCalendarSchedule, resolveMaintenanceIntervalStates };
+export type { AXMDateIntervalTrigger, AXMMaintenanceIntervalBuildResult, AXMMaintenanceIntervalConfig, AXMMaintenanceIntervalDraft, AXMMaintenanceIntervalErrorCode, AXMMaintenanceIntervalFieldError, AXMMaintenanceIntervalKind, AXMMaintenanceIntervalMeterDraft, AXMMaintenanceIntervalState, AXMMaintenanceIntervalStateIssue, AXMMaintenanceIntervalStateKind, AXMMaintenanceIntervalTrigger, AXMMaintenanceManagementActivityTypeAssetTypeEntityModel, AXMMaintenanceManagementActivityTypeEntityModel, AXMMaintenanceManagementActivityTypeResourceEntityModel, AXMMaintenanceManagementActivityTypeResourceType, AXMMaintenanceManagementActivityTypeSchedule, AXMMaintenanceManagementFailureCauseEntityModel, AXMMaintenanceManagementFailureDetectionEntityModel, AXMMaintenanceManagementFailureEffectEntityModel, AXMMaintenanceManagementFailureMechanismEntityModel, AXMMaintenanceManagementFailureModeAssetTypeEntityModel, AXMMaintenanceManagementFailureModeEntityModel, AXMMaintenanceManagementFailureModeMechanismEntityModel, AXMMaintenanceManagementFailureModeSolutionEntityModel, AXMMaintenanceManagementFailureRegisterCauseEntityModel, AXMMaintenanceManagementFailureRegisterEffectEntityModel, AXMMaintenanceManagementFailureRegisterEntityModel, AXMMaintenanceManagementFailureRegisterMechanismEntityModel, AXMMaintenanceManagementFailureSeverityEntityModel, AXMMaintenanceManagementFailureTypeEntityModel, AXMMaintenanceManagementMaintenancePlanEntityModel, AXMMaintenanceManagementMaintenancePlanSchedule, AXMMaintenanceManagementMaintenanceTemplateActivityTypeEntityModel, AXMMaintenanceManagementMaintenanceTemplateEntityModel, AXMMaintenanceManagementMaintenanceTemplateFailureModeEntityModel, AXMMaintenanceManagementMaintenanceTemplateMetaDataList, AXMMaintenanceManagementMaintenanceTemplateResourceEntityModel, AXMMaintenanceManagementMaintenanceTemplateResourceType, AXMMaintenanceManagementMaintenanceTemplateSchedule, AXMMaintenanceManagementMaintenanceTemplateWorkflowConfig, AXMMaintenanceManagementMaintenanceTypeEntityModel, AXMMaintenanceManagementWorkOrderCostType, AXMMaintenanceManagementWorkOrderCostValueObject, AXMMaintenanceManagementWorkOrderEntityModel, AXMMaintenanceManagementWorkPackageEntityModel, AXMMaintenanceManagementWorkReportEntityModel, AXMMaintenanceMeterKind, AXMMeterIntervalTrigger, AXMScheduleIntervalTrigger, AXMWorkOrderCompletionUsageReading, AXMWorkOrderIntervalStatesProgression, AXMWorkReportAssessmentReference };

package/types/acorex-platform-module-maintenance-management-client.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { AXValueChangedEvent } from '@acorex/cdk/common';
-import { AXSchedulerPickerSettings, AXSchedulerPickerValue } from '@acorex/components/scheduler-picker';
+import { AXSchedulerPickerValue, AXSchedulerPickerSettings } from '@acorex/components/scheduler-picker';
 import { AXMMaintenanceIntervalConfig, AXMMaintenanceIntervalTriggerLogic, AXMMaintenanceIntervalKind, AXMMaintenanceMeterKind, AXMMaintenanceIntervalUnit } from '@acorex-platform/module-maintenance-management-client/contracts';
 import { AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult } from '@acorex-platform/framework-client/common';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex-platform/framework-client/auth';
@@ -8,12 +8,14 @@ import { AXPMultiLanguageString, AXPWorkflowDefinition } from '@acorex-platform/
 
 declare const AXM_WORK_ORDER_WORKFLOW_DEBUG_NAMESPACE = "maintenance-management";
 
+type MaintenanceScheduleMode = 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly';
 interface MaintenanceIntervalSection {
     kind: AXMMaintenanceIntervalKind;
     labelKey: string;
     enabled: boolean;
-    editor: 'schedule' | 'distance' | 'meter';
+    editor: 'schedule' | 'date' | 'distance' | 'meter';
     meterKind: AXMMaintenanceMeterKind | null;
+    date: string | null;
     interval: number | null;
     decimals: number;
     unitId: AXMMaintenanceIntervalUnit | null;
@@ -32,15 +34,18 @@ declare class AXMMaintenanceIntervalComponent {
     protected readonly titleKey = "@maintenance-management:maintenance-interval.title";
     protected readonly everyKey = "@maintenance-management:maintenance-interval.every";
     protected readonly emptyKey = "@maintenance-management:maintenance-interval.empty";
+    protected readonly recurrenceUnitKey = "@maintenance-management:maintenance-interval.recurrence-unit.title";
     protected readonly triggerLogicTitleKey = "@maintenance-management:maintenance-interval.trigger-logic.title";
     protected readonly triggerLogic: typeof AXMMaintenanceIntervalTriggerLogic;
     protected readonly distanceUnits: MaintenanceIntervalChoice[];
     protected readonly triggerLogicItems: MaintenanceIntervalChoice[];
-    protected readonly scheduleSettings: AXSchedulerPickerSettings;
+    protected readonly scheduleModeItems: MaintenanceIntervalChoice[];
     private readonly draft;
     private lastEmitted;
     private lastSupportedKey;
     protected readonly scheduleValue: _angular_core.Signal<AXSchedulerPickerValue | null>;
+    protected readonly selectedScheduleMode: _angular_core.Signal<MaintenanceScheduleMode>;
+    protected readonly scheduleSettings: _angular_core.Signal<AXSchedulerPickerSettings>;
     protected readonly sections: _angular_core.Signal<MaintenanceIntervalSection[]>;
     protected readonly showTriggerLogic: _angular_core.Signal<boolean>;
     protected readonly selectedTriggerLogic: _angular_core.Signal<AXMMaintenanceIntervalTriggerLogic>;
@@ -48,7 +53,9 @@ declare class AXMMaintenanceIntervalComponent {
     protected onEnabled(kind: AXMMaintenanceIntervalKind, event: AXValueChangedEvent): void;
     protected onInterval(kind: AXMMaintenanceMeterKind, event: AXValueChangedEvent): void;
     protected onDistanceUnit(event: AXValueChangedEvent): void;
+    protected onDate(event: AXValueChangedEvent): void;
     protected onSchedule(value: AXSchedulerPickerValue | null): void;
+    protected onScheduleMode(event: AXValueChangedEvent): void;
     protected onTriggerLogic(event: AXValueChangedEvent): void;
     private supportedKeys;
     private toSection;