# josephlondono/todo-list-full-stack architecture

> Architecture diagram of the GitHub repository josephlondono/todo-list-full-stack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/josephlondono/todo-list-full-stack
- Repository: https://github.com/josephlondono/todo-list-full-stack

## Overview

Para guiar al principal software engineer en la creación de un diagrama de arquitectura preciso para este proyecto “Todo List Full Stack”, sigamos estos pasos, adaptados a la estructura y propósito que arroja el file tree y el README:

##### Identificar el tipo de proyecto y su propósito
- Proyecto monorepo full-stack:
– Front-end: Next.js (React) con NextAuth para autenticación.
– Back-end: NestJS (TypeScript) con módulos de Auth, Task y Users.
– Base de datos relacional (asumida: PostgreSQL, MySQL o similar, configurada en `url.config.ts`).

##### Analizar la estructura de carpetas
- back-end/src/modules – modularidad en Auth, Task y Users (pattern MVC dentro de cada módulo).
- back-end/src/configuration – configuración de JWT, URLs, variables de entorno.
- front-end/src/app + src/components + src/lib –
– `app/api/auth/[...nextauth]`: ruta de NextAuth para gestión de sesiones.
– `lib/taskManager`: abstracción de llamadas REST para CRUD de tareas.
– Contexto global de sesión (`sessionContext.tsx`).

##### Puntos clave en el README
- Mecanismos de inicio simultáneo (npm start) o por separado.
- Uso de workspaces npm para sincronizar dependencias.
- No hay microservicios: un monolito back-end, un front-end desacoplado consumiendo APIs REST.

##### Componentes principales para el diagrama
a. Front-end (Next.js)
– Páginas: /auth, /tasks, / (Home).
– API Routes de NextAuth (/api/auth).
– Librería interna `taskManager` para llamadas a:
- POST /tasks
- GET /tasks
- /tasks/:id
- DELETE /tasks/:id
– Contexto de sesión para almacenar JWT.
b. Back-end (NestJS)
– Controller de Auth:
- POST /auth/signup, POST /auth/signin → emite JWT.
– Controller de Tasks:
- Rutas CRUD protegidas con JwtStrategy.
– Controller de Users: CRUD de usuarios (opcional).
– ConfigModule / ConfigService: variables de entorno (JWT secret, DB URL).
– Pipes (ParseIntPipe) para validación de parámetros.
– ORM (TypeORM) Entities: TaskEntity, UserEntity → esquema de la base de datos.
c. Base de datos
– Tabla users, tabla tasks con FK usuario.
d. (Opcional) Servicios externos
– Proveedor de email o logging (si existiera). En este caso no hay.

##### Relaciones e interacciones
- Usuario en UI → Next.js (petición de login o vista de tareas)
- Front-end → Back-end (HTTP REST + JWT en Authorization header)
- Back-end → Base de datos (ORM/Query)
- Back-end valida JWT usando JwtStrategy y ConfigService
- NextAuth maneja el storage de sesión en cookies/localStorage

##### Patrones y principios
- Full-stack desacoplado (separación de responsabilidades).
- Back-end modular (NestJS Modules).
- Autenticación JWT centralizada.
- Single Page Application + API layer.

##### Guía para dibujar el diagrama
a. Usa rectángulos para componentes de cómputo (Frontend, Backend).
b. Dentro de Backend, subdivide en módulos: Auth, Task, Users, Config.
c. Representa la Base de Datos como un cilindro.
d. Dibuja flechas direccionales:
– Front→Backend: “HTTP REST (JWT)”
– Backend→DB: “ORM / SQL”
e. Emplea colores o formas distintas:
– Front-end (azul claro),
– Back-end (verde),
– DB (gris).
f. Etiqueta cada flecha con el tipo de protocolo/datos.
g. Opcional: usa notas o callouts para destacar archivos críticos (ej. `jwt-strategy.service.ts`, `task.entity.ts`, `createTask.tsx`).

