How grupo-1-epialc/bolsa-de-trabajo works
Bolsa de Trabajo is a student–job matching product built from a React frontend and REST microservices, with rule-based scoring and AI workflows orchestrated by n8n. The main user journey is account access, profile/CV completion, job discovery or company vacancy management, and recommendations or candidate review. The map also includes admin controls and the internal MCP tool layer. Cross-service workflow links are based on README documentation; unsampled implementation details are not inferred.
Main entry points: App.tsx App routing · generate_workflows.py AI workflows · authService.ts Auth client · routes_profiles.py Profile API
Components 21
Frontend
- App routing
frontend/src/App.tsx - Auth client
frontend/src/services/authService.ts - API client
frontend/src/services/api.ts - Student workspace
frontend/src/pages/StudentArea.tsx - Company workspace
frontend/src/pages/CompanyArea.tsx - Admin workspace
frontend/src/pages/AdminArea.tsx
Identity
- Auth service
services/auth-service/src/auth/auth.service.ts - Account store
services/auth-service/src/users/user.entity.ts
Profiles and Jobs
- Profile API
services/profile-service/app/api/routes_profiles.py - Profile management
services/profile-service/app/application/profile_service.py - CV storage
services/profile-service/app/infrastructure/storage_fs.py - Jobs API
services/jobs-service/app/api/routes_jobs.py - Job management
services/jobs-service/app/application/job_service.py
Matching and AI
- Matching API
services/matching-service/app/api/routes.py - Rule engine
services/matching-service/app/domain/engine.py
Agent Tooling
- AI workflows
n8n/generate_workflows.py - MCP tools
mcp-tools/app/main.py - Tool gateways
mcp-tools/app/domain/ports.py
Other components
- Student
- Company user
- Admin user
Connections 21
- Student → App routing: uses
README.md - Company user → App routing: uses
README.md - Admin user → App routing: uses
README.md - App routing → Auth client: routes auth
frontend/src/App.tsx - Auth client → API client: calls
frontend/src/services/authService.ts - App routing → Student workspace: renders
frontend/src/App.tsx - App routing → Company workspace: renders
frontend/src/App.tsx - App routing → Admin workspace: renders
frontend/src/App.tsx - Auth client → Auth service: requests auth
frontend/src/services/authService.ts - Auth service → Account store: persists accounts
services/auth-service/src/auth/auth.service.ts - Student workspace → Profile API: manages profile
README.md - Company workspace → Jobs API: manages vacancies
README.md - Admin workspace → Matching API: configures matching
README.md - Profile API → Profile management: delegates to
services/profile-service/app/api/routes_profiles.py - Profile management → CV storage: stores CVs
README.md - Jobs API → Job management: calls
services/jobs-service/app/api/routes_jobs.py - Matching API → Rule engine: computes matches
services/matching-service/app/api/routes.py - AI workflows → MCP tools: calls directly
README.md - MCP tools → Tool gateways: uses gateways
mcp-tools/app/domain/ports.py - AI workflows → Profile API: requests CV extraction
README.md - AI workflows → Matching API: requests recommendations
README.md