# gonzalez-matias/agendaya architecture

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

- Interactive diagram: https://gitdiagram.com/gonzalez-matias/agendaya
- Repository: https://github.com/gonzalez-matias/agendaya

## Overview

AgendaYa is a professional appointment-booking and agenda-management system. Guests check availability and create bookings; administrators review reservations in calendar or list views and manage their status or schedule. The documented runtime separates HTTP routes, business services, repositories, and PostgreSQL. The graph includes the main UI, booking, availability, and management capabilities. Some subsystem links rely on the README’s layer description or SOURCE INDEX references; unsampled implementation details are not inferred.

Main entry points: [`src/app/agenda/page.tsx`](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/page.tsx) (Agenda page), [`src/services/visualizacion.ts`](https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/visualizacion.ts) (Agenda presentation), [`src/app/agenda/components/CalendarioMensual.tsx`](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioMensual.tsx) (Monthly calendar), [`src/app/agenda/components/CalendarioSemanal.tsx`](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioSemanal.tsx) (Weekly calendar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Guest booking"]
  node_booking_api["Booking endpoint<br/>[route.ts]"]
  node_availability_api["Availability endpoint<br/>[route.ts]"]
end

subgraph group_agenda["Admin agenda"]
  node_agenda_page["Agenda page<br/>[page.tsx]"]
  node_toolbar["Calendar toolbar"]
  node_month_calendar["Monthly calendar"]
  node_week_calendar["Weekly calendar"]
  node_reservation_list["Reservation list<br/>[ListaReservas.tsx]"]
  node_reservation_detail["Reservation detail<br/>[DetalleReserva.tsx]"]
  node_confirm_dialog["Confirmation dialog<br/>[ConfirmDialog.tsx]"]
  node_reschedule_modal["Reschedule modal<br/>[ReagendarModal.tsx]"]
  node_status_icon["Status icon<br/>[StatusIcon.tsx]"]
  node_filters["Agenda filters<br/>[FiltrosAgenda.tsx]"]
  node_status_filter["Status filtering<br/>[filtroEstado.ts]"]
  node_visual_api["Agenda endpoint<br/>[route.ts]"]
  node_admin_api["Administrator endpoint<br/>[route.ts]"]
end

subgraph group_business["Business services"]
  node_create_booking["Create booking<br/>[crearReserva.ts]"]
  node_availability["Availability rules<br/>[disponibilidad.ts]"]
  node_visual_service["Agenda presentation<br/>[visualizacion.ts]"]
end

subgraph group_data["Persistence"]
  node_availability_repo["Availability queries<br/>[disponibilidad.ts]"]
  node_booking_repo["Reservation queries<br/>[reserva.ts]"]
  node_visual_repo["Agenda queries<br/>[visualizacion.ts]"]
  node_database[("PostgreSQL")]
end

node_guest(("Guest"))
node_admin(("Administrator"))

node_guest -->|"submits booking"| node_booking_api
node_booking_api -->|"creates reservation"| node_create_booking
node_guest -->|"checks slots"| node_availability_api
node_availability_api -->|"requests slots"| node_availability
node_create_booking -->|"checks availability"| node_availability
node_create_booking -->|"creates reservation"| node_booking_repo
node_availability -->|"loads schedule data"| node_availability_repo
node_agenda_page -->|"renders"| node_toolbar
node_agenda_page -->|"renders"| node_month_calendar
node_agenda_page -->|"renders"| node_week_calendar
node_agenda_page -->|"renders"| node_reservation_list
node_agenda_page -->|"renders"| node_reservation_detail
node_agenda_page -->|"renders"| node_filters
node_agenda_page -->|"loads agenda data"| node_visual_service
node_filters -->|"uses status rules"| node_status_filter
node_month_calendar -->|"renders status"| node_status_icon
node_week_calendar -->|"renders status"| node_status_icon
node_reservation_detail -->|"uses dialog"| node_confirm_dialog
node_reservation_detail -->|"opens modal"| node_reschedule_modal
node_toolbar -->|"uses view logic"| node_visual_service
node_month_calendar -->|"uses view logic"| node_visual_service
node_week_calendar -->|"uses view logic"| node_visual_service
node_reservation_list -->|"uses view logic"| node_visual_service
node_visual_api -->|"loads reservations"| node_visual_service
node_visual_service -->|"queries reservations"| node_visual_repo
node_visual_api -->|"queries paginated view"| node_visual_repo
node_admin -->|"views agenda"| node_visual_api
node_admin -->|"lists administrators"| node_admin_api
node_admin_api -->|"reads administrators"| node_database
node_availability_repo -->|"reads schedule data"| node_database
node_booking_repo -->|"reads and writes bookings"| node_database
node_visual_repo -->|"reads reservations"| node_database

click node_booking_api "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/reservas/route.ts"
click node_availability_api "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/disponibilidad/route.ts"
click node_create_booking "https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/crearReserva.ts"
click node_availability "https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/disponibilidad.ts"
click node_availability_repo "https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/disponibilidad.ts"
click node_booking_repo "https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/reserva.ts"
click node_agenda_page "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/page.tsx"
click node_toolbar "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarToolbar.tsx"
click node_month_calendar "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioMensual.tsx"
click node_week_calendar "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioSemanal.tsx"
click node_reservation_list "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ListaReservas.tsx"
click node_reservation_detail "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/DetalleReserva.tsx"
click node_confirm_dialog "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ConfirmDialog.tsx"
click node_reschedule_modal "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ReagendarModal.tsx"
click node_status_icon "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/StatusIcon.tsx"
click node_filters "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/FiltrosAgenda.tsx"
click node_status_filter "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/filtroEstado.ts"
click node_visual_api "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/visualizacion/route.ts"
click node_visual_service "https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/visualizacion.ts"
click node_visual_repo "https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/visualizacion.ts"
click node_admin_api "https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/administradores/route.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_booking_api,node_availability_api toneBlue
class node_agenda_page,node_toolbar,node_month_calendar,node_week_calendar,node_reservation_list,node_reservation_detail,node_confirm_dialog,node_reschedule_modal,node_status_icon,node_filters,node_status_filter,node_visual_api,node_admin_api toneAmber
class node_create_booking,node_availability,node_visual_service toneMint
class node_availability_repo,node_booking_repo,node_visual_repo,node_database toneRose
class node_guest,node_admin toneIndigo
```

## Components

### Guest booking

- [Booking endpoint](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/reservas/route.ts): `src/app/api/reservas/route.ts`
- [Availability endpoint](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/disponibilidad/route.ts): `src/app/api/disponibilidad/route.ts`

### Admin agenda

- [Agenda page](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/page.tsx): `src/app/agenda/page.tsx`
- [Calendar toolbar](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarToolbar.tsx): `src/app/agenda/components/CalendarToolbar.tsx`
- [Monthly calendar](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioMensual.tsx): `src/app/agenda/components/CalendarioMensual.tsx`
- [Weekly calendar](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/CalendarioSemanal.tsx): `src/app/agenda/components/CalendarioSemanal.tsx`
- [Reservation list](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ListaReservas.tsx): `src/app/agenda/components/ListaReservas.tsx`
- [Reservation detail](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/DetalleReserva.tsx): `src/app/agenda/components/DetalleReserva.tsx`
- [Confirmation dialog](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ConfirmDialog.tsx): `src/app/agenda/components/ConfirmDialog.tsx`
- [Reschedule modal](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/ReagendarModal.tsx): `src/app/agenda/components/ReagendarModal.tsx`
- [Status icon](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/StatusIcon.tsx): `src/app/agenda/components/StatusIcon.tsx`
- [Agenda filters](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/components/FiltrosAgenda.tsx): `src/app/agenda/components/FiltrosAgenda.tsx`
- [Status filtering](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/agenda/filtroEstado.ts): `src/app/agenda/filtroEstado.ts`
- [Agenda endpoint](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/visualizacion/route.ts): `src/app/api/visualizacion/route.ts`
- [Administrator endpoint](https://github.com/gonzalez-matias/agendaya/blob/develop/src/app/api/administradores/route.ts): `src/app/api/administradores/route.ts`

### Business services

- [Create booking](https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/crearReserva.ts): `src/services/crearReserva.ts`
- [Availability rules](https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/disponibilidad.ts): `src/services/disponibilidad.ts`
- [Agenda presentation](https://github.com/gonzalez-matias/agendaya/blob/develop/src/services/visualizacion.ts): `src/services/visualizacion.ts`

### Persistence

- [Availability queries](https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/disponibilidad.ts): `src/repositories/disponibilidad.ts`
- [Reservation queries](https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/reserva.ts): `src/repositories/reserva.ts`
- [Agenda queries](https://github.com/gonzalez-matias/agendaya/blob/develop/src/repositories/visualizacion.ts): `src/repositories/visualizacion.ts`
- **PostgreSQL**

### Other components

- **Guest**
- **Administrator**

## Connections

- Guest → Booking endpoint: submits booking (evidence: `README.md`)
- Booking endpoint → Create booking: creates reservation (evidence: `src/app/api/reservas/route.ts`)
- Guest → Availability endpoint: checks slots (evidence: `README.md`)
- Availability endpoint → Availability rules: requests slots (evidence: `src/app/api/disponibilidad/route.ts`)
- Create booking → Availability rules: checks availability (evidence: `src/services/crearReserva.ts`)
- Create booking → Reservation queries: creates reservation (evidence: `src/services/crearReserva.ts`)
- Availability rules → Availability queries: loads schedule data (evidence: `src/services/disponibilidad.ts`)
- Agenda page → Calendar toolbar: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Monthly calendar: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Weekly calendar: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Reservation list: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Reservation detail: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Agenda filters: renders (evidence: `src/app/agenda/page.tsx`)
- Agenda page → Agenda presentation: loads agenda data (evidence: `src/app/agenda/page.tsx`)
- Agenda filters → Status filtering: uses status rules (evidence: `src/app/agenda/components/FiltrosAgenda.tsx`)
- Monthly calendar → Status icon: renders status (evidence: `src/app/agenda/components/CalendarioMensual.tsx`)
- Weekly calendar → Status icon: renders status (evidence: `src/app/agenda/components/CalendarioSemanal.tsx`)
- Reservation detail → Confirmation dialog: uses dialog (evidence: `src/app/agenda/components/DetalleReserva.tsx`)
- Reservation detail → Reschedule modal: opens modal (evidence: `src/app/agenda/components/DetalleReserva.tsx`)
- Calendar toolbar → Agenda presentation: uses view logic (evidence: `src/app/agenda/components/CalendarToolbar.tsx`)
- Monthly calendar → Agenda presentation: uses view logic (evidence: `src/app/agenda/components/CalendarioMensual.tsx`)
- Weekly calendar → Agenda presentation: uses view logic (evidence: `src/app/agenda/components/CalendarioSemanal.tsx`)
- Reservation list → Agenda presentation: uses view logic (evidence: `src/app/agenda/components/ListaReservas.tsx`)
- Agenda endpoint → Agenda presentation: loads reservations (evidence: `src/app/api/visualizacion/route.ts`)
- Agenda presentation → Agenda queries: queries reservations (evidence: `src/services/visualizacion.ts`)
- Agenda endpoint → Agenda queries: queries paginated view (evidence: `src/app/api/visualizacion/route.ts`)
- Administrator → Agenda endpoint: views agenda (evidence: `README.md`)
- Administrator → Administrator endpoint: lists administrators (evidence: `README.md`)
- Administrator endpoint → PostgreSQL: reads administrators (evidence: `src/app/api/administradores/route.ts`)
- Availability queries → PostgreSQL: reads schedule data (evidence: `README.md`)
- Reservation queries → PostgreSQL: reads and writes bookings (evidence: `README.md`)
- Agenda queries → PostgreSQL: reads reservations (evidence: `README.md`)
