@dirayaah/assessment-module 1.0.0

package/index.ts

@@ -0,0 +1,26 @@
+//MODULES
+export * from './src/modules/assessment.module';
+
+//INTERFACES
+export * from './src/interfaces/assessments-options.interface';
+
+//SERVICES
+export * from './src/services';
+
+//ENTITIES
+export * from './src/entities';
+
+//DTOS
+export * from './src/dto';
+
+//CONSTANTS
+export * from './src/constants';
+
+//MIGRATIONS
+export * from './src/migrations';
+
+//REPOSITORIES
+export * from './src/repositories';
+
+//ENUMS
+export * from './src/enums';

package/jest.config.ts

@@ -0,0 +1,10 @@
+// jest.config.js
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  moduleFileExtensions: ['ts', 'tsx', 'js'],
+  testMatch: ['src/test/?(*.)+(spec|test).[jt]s?(x)'],
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+};

package/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@dirayaah/assessment-module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.0.0",
+  "description": "A reusable module for handling assessments in nestjs applications",
+  "main": "dist/index.js",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./migrations": {
+      "import": "./dist/migrations/index.js",
+      "require": "./dist/migrations/index.js"
+    },
+    "./entities": {
+      "import": "./dist/entities/index.js",
+      "require": "./dist/entities/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.zadapps.info/dirayaah/packages/assessments.git"
+  },
+  "author": "MD-LABS",
+  "license": "MIT",
+  "dependencies": {
+    "@nestjs/common": "7.5.1",
+    "@nestjs/core": "7.5.1",
+    "@nestjs/platform-express": "7.5.1",
+    "@nestjs/swagger": "4.8.0",
+    "@nestjs/typeorm": "7.1.4",
+    "dayjs": "1.11.13",
+    "dayjs-plugin-utc": "0.1.2",
+    "typeorm": "0.2.45"
+  },
+  "devDependencies": {
+    "@nestjs/testing": "^7.5.1",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^28.1.8",
+    "@types/node": "^20.14.0",
+    "jest": "^28.1.3",
+    "ts-jest": "^28.0.8",
+    "typescript": "^5.3.3"
+  }
+}

package/src/constants/assessments-options.ts

@@ -0,0 +1 @@
+export const ASSESSMENTS_OPTIONS = 'ASSESSMENTS_OPTIONS';

package/src/constants/index.ts

@@ -0,0 +1,12 @@
+import { ASSESSMENTS_OPTIONS } from './assessments-options';
+import {
+  DISC_ASSESSMENT,
+  HOLLAND_ASSESSMENT,
+  LEADERSHIP_ASSESSMENT,
+} from './predefined-assessments';
+export {
+  ASSESSMENTS_OPTIONS,
+  DISC_ASSESSMENT,
+  HOLLAND_ASSESSMENT,
+  LEADERSHIP_ASSESSMENT,
+};

package/src/constants/predefined-assessments/disc.ts

