# santivalverde4/proyecto_my_track-fit architecture

> Architecture diagram of the GitHub repository santivalverde4/proyecto_my_track-fit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/santivalverde4/proyecto_my_track-fit
- Repository: https://github.com/santivalverde4/proyecto_my_track-fit

## Overview

A continuación tienes una guía paso a paso, en español y en blanco y negro, para que puedas elaborar un diagrama de arquitectura preciso y detallado del proyecto “My-Track-Fit”, compuesto por una aplicación Android nativa (My-Track-Fit-ui) y un servicio REST en Node.js (My-Track-Fit-api).

##### Identificación del tipo de proyecto y su propósito
- Es una solución full-stack móvil:
- Cliente Android en Kotlin que consume una API REST.
- Backend en Node.js/Express que expone endpoints de autenticación y gestión de usuarios, ejercicios, rutinas y peso corporal.
- Objetivo: seguimiento de entrenamiento y mediciones corporales.

##### Análisis de la estructura de directorios
- My-Track-Fit-ui: módulo Android con Activities, Fragments, adaptadores, modelos de datos (model/*) y cliente de red (network/RetrofitClient.kt).
- My-Track-Fit-api: microservicio Node.js con rutas (routes/), lógica de autenticación (autenticacion.js), entidades (entity/ y src/entity/) presumiblemente gestionadas con un ORM (TypeORM u otro).
- Raíz: configuración de Gradle, Node, .env, node_modules, etc.

##### Componentes principales a representar
A. Cliente Android
- Caja “Android App”
- Activities & Fragments (LoginActivity, MainActivity, WorkoutFragment, etc.)
- Modelo de datos local (model/Block.kt, model/Workout.kt, …)
- RetrofitClient: configuración de Retrofit para llamadas HTTP
B. Servicio Backend
- Caja “API REST Node.js”
- Express.js (index.js)
- Rutas HTTP: auth.js, body.js, pesocorporal.js
- Capa de entidades (src/entity/Exercise, User, Routine, …)
- Lógica de negocio para CRUD de usuarios, rutinas, ejercicios, peso corporal
C. Base de datos
- Caja “Base de Datos Relacional” (p. ej. PostgreSQL/MySQL)
- Tablas: users, bodyweights, exercises, routines, workouts, weeks, exercise_instances, …
D. Servicios o dependencias externas (si los tuviere):
- Servicio de correo para restablecer contraseña
- Autenticación (JWT u OAuth, según .env)

##### Relaciones e interacciones
- Flechas dirigidas de “Android App” → “API REST Node.js”: peticiones HTTP (GET, POST, PUT, DELETE) vía Retrofit.
- Flechas de “API REST Node.js” → “Base de Datos Relacional”: consultas SQL generadas por ORM.
- (Opcional) Flecha de “API REST Node.js” → “Servicio de correo” para envíos de email.

##### Patrones y principios arquitectónicos
- Separación de capas: presentación (Android), API (Express + entidades), persistencia (BD).
- RESTful API: rutas organizadas por recurso (users, bodyweights, exercises…).
- Retrofit en cliente: adapter pattern para consumo de servicios HTTP.
- Entity–Relationship en backend: uso de entidades para mapear tablas.

##### Tecnologías clave
- Android SDK + Kotlin + Retrofit
- Node.js + Express.js + ORM (ej. TypeORM)
- Base de Datos SQL (PostgreSQL/MySQL)
- Gradle (Android) y npm/yarn (API)

##### Recomendaciones para el diagrama (blanco y negro)
- Usa rectángulos para cada componente lógico (UI, API, BD, servicios externos).
- Emplea diferentes tipos de líneas (continua, discontinua, punteada) o patrones de relleno para distinguir capas:
- Capa presentación: línea continua gruesa.
- Capa lógica (API): línea continua media.
- Capa datos: línea discontinua.
- Flechas con punta clara para indicar flujo de datos y dependencia.
- Etiqueta cada rectángulo con su nombre y versión de tecnología (p. ej. “RetrofitClient (v2.9.0)”).
- Incluye en una leyenda los patrones de línea o relleno usados.

##### Pasos concretos para dibujarlo
a) Dibuja tres columnas verticales (de izquierda a derecha):
1) Android App
2) API REST
3) Base de Datos
b) Dentro de cada columna, subdivide en bloques:
– Android App: UI (Activities/Fragments), Data Models, Network (Retrofit)
– API REST: Rutas HTTP, Controladores, Entidades, Configuración de servidor
– Base de Datos: Tablas principales
c) Añade flechas de izquierda a derecha (App→API→BD).
d) Opcionalmente, coloca abajo un rectángulo “Servicios Externos” y conéctalo desde API REST.
e) Revisa que cada flecha esté etiquetada (GET /users, POST /login, etc.).

Con este nivel de detalle y organización en blanco y negro, tendrás un diagrama claro, preciso y fácil de entender por cualquier miembro del equipo.

## Diagram (Mermaid)

```mermaid
flowchart LR
    %% Capas de la arquitectura
    subgraph "Android App" 
        direction TB
        UI["UI (Activities & Fragments)"] 
        Models["Data Models"] 
        Network["RetrofitClient (v2.9.0)"]
    end

    subgraph "API REST Node.js"
        direction TB
        Server["Express.js (index.js)"]
        AuthLogic["Autenticación (autenticacion.js)"]
        Routes["Rutas HTTP"]
        EntitiesRoot["Entidades (entity/)"]
        EntitiesSrc["Entidades (src/entity/)"]
    end

    subgraph "Base de Datos Relacional"
        direction TB
        DB["Tablas SQL (users, bodyweights, exercises, routines, workouts, weeks, exercise_instances)"]
    end

    subgraph "Servicios Externos"
        direction TB
        Mail["Servicio de Correo"]
        AuthExt["JWT / OAuth"]
    end

    %% Conexiones
    UI -->|"GET/POST/PUT/DELETE via Retrofit"| Server
    Network -->|"> API REST"| Server
    Server -->|"ORM queries"| DB
    AuthLogic -->|"> Envío de email"| Mail
    AuthLogic -->|"> Verificación Tokens"| AuthExt

    %% Click Events para componentes
    click UI "https://github.com/santivalverde4/proyecto_my_track-fit/tree/main/My-Track-Fit-ui/app/src/main/java/com/example/my_track_fit"
    click Models "https://github.com/santivalverde4/proyecto_my_track-fit/tree/main/My-Track-Fit-ui/app/src/main/java/com/example/my_track_fit/model"
    click Network "https://github.com/santivalverde4/proyecto_my_track-fit/blob/main/My-Track-Fit-ui/app/src/main/java/com/example/my_track_fit/network/RetrofitClient.kt"
    click Server "https://github.com/santivalverde4/proyecto_my_track-fit/blob/main/My-Track-Fit-api/index.js"
    click Server "https://github.com/santivalverde4/proyecto_my_track-fit/blob/main/My-Track-Fit-api/src/index.js"
    click AuthLogic "https://github.com/santivalverde4/proyecto_my_track-fit/blob/main/My-Track-Fit-api/autenticacion.js"
    click Routes "https://github.com/santivalverde4/proyecto_my_track-fit/tree/main/My-Track-Fit-api/routes"
    click EntitiesRoot "https://github.com/santivalverde4/proyecto_my_track-fit/tree/main/My-Track-Fit-api/entity"
    click EntitiesSrc "https://github.com/santivalverde4/proyecto_my_track-fit/tree/main/My-Track-Fit-api/src/entity"
    click DB "https://github.com/santivalverde4/proyecto_my_track-fit/blob/main/.env"

    %% Estilos para capas (blanco y negro)
    classDef presentacion stroke-width:2,stroke:#000,fill:none;
    classDef logica stroke-width:1.5,stroke-dasharray:0,stroke:#000,fill:none;
    classDef datos stroke-width:1,stroke-dasharray:5 5,stroke:#000,fill:none;

    class UI,Models,Network presentacion
    class Server,AuthLogic,Routes,EntitiesRoot,EntitiesSrc logica
    class DB,direction datos
    class Mail,AuthExt logica

    %% Leyenda
    subgraph "Leyenda"
        direction TB
        A["-- Capa Presentación"] 
        B["-- Capa Lógica"] 
        C["-- Capa Datos"]
    end

    class A presentacion
    class B logica
    class C datos
```
