How alfredop73/portaldelegresado works
This repository implements a multi-role alumni employment platform: graduates maintain profiles and find opportunities, companies manage vacancies and applications, and administrators/coordinators oversee operations. The web app routes users into these workflows and calls a set of backend services for authentication, graduate data, hiring, matching, and analytics. The graph preserves documented capability areas such as AI copilots, events, messaging, surveys, and the alumni directory, but their detailed runtime wiring is not shown. Edges are limited to relationships visible in excerpts or the source index.
Main entry points: index.ts API client · database.py SQL database · graduate_controller.py Graduate endpoints · application_controller.py Hiring endpoints
Components 24
Web application
- Role-based routes
frontend/src/App.tsx - Application shell
frontend/src/components/Layout.tsx - API client
frontend/src/api/index.ts - Sign-in and settings
frontend/src/features/auth/pages/Login.tsx - Graduate workspace
frontend/src/features/graduate/pages/JobBoard.tsx - Company hiring
frontend/src/features/company/pages/Kanban.tsx - Admin analytics
frontend/src/features/dashboard/pages/ExecutiveAnalyticsDashboard.tsx
Identity and messaging
- Authentication endpoints
backend/app/auth/controllers/auth_controller.py - Account and token logic
backend/app/auth/services/auth_service.py - Users and conversations
backend/app/auth/models.py
Talent and hiring
- Graduate endpoints
backend/app/graduates/controllers/graduate_controller.py - Graduate profile services
backend/app/graduates/services/graduate_service.py - CV parsing
backend/app/graduates/services/cv_parser_service.py - Hiring endpoints
backend/app/companies/controllers/application_controller.py - Application workflow
backend/app/companies/services/application_service.py - Hiring data
backend/app/companies/models.py
Matching and insights
- Match endpoints
backend/app/matchmaking/controllers/match_controller.py - Recommendation engine
backend/app/matchmaking/services/matching_service.py - Dashboard endpoints
backend/app/dashboard/controllers/dashboard_controller.py - Dashboard aggregation
backend/app/dashboard/services/dashboard_facade.py
Shared platform
- SQL database
backend/app/database.py - Service adapters
backend/app/core/adapters.py - S3 storage
backend/app/core/s3.py
Other components
- Platform users
Connections 22
- Platform users → Role-based routes: opens
frontend/src/App.tsx - Role-based routes → Sign-in and settings: routes to
frontend/src/App.tsx - Role-based routes → Application shell: wraps pages
frontend/src/App.tsx - Application shell → API client: calls
frontend/src/components/Layout.tsx - Sign-in and settings → API client: uses client
- Graduate workspace → API client: uses client
- Company hiring → API client: uses client
- Admin analytics → API client: uses client
- Authentication endpoints → Account and token logic: delegates to
backend/app/auth/controllers/auth_controller.py - Account and token logic → Users and conversations: queries
backend/app/auth/services/auth_service.py - Account and token logic → Service adapters: uses notifications
backend/app/auth/services/auth_service.py - Graduate endpoints → Graduate profile services: delegates to
backend/app/graduates/controllers/graduate_controller.py - Graduate endpoints → CV parsing: uses parser
backend/app/graduates/controllers/graduate_controller.py - Hiring endpoints → Application workflow: delegates to
backend/app/companies/controllers/application_controller.py - Hiring endpoints → S3 storage: stores uploads
backend/app/companies/controllers/application_controller.py - Match endpoints → Recommendation engine: invokes
backend/app/matchmaking/controllers/match_controller.py - Recommendation engine → Service adapters: uses
backend/app/matchmaking/services/matching_service.py - Dashboard endpoints → Dashboard aggregation: delegates to
backend/app/dashboard/controllers/dashboard_controller.py - Graduate endpoints → SQL database: queries
backend/app/graduates/controllers/graduate_controller.py - Hiring endpoints → SQL database: queries
backend/app/companies/controllers/application_controller.py - Users and conversations → SQL database: maps tables
backend/app/auth/models.py - Hiring data → SQL database: maps tables
backend/app/companies/models.py