Construyendo un Nutritional Tracker: Parte 1 - Diseño del Modelo de Datos

Parte 1: Diseño del Modelo de Datos — Nutrition Tracker

Motivación: ¿Por qué crear un Nutritional Tracker?

El primer paso para adquirir hábitos saludables es el autoconocimiento. La idea de este tracker es tener un registro de la alimentación de los miembros de la familia para fomentar mejores decisiones. Además, representa un desafío técnico ideal para aplicar React moderno y buenas prácticas de frontend.

1. Setup del Proyecto

La creación con Vite es directa y veloz:

npm create vite@latest nutritional-tracker -- --template react-ts

2. Definición del Modelo de Datos: Teoría y Práctica

2.1. Fórmula de la entidad

Cada “evento de consumo” registra:

A continuación se explica cada variable.

2.2. Esquema visual del modelo

erDiagram
  USER ||--o{ REGISTER : "crea"
  USER {
    string userId PK
    string userName
  }
  REGISTER {
    string id PK
    string userId FK
    string userName
    string food
    number amount
    enum unit
    date date
    time time
    enum mealType
    enum sweetener
    string notes
    timestamp createdAt
  }

3. Sistema de Unidades Flexible

4. Campo Endulzante: Lógica ternaria

En lugar de un booleano, utilizamos:

Esto permite un seguimiento más detallado (días sin azúcar, consumo de edulcorante, etc.).

5. Campos requeridos vs opcionales

Todos los campos excepto notes y sweetener son requeridos para lograr un análisis sólido.

6. Campos temporales: ¿Por qué date y createdAt?

• date y time: dato de dominio (cuándo se consumió).
• createdAt: metadato técnico (cuándo fue registrado en el sistema).

$T*{\text{real}} \neq T*{\text{registro}}$

7. ¿Qué sigue?

• Setup del entorno de testing con Vitest + Testing Library.
• Validación robusta con Zod.
• Wrapper de localStorage con parsing tolerante y manejo de errores.

Navegación de la serie

• Parte 2: Configuración del Entorno de Testing →

Recursos adicionales

• Documentación de Vite
• React con TypeScript
• Mermaid.js para diagramas