# unla-investigacion-desarrollo/front-gestion-ppps-tfis architecture

> Architecture diagram of the GitHub repository unla-investigacion-desarrollo/front-gestion-ppps-tfis, 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/unla-investigacion-desarrollo/front-gestion-ppps-tfis
- Repository: https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis

## Overview

This is the UNLa web frontend for managing TFI projects and PPP placements, with role-specific student, tutor, evaluator and administrator workflows. Users authenticate, enter guarded routes and work through project creation/exploration, submissions and reviews, or PPP applications and case management. Redux features and service modules provide an internal state and API layer. The graph combines README-described capabilities with routes and calls visible in excerpts or the source index; unsampled page internals are not inferred.

Main entry points: [`src/routes/App.jsx`](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/routes/App.jsx) (Route dispatch), [`src/services/pppService.ts`](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/pppService.ts) (PPP API), [`src/services/projectService.ts`](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/projectService.ts) (Project API), [`src/services/studentWorkService.ts`](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/studentWorkService.ts) (Student work API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_routes["Route dispatch<br/>[App.jsx]"]
  node_auth["Authentication<br/>[useAuth.jsx]"]
  node_profile["Role profile<br/>[useUserProfile.ts]"]
  node_layout["Role workspace"]
  node_login["Login and registration<br/>[Login.tsx]"]
  node_adminusers["User administration<br/>[UsersList.tsx]"]
end

subgraph group_tfi["TFI lifecycle"]
  node_projectexplorer["Project exploration"]
  node_explorerutils["Explorer filtering"]
  node_studentprojects["Student TFI<br/>[MyProjects.tsx]"]
  node_projectcreate["Project creation<br/>[ProjectCreate.tsx]"]
  node_teacherprojects["Teacher projects"]
  node_projecttable["Project table<br/>[ProjectTable.tsx]"]
  node_deliveries["Student deliveries<br/>[Deliveries.tsx]"]
  node_work["Work review and tutoring<br/>[Trabajo.tsx]"]
  node_pagination["Pagination<br/>[Pagination.tsx]"]
  node_dashboard["Role dashboards"]
  node_approvals["Project approvals<br/>[ApprovalQueue.tsx]"]
end

subgraph group_ppp["PPP management"]
  node_pppcatalog["PPP proposals"]
  node_pppapplicants["PPP applicants"]
  node_ppptramite["PPP case detail"]
  node_pppexpedientes["PPP case list"]
  node_pppstudent["Student PPP case"]
  node_ppphook["PPP proposal state<br/>[usePPPProposals.ts]"]
end

subgraph group_platform["State and API"]
  node_authactions["Auth async actions<br/>[asyncActions.ts]"]
  node_projectstate["Project state<br/>[index.ts]"]
  node_pppstate["PPP state<br/>[index.ts]"]
  node_projectapi["Project API<br/>[projectService.ts]"]
  node_workapi["Student work API"]
  node_pppapi["PPP API<br/>[pppService.ts]"]
  node_userapi["User API<br/>[userService.ts]"]
  node_authapi["Auth API<br/>[authService.ts]"]
  node_apiclient["API client<br/>[apiClient.ts]"]
end

node_users(("Users"))
node_backend{{"Management API"}}

node_users -->|"open app"| node_routes
node_routes -->|"routes to"| node_login
node_routes -->|"wraps pages"| node_layout
node_routes -->|"routes to"| node_adminusers
node_routes -->|"routes to"| node_approvals
node_routes -->|"routes to"| node_projectcreate
node_routes -->|"routes to"| node_deliveries
node_routes -->|"routes to"| node_pppcatalog
node_routes -->|"routes to"| node_ppptramite
node_auth -->|"dispatches login"| node_authactions
node_authactions -->|"calls"| node_authapi
node_authapi -->|"HTTP requests"| node_backend
node_profile -->|"loads profile"| node_userapi
node_layout -->|"uses role data"| node_profile
node_layout -->|"shows workspace"| node_dashboard
node_dashboard -->|"role dashboards"| node_users
node_users -->|"explores projects"| node_projectexplorer
node_projectexplorer -->|"uses filters"| node_explorerutils
node_projectexplorer -->|"loads projects"| node_projectapi
node_projectcreate -->|"creates TFI"| node_users
node_teacherprojects -->|"renders"| node_projecttable
node_teacherprojects -->|"loads projects"| node_projectapi
node_teacherprojects -->|"uses"| node_pagination
node_deliveries -->|"loads work"| node_workapi
node_work -->|"refreshes work"| node_workapi
node_work -->|"refreshes projects"| node_projectstate
node_approvals -->|"handles requests"| node_users
node_pppcatalog -->|"supports applications"| node_users
node_pppcatalog -->|"proposal workflow"| node_ppphook
node_ppphook -->|"calls"| node_pppapi
node_ppphook -->|"uses state"| node_pppstate
node_pppapplicants -.->|"manages applicants"| node_pppapi
node_ppptramite -->|"loads case"| node_pppapi
node_pppexpedientes -.->|"manages cases"| node_pppapi
node_pppstudent -.->|"manages case"| node_pppapi
node_projectstate -->|"calls"| node_projectapi
node_pppstate -->|"dispatches actions"| node_pppapi
node_projectapi -->|"HTTP requests"| node_backend
node_workapi -->|"HTTP requests"| node_backend
node_pppapi -->|"HTTP requests"| node_backend
node_userapi -->|"HTTP requests"| node_backend
node_projectapi -->|"imports config"| node_apiclient
node_pppapi -->|"imports parser"| node_apiclient
node_workapi -->|"imports config"| node_apiclient
node_userapi -->|"imports config"| node_apiclient

click node_routes "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/routes/App.jsx"
click node_auth "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useAuth.jsx"
click node_profile "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useUserProfile.ts"
click node_layout "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/AuthenticatedLayout.jsx"
click node_login "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Login/Login.tsx"
click node_adminusers "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Admin/Users/UsersList.tsx"
click node_projectexplorer "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useProjectExplorer.ts"
click node_explorerutils "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/ProjectExplorer/projectExplorerUtils.ts"
click node_studentprojects "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Student/MyProjects.tsx"
click node_projectcreate "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Projects/ProjectCreate.tsx"
click node_teacherprojects "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Teacher/TeacherProjectsList.tsx"
click node_projecttable "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Teacher/components/ProjectTable.tsx"
click node_deliveries "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Student/Deliveries.tsx"
click node_work "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Trabajo/Trabajo.tsx"
click node_pagination "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/Pagination.tsx"
click node_dashboard "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Dashboard/Teacher/TeacherDashboard.tsx"
click node_approvals "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Admin/Approvals/ApprovalQueue.tsx"
click node_pppcatalog "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPProposalsCatalog.tsx"
click node_pppapplicants "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPProposalApplicantsPage.tsx"
click node_ppptramite "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPTramiteDetail.tsx"
click node_pppexpedientes "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPExpedientesList.tsx"
click node_pppstudent "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPStudentMyTramite.tsx"
click node_ppphook "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/usePPPProposals.ts"
click node_authactions "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/auth/asyncActions.ts"
click node_projectstate "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/projects/index.ts"
click node_pppstate "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/ppp/index.ts"
click node_projectapi "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/projectService.ts"
click node_workapi "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/studentWorkService.ts"
click node_pppapi "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/pppService.ts"
click node_userapi "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/userService.ts"
click node_authapi "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/authService.ts"
click node_apiclient "https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/apiClient.ts"

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_routes,node_auth,node_profile,node_layout,node_login,node_adminusers,node_users toneBlue
class node_projectexplorer,node_explorerutils,node_studentprojects,node_projectcreate,node_teacherprojects,node_projecttable,node_deliveries,node_work,node_pagination,node_dashboard,node_approvals toneAmber
class node_pppcatalog,node_pppapplicants,node_ppptramite,node_pppexpedientes,node_pppstudent,node_ppphook,node_backend toneMint
class node_authactions,node_projectstate,node_pppstate,node_projectapi,node_workapi,node_pppapi,node_userapi,node_authapi,node_apiclient toneRose
```

## Components

### Access and navigation

- [Route dispatch](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/routes/App.jsx): `src/routes/App.jsx`
- [Authentication](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useAuth.jsx): `src/hooks/useAuth.jsx`
- [Role profile](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useUserProfile.ts): `src/hooks/useUserProfile.ts`
- [Role workspace](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/AuthenticatedLayout.jsx): `src/components/AuthenticatedLayout.jsx`
- [Login and registration](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Login/Login.tsx): `src/pages/Login/Login.tsx`
- [User administration](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Admin/Users/UsersList.tsx): `src/pages/Admin/Users/UsersList.tsx`

### TFI lifecycle

- [Project exploration](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/useProjectExplorer.ts): `src/hooks/useProjectExplorer.ts`
- [Explorer filtering](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/ProjectExplorer/projectExplorerUtils.ts): `src/components/ProjectExplorer/projectExplorerUtils.ts`
- [Student TFI](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Student/MyProjects.tsx): `src/pages/Student/MyProjects.tsx`
- [Project creation](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Projects/ProjectCreate.tsx): `src/pages/Projects/ProjectCreate.tsx`
- [Teacher projects](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Teacher/TeacherProjectsList.tsx): `src/pages/Teacher/TeacherProjectsList.tsx`
- [Project table](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Teacher/components/ProjectTable.tsx): `src/pages/Teacher/components/ProjectTable.tsx`
- [Student deliveries](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Student/Deliveries.tsx): `src/pages/Student/Deliveries.tsx`
- [Work review and tutoring](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Trabajo/Trabajo.tsx): `src/pages/Trabajo/Trabajo.tsx`
- [Pagination](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/components/Pagination.tsx): `src/components/Pagination.tsx`
- [Role dashboards](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Dashboard/Teacher/TeacherDashboard.tsx): `src/pages/Dashboard/Teacher/TeacherDashboard.tsx`
- [Project approvals](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/Admin/Approvals/ApprovalQueue.tsx): `src/pages/Admin/Approvals/ApprovalQueue.tsx`

### PPP management

- [PPP proposals](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPProposalsCatalog.tsx): `src/pages/PPP/PPPProposalsCatalog.tsx`
- [PPP applicants](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPProposalApplicantsPage.tsx): `src/pages/PPP/PPPProposalApplicantsPage.tsx`
- [PPP case detail](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPTramiteDetail.tsx): `src/pages/PPP/PPPTramiteDetail.tsx`
- [PPP case list](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPExpedientesList.tsx): `src/pages/PPP/PPPExpedientesList.tsx`
- [Student PPP case](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/pages/PPP/PPPStudentMyTramite.tsx): `src/pages/PPP/PPPStudentMyTramite.tsx`
- [PPP proposal state](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/hooks/usePPPProposals.ts): `src/hooks/usePPPProposals.ts`

### State and API

- [Auth async actions](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/auth/asyncActions.ts): `src/redux/features/auth/asyncActions.ts`
- [Project state](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/projects/index.ts): `src/redux/features/projects/index.ts`
- [PPP state](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/redux/features/ppp/index.ts): `src/redux/features/ppp/index.ts`
- [Project API](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/projectService.ts): `src/services/projectService.ts`
- [Student work API](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/studentWorkService.ts): `src/services/studentWorkService.ts`
- [PPP API](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/pppService.ts): `src/services/pppService.ts`
- [User API](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/userService.ts): `src/services/userService.ts`
- [Auth API](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [API client](https://github.com/unla-investigacion-desarrollo/front-gestion-ppps-tfis/blob/main/src/services/apiClient.ts): `src/services/apiClient.ts`

### Other components

- **Users**
- **Management API**

## Connections

- Users → Route dispatch: open app (evidence: `src/routes/App.jsx`)
- Route dispatch → Login and registration: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → Role workspace: wraps pages (evidence: `src/routes/App.jsx`)
- Route dispatch → User administration: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → Project approvals: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → Project creation: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → Student deliveries: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → PPP proposals: routes to (evidence: `src/routes/App.jsx`)
- Route dispatch → PPP case detail: routes to (evidence: `src/routes/App.jsx`)
- Authentication → Auth async actions: dispatches login (evidence: `src/hooks/useAuth.jsx`)
- Auth async actions → Auth API: calls (evidence: `src/redux/features/auth/asyncActions.ts`)
- Auth API → Management API: HTTP requests (evidence: `src/services/authService.ts`)
- Role profile → User API: loads profile (evidence: `src/hooks/useUserProfile.ts`)
- Role workspace → Role profile: uses role data (evidence: `src/components/AuthenticatedLayout.jsx`)
- Role workspace → Role dashboards: shows workspace (evidence: `src/components/AuthenticatedLayout.jsx`)
- Role dashboards → Users: role dashboards (evidence: `README.md`)
- Users → Project exploration: explores projects (evidence: `README.md`)
- Project exploration → Explorer filtering: uses filters (evidence: `src/hooks/useProjectExplorer.ts`)
- Project exploration → Project API: loads projects (evidence: `src/hooks/useProjectExplorer.ts`)
- Project creation → Users: creates TFI (evidence: `README.md`)
- Teacher projects → Project table: renders (evidence: `src/pages/Teacher/TeacherProjectsList.tsx`)
- Teacher projects → Project API: loads projects (evidence: `src/pages/Teacher/TeacherProjectsList.tsx`)
- Teacher projects → Pagination: uses (evidence: `src/pages/Teacher/TeacherProjectsList.tsx`)
- Student deliveries → Student work API: loads work (evidence: `src/pages/Student/Deliveries.tsx`)
- Work review and tutoring → Student work API: refreshes work (evidence: `src/pages/Trabajo/Trabajo.tsx`)
- Work review and tutoring → Project state: refreshes projects (evidence: `src/pages/Trabajo/Trabajo.tsx`)
- Project approvals → Users: handles requests (evidence: `README.md`)
- PPP proposals → Users: supports applications (evidence: `README.md`)
- PPP proposals → PPP proposal state: proposal workflow (evidence: `src/hooks/usePPPProposals.ts`)
- PPP proposal state → PPP API: calls (evidence: `src/hooks/usePPPProposals.ts`)
- PPP proposal state → PPP state: uses state (evidence: `src/hooks/usePPPProposals.ts`)
- PPP applicants → PPP API: manages applicants
- PPP case detail → PPP API: loads case (evidence: `src/pages/PPP/PPPTramiteDetail.tsx`)
- PPP case list → PPP API: manages cases
- Student PPP case → PPP API: manages case
- Project state → Project API: calls (evidence: `src/redux/features/projects/index.ts`)
- PPP state → PPP API: dispatches actions (evidence: `src/redux/features/ppp/index.ts`)
- Project API → Management API: HTTP requests (evidence: `src/services/projectService.ts`)
- Student work API → Management API: HTTP requests (evidence: `src/services/studentWorkService.ts`)
- PPP API → Management API: HTTP requests (evidence: `src/services/pppService.ts`)
- User API → Management API: HTTP requests (evidence: `src/services/userService.ts`)
- Project API → API client: imports config (evidence: `src/services/projectService.ts`)
- PPP API → API client: imports parser (evidence: `src/services/pppService.ts`)
- Student work API → API client: imports config (evidence: `src/services/studentWorkService.ts`)
- User API → API client: imports config (evidence: `src/services/userService.ts`)
