# armindevelopertec-max/sitbt architecture

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

- Interactive diagram: https://gitdiagram.com/armindevelopertec-max/sitbt
- Repository: https://github.com/armindevelopertec-max/sitbt

## Overview

This repository implements an academic-institution management system: staff and students use a web portal backed by a NestJS API. Its domain spans admissions, student records, academic planning and enrollment, grades, payments, and issued documents, with access control and file storage supporting those workflows. The source excerpts confirm several controller-to-service calls and service dependencies; other major features are represented from the file tree, but their internal connections are not inferred. The README is empty, and frontend-to-API wiring was not shown.

Main entry points: [`backend/src/modules/auth/auth.service.ts`](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/auth/auth.service.ts) (Authentication), [`backend/src/modules/enrollments/enrollments.controller.ts`](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.controller.ts) (Enrollments), [`backend/src/modules/enrollments/enrollments.service.ts`](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.service.ts) (Enrollment service), [`backend/src/modules/storage/storage.service.ts`](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/storage/storage.service.ts) (Storage service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and users"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_guard["JWT guard<br/>[jwt-auth.guard.ts]"]
  node_accounts["Users and roles"]
end

subgraph group_academic["Academic lifecycle"]
  node_admission["Admissions"]
  node_students["Student records"]
  node_careers["Careers"]
  node_plans["Study plans"]
  node_terms["Academic periods"]
  node_enrollments["Enrollments"]
  node_grades["Grades"]
  node_convalidations["Convalidations"]
  node_enrollment_service["Enrollment service"]
  node_enrollment_entity["Enrollment entity"]
  node_term_service["Period service"]
  node_plan_service["Study plan service"]
  node_grade_service["Grade service<br/>[grades.service.ts]"]
  node_convalidation_service["Convalidation service"]
end

subgraph group_operations["Institution operations"]
  node_payments["Payments"]
  node_certificates["Certificates"]
  node_documents["Issued documents"]
  node_consent["Consent records"]
  node_audit["Audit"]
  node_storage["File storage"]
  node_document_service["Document service"]
  node_storage_service["Storage service<br/>[storage.service.ts]"]
end

subgraph group_portal["Web portal"]
  node_web["Web experience"]
end

node_user(("User"))
node_minio[("MinIO")]

node_user -.->|"uses"| node_web
node_web -.->|"requests login"| node_auth
node_auth -.->|"issues JWT"| node_guard
node_auth -->|"checks accounts"| node_accounts
node_enrollments -->|"guards routes"| node_guard
node_enrollments -->|"delegates to"| node_enrollment_service
node_enrollment_service -->|"reads and writes"| node_enrollment_entity
node_terms -->|"delegates to"| node_term_service
node_plans -->|"delegates to"| node_plan_service
node_grades -->|"delegates to"| node_grade_service
node_convalidations -->|"delegates to"| node_convalidation_service
node_documents -->|"delegates to"| node_document_service
node_storage -->|"delegates to"| node_storage_service
node_storage_service -->|"stores files"| node_minio

click node_web "https://github.com/armindevelopertec-max/sitbt/tree/main/frontend/src/app"
click node_auth "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/auth/auth.service.ts"
click node_guard "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/auth/jwt-auth.guard.ts"
click node_accounts "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/users"
click node_admission "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/admission"
click node_students "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/students"
click node_careers "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/careers"
click node_plans "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/study-plans/study-plans.controller.ts"
click node_terms "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/gestiones/gestiones.controller.ts"
click node_enrollments "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.controller.ts"
click node_grades "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/grades/grades.controller.ts"
click node_convalidations "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/convalidations/convalidations.controller.ts"
click node_payments "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/payments"
click node_certificates "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/certificates"
click node_documents "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/documents/documents.controller.ts"
click node_consent "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/consent"
click node_audit "https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/audit"
click node_storage "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/storage/storage.controller.ts"
click node_enrollment_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.service.ts"
click node_enrollment_entity "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/entities/inscripcion.entity.ts"
click node_term_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/gestiones/gestiones.service.ts"
click node_plan_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/study-plans/study-plans.service.ts"
click node_grade_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/grades/grades.service.ts"
click node_convalidation_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/convalidations/convalidations.service.ts"
click node_document_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/documents/documents.service.ts"
click node_storage_service "https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/storage/storage.service.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_auth,node_guard,node_accounts,node_user toneBlue
class node_admission,node_students,node_careers,node_plans,node_terms,node_enrollments,node_grades,node_convalidations,node_enrollment_service,node_enrollment_entity,node_term_service,node_plan_service,node_grade_service,node_convalidation_service,node_minio toneAmber
class node_payments,node_certificates,node_documents,node_consent,node_audit,node_storage,node_document_service,node_storage_service toneMint
class node_web toneRose
```

## Components

### Access and users

- [Authentication](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [JWT guard](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/auth/jwt-auth.guard.ts): `backend/src/modules/auth/jwt-auth.guard.ts`
- [Users and roles](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/users): `backend/src/modules/users`

### Academic lifecycle

- [Admissions](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/admission): `backend/src/modules/admission`
- [Student records](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/students): `backend/src/modules/students`
- [Careers](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/careers): `backend/src/modules/careers`
- [Study plans](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/study-plans/study-plans.controller.ts): `backend/src/modules/study-plans/study-plans.controller.ts`
- [Academic periods](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/gestiones/gestiones.controller.ts): `backend/src/modules/gestiones/gestiones.controller.ts`
- [Enrollments](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.controller.ts): `backend/src/modules/enrollments/enrollments.controller.ts`
- [Grades](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/grades/grades.controller.ts): `backend/src/modules/grades/grades.controller.ts`
- [Convalidations](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/convalidations/convalidations.controller.ts): `backend/src/modules/convalidations/convalidations.controller.ts`
- [Enrollment service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/enrollments/enrollments.service.ts): `backend/src/modules/enrollments/enrollments.service.ts`
- [Enrollment entity](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/entities/inscripcion.entity.ts): entity · `backend/src/entities/inscripcion.entity.ts`
- [Period service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/gestiones/gestiones.service.ts): `backend/src/modules/gestiones/gestiones.service.ts`
- [Study plan service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/study-plans/study-plans.service.ts): `backend/src/modules/study-plans/study-plans.service.ts`
- [Grade service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/grades/grades.service.ts): `backend/src/modules/grades/grades.service.ts`
- [Convalidation service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/convalidations/convalidations.service.ts): `backend/src/modules/convalidations/convalidations.service.ts`

### Institution operations

- [Payments](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/payments): `backend/src/modules/payments`
- [Certificates](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/certificates): `backend/src/modules/certificates`
- [Issued documents](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/documents/documents.controller.ts): `backend/src/modules/documents/documents.controller.ts`
- [Consent records](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/consent): `backend/src/modules/consent`
- [Audit](https://github.com/armindevelopertec-max/sitbt/tree/main/backend/src/modules/audit): `backend/src/modules/audit`
- [File storage](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/storage/storage.controller.ts): `backend/src/modules/storage/storage.controller.ts`
- [Document service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/documents/documents.service.ts): `backend/src/modules/documents/documents.service.ts`
- [Storage service](https://github.com/armindevelopertec-max/sitbt/blob/main/backend/src/modules/storage/storage.service.ts): `backend/src/modules/storage/storage.service.ts`

### Web portal

- [Web experience](https://github.com/armindevelopertec-max/sitbt/tree/main/frontend/src/app): `frontend/src/app`

### Other components

- **User**
- **MinIO**

## Connections

- User → Web experience: uses
- Web experience → Authentication: requests login
- Authentication → JWT guard: issues JWT
- Authentication → Users and roles: checks accounts (evidence: `backend/src/modules/auth/auth.service.ts`)
- Enrollments → JWT guard: guards routes (evidence: `backend/src/modules/enrollments/enrollments.controller.ts`)
- Enrollments → Enrollment service: delegates to (evidence: `backend/src/modules/enrollments/enrollments.controller.ts`)
- Enrollment service → Enrollment entity: reads and writes (evidence: `backend/src/modules/enrollments/enrollments.service.ts`)
- Academic periods → Period service: delegates to (evidence: `backend/src/modules/gestiones/gestiones.controller.ts`)
- Study plans → Study plan service: delegates to (evidence: `backend/src/modules/study-plans/study-plans.controller.ts`)
- Grades → Grade service: delegates to (evidence: `backend/src/modules/grades/grades.controller.ts`)
- Convalidations → Convalidation service: delegates to (evidence: `backend/src/modules/convalidations/convalidations.controller.ts`)
- Issued documents → Document service: delegates to (evidence: `backend/src/modules/documents/documents.controller.ts`)
- File storage → Storage service: delegates to (evidence: `backend/src/modules/storage/storage.controller.ts`)
- Storage service → MinIO: stores files (evidence: `backend/src/modules/storage/storage.service.ts`)
