@platform-modules/foreign-ministry 1.2.19 → 1.2.20

package/src/models/DiplomaticRequestsModel.ts

@@ -1,154 +1,154 @@
-import { Column, Entity, OneToOne, OneToMany, ManyToOne, JoinColumn } from "typeorm";
-import { BaseModel } from './BaseModel';
-
-// Import types only (not for runtime)
-import type { DiplomaticApprovals } from './DiplomaticApprovalsModel';
-import type { DiplomaticWorkFlow } from './DiplomaticWorkFlowModel';
-import type { DiplomaticAttachments } from './DiplomaticAttachmentsModel';
-import type { DiplomaticChats } from './DiplomaticChatsModel';
-import type { DiplomaticClubCardMembers } from './DiplomaticClubCardMembersModel';
-
-export enum DiplomaticRequestStatus {
-  DRAFT = "Draft",
-  SUBMITTED = "Submitted",
-  PENDING = "Pending",
-  IN_PROGRESS = "In Progress",
-  APPROVED = "Approved",
-  REJECTED = "Rejected",
-  COMPLETED = "Completed",
-  CANCELLED = "Cancelled"
-}
-
-@Entity({ name: 'diplomatic_requests' })
-export class DiplomaticRequests extends BaseModel {
-  @Column({ type: 'int' })
-  user_id: number;
-
-  @Column({ type: 'varchar', length: 100 })
-  employee_id: string;
-
-  @Column({ type: 'varchar', length: 255 })
-  employee_name: string;
-
-  @Column({ type: 'varchar', length: 100, nullable: true })
-  grade: string | null;
-
-  @Column({ type: 'int', nullable: true })
-  designation_id: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  department_id: number | null;
-
-  @Column({ type: 'varchar', length: 255 })
-  email_address: string;
-
-  @Column({ type: 'varchar', length: 20 })
-  contact_number: string;
-
-  @Column({ type: 'timestamp', default: () => 'CURRENT_TIMESTAMP' })
-  request_date: Date;
-
-  @Column({ type: 'enum', enum: DiplomaticRequestStatus, default: DiplomaticRequestStatus.PENDING })
-  request_status: DiplomaticRequestStatus;
-
-  @Column({ type: 'timestamp', nullable: true })
-  request_close_date: Date | null;
-
-  @Column({ type: 'date', nullable: true })
-  end_date: Date | null;
-
-  @Column({ type: 'text', nullable: true })
-  remarks: string | null;
-
-  @Column({ type: 'int', nullable: true })
-  current_approval_level: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  current_approver_id: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  service_id: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  sub_service_id: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  member_name: string | null;
-
-  @Column({ type: 'varchar', length: 100, nullable: true })
-  membership_type: string | null;
-
-  @Column({ type: 'int', nullable: true })
-  diplomatic_title_id: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  location: string | null;
-
-  @Column({ type: 'varchar', length: 100, nullable: true })
-  request_type: string | null;
-
-  @Column({ type: 'date', nullable: true })
-  expiry_date: Date | null;
-
-  @Column({ type: 'varchar', length: 500, nullable: true })
-  photo_url: string | null;
-
-  @Column({ type: 'varchar', length: 100, nullable: true })
-  membership_id: string | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  organization: string | null;
-
-  @Column({ type: 'decimal', precision: 10, scale: 2, nullable: true })
-  subscription_amount: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  section_id: number | null;
-
-  @Column({ type: 'int', nullable: true })
-  reporting_manager: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  workflow_execution_id: string | null;
-
-  @OneToMany('DiplomaticClubCardMembers', 'diplomaticRequest', { nullable: true })
-  diplomaticClubCardMembers?: DiplomaticClubCardMembers[];
-
-  @OneToMany('DiplomaticApprovals', 'diplomaticRequest')
-  approvals?: DiplomaticApprovals[];
-
-  @OneToMany('DiplomaticWorkFlow', 'diplomaticRequest')
-  workflows?: DiplomaticWorkFlow[];
-
-  @OneToMany('DiplomaticAttachments', 'diplomaticRequest')
-  attachments?: DiplomaticAttachments[];
-
-  @OneToMany('DiplomaticChats', 'diplomaticRequest')
-  chats?: DiplomaticChats[];
-
-  constructor(
-    user_id: number,
-    employee_id: string,
-    employee_name: string,
-    email_address: string,
-    contact_number: string,
-    service_id: number | null,
-    sub_service_id: number | null,
-    section_id: number | null,
-    reporting_manager: number | null
-  ) {
-    super();
-    this.user_id = user_id;
-    this.employee_id = employee_id;
-    this.employee_name = employee_name;
-    this.email_address = email_address;
-    this.contact_number = contact_number;
-    this.request_date = new Date();
-    this.request_status = DiplomaticRequestStatus.PENDING;
-    this.service_id = service_id;
-    this.sub_service_id = sub_service_id;
-    this.section_id = section_id;
-    this.reporting_manager = reporting_manager;
-  }
-}
-
+import { Column, Entity, OneToOne, OneToMany, ManyToOne, JoinColumn } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+// Import types only (not for runtime)
+import type { DiplomaticApprovals } from './DiplomaticApprovalsModel';
+import type { DiplomaticWorkFlow } from './DiplomaticWorkFlowModel';
+import type { DiplomaticAttachments } from './DiplomaticAttachmentsModel';
+import type { DiplomaticChats } from './DiplomaticChatsModel';
+import type { DiplomaticClubCardMembers } from './DiplomaticClubCardMembersModel';
+
+export enum DiplomaticRequestStatus {
+  DRAFT = "Draft",
+  SUBMITTED = "Submitted",
+  PENDING = "Pending",
+  IN_PROGRESS = "In Progress",
+  APPROVED = "Approved",
+  REJECTED = "Rejected",
+  COMPLETED = "Completed",
+  CANCELLED = "Cancelled"
+}
+
+@Entity({ name: 'diplomatic_requests' })
+export class DiplomaticRequests extends BaseModel {
+  @Column({ type: 'int' })
+  user_id: number;
+
+  @Column({ type: 'varchar', length: 100 })
+  employee_id: string;
+
+  @Column({ type: 'varchar', length: 255 })
+  employee_name: string;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  grade: string | null;
+
+  @Column({ type: 'int', nullable: true })
+  designation_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  department_id: number | null;
+
+  @Column({ type: 'varchar', length: 255 })
+  email_address: string;
+
+  @Column({ type: 'varchar', length: 20 })
+  contact_number: string;
+
+  @Column({ type: 'timestamp', default: () => 'CURRENT_TIMESTAMP' })
+  request_date: Date;
+
+  @Column({ type: 'enum', enum: DiplomaticRequestStatus, default: DiplomaticRequestStatus.PENDING })
+  request_status: DiplomaticRequestStatus;
+
+  @Column({ type: 'timestamp', nullable: true })
+  request_close_date: Date | null;
+
+  @Column({ type: 'date', nullable: true })
+  end_date: Date | null;
+
+  @Column({ type: 'text', nullable: true })
+  remarks: string | null;
+
+  @Column({ type: 'int', nullable: true })
+  current_approval_level: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  current_approver_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  service_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  sub_service_id: number | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  member_name: string | null;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  membership_type: string | null;
+
+  @Column({ type: 'int', nullable: true })
+  diplomatic_title_id: number | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  location: string | null;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  request_type: string | null;
+
+  @Column({ type: 'date', nullable: true })
+  expiry_date: Date | null;
+
+  @Column({ type: 'varchar', length: 500, nullable: true })
+  photo_url: string | null;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  membership_id: string | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  organization: string | null;
+
+  @Column({ type: 'decimal', precision: 10, scale: 2, nullable: true })
+  subscription_amount: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  section_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  reporting_manager: number | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  workflow_execution_id: string | null;
+
+  @OneToMany('DiplomaticClubCardMembers', 'diplomaticRequest', { nullable: true })
+  diplomaticClubCardMembers?: DiplomaticClubCardMembers[];
+
+  @OneToMany('DiplomaticApprovals', 'diplomaticRequest')
+  approvals?: DiplomaticApprovals[];
+
+  @OneToMany('DiplomaticWorkFlow', 'diplomaticRequest')
+  workflows?: DiplomaticWorkFlow[];
+
+  @OneToMany('DiplomaticAttachments', 'diplomaticRequest')
+  attachments?: DiplomaticAttachments[];
+
+  @OneToMany('DiplomaticChats', 'diplomaticRequest')
+  chats?: DiplomaticChats[];
+
+  constructor(
+    user_id: number,
+    employee_id: string,
+    employee_name: string,
+    email_address: string,
+    contact_number: string,
+    service_id: number | null,
+    sub_service_id: number | null,
+    section_id: number | null,
+    reporting_manager: number | null
+  ) {
+    super();
+    this.user_id = user_id;
+    this.employee_id = employee_id;
+    this.employee_name = employee_name;
+    this.email_address = email_address;
+    this.contact_number = contact_number;
+    this.request_date = new Date();
+    this.request_status = DiplomaticRequestStatus.PENDING;
+    this.service_id = service_id;
+    this.sub_service_id = sub_service_id;
+    this.section_id = section_id;
+    this.reporting_manager = reporting_manager;
+  }
+}
+

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;
+  }
+}