# alfredop73/portaldelegresado architecture

> Architecture diagram of the GitHub repository alfredop73/portaldelegresado, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alfredop73/portaldelegresado
- Repository: https://github.com/alfredop73/portaldelegresado

## Overview

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: [`frontend/src/api/index.ts`](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/api/index.ts) (API client), [`backend/app/database.py`](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/database.py) (SQL database), [`backend/app/graduates/controllers/graduate_controller.py`](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/controllers/graduate_controller.py) (Graduate endpoints), [`backend/app/companies/controllers/application_controller.py`](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/controllers/application_controller.py) (Hiring endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Role-based routes<br/>[App.tsx]"]
  node_layout["Application shell<br/>[Layout.tsx]"]
  node_frontend_api["API client<br/>[index.ts]"]
  node_auth_ui["Sign-in and settings<br/>[Login.tsx]"]
  node_graduate_ui["Graduate workspace<br/>[JobBoard.tsx]"]
  node_company_ui["Company hiring<br/>[Kanban.tsx]"]
  node_admin_ui["Admin analytics"]
end

subgraph group_identity["Identity and messaging"]
  node_auth_api["Authentication endpoints<br/>[auth_controller.py]"]
  node_auth_service["Account and token logic<br/>[auth_service.py]"]
  node_auth_models[("Users and conversations<br/>[models.py]")]
end

subgraph group_talent["Talent and hiring"]
  node_graduate_api["Graduate endpoints"]
  node_graduate_service["Graduate profile services"]
  node_cv_parser["CV parsing"]
  node_company_api["Hiring endpoints"]
  node_application_service["Application workflow"]
  node_company_models[("Hiring data<br/>[models.py]")]
end

subgraph group_insights["Matching and insights"]
  node_match_api["Match endpoints"]
  node_matching["Recommendation engine"]
  node_dashboard_api["Dashboard endpoints"]
  node_dashboard_facade["Dashboard aggregation"]
end

subgraph group_platform["Shared platform"]
  node_database[("SQL database<br/>[database.py]")]
  node_adapters["Service adapters<br/>[adapters.py]"]
  node_object_storage[("S3 storage<br/>[s3.py]")]
end

node_user(("Platform users"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"wraps pages"| node_layout
node_layout -->|"calls"| node_frontend_api
node_auth_ui -.->|"uses client"| node_frontend_api
node_graduate_ui -.->|"uses client"| node_frontend_api
node_company_ui -.->|"uses client"| node_frontend_api
node_admin_ui -.->|"uses client"| node_frontend_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"queries"| node_auth_models
node_auth_service -->|"uses notifications"| node_adapters
node_graduate_api -->|"delegates to"| node_graduate_service
node_graduate_api -->|"uses parser"| node_cv_parser
node_company_api -->|"delegates to"| node_application_service
node_company_api -->|"stores uploads"| node_object_storage
node_match_api -->|"invokes"| node_matching
node_matching -->|"uses"| node_adapters
node_dashboard_api -->|"delegates to"| node_dashboard_facade
node_graduate_api -->|"queries"| node_database
node_company_api -->|"queries"| node_database
node_auth_models -->|"maps tables"| node_database
node_company_models -->|"maps tables"| node_database

click node_app "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/App.tsx"
click node_layout "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/components/Layout.tsx"
click node_frontend_api "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/api/index.ts"
click node_auth_ui "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/auth/pages/Login.tsx"
click node_graduate_ui "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/graduate/pages/JobBoard.tsx"
click node_company_ui "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/company/pages/Kanban.tsx"
click node_admin_ui "https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/dashboard/pages/ExecutiveAnalyticsDashboard.tsx"
click node_auth_api "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/controllers/auth_controller.py"
click node_auth_service "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/services/auth_service.py"
click node_auth_models "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/models.py"
click node_graduate_api "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/controllers/graduate_controller.py"
click node_graduate_service "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/services/graduate_service.py"
click node_cv_parser "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/services/cv_parser_service.py"
click node_company_api "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/controllers/application_controller.py"
click node_application_service "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/services/application_service.py"
click node_company_models "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/models.py"
click node_match_api "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/matchmaking/controllers/match_controller.py"
click node_matching "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/matchmaking/services/matching_service.py"
click node_dashboard_api "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/dashboard/controllers/dashboard_controller.py"
click node_dashboard_facade "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/dashboard/services/dashboard_facade.py"
click node_database "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/database.py"
click node_adapters "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/core/adapters.py"
click node_object_storage "https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/core/s3.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_layout,node_frontend_api,node_auth_ui,node_graduate_ui,node_company_ui,node_admin_ui,node_user toneBlue
class node_auth_api,node_auth_service,node_auth_models toneAmber
class node_graduate_api,node_graduate_service,node_cv_parser,node_company_api,node_application_service,node_company_models toneMint
class node_match_api,node_matching,node_dashboard_api,node_dashboard_facade toneRose
class node_database,node_adapters,node_object_storage toneIndigo
```

## Components

### Web application

- [Role-based routes](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Application shell](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/components/Layout.tsx): `frontend/src/components/Layout.tsx`
- [API client](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/api/index.ts): `frontend/src/api/index.ts`
- [Sign-in and settings](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/auth/pages/Login.tsx): `frontend/src/features/auth/pages/Login.tsx`
- [Graduate workspace](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/graduate/pages/JobBoard.tsx): `frontend/src/features/graduate/pages/JobBoard.tsx`
- [Company hiring](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/company/pages/Kanban.tsx): `frontend/src/features/company/pages/Kanban.tsx`
- [Admin analytics](https://github.com/alfredop73/portaldelegresado/blob/main/frontend/src/features/dashboard/pages/ExecutiveAnalyticsDashboard.tsx): `frontend/src/features/dashboard/pages/ExecutiveAnalyticsDashboard.tsx`

### Identity and messaging

- [Authentication endpoints](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/controllers/auth_controller.py): `backend/app/auth/controllers/auth_controller.py`
- [Account and token logic](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/services/auth_service.py): `backend/app/auth/services/auth_service.py`
- [Users and conversations](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/auth/models.py): `backend/app/auth/models.py`

### Talent and hiring

- [Graduate endpoints](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/controllers/graduate_controller.py): `backend/app/graduates/controllers/graduate_controller.py`
- [Graduate profile services](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/services/graduate_service.py): `backend/app/graduates/services/graduate_service.py`
- [CV parsing](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/graduates/services/cv_parser_service.py): `backend/app/graduates/services/cv_parser_service.py`
- [Hiring endpoints](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/controllers/application_controller.py): `backend/app/companies/controllers/application_controller.py`
- [Application workflow](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/services/application_service.py): `backend/app/companies/services/application_service.py`
- [Hiring data](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/companies/models.py): `backend/app/companies/models.py`

### Matching and insights

- [Match endpoints](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/matchmaking/controllers/match_controller.py): `backend/app/matchmaking/controllers/match_controller.py`
- [Recommendation engine](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/matchmaking/services/matching_service.py): `backend/app/matchmaking/services/matching_service.py`
- [Dashboard endpoints](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/dashboard/controllers/dashboard_controller.py): `backend/app/dashboard/controllers/dashboard_controller.py`
- [Dashboard aggregation](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/dashboard/services/dashboard_facade.py): `backend/app/dashboard/services/dashboard_facade.py`

### Shared platform

- [SQL database](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/database.py): `backend/app/database.py`
- [Service adapters](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/core/adapters.py): `backend/app/core/adapters.py`
- [S3 storage](https://github.com/alfredop73/portaldelegresado/blob/main/backend/app/core/s3.py): `backend/app/core/s3.py`

### Other components

- **Platform users**

## Connections

- Platform users → Role-based routes: opens (evidence: `frontend/src/App.tsx`)
- Role-based routes → Sign-in and settings: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routes → Application shell: wraps pages (evidence: `frontend/src/App.tsx`)
- Application shell → API client: calls (evidence: `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 (evidence: `backend/app/auth/controllers/auth_controller.py`)
- Account and token logic → Users and conversations: queries (evidence: `backend/app/auth/services/auth_service.py`)
- Account and token logic → Service adapters: uses notifications (evidence: `backend/app/auth/services/auth_service.py`)
- Graduate endpoints → Graduate profile services: delegates to (evidence: `backend/app/graduates/controllers/graduate_controller.py`)
- Graduate endpoints → CV parsing: uses parser (evidence: `backend/app/graduates/controllers/graduate_controller.py`)
- Hiring endpoints → Application workflow: delegates to (evidence: `backend/app/companies/controllers/application_controller.py`)
- Hiring endpoints → S3 storage: stores uploads (evidence: `backend/app/companies/controllers/application_controller.py`)
- Match endpoints → Recommendation engine: invokes (evidence: `backend/app/matchmaking/controllers/match_controller.py`)
- Recommendation engine → Service adapters: uses (evidence: `backend/app/matchmaking/services/matching_service.py`)
- Dashboard endpoints → Dashboard aggregation: delegates to (evidence: `backend/app/dashboard/controllers/dashboard_controller.py`)
- Graduate endpoints → SQL database: queries (evidence: `backend/app/graduates/controllers/graduate_controller.py`)
- Hiring endpoints → SQL database: queries (evidence: `backend/app/companies/controllers/application_controller.py`)
- Users and conversations → SQL database: maps tables (evidence: `backend/app/auth/models.py`)
- Hiring data → SQL database: maps tables (evidence: `backend/app/companies/models.py`)
