# luarsel2/poo-proyect architecture

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

- Interactive diagram: https://gitdiagram.com/luarsel2/poo-proyect
- Repository: https://github.com/luarsel2/poo-proyect

## Overview

This is a Spring-based university academic portal for administering students, staff, academic offerings and enrollment, with a static browser interface and CSV-backed records. The principal workflow is a user request reaching a REST controller, which resolves related academic records, updates in-memory models and persists changes. The excerpts show login and parts of student, section and enrollment handling; other controller capabilities are represented from the source index. Frontend-to-API wiring and unsampled controller behavior are not asserted.

Main entry points: [`Proyect/src/main/java/com/uvg/pooproyect/persistencia/CsvUtil.java`](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/persistencia/CsvUtil.java) (CSV persistence), [`Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java) (Enrollment), [`Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java`](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java) (Sections and schedules), [`Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java`](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java) (Student records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Portal interface"]
  node_browser["Static portal"]
  node_browser_js["Browser scripts"]
  node_auth_ui["Login interface<br/>[login.html]"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Authentication API"]
  node_auth_filter["Session filter<br/>[AuthFilter.java]"]
end

subgraph group_academics["Academic operations"]
  node_students["Student records"]
  node_enrollment["Enrollment"]
  node_sections["Sections and schedules"]
  node_periods["Academic periods"]
  node_courses["Courses"]
  node_faculty["Faculties and departments"]
  node_careers["Careers and plans"]
  node_professors["Professor records"]
  node_administration["Administration staff"]
end

subgraph group_records["Domain and persistence"]
  node_requests["Request DTOs<br/>[Requests.java]"]
  node_models["Academic domain models"]
  node_csv[("CSV persistence<br/>[CsvUtil.java]")]
end

node_user(("Portal user"))

node_user -->|"opens login"| node_auth_ui
node_user -->|"uses portal"| node_browser
node_auth_ui -.->|"submits credentials"| node_auth_controller
node_auth_controller -->|"looks up student"| node_students
node_auth_filter -.->|"checks session"| node_auth_controller
node_students -->|"loads and saves"| node_csv
node_students -->|"creates students"| node_models
node_enrollment -->|"resolves student"| node_students
node_enrollment -->|"resolves period"| node_periods
node_enrollment -->|"resolves section"| node_sections
node_enrollment -->|"builds enrollment"| node_models
node_enrollment -->|"loads and saves"| node_csv
node_sections -->|"resolves professor"| node_professors
node_sections -->|"updates section"| node_models
node_sections -->|"loads and saves"| node_csv
node_careers -->|"resolves courses"| node_courses
node_faculty -->|"uses career lookup"| node_careers
node_courses -->|"persists records"| node_csv
node_periods -->|"persists records"| node_csv
node_professors -->|"persists records"| node_csv
node_administration -->|"persists records"| node_csv

click node_browser "https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/resources/static"
click node_browser_js "https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/resources/static/js"
click node_auth_ui "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/resources/static/login.html"
click node_auth_controller "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/auth/AuthController.java"
click node_auth_filter "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/auth/AuthFilter.java"
click node_students "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java"
click node_enrollment "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java"
click node_sections "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java"
click node_periods "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/PeriodoController.java"
click node_courses "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/CursoController.java"
click node_faculty "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/FacultadController.java"
click node_careers "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/CarreraController.java"
click node_professors "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/ProfesorController.java"
click node_administration "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/AdministracionController.java"
click node_requests "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/dto/Requests.java"
click node_models "https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/java/com/uvg/pooproyect/model"
click node_csv "https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/persistencia/CsvUtil.java"

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_browser,node_browser_js,node_auth_ui,node_user toneBlue
class node_auth_controller,node_auth_filter toneAmber
class node_students,node_enrollment,node_sections,node_periods,node_courses,node_faculty,node_careers,node_professors,node_administration toneMint
class node_requests,node_models,node_csv toneRose
```

## Components

### Portal interface

- [Static portal](https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/resources/static): `Proyect/src/main/resources/static`
- [Browser scripts](https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/resources/static/js): `Proyect/src/main/resources/static/js`
- [Login interface](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/resources/static/login.html): `Proyect/src/main/resources/static/login.html`

### Identity and access

- [Authentication API](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/auth/AuthController.java): `Proyect/src/main/java/com/uvg/pooproyect/auth/AuthController.java`
- [Session filter](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/auth/AuthFilter.java): `Proyect/src/main/java/com/uvg/pooproyect/auth/AuthFilter.java`

### Academic operations

- [Student records](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java`
- [Enrollment](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`
- [Sections and schedules](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java`
- [Academic periods](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/PeriodoController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/PeriodoController.java`
- [Courses](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/CursoController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/CursoController.java`
- [Faculties and departments](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/FacultadController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/FacultadController.java`
- [Careers and plans](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/CarreraController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/CarreraController.java`
- [Professor records](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/ProfesorController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/ProfesorController.java`
- [Administration staff](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/controller/AdministracionController.java): `Proyect/src/main/java/com/uvg/pooproyect/controller/AdministracionController.java`

### Domain and persistence

- [Request DTOs](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/dto/Requests.java): `Proyect/src/main/java/com/uvg/pooproyect/dto/Requests.java`
- [Academic domain models](https://github.com/luarsel2/poo-proyect/tree/main/Proyect/src/main/java/com/uvg/pooproyect/model): `Proyect/src/main/java/com/uvg/pooproyect/model`
- [CSV persistence](https://github.com/luarsel2/poo-proyect/blob/main/Proyect/src/main/java/com/uvg/pooproyect/persistencia/CsvUtil.java): `Proyect/src/main/java/com/uvg/pooproyect/persistencia/CsvUtil.java`

### Other components

- **Portal user**

## Connections

- Portal user → Login interface: opens login
- Portal user → Static portal: uses portal
- Login interface → Authentication API: submits credentials
- Authentication API → Student records: looks up student (evidence: `Proyect/src/main/java/com/uvg/pooproyect/auth/AuthController.java`)
- Session filter → Authentication API: checks session (evidence: `Proyect/src/main/java/com/uvg/pooproyect/auth/AuthFilter.java`)
- Student records → CSV persistence: loads and saves (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java`)
- Student records → Academic domain models: creates students (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/EstudianteController.java`)
- Enrollment → Student records: resolves student (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`)
- Enrollment → Academic periods: resolves period (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`)
- Enrollment → Sections and schedules: resolves section (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`)
- Enrollment → Academic domain models: builds enrollment (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`)
- Enrollment → CSV persistence: loads and saves (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/InscripcionController.java`)
- Sections and schedules → Professor records: resolves professor (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java`)
- Sections and schedules → Academic domain models: updates section (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java`)
- Sections and schedules → CSV persistence: loads and saves (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/SeccionController.java`)
- Careers and plans → Courses: resolves courses (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/CarreraController.java`)
- Faculties and departments → Careers and plans: uses career lookup (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/FacultadController.java`)
- Courses → CSV persistence: persists records (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/CursoController.java`)
- Academic periods → CSV persistence: persists records (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/PeriodoController.java`)
- Professor records → CSV persistence: persists records (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/ProfesorController.java`)
- Administration staff → CSV persistence: persists records (evidence: `Proyect/src/main/java/com/uvg/pooproyect/controller/AdministracionController.java`)
