# proyecto-de-calendario/principal architecture

> Architecture diagram of the GitHub repository proyecto-de-calendario/principal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/proyecto-de-calendario/principal
- Repository: https://github.com/proyecto-de-calendario/principal

## Overview

##### Project type and purpose
- This is a monorepo for a “FreeHealth” task‐management and time‐tracking system. It combines:
- A static/SPA frontend (“Client” folder) built with HTML/CSS/JavaScript (Tailwind, PostCSS).
- A RESTful backend API (“server” folder) using Node.js, Express.js, MySQL, JWT, bcrypt, and express-validator.
- A browser extension/time-tracker (“tracker” folder) that gathers interaction timing (Chrome manifest, content script, popup) and posts data back to a server endpoint.
- The README confirms a task CRUD system, user authentication, and a MySQL database.

##### File structure
- Top level:
.gitignore, freehealth_database.sql (schema dump), eventotiempo.js (utilities).
Three subprojects: Client, server, tracker.
- Client:
– package.json, PostCSS & Tailwind configuration.
– /assets: standalone JS modules for calendar, charting, login/register flows.
– /pages: individual HTML pages (agenda, estadística, landing, límite tiempo).
– /src: modularized SPA logic (routing, CRUD tasks, auth, time save).
- server:
– app.js (Express app entry), applyValidations.js, authValidations.js.
– /controllers: business logic for auth, profiles, tasks.
– /routes: route definitions for auth, profiles, tasks.
– /helpers: JWT generation/validation.
– dataBase.js: MySQL connection via mysql2/promise.
– .env.development: environment variables (DB credentials, JWT secret).
- tracker:
– manifest.json, content.js (in-page script), popup.html/UI, timeTracker.js, and its own server.js (if it has a local backend or debugging server).

##### README for additional insights
- Describes system features (CRUD tasks, authentication, sessions, JWT).
- Details endpoints under “Rutas y Endpoints” (GET/POST/PUT/DELETE /tasks, etc.).
- Mentions express-validator for request validation and JWT for session management.

##### Essential details to capture
- Component names and responsibilities (e.g., tasks.Controller handles task CRUD).
- Data flows: user actions → client JS → HTTP → server controller → DB → JSON response → client render.
- Security layer: JWT generation (generarJWT) and validation (validarJWT, validateToken).
- Configuration: .env settings used by config/config.js → database credentials.

## Diagram (Mermaid)

