# zumaetaadriel2/asistencia-misa-pastoral architecture

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

- Interactive diagram: https://gitdiagram.com/zumaetaadriel2/asistencia-misa-pastoral
- Repository: https://github.com/zumaetaadriel2/asistencia-misa-pastoral

## Overview

Asistencia Misa Pastoral es una PWA para registrar asistencia semanal a misa y gestionar catequesis. El flujo principal va del código personal del alumno a la identificación y envío de una foto; después, guías revisan y validan o rechazan el envío, y administradores gestionan alumnos, ciclos, comunidades, staff y reportes. También incluye control de asistencia a sesiones de catequesis, consulta de misas y avisos. Las relaciones se basan en README y referencias del índice de fuentes; varias implementaciones no fueron muestreadas.

Main entry points: [`lib/supabase/client.ts`](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/supabase/client.ts) (Cliente Supabase), [`components/admin/panel-administracion.tsx`](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/admin/panel-administracion.tsx) (Administración), [`components/alumno/envio-foto.tsx`](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/envio-foto.tsx) (Envío de foto), [`components/dashboard/panel-revision.tsx`](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/dashboard/panel-revision.tsx) (Cola de revisión)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Asistencia del alumno"]
  node_code_entry["Ingreso de código<br/>[ingreso-codigo.tsx]"]
  node_student_page["Flujo alumno<br/>[page.tsx]"]
  node_student_panel["Panel alumno<br/>[panel-alumno.tsx]"]
  node_photo_upload_ui["Envío de foto<br/>[envio-foto.tsx]"]
end

subgraph group_staff["Operación del staff"]
  node_review_panel["Cola de revisión<br/>[panel-revision.tsx]"]
  node_review_logic["Revisión asistencia<br/>[revision.ts]"]
  node_staff_frame["Acceso staff<br/>[marco-staff.tsx]"]
  node_community_view["Mi comunidad"]
  node_attendance_matrix["Matriz asistencia"]
  node_catechesis_view["Vista catequesis"]
  node_catechesis_roll["Pasar lista<br/>[pasar-lista.tsx]"]
  node_catechesis_logic["Sesiones y marcas<br/>[catequesis.ts]"]
end

subgraph group_admin["Gestión pastoral"]
  node_admin_panel["Administración"]
  node_admin_mass["Gestión de misas<br/>[seccion-misas.tsx]"]
  node_mass_import["Importación de misas<br/>[importacion.ts]"]
  node_mass_public["Consulta de misas<br/>[pagina-misas.tsx]"]
  node_reports["Reportes<br/>[reporte.ts]"]
end

subgraph group_platform["Servicios de plataforma"]
  node_photo_upload_lib["Carga de foto<br/>[subir.ts]"]
  node_photo_function["Recepción de foto<br/>[index.ts]"]
  node_photo_storage[("Fotos privadas")]
  node_supabase_client["Cliente Supabase<br/>[client.ts]"]
  node_database[("Base de datos")]
  node_login["Acceso Google<br/>[page.tsx]"]
  node_push["Avisos push<br/>[avisos.ts]"]
  node_push_function["Envío de avisos<br/>[index.ts]"]
end

node_student(("Alumno"))
node_staff_actor(("Guía y catequista"))
node_mass_actor(("Visitante"))

