@platform-modules/foreign-ministry 1.2.21 → 1.2.23

package/src/models/EmployeeCardApprovalsModel.ts

@@ -0,0 +1,87 @@
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * Approval Status Enum
+ */
+export enum EmployeeCardApprovalStatus {
+  PENDING = "Pending",
+  APPROVED = "Approved",
+  REJECTED = "Rejected",
+  IN_PROGRESS = "In Progress",
+  CANCELLED = "Cancelled"
+}
+
+/**
+ * Employee Card Approval Details Table
+ * Stores approval information for each level of the workflow
+ * Supports workflow: Employee → Department Admin Office → US (if Special) → Security
+ */
+@Entity({ name: 'employee_card_approvals' })
+export class EmployeeCardApprovalDetails extends BaseModel {
+  
+  @Column({ type: 'int', nullable: false })
+  employee_card_request_id: number; // Foreign key to employee_card_requests
+
+  @Column({ type: 'int', nullable: false })
+  level: number; // Approval level (1: Dept Admin, 2: US for Special/Security for Normal, 3: Security for Special)
+
+  @Column({ type: 'int', nullable: true })
+  approver_user_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  approver_role_id: number | null;
+
+  @Column({ type: 'integer', nullable: true })
+  delegate_user_id: number | null; // If someone is delegating approval
+
+  @Column({ type: 'integer', nullable: true })
+  approved_by: number | null; // Actual user who approved (in case of delegation)
+
+  @Column({ type: 'int', nullable: true })
+  department_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  section_id: number | null;
+
+  @Column({ type: 'text', nullable: true })
+  comment: string | null; // Approval/rejection comment
+
+  @Column({ type: 'enum', enum: EmployeeCardApprovalStatus, default: EmployeeCardApprovalStatus.PENDING, nullable: false })
+  approval_status: EmployeeCardApprovalStatus;
+
+  @Column({ type: 'boolean', default: true, nullable: false })
+  is_allowed: boolean; // Whether this approval step is allowed
+
+  @Column({ type: 'varchar', length: 50, nullable: true })
+  access_type: string | null; // Normal or Special - to track which path
+
+  constructor(
+    employee_card_request_id: number,
+    level: number,
+    approver_user_id: number | null,
+    approver_role_id: number | null,
+    delegate_user_id: number | null,
+    approved_by: number | null,
+    department_id: number | null,
+    section_id: number | null,
+    comment: string | null,
+    approval_status: EmployeeCardApprovalStatus,
+    is_allowed: boolean,
+    access_type: string | null
+  ) {
+    super();
+    this.employee_card_request_id = employee_card_request_id;
+    this.level = level;
+    this.approver_user_id = approver_user_id;
+    this.approver_role_id = approver_role_id;
+    this.delegate_user_id = delegate_user_id;
+    this.approved_by = approved_by;
+    this.department_id = department_id;
+    this.section_id = section_id;
+    this.comment = comment;
+    this.approval_status = approval_status;
+    this.is_allowed = is_allowed;
+    this.access_type = access_type;
+  }
+}

package/src/models/EmployeeCardAttachmentsModel.ts

