# 100023804-uapa/sistema-integral-de-gestion-de-certificaciones architecture

> Architecture diagram of the GitHub repository 100023804-uapa/sistema-integral-de-gestion-de-certificaciones, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones
- Repository: https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones

## Overview

SIGCE is an academic certificate-management platform. Administrators manage certificate records and templates, then generate and issue certificates; students access their certificate history, while the public can verify certificates by QR/code. The tree and README establish these product capabilities, and sampled sources confirm selected authentication, template-rendering, generation, and persistence links. Many individual routes and use cases were not sampled, so the graph avoids asserting their internal call chains.

Main entry points: [`app/api/admin`](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/api/admin) (Admin APIs), [`lib/services/CertificateGenerationService.ts`](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/services/CertificateGenerationService.ts) (Certificate generation), [`app/api/auth/session/login/route.ts`](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/api/auth/session/login/route.ts) (Session login API), [`app/dashboard`](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/dashboard) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and portals"]
  node_login["Login UI<br/>[page.tsx]"]
  node_session["Session login API<br/>[route.ts]"]
  node_portal["Student portal<br/>[page.tsx]"]
  node_student_services["Student certificate services<br/>[studentPortal.ts]"]
  node_authz["Internal authorization<br/>[server.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin dashboard"]
  node_admin_api["Admin APIs"]
  node_template_ui["Template preview"]
end

subgraph group_certificates["Certificate lifecycle"]
  node_certificate_usecases["Certificate use cases"]
  node_template_usecases["Template use cases"]
  node_template_renderer["Template renderer"]
  node_generation["Certificate generation"]
  node_pdf["PDF generation"]
  node_verification["Public verification"]
end

subgraph group_platform["Persistence and services"]
  node_certificate_store[("Certificate repositories")]
  node_template_store[("Template repository")]
  node_composition["Dependency container<br/>[container.ts]"]
  node_firebase[("Firebase services<br/>[firebase.ts]")]
  node_upload[("PDF file storage<br/>[uploadthing.ts]")]
end

node_administrator(("Administrator"))
node_student(("Student"))
node_public(("Public verifier"))

node_administrator -->|"signs in"| node_login
node_login -.->|"creates session"| node_session
node_session -->|"resolves student access"| node_student_services
node_session -.->|"validates internal access"| node_authz
node_student -->|"opens portal"| node_portal
node_portal -->|"loads certificate access"| node_student_services
node_administrator -->|"manages records"| node_admin_ui
node_admin_ui -.->|"uses admin endpoints"| node_admin_api
node_admin_api -->|"checks authorization"| node_authz
node_admin_ui -.->|"previews templates"| node_template_ui
node_template_ui -->|"renders preview"| node_template_renderer
node_admin_api -.->|"manages templates"| node_template_usecases
node_admin_api -.->|"manages certificates"| node_certificate_usecases
node_template_usecases -.->|"persists templates"| node_template_store
node_certificate_usecases -.->|"persists certificates"| node_certificate_store
node_composition -->|"provides repository"| node_template_store
node_composition -->|"provides repository"| node_certificate_store
node_template_store -->|"reads and writes"| node_firebase
node_generation -->|"generates PDF"| node_pdf
node_generation -->|"uploads PDF"| node_upload
node_generation -->|"gets certificate repository"| node_composition
node_public -->|"checks certificate"| node_verification
node_student -->|"downloads history"| node_student_services