@@ -0,0 +1,205 @@
+import { PredefinedAssessmentEntity } from '../../entities/predefined-assessment.entity';
+import { AssessmentDetailsLanguage, PredefinedAssessmentType } from '../../enums';
+
+const DISC_ASSESSMENT: PredefinedAssessmentEntity[] = [
+  {
+    title: 'مقياس ديسك (DISC) للشخصية',
+    description:
+      'مقياس ديسك (DISC) هو أداة تحليل سلوكي تساعد الأفراد على فهم أنماط شخصياتهم وطريقة تفاعلهم مع الآخرين. يركز المقياس على السلوكيات وليس الذكاء أو المهارات، ويُستخدم على نطاق واسع في التطوير المهني والشخصي.',
+    language: AssessmentDetailsLanguage.AR,
+    category: 'شخصية',
+    type: PredefinedAssessmentType.DISC,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'مقياس ديسك (DISC) للشخصية',
+        description:
+          'مقياس ديسك (DISC) هو أداة تحليل سلوكي تساعد الأفراد على فهم أنماط شخصياتهم وطريقة تفاعلهم مع الآخرين. يركز المقياس على السلوكيات وليس الذكاء أو المهارات، ويُستخدم على نطاق واسع في التطوير المهني والشخصي.',
+      },
+      behavioralPatterns: {
+        title: 'الأنماط السلوكية في مقياس DISC',
+        patterns: [
+          {
+            title: 'النمط القيادي (D-Dominance)',
+            description:
+              'يعكس طريقة تعامل الشخص مع التحديات والمشكلات وتحقيق النتائج. يتميز أصحاب هذا النمط بالحزم والثقة والتركيز على الإنجاز.',
+          },
+          {
+            title: 'النمط التأثيري (I-Influence)',
+            description:
+              'يعبر عن طريقة تفاعل الشخص مع الآخرين وقدرته على التأثير فيهم. يتميز أصحاب هذا النمط بالحيوية والاجتماعية والقدرة على الإقناع.',
+          },
+          {
+            title: 'النمط الثابت (S- Steadiness)',
+            description:
+              'يمثل طريقة تعامل الشخص مع التغيير والاستقرار. يتميز أصحاب هذا النمط بالهدوء والصبر والموثوقية.',
+          },
+          {
+            title: 'النمط الدقيق (C-Conscientiousness)',
+            description:
+              'يعكس مدى التزام الشخص بالقواعد والدقة والتنظيم. يتميز أصحاب هذا النمط بالتحليل والتركيز على التفاصيل والجودة.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'كيف يعمل مقياس DISC',
+        description:
+          'يتضمن المقياس مجموعة من الأسئلة السلوكية، ويتم تحليل الإجابات لتحديد النمط السلوكي الأساسي والأنماط الثانوية، مما ينتج عنه ملف شخصي مفصل.',
+      },
+      outputs: {
+        title: 'مخرجات التقييم',
+        items: [
+          'ملف شخصي سلوكي',
+          'نقاط القوة والتحديات',
+          'أسلوب التواصل المناسب',
+          'تحليل السلوك في بيئة العمل',
+        ],
+      },
+      useCases: {
+        title: 'استخدامات مقياس DISC',
+        items: [
+          'التوظيف والاختيار',
+          'بناء فرق العمل',
+          'تطوير القيادات',
+          'تحسين التواصل والمبيعات',
+          'التطوير الذاتي',
+        ],
+      },
+    },
+    configuration: undefined,
+  },
+  {
+    title: 'DISC Personality Assessment',
+    description:
+      'The DISC Personality Assessment is a behavioral analysis tool that helps individuals understand their personality styles and how they interact with others. It focuses on behaviors rather than intelligence or skills and is widely used in professional and personal development.',
+    language: AssessmentDetailsLanguage.EN,
+    category: 'Personality',
+    type: PredefinedAssessmentType.DISC,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'DISC Personality Assessment',
+        description:
+          'The DISC Personality Assessment is a behavioral analysis tool that helps individuals understand their personality styles and how they interact with others. It focuses on behaviors rather than intelligence or skills and is widely used in professional and personal development.',
+      },
+      behavioralPatterns: {
+        title: 'Behavioral Patterns in the DISC Assessment',
+        patterns: [
+          {
+            title: 'Dominance Style (D – Dominance)',
+            description:
+              'Represents how a person deals with challenges, problems, and achieving results. Individuals with this style are assertive, confident, and focused on outcomes.',
+          },
+          {
+            title: 'Influence Style (I – Influence)',
+            description:
+              'Reflects how a person interacts with others and influences their environment. Individuals with this style are energetic, social, and persuasive.',
+          },
+          {
+            title: 'Steadiness Style (S – Steadiness)',
+            description:
+              'Represents how a person responds to change and stability. Individuals with this style are calm, patient, and reliable.',
+          },
+          {
+            title: 'Conscientious Style (C – Conscientiousness)',
+            description:
+              'Reflects a person’s commitment to rules, accuracy, and organization. Individuals with this style are analytical, detail-oriented, and quality-focused.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'How the DISC Assessment Works',
+        description:
+          'The assessment consists of a set of behavioral questions. Responses are analyzed to identify primary and secondary behavioral styles, resulting in a detailed personal profile.',
+      },
+      outputs: {
+        title: 'Assessment Outputs',
+        items: [
+          'Behavioral personality profile',
+          'Strengths and challenges',
+          'Preferred communication style',
+          'Workplace behavior analysis',
+        ],
+      },
+      useCases: {
+        title: 'DISC Assessment Use Cases',
+        items: [
+          'Recruitment and selection',
+          'Team building',
+          'Leadership development',
+          'Improving communication and sales',
+          'Personal development',
+        ],
+      },
+    },
+    configuration: null,
+  },
+  {
+    title: 'Evaluación de Personalidad DISC',
+    description:
+      'La Evaluación de Personalidad DISC es una herramienta de análisis conductual que ayuda a las personas a comprender sus estilos de personalidad y la forma en que interactúan con los demás. Se centra en el comportamiento y se utiliza ampliamente en el desarrollo profesional y personal.',
+    language: AssessmentDetailsLanguage.ES,
+    category: 'Personalidad',
+    type: PredefinedAssessmentType.DISC,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'Evaluación de Personalidad DISC',
+        description:
+          'La Evaluación de Personalidad DISC es una herramienta de análisis conductual que ayuda a las personas a comprender sus estilos de personalidad y la forma en que interactúan con los demás. Se centra en el comportamiento y se utiliza ampliamente en el desarrollo profesional y personal.',
+      },
+      behavioralPatterns: {
+        title: 'Patrones de Comportamiento en la Evaluación DISC',
+        patterns: [
+          {
+            title: 'Estilo Dominante (D – Dominancia)',
+            description:
+              'Representa cómo una persona enfrenta los desafíos, los problemas y el logro de resultados. Las personas con este estilo son decididas, seguras y orientadas a objetivos.',
+          },
+          {
+            title: 'Estilo Influyente (I – Influencia)',
+            description:
+              'Refleja cómo una persona interactúa e influye en los demás. Las personas con este estilo son enérgicas, sociables y persuasivas.',
+          },
+          {
+            title: 'Estilo Estable (S – Estabilidad)',
+            description:
+              'Representa cómo una persona responde al cambio y a la estabilidad. Las personas con este estilo son tranquilas, pacientes y confiables.',
+          },
+          {
+            title: 'Estilo Concienzudo (C – Conciencia)',
+            description:
+              'Refleja el compromiso de una persona con las reglas, la precisión y la organización. Las personas con este estilo son analíticas, detallistas y enfocadas en la calidad.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'Cómo Funciona la Evaluación DISC',
+        description:
+          'La evaluación incluye un conjunto de preguntas conductuales. Las respuestas se analizan para identificar los estilos conductuales primarios y secundarios, generando un perfil personal detallado.',
+      },
+      outputs: {
+        title: 'Resultados de la Evaluación',
+        items: [
+          'Perfil de personalidad conductual',
+          'Fortalezas y áreas de mejora',
+          'Estilo de comunicación preferido',
+          'Análisis del comportamiento en el entorno laboral',
+        ],
+      },
+      useCases: {
+        title: 'Casos de Uso de la Evaluación DISC',
+        items: [
+          'Reclutamiento y selección',
+          'Trabajo en equipo',
+          'Desarrollo de liderazgo',
+          'Mejora de la comunicación y ventas',
+          'Desarrollo personal',
+        ],
+      },
+    },
+    configuration: null,
+  },
+];
+
+export default DISC_ASSESSMENT;