```mermaid
graph TB
    %% User Interfaces Layer
    subgraph "User Interfaces"
        subgraph "Web Client"
            CLI_index["index.html"]:::frontend
            CLI_main["main.js"]:::frontend
            TAILWIND["tailwind.config.js"]:::frontend
            POSTCSS["postcss.config.js"]:::frontend
            CLI_assets["Assets Modules"]:::frontend
            CLI_pages["Static Pages"]:::frontend
            CLI_src["SPA Logic"]:::frontend
        end
        subgraph "Browser Extension"
            EXT_manifest["manifest.json"]:::extension
            EXT_content["content.js"]:::extension
            EXT_popup["popup.html"]:::extension
            EXT_tracker["timeTracker.js"]:::extension
            EXT_server["server.js"]:::extension
        end
    end

    %% API Server Layer
    subgraph "API Server"
        APP["app.js"]:::backend
        subgraph "Routes"
            R_AUTH["Auth Routes"]:::backend
            R_PROF["Profile Routes"]:::backend
            R_TASK["Task Routes"]:::backend
        end
        subgraph "Controllers"
            C_AUTH["auth.Controller.js"]:::backend
            C_PROF["perfiles.Controller.js"]:::backend
            C_TASK["tasks.Controller.js"]:::backend
        end
        subgraph "Middleware & Helpers"
            VAL_GEN["applyValidations.js"]:::backend
            VAL_AUTH["authValidations.js"]:::backend
            H_JWT_GEN["generarJWT.js"]:::backend
            H_JWT_VAL["validarJWT.js"]:::backend
            H_VALIDATE["validateToken.js"]:::backend
        end
        subgraph "DB Config"
            DB_CONF["config/config.js"]:::backend
            DB_CONN["dataBase.js"]:::backend
            ENV[".env.development"]:::backend
        end
    end

    %% Database Layer
    subgraph "Database"
        MYSQL["MySQL DB"]:::db
        SCHEMA["freehealth_database.sql"]:::db
    end

    %% Data Flows
    CLI_src -->|"HTTP/REST (JWT)"| R_TASK
    CLI_src -->|"HTTP/REST (JWT)"| R_AUTH
    CLI_src -->|"HTTP/REST (JWT)"| R_PROF
    EXT_content -->|"HTTP/REST (JWT)"| R_TASK
    EXT_tracker -->|"HTTP/REST (JWT)"| R_TASK

    APP --> R_AUTH
    APP --> R_PROF
    APP --> R_TASK

    R_AUTH --> C_AUTH
    R_PROF --> C_PROF
    R_TASK --> C_TASK

    C_AUTH --> VAL_GEN
    C_AUTH --> VAL_AUTH
    C_AUTH --> H_JWT_GEN
    C_AUTH --> H_JWT_VAL
    C_AUTH --> H_VALIDATE

    C_PROF --> DB_CONN
    C_TASK --> DB_CONN

    DB_CONN --> DB_CONF
    DB_CONN --> MYSQL
    ENV --> DB_CONN
    SCHEMA --> MYSQL

    %% Click Events
    click CLI_index "https://github.com/proyecto-de-calendario/principal/blob/main/Client/index.html"
    click CLI_main "https://github.com/proyecto-de-calendario/principal/blob/main/Client/main.js"
    click TAILWIND "https://github.com/proyecto-de-calendario/principal/blob/main/Client/tailwind.config.js"
    click POSTCSS "https://github.com/proyecto-de-calendario/principal/blob/main/Client/postcss.config.js"
    click CLI_assets "https://github.com/proyecto-de-calendario/principal/tree/main/Client/assets/"
    click CLI_pages "https://github.com/proyecto-de-calendario/principal/tree/main/Client/pages/"
    click CLI_src "https://github.com/proyecto-de-calendario/principal/tree/main/Client/src/"
    click EXT_manifest "https://github.com/proyecto-de-calendario/principal/blob/main/tracker/manifest.json"
    click EXT_content "https://github.com/proyecto-de-calendario/principal/blob/main/tracker/content.js"
    click EXT_popup "https://github.com/proyecto-de-calendario/principal/blob/main/tracker/popup.html"
    click EXT_tracker "https://github.com/proyecto-de-calendario/principal/blob/main/tracker/timeTracker.js"
    click EXT_server "https://github.com/proyecto-de-calendario/principal/blob/main/tracker/server.js"
    click APP "https://github.com/proyecto-de-calendario/principal/blob/main/server/app.js"
    click R_AUTH "https://github.com/proyecto-de-calendario/principal/blob/main/server/routes/auth.Routes.js"
    click R_PROF "https://github.com/proyecto-de-calendario/principal/blob/main/server/routes/perfiles.Routes.js"
    click R_TASK "https://github.com/proyecto-de-calendario/principal/blob/main/server/routes/tasks.Routes.js"
    click C_AUTH "https://github.com/proyecto-de-calendario/principal/blob/main/server/controllers/auth.Controller.js"
    click C_PROF "https://github.com/proyecto-de-calendario/principal/blob/main/server/controllers/perfiles.Controller.js"
    click C_TASK "https://github.com/proyecto-de-calendario/principal/blob/main/server/controllers/tasks.Controller.js"
    click VAL_GEN "https://github.com/proyecto-de-calendario/principal/blob/main/server/applyValidations.js"
    click VAL_AUTH "https://github.com/proyecto-de-calendario/principal/blob/main/server/authValidations.js"
    click H_JWT_GEN "https://github.com/proyecto-de-calendario/principal/blob/main/server/helpers/generarJWT.js"
    click H_JWT_VAL "https://github.com/proyecto-de-calendario/principal/blob/main/server/helpers/validarJWT.js"
    click H_VALIDATE "https://github.com/proyecto-de-calendario/principal/blob/main/server/helpers/validateToken.js"
    click DB_CONN "https://github.com/proyecto-de-calendario/principal/blob/main/server/dataBase.js"
    click DB_CONF "https://github.com/proyecto-de-calendario/principal/blob/main/server/config/config.js"
    click ENV "https://github.com/proyecto-de-calendario/principal/blob/main/server/.env.development"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#90CAF9
    classDef backend fill:#FFF3E0,stroke:#FFA726
    classDef db fill:#E8F5E9,stroke:#66BB6A
    classDef extension fill:#F3E5F5,stroke:#AB47BC
```