@@ -0,0 +1,56 @@
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * Employee Card Attachments Table
+ * Stores file attachments related to employee card requests
+ * Can be attached during initial request or via chat
+ */
+@Entity({ name: 'employee_card_attachments' })
+export class EmployeeCardAttachments extends BaseModel {
+  
+  @Column({ type: 'int', nullable: false })
+  employee_card_request_id: number; // Foreign key to employee_card_requests
+
+  @Column({ type: 'int', nullable: false })
+  attached_by_user_id: number; // User who uploaded the attachment
+
+  @Column({ type: 'varchar', length: 500, nullable: false })
+  file_url: string; // URL/path to the file
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  file_name: string | null; // Original file name
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  file_type: string | null; // MIME type (e.g., image/jpeg, application/pdf)
+
+  @Column({ type: 'bigint', nullable: true })
+  file_size: number | null; // File size in bytes
+
+  @Column({ type: 'integer', nullable: true })
+  chat_id: number | null; // Reference to chat message if attached via chat
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  description: string | null; // Optional description of the attachment
+
+  constructor(
+    employee_card_request_id: number,
+    attached_by_user_id: number,
+    file_url: string,
+    file_name: string | null,
+    file_type: string | null,
+    file_size: number | null,
+    chat_id: number | null,
+    description: string | null
+  ) {
+    super();
+    this.employee_card_request_id = employee_card_request_id;
+    this.attached_by_user_id = attached_by_user_id;
+    this.file_url = file_url;
+    this.file_name = file_name;
+    this.file_type = file_type;
+    this.file_size = file_size;
+    this.chat_id = chat_id;
+    this.description = description;
+  }
+}

package/src/models/EmployeeCardChatsModel.ts

@@ -0,0 +1,66 @@
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * Employee Card Chat/Communication Table
+ * Stores messages/comments between the requester and approvers
+ * Allows discussion regarding the employee card request
+ */
+@Entity({ name: 'employee_card_chats' })
+export class EmployeeCardChat extends BaseModel {
+  
+  @Column({ type: 'int', nullable: false })
+  employee_card_request_id: number; // Foreign key to employee_card_requests
+
+  @Column({ type: 'text', nullable: false })
+  content: string; // Chat message content
+
+  @Column({ type: 'int', nullable: false })
+  sender_user_id: number; // User who sent the message
+
+  @Column({ type: 'integer', nullable: true })
+  service_id: number | null; // Service context
+
+  @Column({ type: 'integer', nullable: true })
+  sub_service_id: number | null; // Sub-service context
+
+  @Column({ type: 'integer', nullable: true })
+  role_id: number | null; // Role of the sender
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  status: string | null; // Status of the request at the time of message
+
+  @Column({ type: 'integer', nullable: true })
+  department_id: number | null; // Department of the sender
+
+  @Column({ type: 'integer', nullable: true })
+  section_id: number | null; // Section of the sender
+
+  @Column({ type: 'boolean', default: false, nullable: true })
+  is_internal: boolean | null; // Flag to mark internal notes (visible only to approvers)
+
+  constructor(
+    employee_card_request_id: number,
+    content: string,
+    sender_user_id: number,
+    service_id: number | null,
+    sub_service_id: number | null,
+    role_id: number | null,
+    status: string | null,
+    department_id: number | null,
+    section_id: number | null,
+    is_internal: boolean | null
+  ) {
+    super();
+    this.employee_card_request_id = employee_card_request_id;
+    this.content = content;
+    this.sender_user_id = sender_user_id;
+    this.service_id = service_id;
+    this.sub_service_id = sub_service_id;
+    this.role_id = role_id;
+    this.status = status;
+    this.department_id = department_id;
+    this.section_id = section_id;
+    this.is_internal = is_internal;
+  }
+}

package/src/models/EmployeeCardRequestsModel.ts

