@acorex/modules 20.2.0-next.2 → 20.2.0-next.4

package/fesm2022/acorex-modules-workflow-management.mjs

@@ -1,2 +1,2 @@
-export { b as AXMMenuProvider, c as AXMWorkflowManagementModule, a as AXPTaskBoardModule, A as AXPTaskBoardService } from './acorex-modules-workflow-management-acorex-modules-workflow-management-DnSdOSmj.mjs';
+export { b as AXMMenuProvider, c as AXMWorkflowManagementModule, a as AXPTaskBoardModule, A as AXPTaskBoardService } from './acorex-modules-workflow-management-acorex-modules-workflow-management-DC7jdoqZ.mjs';
 //# sourceMappingURL=acorex-modules-workflow-management.mjs.map

package/locale-management/README.md

@@ -0,0 +1,3 @@
+# @acorex/modules/locale-management
+
+Secondary entry point of `@acorex/modules`. It can be used by importing from `@acorex/modules/locale-management`.

package/locale-management/index.d.ts

@@ -0,0 +1,182 @@
+import * as i0 from '@angular/core';
+import { Injector } from '@angular/core';
+import { AXPAppStartUpService } from '@acorex/platform/core';
+import * as i1 from '@angular/common';
+import * as i2 from '@acorex/platform/layout/components';
+import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult, AXPCurrency, AXPLocaleProfile, AXPLanguage, AXPTimeZone } from '@acorex/platform/common';
+import { AXPEntityModel, AXMEntityCrudServiceImpl, AXPEntityDefinitionLoader } from '@acorex/platform/layout/entity';
+import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
+
+declare class AXMLocaleManagementModule {
+    constructor(appInitService: AXPAppStartUpService, injector: Injector);
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocaleManagementModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AXMLocaleManagementModule, never, [typeof i1.CommonModule, typeof i2.AXPComponentSlotModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AXMLocaleManagementModule>;
+}
+
+declare const RootConfig: {
+    config: {
+        i18n: string;
+    };
+    module: {
+        name: string;
+        title: string;
+        icon: string;
+    };
+    entities: {
+        languages: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        locales: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        timezones: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        currencies: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+    };
+};
+
+declare function languagesFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocaleManagementLanguagesEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: string;
+    nativeTitle: string;
+    isRTL: boolean;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+declare abstract class AXMLanguagesService extends AXMEntityCrudServiceImpl<string, AXMLocaleManagementLanguagesEntityModel> {
+}
+declare class AXMLanguagesServiceImpl extends AXMLanguagesService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLanguagesServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLanguagesServiceImpl>;
+}
+
+declare function localesFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocaleManagementLocalesEntityModel extends AXPEntityModel<string> {
+    languageId: string;
+    code: string;
+    title: string;
+    countryCode: string;
+    isDefault: boolean;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+declare abstract class AXMLocalesService extends AXMEntityCrudServiceImpl<string, AXMLocaleManagementLocalesEntityModel> {
+}
+declare class AXMLocalesServiceImpl extends AXMLocalesService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocalesServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocalesServiceImpl>;
+}
+
+declare function timezonesFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocaleManagementTimezonesEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: string;
+    abbreviation: string;
+    standardOffset: number;
+    supportsDST: boolean;
+    region: string;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+declare abstract class AXMTimezonesService extends AXMEntityCrudServiceImpl<string, AXMLocaleManagementTimezonesEntityModel> {
+}
+declare class AXMTimezonesServiceImpl extends AXMTimezonesService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMTimezonesServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMTimezonesServiceImpl>;
+}
+
+declare function currenciesFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocaleManagementCurrenciesEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: string;
+    symbol: string;
+    decimalPlaces: number;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+declare abstract class AXMCurrenciesService extends AXMEntityCrudServiceImpl<string, AXMLocaleManagementCurrenciesEntityModel> {
+}
+declare class AXMCurrenciesServiceImpl extends AXMCurrenciesService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMCurrenciesServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMCurrenciesServiceImpl>;
+}
+
+declare class AXMLocaleManagementEntityProvider implements AXPEntityDefinitionLoader {
+    private injector;
+    constructor(injector: Injector);
+    get(moduleName: string, entityName: string): Promise<AXPEntity | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocaleManagementEntityProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocaleManagementEntityProvider>;
+}
+
+declare class AXMLocaleManagementMenuProvider implements AXPMenuProvider {
+    private entityService;
+    provide(context: AXPMenuProviderContext): Promise<void>;
+}
+
+declare class AXMLocaleManagementSearchCommandProvider extends AXPSearchCommandProvider {
+    commands: AXPSearchResult[];
+}
+
+declare class AXMLocaleManagementPermissionDefinitionProvider implements AXPPermissionDefinitionProvider {
+    private injector;
+    private readonly translateService;
+    constructor(injector: Injector);
+    define(context: AXPPermissionDefinitionProviderContext): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocaleManagementPermissionDefinitionProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocaleManagementPermissionDefinitionProvider>;
+}
+
+declare class AXMLocaleManagementService {
+    private translationService;
+    private currenciesService;
+    private languagesService;
+    private timezonesService;
+    private localesService;
+    private activeQuery;
+    getCurrencies(): Promise<AXPCurrency[]>;
+    getLocaleProfiles(): Promise<AXPLocaleProfile[]>;
+    getLanguages(): Promise<AXPLanguage[]>;
+    getLocales(): Promise<AXPLanguage[]>;
+    getAvailableLanguages(): Promise<AXPLanguage[]>;
+    getTimeZones(): Promise<AXPTimeZone[]>;
+    getBrowserTimeZoneCode(): Promise<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocaleManagementService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocaleManagementService>;
+}
+
+export { AXMCurrenciesService, AXMCurrenciesServiceImpl, AXMLanguagesService, AXMLanguagesServiceImpl, AXMLocaleManagementEntityProvider, AXMLocaleManagementMenuProvider, AXMLocaleManagementModule, AXMLocaleManagementPermissionDefinitionProvider, AXMLocaleManagementSearchCommandProvider, AXMLocaleManagementService, AXMLocalesService, AXMLocalesServiceImpl, AXMTimezonesService, AXMTimezonesServiceImpl, RootConfig, currenciesFactory, languagesFactory, localesFactory, timezonesFactory };
+export type { AXMLocaleManagementCurrenciesEntityModel, AXMLocaleManagementLanguagesEntityModel, AXMLocaleManagementLocalesEntityModel, AXMLocaleManagementTimezonesEntityModel };

