# pablofls/merp architecture

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

- Interactive diagram: https://gitdiagram.com/pablofls/merp
- Repository: https://github.com/pablofls/merp

## Overview

Es una aplicación web de organización personal y escolar: usuarios administran pendientes, clases y fechas importantes, hábitos y categorías personales; la interfaz obtiene y actualiza esos datos mediante hooks con caché y Supabase. Google Calendar y Google Tasks amplían la planificación, y la app incluye vinculación de cuenta mediante OAuth. El índice permite trazar páginas hacia varios hooks y componentes; las conexiones no visibles entre la interfaz y algunas integraciones se omiten.

Main entry points: [`src/features/home/hooks/usePendientes.ts`](https://github.com/pablofls/merp/blob/main/src/features/home/hooks/usePendientes.ts) (Gestión de pendientes), [`src/app/personal/page.tsx`](https://github.com/pablofls/merp/blob/main/src/app/personal/page.tsx) (Vista personal), [`src/app/escolar/page.tsx`](https://github.com/pablofls/merp/blob/main/src/app/escolar/page.tsx) (Vista escolar), [`src/features/escolar/hooks/useClases.ts`](https://github.com/pablofls/merp/blob/main/src/features/escolar/hooks/useClases.ts) (Clases y horario)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Acceso y datos"]
  node_login["Inicio de sesión<br/>[page.tsx]"]
  node_auth["Estado de sesión<br/>[AuthContext.tsx]"]
  node_cache["Caché de listas<br/>[useCachedList.ts]"]
  node_supabase[("Supabase")]
end

subgraph group_tasks["Pendientes y organización"]
  node_personal_page["Vista personal<br/>[page.tsx]"]
  node_pending_hook["Gestión de pendientes<br/>[usePendientes.ts]"]
  node_pending_views["Vistas de pendientes"]
  node_pending_form["Formulario de pendiente<br/>[FormPendiente.tsx]"]
  node_categories["Categorías personales<br/>[useCategorias.ts]"]
end

subgraph group_school["Organización escolar"]
  node_school_page["Vista escolar<br/>[page.tsx]"]
  node_classes["Clases y horario<br/>[useClases.ts]"]
  node_subjects["Materias<br/>[useMaterias.ts]"]
  node_important_dates["Fechas importantes"]
end

subgraph group_habits["Hábitos"]
  node_habits_page["Vista de hábitos<br/>[page.tsx]"]
  node_habits["Gestión de hábitos<br/>[useHabitos.ts]"]
end

subgraph group_google["Integración Google"]
  node_google_api["API Google Calendar<br/>[route.ts]"]
  node_google_tasks["Sincronización Tasks<br/>[google-tasks.ts]"]
  node_google_auth["Autenticación Google<br/>[google-auth.ts]"]
  node_exchange["Intercambio OAuth<br/>[route.ts]"]
end

node_user(("Usuario"))
node_google_calendar(("Google Calendar"))
node_google_oauth(("Google OAuth"))

node_user -->|"inicia sesión"| node_login
node_login -->|"autentica"| node_supabase
node_auth -->|"lee sesión"| node_supabase
node_pending_hook -->|"consulta usuario"| node_auth
node_pending_hook -->|"obtiene lista"| node_cache
node_pending_hook -->|"lee y actualiza"| node_supabase
node_pending_hook -->|"sincroniza tareas"| node_google_tasks
node_personal_page -->|"usa gestión"| node_pending_hook
node_personal_page -->|"usa categorías"| node_categories
node_personal_page -->|"muestra lista"| node_pending_views
node_personal_page -->|"muestra formulario"| node_pending_form
node_pending_views -.->|"presenta datos"| node_pending_hook
node_school_page -->|"usa clases"| node_classes
node_school_page -->|"usa materias"| node_subjects
node_school_page -->|"muestra fechas"| node_important_dates
node_school_page -->|"usa pendientes"| node_pending_hook
node_classes -->|"consulta usuario"| node_auth
node_classes -->|"obtiene lista"| node_cache
node_classes -->|"lee y actualiza"| node_supabase
node_habits_page -->|"usa hábitos"| node_habits
node_habits -->|"consulta usuario"| node_auth
node_habits -->|"obtiene lista"| node_cache
node_habits -->|"lee y actualiza"| node_supabase
node_google_api -->|"obtiene token"| node_google_auth
node_google_api -->|"solicita eventos"| node_google_calendar
node_exchange -->|"invalida token"| node_google_auth
node_exchange -->|"intercambia código"| node_google_oauth
node_exchange -->|"guarda credenciales"| node_supabase

click node_login "https://github.com/pablofls/merp/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/pablofls/merp/blob/main/src/lib/context/AuthContext.tsx"
click node_cache "https://github.com/pablofls/merp/blob/main/src/lib/cache/useCachedList.ts"
click node_personal_page "https://github.com/pablofls/merp/blob/main/src/app/personal/page.tsx"
click node_pending_hook "https://github.com/pablofls/merp/blob/main/src/features/home/hooks/usePendientes.ts"
click node_pending_views "https://github.com/pablofls/merp/blob/main/src/features/home/components/TimelinePendientes.tsx"
click node_pending_form "https://github.com/pablofls/merp/blob/main/src/features/home/components/FormPendiente.tsx"
click node_categories "https://github.com/pablofls/merp/blob/main/src/features/personal/hooks/useCategorias.ts"
click node_school_page "https://github.com/pablofls/merp/blob/main/src/app/escolar/page.tsx"
click node_classes "https://github.com/pablofls/merp/blob/main/src/features/escolar/hooks/useClases.ts"
click node_subjects "https://github.com/pablofls/merp/blob/main/src/features/escolar/hooks/useMaterias.ts"
click node_important_dates "https://github.com/pablofls/merp/blob/main/src/features/escolar/components/FechasImportantes.tsx"
click node_habits_page "https://github.com/pablofls/merp/blob/main/src/app/habitos/page.tsx"
click node_habits "https://github.com/pablofls/merp/blob/main/src/features/habitos/hooks/useHabitos.ts"
click node_google_api "https://github.com/pablofls/merp/blob/main/src/app/api/google/calendar/route.ts"
click node_google_tasks "https://github.com/pablofls/merp/blob/main/src/features/google/lib/google-tasks.ts"
click node_google_auth "https://github.com/pablofls/merp/blob/main/src/features/google/server/google-auth.ts"
click node_exchange "https://github.com/pablofls/merp/blob/main/src/app/api/google/exchange/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_login,node_auth,node_cache,node_supabase toneBlue
class node_personal_page,node_pending_hook,node_pending_views,node_pending_form,node_categories toneAmber
class node_school_page,node_classes,node_subjects,node_important_dates toneMint
class node_habits_page,node_habits toneRose
class node_google_api,node_google_tasks,node_google_auth,node_exchange,node_user,node_google_calendar,node_google_oauth toneIndigo
```

## Components

### Acceso y datos

- [Inicio de sesión](https://github.com/pablofls/merp/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Estado de sesión](https://github.com/pablofls/merp/blob/main/src/lib/context/AuthContext.tsx): `src/lib/context/AuthContext.tsx`
- [Caché de listas](https://github.com/pablofls/merp/blob/main/src/lib/cache/useCachedList.ts): `src/lib/cache/useCachedList.ts`
- **Supabase**

### Pendientes y organización

- [Vista personal](https://github.com/pablofls/merp/blob/main/src/app/personal/page.tsx): `src/app/personal/page.tsx`
- [Gestión de pendientes](https://github.com/pablofls/merp/blob/main/src/features/home/hooks/usePendientes.ts): `src/features/home/hooks/usePendientes.ts`
- [Vistas de pendientes](https://github.com/pablofls/merp/blob/main/src/features/home/components/TimelinePendientes.tsx): `src/features/home/components/TimelinePendientes.tsx`
- [Formulario de pendiente](https://github.com/pablofls/merp/blob/main/src/features/home/components/FormPendiente.tsx): `src/features/home/components/FormPendiente.tsx`
- [Categorías personales](https://github.com/pablofls/merp/blob/main/src/features/personal/hooks/useCategorias.ts): `src/features/personal/hooks/useCategorias.ts`

### Organización escolar

- [Vista escolar](https://github.com/pablofls/merp/blob/main/src/app/escolar/page.tsx): `src/app/escolar/page.tsx`
- [Clases y horario](https://github.com/pablofls/merp/blob/main/src/features/escolar/hooks/useClases.ts): `src/features/escolar/hooks/useClases.ts`
- [Materias](https://github.com/pablofls/merp/blob/main/src/features/escolar/hooks/useMaterias.ts): `src/features/escolar/hooks/useMaterias.ts`
- [Fechas importantes](https://github.com/pablofls/merp/blob/main/src/features/escolar/components/FechasImportantes.tsx): `src/features/escolar/components/FechasImportantes.tsx`

### Hábitos

- [Vista de hábitos](https://github.com/pablofls/merp/blob/main/src/app/habitos/page.tsx): `src/app/habitos/page.tsx`
- [Gestión de hábitos](https://github.com/pablofls/merp/blob/main/src/features/habitos/hooks/useHabitos.ts): `src/features/habitos/hooks/useHabitos.ts`

### Integración Google

- [API Google Calendar](https://github.com/pablofls/merp/blob/main/src/app/api/google/calendar/route.ts): `src/app/api/google/calendar/route.ts`
- [Sincronización Tasks](https://github.com/pablofls/merp/blob/main/src/features/google/lib/google-tasks.ts): `src/features/google/lib/google-tasks.ts`
- [Autenticación Google](https://github.com/pablofls/merp/blob/main/src/features/google/server/google-auth.ts): `src/features/google/server/google-auth.ts`
- [Intercambio OAuth](https://github.com/pablofls/merp/blob/main/src/app/api/google/exchange/route.ts): `src/app/api/google/exchange/route.ts`

### Other components

- **Usuario**
- **Google Calendar**
- **Google OAuth**

## Connections

- Usuario → Inicio de sesión: inicia sesión (evidence: `src/app/login/page.tsx`)
- Inicio de sesión → Supabase: autentica (evidence: `src/app/login/page.tsx`)
- Estado de sesión → Supabase: lee sesión (evidence: `src/lib/context/AuthContext.tsx`)
- Gestión de pendientes → Estado de sesión: consulta usuario (evidence: `src/features/home/hooks/usePendientes.ts`)
- Gestión de pendientes → Caché de listas: obtiene lista (evidence: `src/features/home/hooks/usePendientes.ts`)
- Gestión de pendientes → Supabase: lee y actualiza (evidence: `src/features/home/hooks/usePendientes.ts`)
- Gestión de pendientes → Sincronización Tasks: sincroniza tareas (evidence: `src/features/home/hooks/usePendientes.ts`)
- Vista personal → Gestión de pendientes: usa gestión (evidence: `src/app/personal/page.tsx`)
- Vista personal → Categorías personales: usa categorías (evidence: `src/app/personal/page.tsx`)
- Vista personal → Vistas de pendientes: muestra lista (evidence: `src/app/personal/page.tsx`)
- Vista personal → Formulario de pendiente: muestra formulario (evidence: `src/app/personal/page.tsx`)
- Vistas de pendientes → Gestión de pendientes: presenta datos
- Vista escolar → Clases y horario: usa clases (evidence: `src/app/escolar/page.tsx`)
- Vista escolar → Materias: usa materias (evidence: `src/app/escolar/page.tsx`)
- Vista escolar → Fechas importantes: muestra fechas (evidence: `src/app/escolar/page.tsx`)
- Vista escolar → Gestión de pendientes: usa pendientes (evidence: `src/app/escolar/page.tsx`)
- Clases y horario → Estado de sesión: consulta usuario (evidence: `src/features/escolar/hooks/useClases.ts`)
- Clases y horario → Caché de listas: obtiene lista (evidence: `src/features/escolar/hooks/useClases.ts`)
- Clases y horario → Supabase: lee y actualiza (evidence: `src/features/escolar/hooks/useClases.ts`)
- Vista de hábitos → Gestión de hábitos: usa hábitos (evidence: `src/app/habitos/page.tsx`)
- Gestión de hábitos → Estado de sesión: consulta usuario (evidence: `src/features/habitos/hooks/useHabitos.ts`)
- Gestión de hábitos → Caché de listas: obtiene lista (evidence: `src/features/habitos/hooks/useHabitos.ts`)
- Gestión de hábitos → Supabase: lee y actualiza (evidence: `src/features/habitos/hooks/useHabitos.ts`)
- API Google Calendar → Autenticación Google: obtiene token (evidence: `src/app/api/google/calendar/route.ts`)
- API Google Calendar → Google Calendar: solicita eventos (evidence: `src/app/api/google/calendar/route.ts`)
- Intercambio OAuth → Autenticación Google: invalida token (evidence: `src/app/api/google/exchange/route.ts`)
- Intercambio OAuth → Google OAuth: intercambia código (evidence: `src/app/api/google/exchange/route.ts`)
- Intercambio OAuth → Supabase: guarda credenciales (evidence: `src/app/api/google/exchange/route.ts`)