@@ -0,0 +1,115 @@
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * Employee Card Request Status Enum
+ */
+export enum EmployeeCardRequestStatus {
+  PENDING = "Pending",
+  APPROVED = "Approved",
+  REJECTED = "Rejected",
+  CANCELLED = "Cancelled"
+}
+
+/**
+ * Access Type Enum - Normal or Special
+ */
+export enum AccessType {
+  NORMAL = "Normal",
+  SPECIAL = "Special"
+}
+
+/**
+ * Main Employee Card Request Table (FM020)
+ * This table stores the primary employee card request data
+ */
+@Entity({ name: 'employee_card_requests' })
+export class EmployeeCardRequests extends BaseModel {
+  
+  // User and Department Information
+  @Column({ type: 'int', nullable: false })
+  user_id: number;
+
+  @Column({ type: 'int', nullable: true })
+  req_user_department_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  req_user_section_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  service_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  sub_service_id: number | null;
+
+  // Request Status and Workflow
+  @Column({ type: 'enum', enum: EmployeeCardRequestStatus, default: EmployeeCardRequestStatus.PENDING, nullable: false })
+  status: EmployeeCardRequestStatus;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  workflow_execution_id: string | null;
+  
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  number: string | null; 
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  name: string | null; 
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  job_title: string | null;
+
+  @Column({ type: 'text', nullable: true })
+  reason_for_request: string | null;
+
+  @Column({ type: 'date', nullable: true })
+  date_of_joining: Date | null; 
+
+  @Column({ type: 'date', nullable: true })
+  date_of_issue: Date | null;
+  @Column({ type: 'enum', enum: AccessType, default: AccessType.NORMAL, nullable: false })
+  access_type: AccessType; // Normal / Special (Radio Button)
+
+  // Photo from Profile (URL or reference)
+  @Column({ type: 'varchar', length: 500, nullable: true })
+  photo_url: string | null; // Photo pulled from profile data
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  photo_file_name: string | null;
+
+  constructor(
+    user_id: number,
+    req_user_department_id: number | null,
+    req_user_section_id: number | null,
+    service_id: number | null,
+    sub_service_id: number | null,
+    status: EmployeeCardRequestStatus,
+    workflow_execution_id: string | null,
+    number: string | null,
+    name: string | null,
+    job_title: string | null,
+    reason_for_request: string | null,
+    date_of_joining: Date | null,
+    date_of_issue: Date | null,
+    access_type: AccessType,
+    photo_url: string | null,
+    photo_file_name: string | null
+  ) {
+    super();
+    this.user_id = user_id;
+    this.req_user_department_id = req_user_department_id;
+    this.req_user_section_id = req_user_section_id;
+    this.service_id = service_id;
+    this.sub_service_id = sub_service_id;
+    this.status = status;
+    this.workflow_execution_id = workflow_execution_id;
+    this.number = number;
+    this.name = name;
+    this.job_title = job_title;
+    this.reason_for_request = reason_for_request;
+    this.date_of_joining = date_of_joining;
+    this.date_of_issue = date_of_issue;
+    this.access_type = access_type;
+    this.photo_url = photo_url;
+    this.photo_file_name = photo_file_name;
+  }
+}

package/src/models/EmployeeCardWorkFlowModel.ts