package/location-management/README.md

@@ -0,0 +1,3 @@
+# @acorex/modules/location-management
+
+Secondary entry point of `@acorex/modules`. It can be used by importing from `@acorex/modules/location-management`.

package/location-management/index.d.ts

@@ -0,0 +1,166 @@
+import * as i0 from '@angular/core';
+import { Injector } from '@angular/core';
+import * as i1 from '@angular/common';
+import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult, AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext, AXPGeoLocation } from '@acorex/platform/common';
+import { AXPEntityModel, AXMEntityCrudServiceImpl, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityPreloadEntity } from '@acorex/platform/layout/entity';
+
+declare class AXMLocationManagementModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationManagementModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AXMLocationManagementModule, never, [typeof i1.CommonModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AXMLocationManagementModule>;
+}
+
+declare const RootConfig: {
+    config: {
+        i18n: string;
+    };
+    module: {
+        name: string;
+        title: string;
+        icon: string;
+    };
+    entities: {
+        location: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        locationType: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        geographicRegion: {
+            name: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+    };
+};
+
+declare function locationFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocationManagementLocationEntityModel extends AXPEntityModel<string> {
+    title: string;
+    code?: string;
+    locationTypeId?: string;
+    locationType?: {
+        id: string;
+        title: string;
+        description?: string;
+        icon?: string;
+        color?: string;
+    };
+    street1: string;
+    street2?: string;
+    countryId?: string;
+    stateId?: string;
+    cityId?: string;
+    districtId?: string;
+    postalCode: string;
+    coordinates?: string;
+    description?: string;
+    parentLocationId?: string;
+    isPrimary?: boolean;
+    isActive: boolean;
+    validFrom?: Date;
+    validTo?: Date;
+    timezone?: string;
+    externalId?: string;
+}
+
+declare abstract class AXMLocationService extends AXMEntityCrudServiceImpl<string, AXMLocationManagementLocationEntityModel> {
+}
+declare class AXMLocationServiceImpl extends AXMLocationService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocationServiceImpl>;
+}
+
+declare function locationTypeFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocationManagementLocationTypeEntityModel extends AXPEntityModel<string> {
+    title: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    isActive: boolean;
+}
+
+declare abstract class AXMLocationTypeService extends AXMEntityCrudServiceImpl<string, AXMLocationManagementLocationTypeEntityModel> {
+}
+declare class AXMLocationTypeServiceImpl extends AXMLocationTypeService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationTypeServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocationTypeServiceImpl>;
+}
+
+declare function geographicRegionFactory(injector: Injector): Promise<AXPEntity | null>;
+
+interface AXMLocationManagementGeographicRegionEntityModel extends AXPEntityModel<string> {
+    title: string;
+    code?: string;
+    type: string;
+    parentId?: string;
+    coordinates?: string;
+    timezone?: string;
+    population?: number;
+    area?: number;
+    currency?: string;
+    isActive: boolean;
+}
+interface GeographicRegionHierarchy {
+    country?: AXMLocationManagementGeographicRegionEntityModel;
+    state?: AXMLocationManagementGeographicRegionEntityModel;
+    city?: AXMLocationManagementGeographicRegionEntityModel;
+    district?: AXMLocationManagementGeographicRegionEntityModel;
+}
+
+declare abstract class AXMGeographicRegionService extends AXMEntityCrudServiceImpl<string, AXMLocationManagementGeographicRegionEntityModel> {
+}
+declare class AXMGeographicRegionServiceImpl extends AXMGeographicRegionService {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMGeographicRegionServiceImpl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMGeographicRegionServiceImpl>;
+}
+
+declare class AXMLocationManagementEntityProvider implements AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader {
+    private injector;
+    preload(): AXPEntityPreloadEntity[];
+    get(moduleName: string, entityName: string): Promise<AXPEntity | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationManagementEntityProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocationManagementEntityProvider>;
+}
+
+declare class AXMLocationManagementMenuProvider implements AXPMenuProvider {
+    private entityService;
+    provide(context: AXPMenuProviderContext): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationManagementMenuProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocationManagementMenuProvider>;
+}
+
+declare class AXMSearchCommandProvider extends AXPSearchCommandProvider {
+    commands: AXPSearchResult[];
+}
+
+declare class AXMSettingProvider implements AXPSettingDefinitionProvider {
+    provide(context: AXPSettingDefinitionProviderContext): Promise<void>;
+}
+
+declare class AXMLocationManagementService {
+    private geographicRegionService;
+    getCountries(): Promise<AXPGeoLocation[]>;
+    getProvinces(countryId?: string): Promise<AXPGeoLocation[]>;
+    getCities(filter?: {
+        countryId?: string;
+        provinceId?: string;
+    }): Promise<AXPGeoLocation[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLocationManagementService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLocationManagementService>;
+}
+
+export { AXMGeographicRegionService, AXMGeographicRegionServiceImpl, AXMLocationManagementEntityProvider, AXMLocationManagementMenuProvider, AXMLocationManagementModule, AXMLocationManagementService, AXMLocationServiceImpl as AXMLocationService, AXMLocationTypeServiceImpl as AXMLocationTypeService, AXMSearchCommandProvider, AXMSettingProvider, RootConfig, geographicRegionFactory, locationFactory, locationTypeFactory };
+export type { AXMLocationManagementGeographicRegionEntityModel, AXMLocationManagementLocationEntityModel, AXMLocationManagementLocationTypeEntityModel, GeographicRegionHierarchy };

package/notification-management/index.d.ts

@@ -1,8 +1,8 @@
 import { AXPEntity, AXPFileStorageInfo, AXPMenuProvider, AXPMenuProviderContext, AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '@acorex/platform/common';
 import * as i0 from '@angular/core';
-import { Injector, InjectionToken, OnInit, OnDestroy } from '@angular/core';
+import { Injector, InputSignal, OutputEmitterRef, Type, InjectionToken, OnInit, OnDestroy } from '@angular/core';
 import { AXPEntityModel, AXMEntityCrudServiceImpl } from '@acorex/platform/layout/entity';
-import { AXPActionMenuItem, AXPExecuteCommand, AXPContent, AXPUserReference, AXPQueryRequest, AXPPagedListResult } from '@acorex/platform/core';
+import { AXPExecuteCommand, AXPContent, AXPUserReference, AXPQueryRequest, AXPPagedListResult } from '@acorex/platform/core';
 import * as i1 from '@acorex/platform/layout/components';
 import * as i2 from '@acorex/platform/layout/builder';
 import { AXPValueWidgetComponent, AXPWidgetConfig } from '@acorex/platform/layout/builder';
@@ -70,11 +70,19 @@ declare class AXMNotificationManagementChannelEntityServiceImpl extends AXMNotif
 declare function notificationEntityFactory(injector: Injector): Promise<AXPEntity | null>;
 
 type AXMNotificationType = 'File' | 'Chat' | 'Comment' | 'Log';
+/**
+ * Interface for dynamic notification content components.
+ * Ensures that any component used for notification content has a consistent API.
+ */
+interface AXPNotificationContent {
+    item: InputSignal<AXMNotificationItem | undefined>;
+    execute: OutputEmitterRef<AXPExecuteCommand>;
+}
 declare abstract class AXPNotificationDefinitionProvider {
     name: AXMNotificationType;
     title: string;
     icon: string;
-    actions?: AXPActionMenuItem[];
+    content?: () => Promise<Type<AXPNotificationContent>>;
     execute: (command: AXPExecuteCommand, item: AXMNotificationItem) => Promise<void>;
 }
 declare class AXPNotificationDefinitionProviderDefault extends AXPNotificationDefinitionProvider {
@@ -84,7 +92,7 @@ declare const AXP_NOTIFICATION_DEFINITION_PROVIDER: InjectionToken<AXPNotificati
 declare class AXPNotificationDefinitionService {
     private providers;
     getProviders(): AXPNotificationDefinitionProvider[];
-    resolve(name: string): AXPNotificationDefinitionProvider;
+    resolve(name: string): AXPNotificationDefinitionProvider | null;
     execute(command: AXPExecuteCommand, item: AXMNotificationItem): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPNotificationDefinitionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPNotificationDefinitionService>;
@@ -116,6 +124,7 @@ interface AXMNotificationItem {
     readAt: Date | null;
     createAt: Date;
     entityName: 'notifications';
+    data?: Record<string, unknown>;
 }
 interface AXMNotificationResponse {
     total: number;
@@ -369,4 +378,4 @@ declare class AXPNotificationWidgetViewComponent extends AXPValueWidgetComponent
 declare const AXPMyNotificationDashboardWidget: AXPWidgetConfig;
 
 export { AXMNotificationConnectorService, AXMNotificationEntityService, AXMNotificationEntityServiceImpl, AXMNotificationManagementChannelEntityService, AXMNotificationManagementChannelEntityServiceImpl, AXMNotificationManagementModule, AXMNotificationManagementTemplateEntityModule, AXMNotificationManagementTemplateEntityService, AXMNotificationManagementTemplateEntityServiceImpl, AXMNotificationManagmentModuleMenuProvider, AXMOsNotificationService, AXMSettingProvider, AXPMyNotificationDashboardWidget, AXPNotificationDefinitionProvider, AXPNotificationDefinitionProviderDefault, AXPNotificationDefinitionService, AXPNotificationWidgetViewComponent, AXP_NOTIFICATION_DEFINITION_PROVIDER, RootConfig, myNotificationEntityFactory, notificationChannelEntityFactory, notificationEntityFactory, notificationLogEntityFactory, notificationTemplateEntityFactory };
-export type { AXMNotificationActionType, AXMNotificationCategory, AXMNotificationChannel, AXMNotificationItem, AXMNotificationManagementChannelEntityModel, AXMNotificationManagementNotificationEntityModel, AXMNotificationManagementTemplateEntityModel, AXMNotificationMarkAsReadRequest, AXMNotificationPrority, AXMNotificationResponse, AXMNotificationType, AXMOsNotificationOptions, AXMSelectModel };
+export type { AXMNotificationActionType, AXMNotificationCategory, AXMNotificationChannel, AXMNotificationItem, AXMNotificationManagementChannelEntityModel, AXMNotificationManagementNotificationEntityModel, AXMNotificationManagementTemplateEntityModel, AXMNotificationMarkAsReadRequest, AXMNotificationPrority, AXMNotificationResponse, AXMNotificationType, AXMOsNotificationOptions, AXMSelectModel, AXPNotificationContent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/modules",
-  "version": "20.2.0-next.2",
+  "version": "20.2.0-next.4",
   "peerDependencies": {
     "@angular/common": ">=19.0.0",
     "@angular/core": ">=19.0.0",
@@ -54,6 +54,10 @@
       "types": "./dashboard-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-dashboard-management.mjs"
     },
+    "./data-management": {
+      "types": "./data-management/index.d.ts",
+      "default": "./fesm2022/acorex-modules-data-management.mjs"
+    },
     "./document-management": {
       "types": "./document-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-document-management.mjs"
@@ -62,14 +66,18 @@
       "types": "./form-template-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-form-template-management.mjs"
     },
-    "./data-management": {
-      "types": "./data-management/index.d.ts",
-      "default": "./fesm2022/acorex-modules-data-management.mjs"
-    },
     "./issue-management": {
       "types": "./issue-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-issue-management.mjs"
     },
+    "./locale-management": {
+      "types": "./locale-management/index.d.ts",
+      "default": "./fesm2022/acorex-modules-locale-management.mjs"
+    },
+    "./location-management": {
+      "types": "./location-management/index.d.ts",
+      "default": "./fesm2022/acorex-modules-location-management.mjs"
+    },
     "./log-management": {
       "types": "./log-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-log-management.mjs"
@@ -110,6 +118,10 @@
       "types": "./text-template-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-text-template-management.mjs"
     },
+    "./task-management": {
+      "types": "./task-management/index.d.ts",
+      "default": "./fesm2022/acorex-modules-task-management.mjs"
+    },
     "./training-management": {
       "types": "./training-management/index.d.ts",
       "default": "./fesm2022/acorex-modules-training-management.mjs"

package/task-management/README.md

@@ -0,0 +1,189 @@
+# @acorex/modules/task-management
+
+Secondary entry point of `@acorex/modules`. It can be used by importing from `@acorex/modules/task-management`.
+
+# @acorex/modules/task-management
+
+Secondary entry point of `@acorex/modules`. It can be used by importing from `@acorex/modules/task-management`.
+This module defines the universal Task Engine used across the ACoreX Platform — powering everything from personal to-do lists to complex project workflows.
+
+# ✅ ACoreX Task Management Module
+
+## 📌 What is Task Management?
+
+The **Task Management Module** is a core, standalone service in the ACoreX Platform responsible for creating, assigning, tracking, and managing **tasks** across the system. It is designed to be **reusable and integratable** into any other module (e.g., Project Management, Workflow, Meeting, Help Desk).
+
+It supports:
+
+- Generic and contextual tasks
+- Full lifecycle and status management per task type
+- Task type-based behavior, fields, and flows
+- Comments, attachments, time tracking
+- Visual boards (Kanban, Table, Scheduler)
+- Notification, calendar, and chat integration
+
+---
+
+## 🧠 TaskType-Centric Architecture
+
+Each task is linked to a **`TaskType`**, which defines:
+
+- Allowed statuses and their transitions
+- Supported features (e.g., checklists, time tracking)
+- Form layout and validation (via `form-template-management`)
+- Default permissions and assignment rules
+- Allowed context types (e.g., `project`, `meeting`, or `null` for personal to-do)
+
+This allows the module to support both **simple personal tasks** and **enterprise-grade tasks**.
+
+---
+
+## 🧱 Core Entities
+
+| Entity                | Description                                                                                         |
+| --------------------- | --------------------------------------------------------------------------------------------------- |
+| **Task**              | The main work unit. Can be linked to one or more contexts (project, meeting, etc.) via TaskContext. |
+| **TaskType**          | Defines allowed statuses, structure, form template, context scopes, etc.                            |
+| **TaskStatus**        | Status configuration per TaskType (with allowed transitions)                                        |
+| **TaskChecklistItem** | Optional checklist items inside tasks                                                               |
+| **TaskAssignment**    | Maps users to tasks with optional roles                                                             |
+| **TimeLog**           | Logs time spent by users per task                                                                   |
+| **TaskTemplate**      | Reusable structure for task generation (optional)                                                   |
+| **TaskDependency**    | Define dependencies between tasks (used in projects or workflows)                                   |
+
+---
+
+## ⚙️ Required Commands
+
+| Command                            | Purpose                                    |
+| ---------------------------------- | ------------------------------------------ |
+| `AXPCreateTaskCommand`             | Create a new task                          |
+| `AXPUpdateTaskCommand`             | Update task metadata                       |
+| `AXPDeleteTaskCommand`             | Soft-delete a task                         |
+| `AXPAssignTaskCommand`             | Assign task to user(s)                     |
+| `AXPAddTimeLogCommand`             | Log time on a task                         |
+| `AXPCompleteChecklistItemCommand`  | Mark checklist item as done                |
+| `AXPSetTaskStatusCommand`          | Change task status                         |
+| `AXPCreateTaskFromTemplateCommand` | Spawn task from a predefined template      |
+| `AXPReorderTaskCommand`            | Change task position/order in a board view |
+| `AXPSetTaskDependenciesCommand`    | Define task prerequisites                  |
+
+---
+
+## 🔍 Queries
+
+| Query                           | Purpose                                        |
+| ------------------------------- | ---------------------------------------------- |
+| `AXPGetTaskDetailQuery`         | Fetch full task data with comments, logs, etc. |
+| `AXPGetTaskListQuery`           | Paginated/filterable task list                 |
+| `AXPGetTaskBoardQuery`          | Fetch board data (Kanban, Table, Scheduler)    |
+| `AXPGetMyTasksQuery`            | Tasks assigned to current user                 |
+| `AXPGetTaskTemplatesQuery`      | Retrieve reusable templates                    |
+| `AXPGetTaskCalendarEventsQuery` | Used for calendar views                        |
+| `AXPGetTaskSuggestionsQuery`    | Used by AI assistant or filters                |
+| `AXPGetTaskTypesQuery`          | Fetch metadata about all available task types  |
+
+---
+
+## 🧩 Integration with Other Modules
+
+| Module                   | Integration Type                                         |
+| ------------------------ | -------------------------------------------------------- |
+| **Project Management**   | `taskType = 'project-task'`, `contextType = 'project'`   |
+| **Meeting Management**   | `taskType = 'meeting-action'`, `contextType = 'meeting'` |
+| **Workflow Management**  | `taskType = 'approval-step'`, flow hooks                 |
+| **Help Desk**            | Internal tasks for resolution                            |
+| **Learning Management**  | Course-based tasks                                       |
+| **Calendar Management**  | Task due dates → calendar events                         |
+| **Conversation Module**  | Comments, mentions, chat                                 |
+| **Notification Module**  | Reminders, assignments, status changes                   |
+| **EDMS**                 | File attachments                                         |
+| **Form Template Engine** | Dynamic task forms per type                              |
+| **Extra Fields Engine**  | Dynamic fields per task type/context                     |
+| **Report Builder**       | KPI dashboards, task reports                             |
+| **RBAC & Org Module**    | Role-based visibility and assignment                     |
+
+---
+
+## 🖼️ UI Features and Views
+
+### ✅ Generic Task Board Page
+
+A reusable component to visualize tasks in various modes:
+
+| View Type          | Features                                                |
+| ------------------ | ------------------------------------------------------- |
+| **Scheduler View** | Monthly, weekly, daily calendar-style task board        |
+| **Table View**     | Sortable and filterable data table with task columns    |
+| **Kanban View**    | Drag-and-drop column-based layout by status or assignee |
+
+All views support:
+
+- Context and task-type filters
+- My tasks toggle
+- Saved view configurations
+
+---
+
+## 📋 UI Forms
+
+| Form                  | Description                                                         |
+| --------------------- | ------------------------------------------------------------------- |
+| **Task Form**         | Dynamic form loaded via form-template per `taskType`                |
+| **Checklist Editor**  | Add/edit checklist items                                            |
+| **Assignment Form**   | Select assignees with roles or teams                                |
+| **Time Log Form**     | Add/edit time logs                                                  |
+| **Task Type Manager** | Admin UI to define task types, statuses, transitions, form mappings |
+
+---
+
+## 📊 Reports & Dashboards
+
+| Report / Widget               | Description                          |
+| ----------------------------- | ------------------------------------ |
+| **Task Summary Report**       | By status, due date, project/type    |
+| **Time Spent per Task/User**  | Aggregated time logs                 |
+| **My Tasks Report**           | Assigned to user, filterable         |
+| **Overdue Tasks Report**      | Tasks past due                       |
+| **Task Completion Trend**     | Weekly/daily progress visualizations |
+| **Checklist Completion Rate** | % done per task/project              |
+
+---
+
+## 🔐 Permissions (RBAC)
+
+| Action              | Permission Key       |
+| ------------------- | -------------------- |
+| Create Task         | `task.create`        |
+| Edit Task           | `task.edit`          |
+| Delete Task         | `task.delete`        |
+| View All Tasks      | `task.view.all`      |
+| View Assigned Tasks | `task.view.assigned` |
+| Assign Task         | `task.assign`        |
+| Log Time            | `task.timelog.add`   |
+| Comment on Task     | `task.comment`       |
+
+---
+
+## 🌐 Routing & Page Guidelines
+
+- `/tasks` → All tasks (with filters/views)
+- `/tasks/:id` → Task detail view
+- `/projects/:id/tasks` → Project-specific view
+- `/meetings/:id/tasks` → Post-meeting action view
+
+---
+
+## 🧠 Future Enhancements
+
+- AI-generated task suggestions
+- Task recurrence & SLA
+- Workflow-triggered tasks
+- Cross-module assignment rules
+- Delegation and escalation logic
+
+---
+
+## ✅ Summary
+
+The `task-management` module serves as a **universal, task-type-driven engine** across ACoreX. It powers everything from personal to-dos to collaborative project or workflow execution. Through the flexible `TaskType` contract, it enables modular reuse, customization, and platform-wide integration.