feat: add matching service with cosine similarity - API working

api/package-lock.json

@@ -11,6 +11,7 @@
       "dependencies": {
         "@nestjs/common": "^11.0.1",
         "@nestjs/core": "^11.0.1",
+        "@nestjs/mapped-types": "*",
         "@nestjs/platform-express": "^11.0.1",
         "hbs": "^4.2.0",
         "mathjs": "^15.1.0",
@@ -2206,6 +2207,26 @@
         }
       }
     },
+    "node_modules/@nestjs/mapped-types": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@nestjs/mapped-types/-/mapped-types-2.1.0.tgz",
+      "integrity": "sha512-W+n+rM69XsFdwORF11UqJahn4J3xi4g/ZEOlJNL6KoW5ygWSmBB2p0S2BZ4FQeS/NDH72e6xIcu35SfJnE8bXw==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@nestjs/common": "^10.0.0 || ^11.0.0",
+        "class-transformer": "^0.4.0 || ^0.5.0",
+        "class-validator": "^0.13.0 || ^0.14.0",
+        "reflect-metadata": "^0.1.12 || ^0.2.0"
+      },
+      "peerDependenciesMeta": {
+        "class-transformer": {
+          "optional": true
+        },
+        "class-validator": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/@nestjs/platform-express": {
       "version": "11.1.9",
       "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-11.1.9.tgz",

api/package.json

@@ -22,6 +22,7 @@
   "dependencies": {
     "@nestjs/common": "^11.0.1",
     "@nestjs/core": "^11.0.1",
+    "@nestjs/mapped-types": "*",
     "@nestjs/platform-express": "^11.0.1",
     "hbs": "^4.2.0",
     "mathjs": "^15.1.0",

api/src/app.module.ts

@@ -1,9 +1,10 @@
 import { Module } from '@nestjs/common';
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
+import { MatchingModule } from './matching/matching.module';
 
 @Module({
-  imports: [],
+  imports: [MatchingModule],
   controllers: [AppController],
   providers: [AppService],
 })

api/src/matching/matching.controller.spec.ts

@@ -0,0 +1,20 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { MatchingController } from './matching.controller';
+import { MatchingService } from './matching.service';
+
+describe('MatchingController', () => {
+  let controller: MatchingController;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      controllers: [MatchingController],
+      providers: [MatchingService],
+    }).compile();
+
+    controller = module.get<MatchingController>(MatchingController);
+  });
+
+  it('should be defined', () => {
+    expect(controller).toBeDefined();
+  });
+});

api/src/matching/matching.controller.ts

@@ -0,0 +1,21 @@
+import { Controller, Get, Query, Param } from '@nestjs/common';
+import { MatchingService } from './matching.service';
+
+@Controller('api/matching')
+export class MatchingController {
+  constructor(private readonly matchingService: MatchingService) {}
+
+  @Get('candidate/:id/matches')
+  getMatches(
+    @Param('id') candidateId: string,
+    @Query('topK') topK?: number
+  ) {
+    const id = parseInt(candidateId);
+    const k = topK ? parseInt(topK.toString()) : 10;
+    
+    return {
+      candidate: this.matchingService.getCandidateData(id),
+      matches: this.matchingService.findTopMatches(k),
+    };
+  }
+}

api/src/matching/matching.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { MatchingService } from './matching.service';
+import { MatchingController } from './matching.controller';
+
+@Module({
+  controllers: [MatchingController],
+  providers: [MatchingService],
+})
+export class MatchingModule {}

api/src/matching/matching.service.spec.ts

@@ -0,0 +1,18 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { MatchingService } from './matching.service';
+
+describe('MatchingService', () => {
+  let service: MatchingService;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [MatchingService],
+    }).compile();
+
+    service = module.get<MatchingService>(MatchingService);
+  });
+
+  it('should be defined', () => {
+    expect(service).toBeDefined();
+  });
+});

api/src/matching/matching.service.ts

@@ -0,0 +1,33 @@
+import { Injectable } from '@nestjs/common';
+import * as math from 'mathjs';
+import { mockCandidate, mockCompanies } from './mock-data';
+
+@Injectable()
+export class MatchingService {
+  
+  cosineSimilarity(vecA: number[], vecB: number[]): number {
+    const dotProduct = math.dot(vecA, vecB) as number;
+    const normA = math.norm(vecA) as number;
+    const normB = math.norm(vecB) as number;
+    return dotProduct / (normA * normB);
+  }
+
+  findTopMatches(candidateId: number, topK: number = 10) {
+    const candidate = mockCandidate;
+    
+    const matches = mockCompanies.map((company) => ({
+      companyId: company.id,
+      companyName: company.name,
+      jobTitle: company.title,
+      score: this.cosineSimilarity(candidate.embedding, company.embedding),
+    }));
+
+    return matches
+      .sort((a, b) => b.score - a.score)
+      .slice(0, topK);
+  }
+
+  getCandidateData(candidateId: number) {
+    return mockCandidate;
+  }
+}

api/src/matching/mock-data.ts

@@ -0,0 +1,29 @@
+export const mockCandidate = {
+  id: 0,
+  name: 'Candidate #0',
+  skills: ['Python', 'Machine Learning', 'Data Science', 'SQL', 'AWS'],
+  experience: '5 years',
+  education: 'Master in Computer Science',
+  embedding: [0.1, 0.2, 0.3, 0.4, 0.5] // Simplificado (real seria 384 dims)
+};
+
+export const mockCompanies = [
+  {
+    id: 42,
+    name: 'Anblicks',
+    title: 'Data Scientist',
+    embedding: [0.12, 0.19, 0.31, 0.38, 0.52]
+  },
+  {
+    id: 15,
+    name: 'iO Associates',
+    title: 'ML Engineer',
+    embedding: [0.11, 0.21, 0.29, 0.41, 0.48]
+  },
+  {
+    id: 89,
+    name: 'DATAECONOMY',
+    title: 'Senior Data Analyst',
+    embedding: [0.09, 0.18, 0.33, 0.39, 0.51]
+  }
+];