@platform-modules/foreign-ministry 1.3.277 → 1.3.290

package/src/models/EmployeeEvaluationRequestModel.ts

@@ -1,77 +1,90 @@
-import { Column, Entity } from 'typeorm';
-import { BaseModel } from './BaseModel';
-
-export enum EmployeeEvaluationRequestStatus {
-  PENDING = 'Pending',
-  IN_PROGRESS = 'In Progress',
-  APPROVED = 'Approved',
-  REJECTED = 'Rejected',
-}
-
-/** Routing bucket derived from undersecretary department (US Political / Administrative / Finance). */
-export enum EmployeeEvaluationRoutingBucket {
-  US_POLITICAL = 'US_POLITICAL',
-  US_ADMINISTRATIVE = 'US_ADMINISTRATIVE',
-  FINANCE = 'FINANCE',
-  OTHER = 'OTHER',
-}
-
-@Entity({ name: 'employee_evaluation_requests' })
-export class EmployeeEvaluationRequests extends BaseModel {
-  @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;
-
-  /** User who raised the request (e.g. HOD). */
-  @Column({ type: 'int', nullable: false })
-  user_id: number;
-
-  @Column({ type: 'int', nullable: false })
-  evaluation_year: number;
-
-  @Column({ type: 'varchar', length: 120, nullable: false })
-  evaluation_period: string;
-
-  @Column({ type: 'int', nullable: false })
-  evaluation_month: number;
-
-  /** Scope: employees must belong to this department. */
-  @Column({ type: 'int', nullable: false })
-  department_id: number;
-
-  /** Scope: employees must belong to this section. */
-  @Column({ type: 'int', nullable: false })
-  section_id: number;
-
-  @Column({ type: 'bigint', nullable: true })
-  undersecretary_department_id: number | null;
-
-  @Column({
-    type: 'enum',
-    enum: EmployeeEvaluationRoutingBucket,
-    nullable: true,
-  })
-  evaluation_routing_bucket: EmployeeEvaluationRoutingBucket | null;
-
-  @Column({
-    type: 'enum',
-    enum: EmployeeEvaluationRequestStatus,
-    default: EmployeeEvaluationRequestStatus.PENDING,
-    nullable: false,
-  })
-  status: EmployeeEvaluationRequestStatus;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  workflow_execution_id: string | null;
-
-  @Column({ type: 'text', nullable: true })
-  comments: string | null;
-}
+import { Column, Entity } from 'typeorm';
+import { BaseModel } from './BaseModel';
+
+export enum EmployeeEvaluationRequestStatus {
+  PENDING = 'Pending',
+  IN_PROGRESS = 'In Progress',
+  APPROVED = 'Approved',
+  REJECTED = 'Rejected',
+}
+
+/** Routing bucket derived from undersecretary department (US Political / Administrative / Finance). */
+export enum EmployeeEvaluationRoutingBucket {
+  US_POLITICAL = 'US_POLITICAL',
+  US_ADMINISTRATIVE = 'US_ADMINISTRATIVE',
+  FINANCE = 'FINANCE',
+  OTHER = 'OTHER',
+}
+
+@Entity({ name: 'employee_evaluation_requests' })
+export class EmployeeEvaluationRequests extends BaseModel {
+  @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;
+
+  /** User who raised the request (e.g. HOD). */
+  @Column({ type: 'int', nullable: false })
+  user_id: number;
+
+  @Column({ type: 'varchar', length: 10, nullable: false })
+  evaluation_year: string;
+
+  @Column({ type: 'varchar', length: 120, nullable: false })
+  evaluation_period: string;
+
+  @Column({ type: 'int', nullable: false })
+  evaluation_month: number;
+
+  /** Scope: employees must belong to this department. */
+  @Column({ type: 'int', nullable: false })
+  department_id: number;
+
+  /** Scope: employees must belong to this section. */
+  @Column({ type: 'int', nullable: false })
+  section_id: number;
+
+  @Column({ type: 'bigint', nullable: true })
+  undersecretary_department_id: number | null;
+
+  @Column({
+    type: 'enum',
+    enum: EmployeeEvaluationRoutingBucket,
+    nullable: true,
+  })
+  evaluation_routing_bucket: EmployeeEvaluationRoutingBucket | null;
+
+  @Column({
+    type: 'enum',
+    enum: EmployeeEvaluationRequestStatus,
+    default: EmployeeEvaluationRequestStatus.PENDING,
+    nullable: false,
+  })
+  status: EmployeeEvaluationRequestStatus;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  workflow_execution_id: string | null;
+
+  @Column({ type: 'text', nullable: true })
+  comments: string | null;
+
+  @Column({ type: 'float', nullable: true })
+  total_score: number | null;
+
+  @Column({ type: 'float', nullable: true })
+  average_score: number | null;
+
+  @Column({ type: 'int', default: 0, nullable: false })
+  employee_count: number;
+
+  /** Form structure snapshot at request creation (sections/questions). */
+  @Column({ type: 'jsonb', nullable: true })
+  dynamic_evaluation_form: Record<string, unknown> | null;
+}