node_student -->|"ingresa código"| node_code_entry
node_code_entry -->|"entrega código"| node_student_page
node_student_page -->|"muestra estado"| node_student_panel
node_student_panel -->|"inicia envío"| node_photo_upload_ui
node_photo_upload_ui -->|"solicita carga"| node_photo_upload_lib
node_photo_upload_lib -->|"usa cliente"| node_supabase_client
node_photo_upload_ui -.->|"solicita carga"| node_photo_function
node_photo_function -.->|"guarda foto"| node_photo_storage
node_staff_actor -->|"inicia sesión"| node_login
node_login -->|"autentica"| node_supabase_client
node_staff_actor -->|"revisa envíos"| node_review_panel
node_review_panel -->|"obtiene cola"| node_review_logic
node_review_logic -->|"consulta RPC"| node_supabase_client
node_review_panel -.->|"muestra foto"| node_photo_storage
node_staff_actor -->|"consulta comunidad"| node_community_view
node_community_view -->|"muestra asistencia"| node_attendance_matrix
node_staff_actor -->|"gestiona sesiones"| node_catechesis_view
node_catechesis_view -->|"abre lista"| node_catechesis_roll
node_catechesis_roll -->|"marca asistencia"| node_catechesis_logic
node_catechesis_logic -->|"consulta RPC"| node_supabase_client
node_staff_actor -->|"administra sistema"| node_admin_panel
node_admin_panel -->|"gestiona misas"| node_admin_mass
node_admin_mass -->|"valida importación"| node_mass_import
node_mass_import -.->|"prepara datos"| node_database
node_mass_actor -->|"consulta horarios"| node_mass_public
node_admin_panel -.->|"genera reportes"| node_reports
node_staff_frame -->|"gestiona avisos"| node_push
node_push_function -.->|"notifica envíos"| node_photo_storage
node_supabase_client -->|"consulta datos"| node_database
node_admin_panel -.->|"gestiona registros"| node_database

