@acorex-platform/module-document-management-client 0.0.57 → 0.0.59

package/i18n/fa-IR/document-management.json

@@ -269,6 +269,7 @@
       "manage-versions": "مدیریت نسخه‌ها",
       "actions": "عملیات",
       "distribute": "توزیع",
+      "request-review": "ایجاد وظیفه بازبینی سند",
       "new-version": "نسخهٔ جدید",
       "upload-new-version": "بارگذاری فایل جدید",
       "publish-version": "انتشار نسخه",
@@ -307,7 +308,8 @@
     "grid": {
       "columns": {
         "items": "موارد"
-      }
+      },
+      "row-menu": "اقدامات بیشتر"
     },
     "detail-panel": {
       "sections": {
@@ -377,7 +379,7 @@
     "items": {
       "view-mode": {
         "title": "حالت نمایش پیش‌فرض",
-        "description": "نحوه نمایش موارد هنگام باز کردن یک پوشه.",
+        "description": "نمایی که برای همه پوشه‌ها و اسناد استفاده می‌شود تا زمانی که آن را تغییر دهید.",
         "options": {
           "large-tiles": "کاشی‌های بزرگ",
           "small-tiles": "کاشی‌های کوچک",
@@ -632,10 +634,66 @@
       "completed": "سند امضا شد."
     }
   },
+  "review": {
+    "dialog": {
+      "title": "ایجاد وظیفه بازبینی سند",
+      "submit": "ایجاد وظیفه"
+    },
+    "fields": {
+      "title": "عنوان",
+      "description": "شرح",
+      "due-date": "مهلت",
+      "reviewer": "بازبین"
+    },
+    "success": {
+      "title": "وظیفه بازبینی سند ایجاد شد",
+      "description": "بازبین می‌تواند این وظیفه را در بورد وظایف ببیند و پس از بازبینی امضا کند."
+    },
+    "loading": {
+      "title": "در حال ایجاد وظیفه بازبینی سند",
+      "description": "در حال ایجاد وظیفه بازبینی سند و تخصیص بازبین."
+    },
+    "errors": {
+      "title": "بازبینی سند ناموفق بود",
+      "forbidden": "اجازه مدیریت بازبینی سند را ندارید.",
+      "subject-required": "یک سند یا پوشه برای بازبینی انتخاب کنید.",
+      "not-enabled": "تاریخ بازبینی و بازبینی‌شده توسط برای این مورد تعریف نشده است.",
+      "task-type-missing": "نوع وظیفه بازبینی سند در دسترس نیست.",
+      "status-missing": "وضعیت‌های وظیفه بازبینی سند در دسترس نیست.",
+      "title-required": "عنوان را وارد کنید.",
+      "due-date-required": "مهلت را انتخاب کنید.",
+      "reviewer-required": "بازبین را انتخاب کنید.",
+      "workflow-failed": "گردش‌کار بازبینی سند شروع نشد.",
+      "failed": "وظیفه بازبینی سند ایجاد نشد.",
+      "folder-view-forbidden": "اجازه مشاهده این پوشه برای بازبینی را ندارید."
+    },
+    "folder-view": {
+      "title": "اسناد پوشه بازبینی",
+      "file": "پرونده",
+      "open": "باز کردن",
+      "empty": "این پوشه سندی برای بازبینی ندارد.",
+      "file-required": "یک پرونده انتخاب کنید.",
+      "opening-all": "در حال باز کردن {{count}} سند."
+    },
+    "warnings": {
+      "title": "میانبر اضافه نشد",
+      "pin-failed": "وظیفه بازبینی ایجاد شد، اما میانبر سند یا پوشه به آن اضافه نشد."
+    },
+    "workflow": {
+      "task-description": "برای بازبینی پرونده‌ها مشاهده را باز کنید، سپس امضا کنید. امضا تاریخ بازبینی و بازبینی‌شده توسط را ثبت می‌کند.",
+      "view-document": "مشاهده",
+      "sign-off-action": "امضا",
+      "sign-off": "برای تکمیل بازبینی سند امضا کنید.",
+      "completed": "بازبینی سند امضا شد."
+    }
+  },
   "commands": {
     "shared": {
       "inputs": {
         "document-id": { "title": "شناسه سند" },
+        "folder-id": { "title": "شناسه پوشه" },
+        "task-id": { "title": "شناسه وظیفه" },
+        "signer-user-id": { "title": "شناسه کاربر امضاکننده" },
         "data": { "title": "داده" },
         "options": { "title": "گزینه‌ها" },
         "instance-id": { "title": "شناسه نمونه" },
@@ -659,6 +717,9 @@
     "upload-document": { "title": "بارگذاری سند" },
     "distribute-document": { "title": "توزیع سند" },
     "sign-distributed-document": { "title": "امضای سند توزیع‌شده" },
+    "request-document-review": { "title": "ایجاد وظیفه بازبینی سند" },
+    "sign-document-review": { "title": "امضای بازبینی سند" },
+    "stamp-document-review": { "title": "ثبت بازبینی سند" },
     "document-expiration-notify-run": { "title": "اعلان گذار انقضای سند" }
   }
 }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex-platform/module-document-management-client",
-  "version": "0.0.57",
+  "version": "0.0.59",
   "sideEffects": false,
   "peerDependencies": {
-    "@acorex-platform/module-data-management-client": "0.0.57",
+    "@acorex-platform/module-data-management-client": "0.0.59",
     "@angular/common": "^21.0.0 || ^22.0.0",
     "@angular/core": "^21.0.0 || ^22.0.0"
   },

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

@@ -1,6 +1,6 @@
+import { AXMMetaDataBuilderValue, AXMMetaDataFieldAppliesTo } from '@acorex-platform/module-data-management-client/contracts';
 import { AXPModuleManifest, AXPMultiLanguageString, AXPFileListItem, AXPMetaData, AXPCategoryEntity } from '@acorex-platform/framework-shared/core';
 import { AXPRecordAuditInfo, AXPAuditEvent, AXPEntityModel } from '@acorex-platform/framework-shared/entity';
-import { AXMMetaDataBuilderValue } from '@acorex-platform/module-data-management-client/contracts';
 
 declare const AXPDocumentManagementFeatureKeys: {
     readonly MaxSizeStorage: "DocumentManagement:Feature:max-size-storage";
@@ -22,6 +22,7 @@ declare const AXPContentDocumentsPermissionKeys: {
     readonly MaintainDocuments: "ContentDocuments:Permission:MaintainDocuments";
     readonly MaintainVersioning: "ContentDocuments:Permission:MaintainVersioning";
     readonly DistributeDocuments: "ContentDocuments:Permission:DistributeDocuments";
+    readonly ManageDocumentReview: "ContentDocuments:Permission:ManageDocumentReview";
     readonly MaintainContent: "ContentDocuments:Permission:MaintainContent";
     readonly MaintainFormTemplates: "ContentDocuments:Permission:MaintainFormTemplates";
     readonly Setup: "ContentDocuments:Permission:Setup";
@@ -68,9 +69,35 @@ declare const AXMDocumentManagementCommandKeys: {
     readonly DocumentDistributionSignOff: "DocumentManagement.DocumentDistribution:SignOff";
     readonly ResolveCurrentSigner: "DocumentManagement.DocumentDistribution:ResolveCurrentSigner";
     readonly AdvanceSignerIndex: "DocumentManagement.DocumentDistribution:AdvanceSignerIndex";
+    readonly DocumentReviewRequest: "DocumentManagement.Document:RequestReview";
+    readonly DocumentReviewSignOff: "DocumentManagement.DocumentReview:SignOff";
+    readonly DocumentReviewStamp: "DocumentManagement.DocumentReview:Stamp";
 };
 declare const AXM_DOCUMENT_EXPIRATION_NOTIFY_RUN_COMMAND_KEY: "DocumentManagement:DocumentExpiration:NotifyRun";
 
+declare const AXM_DOCUMENT_REVIEW_DATE_FIELD_NAME = "review-date";
+declare const AXM_DOCUMENT_REVIEWED_BY_FIELD_NAME = "reviewed-by";
+declare const AXM_DOCUMENT_REVIEW_FIELD_NAMES: readonly ["review-date", "reviewed-by"];
+declare function isDocumentReviewMetadataFieldName(name: unknown): boolean;
+declare function documentReviewReadonlyFieldNames(canManageReview: boolean): readonly string[];
+declare function documentTypeHasFolderScopedMetadata(list: AXMMetaDataBuilderValue | null | undefined): boolean;
+declare function resolveDocumentReviewAppliesTo(list: AXMMetaDataBuilderValue | null | undefined): AXMMetaDataFieldAppliesTo;
+declare function isDocumentReviewRequired(value: unknown): boolean;
+declare function documentTypeHasReviewMetadata(list: AXMMetaDataBuilderValue | null | undefined): boolean;
+declare function documentTypeHasReviewMetadataForAppliesTo(list: AXMMetaDataBuilderValue | null | undefined, appliesTo: AXMMetaDataFieldAppliesTo): boolean;
+declare function applyDocumentReviewMetadataIfRequired<T extends {
+    requiresReview?: unknown;
+    name?: string;
+    metaDataList?: AXMMetaDataBuilderValue | null;
+}>(row: T): T;
+/**
+ * When `requiresReview` is true, every document type gets Review Date and Reviewed By.
+ * Applies To is Folder when any existing field is folder-scoped; otherwise Document.
+ */
+declare function ensureDocumentReviewMetadata(list: AXMMetaDataBuilderValue | null | undefined, typeName?: string): AXMMetaDataBuilderValue;
+declare function restoreDocumentReviewFormValues(incoming: Record<string, unknown> | null | undefined, previous: Record<string, unknown> | null | undefined): Record<string, unknown>;
+declare function stampDocumentReviewFormValues(existing: Record<string, unknown> | null | undefined, reviewedByUserId: string, reviewedAt: string): Record<string, unknown>;
+
 declare const RootConfig: {
     readonly config: {
         i18n: string;
@@ -159,6 +186,9 @@ declare const AXMDocumentManagementQueryKeys: {
         readonly GetPath: "DocumentManagement:Folder:GetPath";
         readonly Search: "DocumentManagement:Folder:Search";
     };
+    readonly DocumentReview: {
+        readonly ListFolderDocuments: "DocumentManagement.DocumentReview:ListFolderDocuments";
+    };
     readonly DocumentType: {
         readonly GetByName: "DocumentManagement:DocumentType:GetByName";
     };
@@ -314,6 +344,8 @@ interface AXMDocumentDocDto {
     enableVersioning?: boolean;
     /** Copied from Document Type at stamp/slim time. Host eligibility is `distributionEnabled`. */
     enableDistributionCapability?: boolean;
+    /** Copied from Document Type at stamp/slim time. Drives Request Review. */
+    requiresReview?: boolean;
 }
 
 /**
@@ -509,5 +541,5 @@ interface AXMDocumentManagementFolderGetDto extends AXMDocumentManagementFolderE
     shortcuts?: AXMDocumentShortcutEntityModel[];
 }
 
-export { AXMDocumentManagementCommandKeys, AXMDocumentManagementDocumentStatusValues, AXMDocumentManagementQueryKeys, AXMDocumentVersioningStatusValues, AXMPermissionsKeys, AXM_DOCUMENT_EXPIRATION_NEAR_DAYS, AXM_DOCUMENT_EXPIRATION_NOTIFY_RUN_COMMAND_KEY, AXPContentDocumentsPermissionKeys, AXPDocumentManagementFeatureKeys, AXPDocumentManagementMenuKeys, AXPDocumentManagementSettings, DocumentManagementManifest, RootConfig, addDaysToDocumentExpirationDateKey, classifyDocumentExpirationStatus, extractDocumentTypeFileKindNames, getDocumentExpirationDateKey, getDocumentExpirationQueryBoundValues, getDocumentExpirationQueryBounds, getDocumentExpirationRemainingDays, getUtcDayBoundsForDateKey, normalizeDocumentTypeFileKinds, toDocumentExpirationDate, toDocumentExpirationStorageValue };
+export { AXMDocumentManagementCommandKeys, AXMDocumentManagementDocumentStatusValues, AXMDocumentManagementQueryKeys, AXMDocumentVersioningStatusValues, AXMPermissionsKeys, AXM_DOCUMENT_EXPIRATION_NEAR_DAYS, AXM_DOCUMENT_EXPIRATION_NOTIFY_RUN_COMMAND_KEY, AXM_DOCUMENT_REVIEWED_BY_FIELD_NAME, AXM_DOCUMENT_REVIEW_DATE_FIELD_NAME, AXM_DOCUMENT_REVIEW_FIELD_NAMES, AXPContentDocumentsPermissionKeys, AXPDocumentManagementFeatureKeys, AXPDocumentManagementMenuKeys, AXPDocumentManagementSettings, DocumentManagementManifest, RootConfig, addDaysToDocumentExpirationDateKey, applyDocumentReviewMetadataIfRequired, classifyDocumentExpirationStatus, documentReviewReadonlyFieldNames, documentTypeHasFolderScopedMetadata, documentTypeHasReviewMetadata, documentTypeHasReviewMetadataForAppliesTo, ensureDocumentReviewMetadata, extractDocumentTypeFileKindNames, getDocumentExpirationDateKey, getDocumentExpirationQueryBoundValues, getDocumentExpirationQueryBounds, getDocumentExpirationRemainingDays, getUtcDayBoundsForDateKey, isDocumentReviewMetadataFieldName, isDocumentReviewRequired, normalizeDocumentTypeFileKinds, resolveDocumentReviewAppliesTo, restoreDocumentReviewFormValues, stampDocumentReviewFormValues, toDocumentExpirationDate, toDocumentExpirationStorageValue };
 export type { AXMDocumentAuditInfo, AXMDocumentDocDto, AXMDocumentDto, AXMDocumentExpirationStatus, AXMDocumentInheritanceType, AXMDocumentManagementDocumentStatus, AXMDocumentManagementDocumentTypeEntityModel, AXMDocumentManagementFolderCreateDto, AXMDocumentManagementFolderEntityModel, AXMDocumentManagementFolderGetDto, AXMDocumentShortcutEntityModel, AXMDocumentVersionDto, AXMDocumentVersioningStatus, AXPDriveBootstrapCatalog, AXPDriveBootstrapDocumentType, AXPDriveBootstrapFolderNode, DocumentTypeAllowedFileKinds, DocumentTypeFileKindName, DocumentTypeFileKindOption, DocumentTypeFileOutput };

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

@@ -19,7 +19,7 @@ import { AXDialogService } from '@acorex/components/dialog';
 import { AXPopupService } from '@acorex/components/popup';
 import * as _acorex_platform_framework_client_common from '@acorex-platform/framework-client/common';
 import { AXPFileStorageService, AXPFileTypeProviderService, AXPFileType, AXPFileTypeInfoProvider, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '@acorex-platform/framework-client/common';
-import { AXPLayoutBuilderService, AXPDialogRef } from '@acorex-platform/framework-client/layout/builder';
+import { AXPDialogOpener, AXPLayoutBuilderService, AXPDialogRef } from '@acorex-platform/framework-client/layout/builder';
 import { AXPFileViewerService, AXPPageComponentProvider, AXPPageComponentDefinition } from '@acorex-platform/framework-client/layout/components';
 import { AXPCommandService } from '@acorex-platform/framework-client/runtime';
 import { AXPHookService, AXPDeviceService } from '@acorex-platform/framework-client/core';
@@ -187,6 +187,11 @@ declare abstract class AXPDocumentManagementService {
         documentTypeIds?: string[];
     }): Promise<AXMDocumentDto[]>;
     abstract findManyDocuments(ids: string[]): Promise<AXMDocumentDto[]>;
+    /**
+     * Lists files in a folder tree for Document Review View.
+     * Authorized for the assigned reviewer (or ManageDocumentReview) without Drive access.
+     */
+    abstract listFolderReviewDocuments(folderId: string, taskId?: string): Promise<AXMDocumentDto[]>;
     /**
      * Returns how many documents are already past their expiration date (tenant-scoped).
      * Used by the Company Documents menu badge.
@@ -384,6 +389,7 @@ declare class AXMDocumentManagerServiceImpl extends AXMDocumentManagerService {
     protected documentTypeService: _acorex_platform_framework_client_layout_entity.EntityDataAccessor<any, any, any, Omit<any, "id">, any>;
     protected documentManagementService: AXPDocumentManagementService;
     protected popupService: AXPopupService;
+    protected dialogOpener: AXPDialogOpener;
     protected dialogService: AXDialogService;
     protected fileService: AXPFileStorageService;
     protected fileManagerService: AXFileService;
@@ -1123,6 +1129,8 @@ declare class AXMDocumentExplorerComponent {
      */
     protected handleExplorerContextMenu(event: MouseEvent): Promise<void>;
     protected handleContextMenuItemClick(e: AXContextMenuItemsClickEvent): Promise<void>;
+    private resolveExplorerItemElement;
+    private resolveExplorerNode;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMDocumentExplorerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMDocumentExplorerComponent, "axm-document-explorer", never, { "browseMode": { "alias": "browseMode"; "required": false; "isSignal": true; }; "viewMode": { "alias": "viewMode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "showContextMenu": { "alias": "showContextMenu"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -2594,6 +2602,7 @@ declare class AXMDocumentManagementApiService extends AXPDocumentManagementServi
         metadataFilters?: AXPFilterQuery[];
         documentTypeIds?: string[];
     }): Promise<AXMDocumentDto[]>;
+    listFolderReviewDocuments(folderId: string, taskId?: string): Promise<AXMDocumentDto[]>;
     findManyDocuments(ids: string[]): Promise<AXMDocumentDto[]>;
     getExpiredDocumentCount(): Promise<number>;
     getFolderPath(folderId: string, stopFolderId?: string): Promise<AXMDocumentManagementFolderEntityModel[]>;