package/src/models/EvaluationEligibilitySettingModel.ts

@@ -1,42 +1,51 @@
-import { Column, Entity, JoinColumn, ManyToOne, OneToMany } from 'typeorm';
-import { BaseModel } from './BaseModel';
-
-/**
- * Department/section/month evaluation window: which employees are excluded or re-included
- * for that cycle (e.g. excluded in January, eligible again in May via a different month row).
- */
-@Entity({ name: 'evaluation_eligibility_settings' })
-export class EvaluationEligibilitySetting extends BaseModel {
-  @Column({ type: 'int' })
-  department_id: number;
-
-  @Column({ type: 'int' })
-  section_id: number;
-
-  /** Calendar month 1–12 */
-  @Column({ type: 'int' })
-  month: number;
-
-  @Column({ type: 'date' })
-  evaluation_end_date: Date;
-
-  @Column({ type: 'boolean', default: true })
-  is_active: boolean;
-
-  @OneToMany(() => EvaluationEligibilitySettingEmployee, (e) => e.evaluation_eligibility_setting)
-  employees?: EvaluationEligibilitySettingEmployee[];
-}
-
-@Entity({ name: 'evaluation_eligibility_setting_employees' })
-export class EvaluationEligibilitySettingEmployee extends BaseModel {
-  @ManyToOne(() => EvaluationEligibilitySetting, (s) => s.employees, { onDelete: 'CASCADE' })
-  @JoinColumn({ name: 'setting_id' })
-  evaluation_eligibility_setting: EvaluationEligibilitySetting;
-
-  @Column({ type: 'int' })
-  employee_id: number;
-
-  /** When true, employee is excluded from evaluation for this setting’s month/department/section. */
-  @Column({ type: 'boolean', default: true })
-  is_excluded_from_evaluation: boolean;
-}
+import { Column, Entity, JoinColumn, ManyToOne, OneToMany } from 'typeorm';
+import { BaseModel } from './BaseModel';
+
+/**
+ * Department/section/month evaluation window: which employees are excluded or re-included
+ * for that cycle (e.g. excluded in January, eligible again in May via a different month row).
+ */
+@Entity({ name: 'evaluation_eligibility_settings' })
+export class EvaluationEligibilitySetting extends BaseModel {
+  @Column({ type: 'int' })
+  department_id: number;
+
+  @Column({ type: 'int' })
+  section_id: number;
+
+  /** Evaluation window start month (1–12). */
+  @Column({ type: 'int' })
+  from_month: number;
+
+  /** Evaluation window end month (1–12), inclusive. */
+  @Column({ type: 'int' })
+  to_month: number;
+
+  /** Last day of the evaluation month (1–31) when submissions close. */
+  @Column({ type: 'int' })
+  evaluation_end_date: number;
+
+  @Column({ type: 'boolean', default: true })
+  is_active: boolean;
+
+  /** Maximum employees allowed in one evaluation request for this dept/section window. */
+  @Column({ type: 'int', default: 50 })
+  max_employees_per_request: number;
+
+  @OneToMany(() => EvaluationEligibilitySettingEmployee, (e) => e.evaluation_eligibility_setting)
+  employees?: EvaluationEligibilitySettingEmployee[];
+}
+
+@Entity({ name: 'evaluation_eligibility_setting_employees' })
+export class EvaluationEligibilitySettingEmployee extends BaseModel {
+  @ManyToOne(() => EvaluationEligibilitySetting, (s) => s.employees, { onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'setting_id' })
+  evaluation_eligibility_setting: EvaluationEligibilitySetting;
+
+  @Column({ type: 'int' })
+  employee_id: number;
+
+  /** When true, employee is excluded from evaluation for this setting’s month/department/section. */
+  @Column({ type: 'boolean', default: true })
+  is_excluded_from_evaluation: boolean;
+}

package/src/models/EvaluationFormModel.ts