click node_code_entry "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/ingreso-codigo.tsx"
click node_student_page "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/app/alumno/page.tsx"
click node_student_panel "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/panel-alumno.tsx"
click node_photo_upload_ui "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/envio-foto.tsx"
click node_photo_upload_lib "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/fotos/subir.ts"
click node_photo_function "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/supabase/functions/subir-foto/index.ts"
click node_review_panel "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/dashboard/panel-revision.tsx"
click node_review_logic "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/revision.ts"
click node_staff_frame "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/dashboard/marco-staff.tsx"
click node_community_view "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/comunidad/vista-comunidad.tsx"
click node_attendance_matrix "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/comunidad/matriz-asistencia.tsx"
click node_catechesis_view "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/catequesis/vista-catequesis.tsx"
click node_catechesis_roll "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/catequesis/pasar-lista.tsx"
click node_catechesis_logic "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/catequesis.ts"
click node_admin_panel "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/admin/panel-administracion.tsx"
click node_admin_mass "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/admin/seccion-misas.tsx"
click node_mass_import "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/misas/importacion.ts"
click node_mass_public "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/misas/pagina-misas.tsx"
click node_reports "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/reporte.ts"
click node_supabase_client "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/supabase/client.ts"
click node_login "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/app/login/page.tsx"
click node_push "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/push/avisos.ts"
click node_push_function "https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/supabase/functions/enviar-avisos/index.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_code_entry,node_student_page,node_student_panel,node_photo_upload_ui toneBlue
class node_review_panel,node_review_logic,node_staff_frame,node_community_view,node_attendance_matrix,node_catechesis_view,node_catechesis_roll,node_catechesis_logic toneAmber
class node_admin_panel,node_admin_mass,node_mass_import,node_mass_public,node_reports toneMint
class node_photo_upload_lib,node_photo_function,node_photo_storage,node_supabase_client,node_database,node_login,node_push,node_push_function toneRose
class node_student,node_staff_actor,node_mass_actor toneIndigo
```

## Components

### Asistencia del alumno

- [Ingreso de código](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/ingreso-codigo.tsx): `components/alumno/ingreso-codigo.tsx`
- [Flujo alumno](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/app/alumno/page.tsx): `app/alumno/page.tsx`
- [Panel alumno](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/panel-alumno.tsx): `components/alumno/panel-alumno.tsx`
- [Envío de foto](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/alumno/envio-foto.tsx): `components/alumno/envio-foto.tsx`

### Operación del staff

- [Cola de revisión](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/dashboard/panel-revision.tsx): `components/dashboard/panel-revision.tsx`
- [Revisión asistencia](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/revision.ts): `lib/staff/revision.ts`
- [Acceso staff](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/dashboard/marco-staff.tsx): `components/dashboard/marco-staff.tsx`
- [Mi comunidad](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/comunidad/vista-comunidad.tsx): `components/comunidad/vista-comunidad.tsx`
- [Matriz asistencia](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/comunidad/matriz-asistencia.tsx): `components/comunidad/matriz-asistencia.tsx`
- [Vista catequesis](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/catequesis/vista-catequesis.tsx): `components/catequesis/vista-catequesis.tsx`
- [Pasar lista](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/catequesis/pasar-lista.tsx): `components/catequesis/pasar-lista.tsx`
- [Sesiones y marcas](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/catequesis.ts): `lib/staff/catequesis.ts`

### Gestión pastoral

- [Administración](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/admin/panel-administracion.tsx): `components/admin/panel-administracion.tsx`
- [Gestión de misas](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/admin/seccion-misas.tsx): `components/admin/seccion-misas.tsx`
- [Importación de misas](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/misas/importacion.ts): `lib/misas/importacion.ts`
- [Consulta de misas](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/components/misas/pagina-misas.tsx): `components/misas/pagina-misas.tsx`
- [Reportes](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/staff/reporte.ts): `lib/staff/reporte.ts`

### Servicios de plataforma

- [Carga de foto](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/fotos/subir.ts): `lib/fotos/subir.ts`
- [Recepción de foto](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/supabase/functions/subir-foto/index.ts): `supabase/functions/subir-foto/index.ts`
- **Fotos privadas**
- [Cliente Supabase](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/supabase/client.ts): `lib/supabase/client.ts`
- **Base de datos**
- [Acceso Google](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/app/login/page.tsx): `app/login/page.tsx`
- [Avisos push](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/lib/push/avisos.ts): `lib/push/avisos.ts`
- [Envío de avisos](https://github.com/zumaetaadriel2/asistencia-misa-pastoral/blob/develop/supabase/functions/enviar-avisos/index.ts): `supabase/functions/enviar-avisos/index.ts`

### Other components

- **Alumno**
- **Guía y catequista**
- **Visitante**

## Connections

- Alumno → Ingreso de código: ingresa código
- Ingreso de código → Flujo alumno: entrega código (evidence: `app/alumno/page.tsx`)
- Flujo alumno → Panel alumno: muestra estado (evidence: `app/alumno/page.tsx`)
- Panel alumno → Envío de foto: inicia envío
- Envío de foto → Carga de foto: solicita carga (evidence: `components/alumno/envio-foto.tsx`)
- Carga de foto → Cliente Supabase: usa cliente (evidence: `lib/fotos/subir.ts`)
- Envío de foto → Recepción de foto: solicita carga
- Recepción de foto → Fotos privadas: guarda foto
- Guía y catequista → Acceso Google: inicia sesión
- Acceso Google → Cliente Supabase: autentica (evidence: `app/login/page.tsx`)
- Guía y catequista → Cola de revisión: revisa envíos
- Cola de revisión → Revisión asistencia: obtiene cola (evidence: `components/dashboard/panel-revision.tsx`)
- Revisión asistencia → Cliente Supabase: consulta RPC (evidence: `lib/staff/revision.ts`)
- Cola de revisión → Fotos privadas: muestra foto
- Guía y catequista → Mi comunidad: consulta comunidad
- Mi comunidad → Matriz asistencia: muestra asistencia
- Guía y catequista → Vista catequesis: gestiona sesiones
- Vista catequesis → Pasar lista: abre lista
- Pasar lista → Sesiones y marcas: marca asistencia (evidence: `components/catequesis/pasar-lista.tsx`)
- Sesiones y marcas → Cliente Supabase: consulta RPC (evidence: `lib/staff/catequesis.ts`)
- Guía y catequista → Administración: administra sistema
- Administración → Gestión de misas: gestiona misas
- Gestión de misas → Importación de misas: valida importación (evidence: `components/admin/seccion-misas.tsx`)
- Importación de misas → Base de datos: prepara datos
- Visitante → Consulta de misas: consulta horarios
- Administración → Reportes: genera reportes
- Acceso staff → Avisos push: gestiona avisos (evidence: `components/dashboard/marco-staff.tsx`)
- Envío de avisos → Fotos privadas: notifica envíos
- Cliente Supabase → Base de datos: consulta datos (evidence: `lib/supabase/client.ts`)
- Administración → Base de datos: gestiona registros