@@ -0,0 +1,90 @@
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * Workflow Status Enum
+ */
+export enum EmployeeCardWorkFlowStatus {
+  COMPLETED = "Completed",
+  NOT_YET_STARTED = "Not Yet Started",
+  PENDING = "Pending",
+  IN_PROGRESS = "In Progress"
+}
+
+/**
+ * Employee Card Workflow Table
+ * Tracks the progress of the request through different workflow stages
+ * Provides a timeline/audit trail of the approval process
+ * 
+ * Workflow paths:
+ * - Normal: Employee → Department Admin Office → Security
+ * - Special: Employee → Department Admin Office → US → Security
+ */
+@Entity({ name: 'employee_card_work_flows' })
+export class EmployeeCardWorkFlow extends BaseModel {
+  
+  @Column({ type: 'int', nullable: false })
+  employee_card_request_id: number; // Foreign key to employee_card_requests
+
+  @Column({ type: 'int', nullable: false, default: 0 })
+  employee_card_approval_details_id: number; // Foreign key to employee_card_approvals
+
+  @Column({ type: 'varchar', length: 255, nullable: false })
+  content: string; // Description of the workflow step (e.g., "Pending Department Admin Office Approval")
+
+  @Column({ type: 'enum', enum: EmployeeCardWorkFlowStatus, default: EmployeeCardWorkFlowStatus.NOT_YET_STARTED, nullable: false })
+  status: EmployeeCardWorkFlowStatus; // Current status of this workflow step
+
+  @Column({ type: 'integer', nullable: true })
+  user_id: number | null; // User responsible for this step
+
+  @Column({ type: 'integer', nullable: true })
+  role_id: number | null; // Role responsible for this step
+
+  @Column({ type: 'integer', nullable: true })
+  department_id: number | null; // Department involved in this step
+
+  @Column({ type: 'integer', nullable: true })
+  section_id: number | null; // Section involved in this step
+
+  @Column({ type: 'integer', nullable: false, default: 1 })
+  level: number; // Workflow level (1: Dept Admin, 2: US/Security, 3: Security for Special)
+
+  @Column({ type: 'varchar', length: 50, nullable: true })
+  access_type: string | null; // Normal or Special - to track workflow path
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  action_taken: string | null; // Action taken (e.g., "Approved", "Rejected", "Forwarded")
+
+  @Column({ type: 'timestamptz', nullable: true })
+  action_date: Date | null; // When the action was taken
+
+  constructor(
+    employee_card_request_id: number,
+    employee_card_approval_details_id: number,
+    content: string,
+    status: EmployeeCardWorkFlowStatus,
+    user_id: number | null,
+    role_id: number | null,
+    department_id: number | null,
+    section_id: number | null,
+    level: number,
+    access_type: string | null,
+    action_taken: string | null,
+    action_date: Date | null
+  ) {
+    super();
+    this.employee_card_request_id = employee_card_request_id;
+    this.employee_card_approval_details_id = employee_card_approval_details_id;
+    this.content = content;
+    this.status = status;
+    this.user_id = user_id;
+    this.role_id = role_id;
+    this.department_id = department_id;
+    this.section_id = section_id;
+    this.level = level;
+    this.access_type = access_type;
+    this.action_taken = action_taken;
+    this.action_date = action_date;
+  }
+}

package/src/models/MissionTravelApprovalModel.ts

@@ -48,6 +48,47 @@ export class MissionTravelApprovalDetails extends BaseModel {
 
   @Column({ type: 'boolean', default: true, nullable: false })
   is_allowed: boolean;
+
+  @Column({ type: 'boolean', default: false, nullable: false })
+  is_reassign: boolean;
+
+  @Column({ type: 'boolean', default: true, nullable: false })
+  is_approval: boolean;
+
+  constructor(
+    request_id: number,
+    service_id: number | null,
+    sub_service_id: number | null,
+    level: number,
+    approver_role_id: number,
+    department_id: number | null,
+    section_id: number | null,
+    approver_user_id: number | null,
+    delegate_user_id: number | null,
+    approved_by: number | null,
+    comment: string,
+    approval_status: MissionTravelApprovalStatus,
+    is_allowed: boolean,
+    is_reassign: boolean,
+    is_approval: boolean
+  ) {
+    super();
+    this.request_id = request_id;
+    this.service_id = service_id;
+    this.sub_service_id = sub_service_id;
+    this.level = level;
+    this.approver_role_id = approver_role_id;
+    this.department_id = department_id;
+    this.section_id = section_id;
+    this.approver_user_id = approver_user_id;
+    this.delegate_user_id = delegate_user_id;
+    this.approved_by = approved_by;
+    this.comment = comment;
+    this.approval_status = approval_status;
+    this.is_allowed = is_allowed;
+    this.is_reassign = is_reassign;
+    this.is_approval = is_approval;
+  }
 }
 
 

package/src/models/MissionTravelAttachmentModel.ts