@@ -0,0 +1,40 @@
+import { Column, Entity, Index, OneToMany } from 'typeorm';
+import { BaseModel } from './BaseModel';
+import { EvaluationFormSection } from './EvaluationFormSectionModel';
+
+export enum EvaluationFormType {
+  EMPLOYEE_EVALUATION = 'employee_evaluation',
+  DEPARTMENT = 'department',
+}
+
+@Entity({ name: 'evaluation_forms' })
+@Index('uq_evaluation_forms_form_name', ['form_name'], { unique: true, where: '"is_deleted" = false' })
+@Index('uq_evaluation_forms_form_code', ['form_code'], { unique: true, where: '"is_deleted" = false' })
+export class EvaluationForm extends BaseModel {
+  @Column({ type: 'varchar', length: 255, nullable: false })
+  form_name: string;
+
+  @Column({ type: 'varchar', length: 64, nullable: false })
+  form_code: string;
+
+  @Column({ type: 'varchar', length: 32, nullable: false })
+  form_type: EvaluationFormType;
+
+  @Column({ type: 'int', nullable: true })
+  department_id: number | null;
+
+  @Column({ type: 'int', nullable: true })
+  section_id: number | null;
+
+  @Column({ type: 'int', default: 0 })
+  min_score: number;
+
+  @Column({ type: 'int', default: 10 })
+  max_score: number;
+
+  @Column({ type: 'boolean', default: true })
+  is_active: boolean;
+
+  @OneToMany(() => EvaluationFormSection, (s) => s.form)
+  sections?: EvaluationFormSection[];
+}

package/src/models/EvaluationFormQuestionModel.ts

@@ -0,0 +1,52 @@
+import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+import { BaseModel } from './BaseModel';
+import { EvaluationFormSection } from './EvaluationFormSectionModel';
+
+export enum EvaluationFormQuestionType {
+  RATING = 'rating',
+  TEXT = 'text',
+  TEXTAREA = 'textarea',
+  DROPDOWN = 'dropdown',
+  CHECKBOX = 'checkbox',
+}
+
+@Entity({ name: 'evaluation_form_questions' })
+@Index('uq_evaluation_form_questions_section_display_order', ['form_section_id', 'display_order'], {
+  unique: true,
+  where: '"is_deleted" = false',
+})
+export class EvaluationFormQuestion extends BaseModel {
+  @Column({ type: 'int', nullable: false })
+  form_section_id: number;
+
+  @ManyToOne(() => EvaluationFormSection, (s) => s.questions, { onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'form_section_id' })
+  section: EvaluationFormSection;
+
+  @Column({ type: 'text', nullable: false })
+  question_text: string;
+
+  @Column({ type: 'varchar', length: 32, nullable: false, default: EvaluationFormQuestionType.RATING })
+  question_type: EvaluationFormQuestionType;
+
+  @Column({ type: 'int', default: 0 })
+  min_score: number;
+
+  @Column({ type: 'int', default: 10 })
+  max_score: number;
+
+  @Column({ type: 'boolean', default: false })
+  is_required: boolean;
+
+  @Column({ type: 'int', default: 0 })
+  display_order: number;
+
+  @Column({ type: 'text', nullable: true })
+  help_text: string | null;
+
+  @Column({ type: 'jsonb', nullable: true })
+  options_json: string[] | null;
+
+  @Column({ type: 'boolean', default: true })
+  is_active: boolean;
+}

package/src/models/EvaluationFormSectionModel.ts

@@ -0,0 +1,33 @@
+import { Column, Entity, Index, JoinColumn, ManyToOne, OneToMany } from 'typeorm';
+import { BaseModel } from './BaseModel';
+import { EvaluationForm } from './EvaluationFormModel';
+import type { EvaluationFormQuestion } from './EvaluationFormQuestionModel';
+
+@Entity({ name: 'evaluation_form_sections' })
+@Index('uq_evaluation_form_sections_form_display_order', ['form_id', 'display_order'], {
+  unique: true,
+  where: '"is_deleted" = false',
+})
+export class EvaluationFormSection extends BaseModel {
+  @Column({ type: 'int', nullable: false })
+  form_id: number;
+
+  @ManyToOne(() => EvaluationForm, (f) => f.sections, { onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'form_id' })
+  form: EvaluationForm;
+
+  @Column({ type: 'varchar', length: 500, nullable: false })
+  section_title: string;
+
+  @Column({ type: 'text', nullable: true })
+  section_description: string | null;
+
+  @Column({ type: 'int', default: 0 })
+  display_order: number;
+
+  @Column({ type: 'boolean', default: true })
+  is_active: boolean;
+
+  @OneToMany('EvaluationFormQuestion', 'section')
+  questions?: EvaluationFormQuestion[];
+}

package/src/models/FinancialWorkFlowModel.ts