##### Elementos imprescindibles
- Componentes claramente nombrados (Next.js App, NestJS App, PostgreSQL).
- Módulos internos de Backend y folders clave del Front.
- Flujo de datos y de autorización.
- Configuración (env vars) como “Configuración Central”.

Con esta información, el diagrama mostrará con detalle cómo las capas se relacionan, qué tecnologías intervienen en cada punto y cómo fluye la información entre el usuario final y la base de datos.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Front-end (Next.js App)"
        direction TB
        FApp["Next.js App"]:::frontend
        subgraph "Pages"
            direction TB
            Home["Home Page"]:::frontend
            AuthPage["Auth Page"]:::frontend
            TasksPage["Tasks Page"]:::frontend
        end
        NextAuthAPI["NextAuth API Route"]:::frontend
        TaskMgr["Task Manager Library"]:::frontend
        SessionCtx["Session Context"]:::frontend
    end

    subgraph "Back-end (NestJS App)"
        direction TB
        Main["main.ts"]:::backend
        Config["Configuration Module"]:::backend
        AuthMod["Auth Module"]:::backend
        TaskMod["Task Module"]:::backend
        UsersMod["Users Module"]:::backend
        Pipes["Global Pipes"]:::backend
    end

    DB["PostgreSQL DB"]:::db
    User["End User"]

    User -->|"Interacts with"| FApp
    FApp -->|"uses pages"| Home
    FApp -->|"uses pages"| AuthPage
    FApp -->|"uses pages"| TasksPage
    FApp -->|"invokes"| NextAuthAPI
    FApp -->|"calls"| TaskMgr
    FApp -->|"stores JWT via"| SessionCtx

    FApp -->|"HTTP REST (JWT)"| Main
    Main -->|"loads Config"| Config
    Main -->|"registers modules"| AuthMod
    Main -->|"registers modules"| TaskMod
    Main -->|"registers modules"| UsersMod
    Main -->|"uses pipes"| Pipes

    AuthMod -->|"ORM / SQL"| DB
    TaskMod -->|"ORM / SQL"| DB
    UsersMod -->|"ORM / SQL"| DB

    click FApp "https://github.com/josephlondono/todo-list-full-stack/tree/main/front-end/src/app"
    click Home "https://github.com/josephlondono/todo-list-full-stack/blob/main/front-end/src/app/page.tsx"
    click AuthPage "https://github.com/josephlondono/todo-list-full-stack/blob/main/front-end/src/app/auth/page.tsx"
    click TasksPage "https://github.com/josephlondono/todo-list-full-stack/blob/main/front-end/src/app/tasks/page.tsx"
    click NextAuthAPI "https://github.com/josephlondono/todo-list-full-stack/blob/main/front-end/src/app/api/auth/[...nextauth]/route.ts"
    click TaskMgr "https://github.com/josephlondono/todo-list-full-stack/tree/main/front-end/src/lib/taskManager"
    click SessionCtx "https://github.com/josephlondono/todo-list-full-stack/blob/main/front-end/src/context/sessionContext.tsx"

    click Main "https://github.com/josephlondono/todo-list-full-stack/blob/main/back-end/src/main.ts"
    click Config "https://github.com/josephlondono/todo-list-full-stack/tree/main/back-end/src/configuration"
    click AuthMod "https://github.com/josephlondono/todo-list-full-stack/blob/main/back-end/src/modules/auth/auth.module.ts"
    click TaskMod "https://github.com/josephlondono/todo-list-full-stack/blob/main/back-end/src/modules/task/task.module.ts"
    click UsersMod "https://github.com/josephlondono/todo-list-full-stack/blob/main/back-end/src/modules/users/users.module.ts"
    click Pipes "https://github.com/josephlondono/todo-list-full-stack/blob/main/back-end/src/pipes/parse-int.pipe.ts"

    classDef frontend fill:#E3F2FD,stroke:#2196F3
    classDef backend fill:#E8F5E9,stroke:#4CAF50
    classDef db fill:#EEEEEE,stroke:#9E9E9E
```