package/src/constants/predefined-assessments/holland.ts

@@ -0,0 +1,235 @@
+import { PredefinedAssessmentEntity } from '../../entities/predefined-assessment.entity';
+import { AssessmentDetailsLanguage, PredefinedAssessmentType } from '../../enums';
+
+const HOLLAND_ASSESSMENT: PredefinedAssessmentEntity[] = [
+  {
+    title: 'مقياس هولاند (HOLLAND) للميول المهنية',
+    description:
+      'مقياس هولاند (Holland) هو أداة إرشاد مهني تهدف إلى تحديد الميول المهنية للأفراد بناءً على ستة أنماط شخصية رئيسية. يساعد المقياس الأفراد على فهم اهتماماتهم المهنية واختيار المسار الوظيفي الأنسب لهم.',
+    language: AssessmentDetailsLanguage.AR,
+    category: 'توجيه مهنية',
+    type: PredefinedAssessmentType.HOLLAND,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'مقياس هولاند (HOLLAND) للميول المهنية',
+        description:
+          'مقياس هولاند (Holland) هو أداة إرشاد مهني تقوم على تصنيف الأشخاص والوظائف إلى ستة أنماط رئيسية. يهدف إلى مساعدة الأفراد على فهم ميولهم المهنية وربطها بالبيئات الوظيفية المناسبة.',
+      },
+      behavioralPatterns: {
+        title: 'الأنماط المهنية في مقياس هولاند',
+        patterns: [
+          {
+            title: 'النمط الواقعي (R - Realistic)',
+            description:
+              'يميل أصحاب هذا النمط إلى الأعمال العملية واليدوية التي تتطلب استخدام الأدوات أو الآلات. يفضلون الأنشطة الملموسة والعملية ويبتعدون عن الأعمال النظرية أو الاجتماعية.',
+          },
+          {
+            title: 'النمط البحثي (I - Investigative)',
+            description:
+              'يتميز أصحاب هذا النمط بالاهتمام بالتحليل والتفكير وحل المشكلات. يفضلون البحث والاكتشاف والعمل مع الأفكار والمفاهيم العلمية.',
+          },
+          {
+            title: 'النمط الفني (A - Artistic)',
+            description:
+              'يميل أصحاب هذا النمط إلى الإبداع والتعبير الفني. يفضلون الأنشطة غير التقليدية التي تسمح بالتعبير عن الذات مثل الفنون، الكتابة، والتصميم.',
+          },
+          {
+            title: 'النمط الاجتماعي (S - Social)',
+            description:
+              'يركز هذا النمط على مساعدة الآخرين والتفاعل الاجتماعي. يفضل أصحابه العمل في مجالات التعليم، الإرشاد، والرعاية الإنسانية.',
+          },
+          {
+            title: 'النمط المغامر (E - Enterprising)',
+            description:
+              'يتميز أصحاب هذا النمط بالقدرة على القيادة والتأثير في الآخرين. يفضلون البيئات التنافسية والأعمال التي تتطلب الإقناع واتخاذ القرار.',
+          },
+          {
+            title: 'النمط التقليدي (C - Conventional)',
+            description:
+              'يميل أصحاب هذا النمط إلى التنظيم والدقة والعمل مع البيانات والأنظمة. يفضلون الأعمال المكتبية والمهام التي تتطلب الترتيب والالتزام بالقواعد.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'كيف يعمل مقياس هولاند',
+        description:
+          'يتضمن المقياس مجموعة من الأسئلة التي تقيس اهتمامات الفرد وميوله المهنية. يتم تحليل الإجابات لتحديد الأنماط المهنية الأساسية والثانوية وربطها بالمسارات الوظيفية المناسبة.',
+      },
+      outputs: {
+        title: 'مخرجات التقييم',
+        items: [
+          'تحديد نمط أو أنماط الميول المهنية',
+          'اقتراح مجالات وتخصصات مهنية مناسبة',
+          'فهم نقاط القوة المهنية',
+          'توجيه مهني مبني على الاهتمامات',
+        ],
+      },
+      useCases: {
+        title: 'استخدامات مقياس هولاند',
+        items: [
+          'الإرشاد المهني',
+          'اختيار التخصص الدراسي',
+          'تخطيط المسار الوظيفي',
+          'التوجيه للطلاب والخريجين',
+          'إعادة التوجيه المهني',
+        ],
+      },
+    },
+    configuration: undefined,
+  },
+  {
+    title: 'Holland (HOLLAND) Career Interest Assessment',
+    description:
+      'The Holland (Holland) Assessment is a career guidance tool designed to identify individuals’ career interests based on six main personality types. It helps individuals understand their professional interests and choose the most suitable career path.',
+    language: AssessmentDetailsLanguage.EN,
+    category: 'Career Interests',
+    type: PredefinedAssessmentType.HOLLAND,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'Holland (HOLLAND) Career Interest Assessment',
+        description:
+          'The Holland (Holland) Assessment is a career guidance tool that classifies people and work environments into six main types. It aims to help individuals understand their career interests and match them with suitable work environments.',
+      },
+      behavioralPatterns: {
+        title: 'Career Patterns in the Holland Assessment',
+        patterns: [
+          {
+            title: 'Realistic Type (R – Realistic)',
+            description:
+              'Individuals with this type prefer practical and hands-on activities that involve tools or machinery. They favor tangible tasks and tend to avoid theoretical or highly social work.',
+          },
+          {
+            title: 'Investigative Type (I – Investigative)',
+            description:
+              'Individuals with this type enjoy analysis, thinking, and problem-solving. They prefer research, discovery, and working with ideas and scientific concepts.',
+          },
+          {
+            title: 'Artistic Type (A – Artistic)',
+            description:
+              'Individuals with this type are inclined toward creativity and self-expression. They prefer non-traditional activities such as arts, writing, and design.',
+          },
+          {
+            title: 'Social Type (S – Social)',
+            description:
+              'This type focuses on helping others and social interaction. Individuals prefer working in education, counseling, and human service fields.',
+          },
+          {
+            title: 'Enterprising Type (E – Enterprising)',
+            description:
+              'Individuals with this type are characterized by leadership and the ability to influence others. They prefer competitive environments and work that involves persuasion and decision-making.',
+          },
+          {
+            title: 'Conventional Type (C – Conventional)',
+            description:
+              'Individuals with this type prefer organization, accuracy, and working with data and systems. They favor office-based tasks and activities that require structure and adherence to rules.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'How the Holland Assessment Works',
+        description:
+          'The assessment consists of a set of questions that measure an individual’s interests and career preferences. Responses are analyzed to identify primary and secondary career types and link them to suitable career paths.',
+      },
+      outputs: {
+        title: 'Assessment Outputs',
+        items: [
+          'Identification of primary and secondary career interest types',
+          'Suggested career fields and academic majors',
+          'Understanding professional strengths',
+          'Career guidance based on personal interests',
+        ],
+      },
+      useCases: {
+        title: 'Holland Assessment Use Cases',
+        items: [
+          'Career guidance and counseling',
+          'Choosing an academic major',
+          'Career path planning',
+          'Student and graduate guidance',
+          'Career reorientation',
+        ],
+      },
+    },
+    configuration: null,
+  },
+  {
+    title: 'Evaluación de Intereses Profesionales Holland (HOLLAND)',
+    description:
+      'La Evaluación Holland (Holland) es una herramienta de orientación profesional diseñada para identificar los intereses profesionales de las personas según seis tipos principales de personalidad. Ayuda a comprender los intereses laborales y a elegir el camino profesional más adecuado.',
+    language: AssessmentDetailsLanguage.ES,
+    category: 'Intereses Profesionales',
+    type: PredefinedAssessmentType.HOLLAND,
+    backgroundImageUrl: null,
+    details: {
+      overview: {
+        title: 'Evaluación de Intereses Profesionales Holland (HOLLAND)',
+        description:
+          'La Evaluación Holland (Holland) es una herramienta de orientación profesional que clasifica a las personas y los entornos laborales en seis tipos principales. Su objetivo es ayudar a las personas a comprender sus intereses profesionales y relacionarlos con entornos laborales adecuados.',
+      },
+      behavioralPatterns: {
+        title: 'Patrones Profesionales en la Evaluación Holland',
+        patterns: [
+          {
+            title: 'Tipo Realista (R – Realista)',
+            description:
+              'Las personas de este tipo prefieren actividades prácticas y manuales que implican el uso de herramientas o maquinaria. Favorecen tareas concretas y suelen evitar trabajos teóricos o muy sociales.',
+          },
+          {
+            title: 'Tipo Investigador (I – Investigador)',
+            description:
+              'Las personas de este tipo disfrutan del análisis, el pensamiento y la resolución de problemas. Prefieren la investigación, el descubrimiento y el trabajo con ideas y conceptos científicos.',
+          },
+          {
+            title: 'Tipo Artístico (A – Artístico)',
+            description:
+              'Las personas de este tipo se inclinan hacia la creatividad y la expresión personal. Prefieren actividades no tradicionales como el arte, la escritura y el diseño.',
+          },
+          {
+            title: 'Tipo Social (S – Social)',
+            description:
+              'Este tipo se centra en ayudar a los demás y en la interacción social. Las personas prefieren trabajar en educación, orientación y servicios humanos.',
+          },
+          {
+            title: 'Tipo Emprendedor (E – Emprendedor)',
+            description:
+              'Las personas de este tipo se caracterizan por el liderazgo y la capacidad de influir en los demás. Prefieren entornos competitivos y trabajos que implican persuasión y toma de decisiones.',
+          },
+          {
+            title: 'Tipo Convencional (C – Convencional)',
+            description:
+              'Las personas de este tipo prefieren la organización, la precisión y el trabajo con datos y sistemas. Se inclinan por tareas administrativas y actividades que requieren estructura y cumplimiento de normas.',
+          },
+        ],
+      },
+      howItWorks: {
+        title: 'Cómo Funciona la Evaluación Holland',
+        description:
+          'La evaluación incluye un conjunto de preguntas que miden los intereses y preferencias profesionales de la persona. Las respuestas se analizan para identificar los tipos profesionales primarios y secundarios y vincularlos con trayectorias profesionales adecuadas.',
+      },
+      outputs: {
+        title: 'Resultados de la Evaluación',
+        items: [
+          'Identificación de los tipos principales y secundarios de intereses profesionales',
+          'Sugerencia de campos profesionales y especialidades académicas',
+          'Comprensión de las fortalezas profesionales',
+          'Orientación profesional basada en los intereses personales',
+        ],
+      },
+      useCases: {
+        title: 'Casos de Uso de la Evaluación Holland',
+        items: [
+          'Orientación y asesoramiento profesional',
+          'Elección de especialidad académica',
+          'Planificación de la carrera profesional',
+          'Orientación para estudiantes y graduados',
+          'Reorientación profesional',
+        ],
+      },
+    },
+    configuration: null,
+  },
+];
+
+export default HOLLAND_ASSESSMENT;

package/src/constants/predefined-assessments/index.ts

@@ -0,0 +1,5 @@
+import DISC_ASSESSMENT from './disc';
+import HOLLAND_ASSESSMENT from './holland';
+import LEADERSHIP_ASSESSMENT from './leadership';
+
+export { DISC_ASSESSMENT, HOLLAND_ASSESSMENT, LEADERSHIP_ASSESSMENT };