@@ -33,15 +33,15 @@ export class FinancialWorkFlow extends BaseModel {
   @Column({ type: 'int', nullable: true })
   approved_by_role_id: number;
 
-  @Column({ type: 'int', nullable: true })
-  step_order: number;
-
-  @Column({ type: 'varchar', length: 50, nullable: true })
-  action: string | null;
-
-  @ManyToOne(() => FinancialRequests, fr => fr.workflows)
-  @JoinColumn({ name: 'financial_request_id' })
-  financialRequest?: FinancialRequests;
+  @Column({ type: 'int', nullable: true })
+  step_order: number;
+
+  @Column({ type: 'varchar', length: 50, nullable: true })
+  action: string | null;
+
+  @ManyToOne(() => FinancialRequests, fr => fr.workflows)
+  @JoinColumn({ name: 'financial_request_id' })
+  financialRequest?: FinancialRequests;
 
   constructor(
     financial_request_id: number,
@@ -55,10 +55,10 @@ export class FinancialWorkFlow extends BaseModel {
     this.status = status;
     this.approved_by_user_id = approved_by_user_id;
     this.content = content;
-    this.financial_approval_id = 0;
-    this.activity_date = new Date();
-    this.step_order = step_order;
-    this.action = null;
-  }
-}
+    this.financial_approval_id = 0;
+    this.activity_date = new Date();
+    this.step_order = step_order;
+    this.action = null;
+  }
+}
 

package/src/models/GatePassVisitorsModel.ts

@@ -85,10 +85,10 @@ export class GatePassVisitors extends BaseModel {
   @Column({ type: 'varchar', length: 255, nullable: true })
   visiting_person_in_department: string | null; // زائر في القسم (Visiting Person in Department)
 
-  @Column({ type: 'int', nullable: true, unique: true })
-  serial_number: number | null;
-
-  // QR Code for Gate Pass
+  @Column({ type: 'int', nullable: true, unique: true })
+  serial_number: number | null;
+
+  // QR Code for Gate Pass
   @Column({ type: 'text', nullable: true })
   qr_code_url: string | null; // QR code URL for this visitor (data URL can be 6000+ characters)
 
@@ -134,9 +134,9 @@ export class GatePassVisitors extends BaseModel {
     this.visitor_email_address = visitor_email_address;
     this.visitor_mobile_number = visitor_mobile_number;
     this.visitor_photo_url = visitor_photo_url;
-    this.visitor_photo_file_name = visitor_photo_file_name;
-    this.serial_number = null;
-    this.gate_pass_generated = false;
+    this.visitor_photo_file_name = visitor_photo_file_name;
+    this.serial_number = null;
+    this.gate_pass_generated = false;
     this.email_sent = false;
   }
 }

package/src/models/LMSExternalEntityTrainedPersonModel.ts

@@ -1,45 +1,45 @@
-import { Column, Entity } from "typeorm";
-import { BaseModel } from './BaseModel';
-
-/**
- * One person/trainee per row; multiple rows per request (Request for Individual Training).
- */
-@Entity({ name: 'lms_external_entity_trained_people' })
-export class LMSExternalEntityTrainedPerson extends BaseModel {
-
-  @Column({ type: 'int', nullable: false })
-  request_id: number;
-
-  @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 })
-  full_name: string | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  employee_id: string | null;
-
-  @Column({ type: 'int', nullable: true })
-  age: number | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  university: string | null;
-
-  @Column({ type: 'text', nullable: true })
-  qualification: string | null;
-
-  @Column({ type: 'text', nullable: true })
-  learning_curriculum: string | null;
-
-  @Column({ type: 'varchar', length: 255, nullable: true })
-  training_period: string | null;
-
-  @Column({ type: 'boolean', default: false })
-  is_selected: boolean;
-
-  @Column({ type: 'int', default: 0 })
-  display_order: number;
-}
+import { Column, Entity } from "typeorm";
+import { BaseModel } from './BaseModel';
+
+/**
+ * One person/trainee per row; multiple rows per request (Request for Individual Training).
+ */
+@Entity({ name: 'lms_external_entity_trained_people' })
+export class LMSExternalEntityTrainedPerson extends BaseModel {
+
+  @Column({ type: 'int', nullable: false })
+  request_id: number;
+
+  @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 })
+  full_name: string | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  employee_id: string | null;
+
+  @Column({ type: 'int', nullable: true })
+  age: number | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  university: string | null;
+
+  @Column({ type: 'text', nullable: true })
+  qualification: string | null;
+
+  @Column({ type: 'text', nullable: true })
+  learning_curriculum: string | null;
+
+  @Column({ type: 'varchar', length: 255, nullable: true })
+  training_period: string | null;
+
+  @Column({ type: 'boolean', default: false })
+  is_selected: boolean;
+
+  @Column({ type: 'int', default: 0 })
+  display_order: number;
+}