@@ -1,32 +1,56 @@
-import { Column, Entity } from "typeorm";
-import { BaseModel } from './BaseModel';
-
-@Entity({ name: 'mission_travel_attachments' })
-export class MissionTravelRequestAttachment extends BaseModel {
-  @Column({ type: 'integer', nullable: false })
-  request_id: number;
-
-  @Column({ type: 'integer', nullable: true })
-  service_id: number | null;
-
-  @Column({ type: 'integer', nullable: true })
-  sub_service_id: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: false })
-  file_name: string;
-
-  @Column({ type: 'varchar', length: 500, nullable: true })
-  file_path: string | null;
-
-  @Column({ type: 'varchar', length: 50, nullable: true })
-  file_type: string | null;
-
-  @Column({ type: 'integer', nullable: true })
-  file_size: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  uploaded_by: string | null;
-}
-
-
-
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+@Entity({ name: 'mission_travel_attachments' })
+export class MissionTravelRequestAttachment extends BaseModel {
+  @Column({ type: 'integer', nullable: false })
+  request_id: number;
+
+  @Column({ type: 'integer', nullable: true })
+  service_id: number | null;
+
+  @Column({ type: 'integer', nullable: true })
+  sub_service_id: number | null;
+
+  @Column({ type: 'integer', nullable: false })
+  uploaded_by: number;
+
+  @Column({ type: 'varchar', length: 500, nullable: false })
+  file_url: string;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  file_name: string;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  file_type: string;
+
+  @Column({ type: 'bigint', nullable: true })
+  file_size: number | null;
+
+  @Column({ type: 'text', nullable: true })
+  description: string;
+
+  constructor(
+      request_id: number,
+      uploaded_by: number,
+      file_url: string,
+      file_name?: string,
+      file_type?: string,
+      file_size?: number,
+      description?: string,
+      service_id?: number | null,
+      sub_service_id?: number | null
+  ) {
+      super();
+      this.request_id = request_id;
+      this.uploaded_by = uploaded_by;
+      this.file_url = file_url;
+      this.file_name = file_name || '';
+      this.file_type = file_type || '';
+      this.file_size = file_size || null;
+      this.description = description || '';
+      this.service_id = service_id ?? null;
+      this.sub_service_id = sub_service_id ?? null;
+  }
+}
+

package/src/models/MissionTravelChatModel.ts

@@ -1,26 +1,52 @@
-import { Column, Entity } from "typeorm";
-import { BaseModel } from './BaseModel';
-
-@Entity({ name: 'mission_travel_chats' })
-export class MissionTravelRequestChat extends BaseModel {
-  @Column({ type: 'integer', nullable: false })
-  request_id: number;
-
-  @Column({ type: 'integer', nullable: true })
-  service_id: number | null;
-
-  @Column({ type: 'integer', nullable: true })
-  sub_service_id: number | null;
-
-  @Column({ type: 'integer', nullable: false })
-  user_id: number;
-
-  @Column({ type: 'text', nullable: false })
-  message: string;
-
-  @Column({ type: 'timestamp', nullable: true, default: () => 'CURRENT_TIMESTAMP' })
-  message_date: Date | null;
-}
-
-
-
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+@Entity({ name: 'mission_travel_chats' })
+export class MissionTravelRequestChat extends BaseModel {
+
+  @Column({ type: 'integer', nullable: false })
+  request_id: number;
+
+  @Column({ type: 'integer', nullable: true })
+  service_id: number | null;
+
+  @Column({ type: 'integer', nullable: true })
+  sub_service_id: number | null;
+
+  @Column({ type: 'integer', nullable: false })
+  user_id: number;
+
+  @Column({ type: 'integer', nullable: true })
+  role_id: number | null;
+
+  @Column({ type: 'text', nullable: false })
+  message: string;
+
+  @Column({ type: 'text', nullable: true })
+  status: string | null;
+
+  @Column({ type: 'boolean', default: false })
+  is_internal: boolean;
+
+  constructor(
+      request_id: number,
+      user_id: number,
+      message: string,
+      is_internal?: boolean,
+      service_id?: number | null,
+      sub_service_id?: number | null,
+      role_id?: number | null,
+      status?: string | null
+  ) {
+      super();
+      this.request_id = request_id;
+      this.service_id = service_id || null;
+      this.sub_service_id = sub_service_id || null;
+      this.user_id = user_id;
+      this.role_id = role_id || null;
+      this.message = message;
+      this.status = status || null;
+      this.is_internal = is_internal || false;
+  }
+}
+