click node_login "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/login/page.tsx"
click node_session "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/api/auth/session/login/route.ts"
click node_portal "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/student/page.tsx"
click node_student_services "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/server/studentPortal.ts"
click node_admin_ui "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/dashboard"
click node_admin_api "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/api/admin"
click node_authz "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/auth/server.ts"
click node_certificate_usecases "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/lib/application/use-cases"
click node_template_usecases "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/lib/usecases/certificateTemplate"
click node_template_ui "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/components/dashboard/templates/TemplateRuntimePreview.tsx"
click node_template_renderer "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/application/utils/certificate-template-renderer.ts"
click node_generation "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/services/CertificateGenerationService.ts"
click node_pdf "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/services/PDFGenerationService.ts"
click node_verification "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/verify"
click node_certificate_store "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/infrastructure/repositories/FirebaseCertificateRepository.ts"
click node_template_store "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/infrastructure/repositories/FirebaseCertificateTemplateRepository.ts"
click node_composition "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/container.ts"
click node_firebase "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/firebase.ts"
click node_upload "https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/server/uploadthing.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_login,node_session,node_portal,node_student_services,node_authz toneBlue
class node_admin_ui,node_admin_api,node_template_ui toneAmber
class node_certificate_usecases,node_template_usecases,node_template_renderer,node_generation,node_pdf,node_verification toneMint
class node_certificate_store,node_template_store,node_composition,node_firebase,node_upload toneRose
class node_administrator,node_student,node_public toneIndigo
```

## Components

### Access and portals

- [Login UI](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Session login API](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/api/auth/session/login/route.ts): `app/api/auth/session/login/route.ts`
- [Student portal](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/app/student/page.tsx): `app/student/page.tsx`
- [Student certificate services](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/server/studentPortal.ts): `lib/server/studentPortal.ts`
- [Internal authorization](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/auth/server.ts): `lib/auth/server.ts`

### Administration

- [Admin dashboard](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/dashboard): `app/dashboard`
- [Admin APIs](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/api/admin): `app/api/admin`
- [Template preview](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/components/dashboard/templates/TemplateRuntimePreview.tsx): `components/dashboard/templates/TemplateRuntimePreview.tsx`

### Certificate lifecycle

- [Certificate use cases](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/lib/application/use-cases): `lib/application/use-cases`
- [Template use cases](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/lib/usecases/certificateTemplate): `lib/usecases/certificateTemplate`
- [Template renderer](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/application/utils/certificate-template-renderer.ts): `lib/application/utils/certificate-template-renderer.ts`
- [Certificate generation](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/services/CertificateGenerationService.ts): `lib/services/CertificateGenerationService.ts`
- [PDF generation](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/services/PDFGenerationService.ts): `lib/services/PDFGenerationService.ts`
- [Public verification](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/tree/main/app/verify): `app/verify`

### Persistence and services

- [Certificate repositories](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/infrastructure/repositories/FirebaseCertificateRepository.ts): `lib/infrastructure/repositories/FirebaseCertificateRepository.ts`
- [Template repository](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/infrastructure/repositories/FirebaseCertificateTemplateRepository.ts): `lib/infrastructure/repositories/FirebaseCertificateTemplateRepository.ts`
- [Dependency container](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/container.ts): `lib/container.ts`
- [Firebase services](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/firebase.ts): `lib/firebase.ts`
- [PDF file storage](https://github.com/100023804-uapa/sistema-integral-de-gestion-de-certificaciones/blob/main/lib/server/uploadthing.ts): `lib/server/uploadthing.ts`

### Other components

- **Administrator**
- **Student**
- **Public verifier**

## Connections

- Administrator → Login UI: signs in (evidence: `app/login/page.tsx`)
- Login UI → Session login API: creates session
- Session login API → Student certificate services: resolves student access (evidence: `app/api/auth/session/login/route.ts`)
- Session login API → Internal authorization: validates internal access
- Student → Student portal: opens portal
- Student portal → Student certificate services: loads certificate access (evidence: `app/student/page.tsx`)
- Administrator → Admin dashboard: manages records
- Admin dashboard → Admin APIs: uses admin endpoints
- Admin APIs → Internal authorization: checks authorization (evidence: `lib/auth/server.ts`)
- Admin dashboard → Template preview: previews templates
- Template preview → Template renderer: renders preview (evidence: `components/dashboard/templates/TemplateRuntimePreview.tsx`)
- Admin APIs → Template use cases: manages templates
- Admin APIs → Certificate use cases: manages certificates
- Template use cases → Template repository: persists templates
- Certificate use cases → Certificate repositories: persists certificates
- Dependency container → Template repository: provides repository (evidence: `lib/container.ts`)
- Dependency container → Certificate repositories: provides repository (evidence: `lib/container.ts`)
- Template repository → Firebase services: reads and writes (evidence: `lib/infrastructure/repositories/FirebaseCertificateTemplateRepository.ts`)
- Certificate generation → PDF generation: generates PDF (evidence: `lib/services/CertificateGenerationService.ts`)
- Certificate generation → PDF file storage: uploads PDF (evidence: `lib/services/CertificateGenerationService.ts`)
- Certificate generation → Dependency container: gets certificate repository (evidence: `lib/services/CertificateGenerationService.ts`)
- Public verifier → Public verification: checks certificate
- Student → Student certificate services: downloads history
