Estatuto del Proyecto

Plataforma Integral de Nutricion y Fitness — Fase 1: Plataforma Base de Nutricion + Cascaron Fitness

Fase 1
Modulos 7
Duracion 12 Semanas + Hypercare
Entrega Web + PWA

I. Informacion General

1.1 Datos de las Partes

CLIENTE
Nombre
Gerardo Reyna
Rol
Nutriologo y Coach de Fitness
Industria
Nutricion & Fitness (Wellness)
PROVEEDOR
Empresa
HIXION
Representante
Angel Cadena
Servicios
Desarrollo de Software, Consultoria Tecnologica

1.2 Equipo de Trabajo

Lider de Celula / Project Manager
Angel
Desarrollador Full Stack, coordinacion general, seguimiento de sprints
Arquitecto de Datos
Luis Manuel Rojas
Estructura de informacion, modelos de datos
Especialista UX/UI & Frontend
Por asignar
Experto en diseno e interfaces
Especialista Backend & BD
Por asignar
APIs, logica de negocio, Firestore
Desarrollador Full Stack
Por asignar
Apoyo frontend/backend segun sprint
Capacidad Adicional
2–3 recursos disponibles
Si se requiere reforzar algun sprint

1.3 Resumen Ejecutivo

Problema

Dependencia de Avena + Fitmewise, interfaces poco intuitivas, comunicacion dispersa (Telegram, WhatsApp, ConfirmaFy).

Solucion

Plataforma integral a la medida, 5 fases modulares con opciones IA. Fase 1 = Plataforma Base Nutricion funcional + Cascaron Fitness.

Beneficios

  • Propiedad total — 100% del codigo fuente
  • Eficiencia operativa — menos del 20% del tiempo actual en gestion de planes
  • Escalabilidad — White Label / Multi-Tenant ready
  • Cumplimiento LFPDPPP para datos de salud

Entregable

Web App + PWA (iOS/Android)

1.4 Diagnostico y Justificacion

Situacion Actual

Avena (nutricion) + Fitmewise (ejercicio) + comunicacion dispersa entre multiples herramientas.

9 Dolores Identificados

  • Costo de suscripciones a herramientas externas
  • Dispersion de informacion en multiples plataformas
  • Gestion de clientela poco eficiente
  • Atletas AAR sin seguimiento especializado
  • Clientes premium sin experiencia diferenciada
  • Reglas de negocio no automatizables en herramientas actuales
  • Procesos no optimizados (manuales, repetitivos)
  • Comunicacion fragmentada (Telegram, WhatsApp, ConfirmaFy)
  • Dependencia total de terceros sin propiedad de datos

8 Oportunidades de Negocio

  • Plataforma propia con identidad de marca
  • Modelo White Label / Multi-Tenant para otros profesionales
  • Integracion completa nutricion + fitness en un solo sistema
  • Copilot IA para optimizar consultas
  • Gamificacion para incrementar adherencia de pacientes
  • Analytics & BI para decisiones basadas en datos
  • Integracion con wearables para datos en tiempo real
  • CMS propio para contenido educativo
↑ Volver arriba

II. Vision Global del Proyecto

2.1 Roadmap de Fases

Fase Modulos Tiempo Anexo
FASE 1 Expedientes, Nutricion, Chat, Agenda, Pagos, Dashboard, Roles + Cascaron Fitness 3 meses + 1 mes HyperCare Este documento
FASE 1.1 (IA) Copilot Nutricion +3 semanas Este documento
FASE 2 Fitness: Biblioteca, Rutinas, Somatocarta, Valoracion 1.5 meses + 2 semanas HC Anexo A
FASE 2.1 (IA) Copilot Fitness +3 semanas Anexo A
FASE 3 Gamificacion + Atletas AAR 2 meses + 1 mes HC Anexo B
FASE 4 Multi-Tenant, Suscripciones, Landing 2 meses + 1 mes HC Anexo C
FASE 4.1 (IA) Copilot Multi-Tenant +2 semanas Anexo C
FASE 5 Wearables, Analytics & BI, CMS 2–3 meses + 1 mes HC Anexo D
Nota: Las fases de IA son opcionales y requieren la fase base completada. Las fases pueden pausarse, reordenarse o combinarse segun las necesidades del proyecto.

2.2 Metodologia: V-Model + Shift Left

  • Arquitectura planificada (como Waterfall) — fundamentos solidos desde el inicio
  • Entregas parciales cada 2 semanas (como Agile) — feedback rapido y continuo
  • Testing desde el inicio (Shift Left) — menos bugs, mas calidad
  • Feedback continuo con revisiones quincenales

Calendario de Validacion

Tipo de Prueba Semanas
Discovery WorkshopSemana 1
Pruebas de AceptacionSemanas 2 y 4
Pruebas de UsabilidadSemanas 6 y 8
Pruebas de FuncionalidadSemanas 9–10 y 11–12
↑ Volver arriba

III. Alcance Tecnico — Fase 1

3.1 Modulos Funcionales

7 modulos principales + cascaron visual de fitness. Haz clic para expandir cada modulo.

1
Expedientes de Pacientes
2 semanas · 11 features

Gestion completa del expediente clinico y seguimiento de cada paciente.

  • Datos Generales (nombre, contacto, foto, notas)
  • Objetivos del paciente (perdida de peso, ganancia muscular, salud)
  • Antropometria Avanzada (pliegues, circunferencias, composicion corporal)
  • Historial Clinico (patologias, alergias, medicamentos, antecedentes)
  • Cuestionario Diario (adherencia, sintomas, bienestar)
  • Gestion de Archivos (laboratorios, estudios, documentos)
  • Visualizacion de Progreso (graficas, tendencias, comparativas)
  • Salud Femenina (ciclo menstrual, sintomatologia, activacion condicional)
  • Enlace Rapido QR (subir evidencias sin login completo)
  • Timestamp Actividad (ultima conexion, monitoreo abandono)
  • Sistema de Etiquetas (categorizar pacientes para filtros y automatizaciones)
2
Nutricion y Dietocalculo
2–3 semanas · 8 features

Motor de calculo nutricional con base de datos SMAE y sistema de equivalencias.

  • Formulas TMB (4–7 formulas: Harris-Benedict, Mifflin, Katch-McArdle, etc.)
  • Calculo Dinamico (ajuste automatico segun actividad, objetivo, metabolismo)
  • Distribucion de Macronutrientes (proteina, carbohidratos, grasas con % personalizables)
  • Plantillas de Planes Alimenticios (crear, duplicar, asignar a pacientes)
  • Gestion de Recetas (ingredientes, porciones, macros calculados automaticamente)
  • Gestion de Suplementacion (dosis, horarios, enlace externo a Odoo)
  • Base de Datos SMAE (9 grupos alimenticios, 1500+ alimentos mexicanos)
  • Sistema de Equivalencias Inteligente (vista nutriologo + vista simplificada paciente)
3
Comunicacion
1 semana · 12 features

Sistema de mensajeria integrado con vistas diferenciadas para nutriologo y paciente.

  • Vista Web Nutriologo (sidebar con contexto del paciente)
  • Asignacion de planes desde chat (enviar plan alimenticio directamente)
  • Logica Condicional (cuestionarios personalizados segun tags del paciente)
  • Badge de ultima fecha de interaccion
  • Historial completo de conversaciones
  • Vista Movil Nutriologo (gestion rapida desde celular)
  • Limitacion Operativa (dietocalculo solo disponible en desktop)
  • Vista Movil Paciente (chat simple, envio de fotos, notificaciones push)
  • Modo Offline (caching PWA, sincronizacion al reconectar)
  • Cuestionarios Diarios Automatizados
  • Dashboard Semaforo (estado de pacientes por adherencia)
  • Notificaciones Inteligentes (contextuales, no spam)
4
Agenda Inteligente
2 semanas · 7 features

Calendario visual con sincronizacion Google Calendar y automatizaciones pre-consulta.

  • Calendario Visual (vista dia, semana, mes)
  • Sincronizacion Bidireccional con Google Calendar
  • Deteccion de Conflictos (revision automatica de calendarios conectados)
  • Workflows Pre-Consulta (recordatorios por tags, formularios de chequeo)
  • Notificaciones Propias (push: 1 dia, 1 hora, 5 minutos antes)
  • Gestion de Citas (crear, drag & drop, cancelar, notas internas)
  • Portal del Paciente (confirmar, reagendar citas)
5
Membresias y Pagos (Stripe)
1 semana · 5 features

Procesamiento de pagos con Stripe, control de acceso automatizado y gestion de no-shows.

  • Gestion de Planes y Suscripciones
  • Logica No-Show / Cancelaciones (pausar acceso, descontar sesion, penalizacion)
  • Control de Acceso Automatizado (pago vencido = acceso restringido)
  • Historial y Reportes de transacciones
  • Registro Manual de Transacciones (pagos en efectivo, transferencias)
6
Dashboard del Nutriologo
1 semana · 4 features

Panel principal con metricas clave, alertas y filtros de desempeno.

  • Metricas de Pacientes (activos, nuevos, abandonos, tendencias)
  • Metrica Last Active (leaderboard para seguimiento y felicitacion)
  • Sistema de Alertas Semaforo (rojo/amarillo/verde por adherencia)
  • Filtros de Desempeno (“Pacientes Top” con >90% adherencia)
7
Roles y Permisos
1 semana · 4 roles, 10 permisos

Sistema de roles granular con permisos configurables por Discovery Workshop.

4 Roles

  • Admin (acceso total, configuracion del sistema)
  • Nutriologo Asociado (consultas, expedientes, planes)
  • Asistente / Coordinador (agenda, comunicacion, reportes limitados)
  • Recepcionista (agenda, confirmaciones, datos basicos)

10 Permisos Configurables

  • Crear / editar expedientes
  • Ver historial clinico completo
  • Crear / asignar planes alimenticios
  • Acceder al dietocalculo
  • Gestionar agenda y citas
  • Enviar mensajes a pacientes
  • Ver dashboard y metricas
  • Gestionar pagos y membresias
  • Configurar roles de otros usuarios
  • Exportar datos e informes

Personalizacion

  • Discovery Workshop define configuracion inicial de roles
  • Permisos toggleable (activar/desactivar por usuario)
  • Invitacion con onboarding guiado para nuevos usuarios
F
Cascaron Visual de Fitness
Incluido en Fase 1 · Solo UI

Pestanas “Rutinas” y “Ejercicios” visibles en la interfaz pero bloqueadas con un indicador de “Proximamente”. La funcionalidad completa de fitness se desarrolla en Fase 2.

3.2 Modulo Opcional IA (Fase 1.1): Copilot Nutricion

  • Consulta de Expediente — El IA analiza el historial completo del paciente
  • Asignacion de Planes — Sugerencias inteligentes basadas en objetivos y restricciones
  • Resumen Inteligente — Sintesis automatica del progreso y alertas
Nota: Cotizado por separado. Requiere Fase 1 completada para implementarse.

3.3 Entregables Tecnicos

Plataformas

Web App + PWA instalable (iOS / Android)

Branding

Identidad visual del Cliente aplicada a toda la plataforma

Codigo

Repositorio completo, 100% propiedad del Cliente

Capacitacion

2–3 horas grabadas + manuales de uso

Documentacion Legal

Politica de Privacidad, Aviso de Privacidad, Disclaimer

3.4 Exclusiones (Fase 1)

  • Fitness funcional (Fase 2)
  • Somatocarta y valoracion funcional (Fase 2)
  • Gamificacion, rachas, atletas AAR (Fase 3)
  • Multi-Tenant & White Label (Fase 4)
  • Wearables & Analytics (Fase 5)
  • Integraciones no mencionadas (Zoom, WhatsApp, Meta) = cotizacion separada
  • Soporte extendido post-Hypercare = contratacion mensual
  • Soporte 24/7 = tarifa adicional

3.5 Informacion y Disponibilidad Requerida

Datos Requeridos

  • Excel con datos de pacientes actuales para migracion
  • Base de datos de recetas e ingredientes
  • Acceso a avena.io para extraccion de datos
  • Columnas y metricas que se usan actualmente
  • Campos personalizados requeridos por el negocio
  • Manual de identidad de marca (logo, colores, tipografia)

Disponibilidad del Equipo del Cliente

  • Discovery Workshop (Semana 1) — participacion activa
  • Revision de Wireframes (Semana 2) — aprobacion requerida
  • Demos quincenales — feedback en menos de 48 horas
  • Aceptacion formal antes de cada hito
  • Beta con pacientes reales (Semanas 11–12)
Request for Change: Cualquier cambio de alcance se documenta formalmente, se evalua su impacto en tiempo y recursos, y se aprueba por ambas partes antes de implementarse.
↑ Volver arriba

IV. Arquitectura y Seguridad

4.1 Stack Tecnologico

Capa Tecnologia Proposito
FrontendNext.js + ReactSSR, rendimiento optimo
UI Componentsshadcn/ui + TailwindComponentes profesionales reutilizables
BackendNestJSAPI robusta, cifrado, escalable
Base de DatosFirebase (Firestore)Tiempo real, escalable, serverless
CDN / SeguridadCloudflareSSL/TLS, proteccion DDoS
PagosStripeProcesamiento seguro de pagos
App NativaCapacitorPWA wrapper para iOS y Android
Multi-idiomai18next o React-IntlEspanol e Ingles

4.2 Licencias de Software

Todas las dependencias utilizan licencia MIT: uso comercial sin restricciones. No se requiere publicar el codigo fuente. Sin costos de licenciamiento recurrentes.

4.3 Cifrado y Proteccion de Datos

En Transito

HTTPS / TLS obligatorio. Cloudflare SSL para todas las conexiones.

En Reposo

Firebase AES-256 para todos los datos almacenados.

4.4 Cumplimiento Normativo (LFPDPPP)

  • Aviso de Privacidad — Presentado al registrarse, aceptacion obligatoria
  • Consentimiento Expreso — Para datos sensibles de salud (explicitamente requerido)
  • Derechos ARCO — Acceso, Rectificacion, Cancelacion, Oposicion implementados
  • Disclaimer — Los datos de salud son orientativos, no sustituyen diagnostico medico
↑ Volver arriba

V. Cronograma

5.1 Calendario de Ejecucion

Sprint Semanas Entregables
Sprint 0 1–2 Setup, Discovery Workshop, Arquitectura, Wireframes
Sprint 1 3–4 Core Nutricion: Dietocalculo + SMAE + Expedientes
Sprint 2 5–6 Recetas + Equivalencias + Historial clinico completo
Sprint 3 7–8 Chat + Cuestionarios + Agenda + Stripe
Sprint 4 9–10 Dashboard + Roles + Cascaron Fitness
Sprint 5 11–12 Testing exhaustivo + Pruebas beta con pacientes reales
Deploy 13 Lanzamiento + Capacitacion + Inicio Hypercare
Hypercare 14–17 1 mes de soporte intensivo post-lanzamiento
Duracion total: 12 semanas de desarrollo + 1 semana de deploy + 1 mes de Hypercare.

5.2 Costos Recurrentes (No Incluidos en el Proyecto)

Servicio Costo Estimado
FirebasePago por uso escalable (free tier generoso para inicio)
Dominio~$15–30 USD / ano
Stripe3.6% + $3 MXN por transaccion
↑ Volver arriba

VI. Calidad y Soporte

6.1 Criterios de Exito

Funcionalidad
  • 7 modulos operativos sin bugs criticos
  • 20 pacientes migrados exitosamente
  • Calculos nutricionales validados (<1% desviacion)
Usabilidad
  • Uso sin ayuda post-capacitacion
  • Creacion de plan alimenticio en <20% del tiempo actual
Performance
  • Carga de pagina <4 segundos
  • Uptime >99%
Satisfaccion
  • Encuesta de satisfaccion ≥8/10

6.2 SLA Hypercare

Severidad Tiempo de Respuesta Ejemplo
Critico 1–2 horas Sistema caido, perdida de datos
Alto 4–8 horas Funcion principal no opera correctamente
Medio / Bajo 24–36 horas Problemas esteticos, mejoras menores

6.3 Periodo de Garantia

1 mes calendario post-deploy.

Incluye

  • Correccion de bugs identificados
  • Soporte prioritario via canal dedicado
  • Ajustes menores de usabilidad

No incluye

  • Nuevas funcionalidades o features no contempladas
  • Cambios mayores de alcance o rediseno
  • Soporte 24/7 (se maneja en horario laboral)
↑ Volver arriba

VII. Terminos y Condiciones

7.1 Propiedad Intelectual

  • El codigo fuente desarrollado es propiedad 100% del Cliente al completar el pago total.
  • HIXION retiene propiedad de frameworks, librerias y herramientas internas preexistentes.
  • El Cliente recibe licencia perpetua de uso de componentes reutilizables de HIXION integrados en la plataforma.
  • Ambas partes pueden referenciar el proyecto en sus portafolios (salvo acuerdo de confidencialidad).

7.2 Confidencialidad

Ambas partes se comprometen a mantener la confidencialidad de la informacion tecnica, comercial y de pacientes compartida durante el proyecto. Esta obligacion se extiende 2 anos despues de la terminacion del contrato.

7.3 Responsabilidades

Proveedor (HIXION)
  • Entregar los modulos segun el cronograma acordado
  • Mantener comunicacion constante sobre avances y bloqueos
  • Garantizar calidad del codigo y documentacion tecnica
  • Proporcionar capacitacion y soporte durante Hypercare
Cliente
  • Proveer informacion y datos requeridos en tiempo
  • Participar en Discovery Workshop y sesiones de feedback
  • Aprobar entregables en los plazos acordados
  • Designar un punto de contacto con poder de decision

7.4 Gestion de Cambios

Todo cambio de alcance sigue este proceso:

  • 1. Solicitud: El solicitante documenta el cambio requerido por escrito
  • 2. Evaluacion: HIXION analiza impacto en tiempo, costo y recursos (24–48 horas)
  • 3. Propuesta: Se presenta al Cliente con estimacion de impacto
  • 4. Aprobacion: Ambas partes firman el addendum antes de iniciar
  • 5. Ejecucion: Se integra al sprint correspondiente o se agenda nuevo sprint

7.5 Bolsa de Horas Adicionales

Se puede contratar una bolsa de horas para trabajo fuera del alcance original. Las horas se consumen bajo demanda, con reporte semanal de uso. La tarifa y condiciones se acuerdan por separado.

7.6 Clausulas de Retraso

Por parte del Cliente
  • Si la informacion requerida (Seccion 3.5) no se entrega a tiempo, los sprints dependientes se recorren proporcionalmente
  • Si la aprobacion de entregables tarda mas de 5 dias habiles, el cronograma se ajusta equivalentemente
  • Si el Discovery Workshop se postpone, todo el cronograma se recorre
Por parte del Proveedor
  • Si un sprint se retrasa por causa del Proveedor, se extiende el Hypercare proporcionalmente sin costo adicional
  • Si el retraso acumulado excede 3 semanas, el Cliente puede solicitar plan de recuperacion formal
  • Dependencias entre sprints: Sprint 1 bloquea Sprint 2 (nutricion); Sprint 3 requiere Sprint 0 y 1 completados

7.7 Causales de Terminacion o Pausa

  • Mutuo acuerdo por escrito entre ambas partes
  • Incumplimiento material no remediado en 15 dias habiles posterior a notificacion
  • Falta de pago por mas de 30 dias naturales
  • Fuerza mayor que imposibilite la continuacion por mas de 60 dias
  • El proyecto puede pausarse por mutuo acuerdo, con retoma bajo condiciones pactadas

7.8 Limitacion de Responsabilidad

La responsabilidad maxima de HIXION se limita al monto total pagado por el Cliente por los servicios de Fase 1. HIXION no sera responsable por danos indirectos, consecuentes, perdida de beneficios o datos derivados del uso o imposibilidad de uso de la plataforma.

7.9 Resolucion de Controversias

Las partes intentaran resolver cualquier controversia mediante negociacion directa. Si no se alcanza acuerdo en 30 dias, se sometera a mediacion y, en su caso, arbitraje conforme a las leyes aplicables en Queretaro, Mexico.

7.10 Fuerza Mayor

Ninguna parte sera responsable por incumplimiento causado por eventos fuera de su control razonable, incluyendo pero no limitado a: desastres naturales, pandemias, acciones gubernamentales, fallas de infraestructura de terceros, o interrupciones de servicios de internet. La parte afectada notificara a la otra en un plazo maximo de 5 dias habiles.

↑ Volver arriba

VIII. Gaps Identificados

Features Comprometidas Pendientes de Documentacion

Features prometidas en el estatuto original que requieren especificacion tecnica detallada.

# Feature Modulo Prioridad Descripcion del Gap
1 Modo Offline PWA Comunicacion ALTA Caching strategy, sync protocol, que datos disponibles offline (plan del dia, rutina, historial reciente)
2 Gestion de Suplementacion Nutricion ALTA Dosis, horarios, link externo a Odoo. Modulo completo sin especificacion
3 Sync Google Calendar Agenda ALTA OAuth flow, sync bidireccional, multiples calendarios. Sin API spec
4 Logica No-Show / Cancelaciones Pagos MEDIA Reglas: pausar acceso, descontar sesion paquete, cargo penalizacion. Sin spec de reglas de negocio
5 Control Acceso por Pago Pagos MEDIA Vencimiento = acceso restringido automatico. Sin especificacion
6 Salud Femenina Expedientes MEDIA Campos ciclo menstrual, sintomatologia. Activacion condicional por genero
7 Enlace Rapido QR Expedientes MEDIA QR en pantalla para subir evidencias sin login completo
8 Deteccion de Conflictos Agenda MEDIA Revision automatica de todos calendarios conectados
9 Workflows Pre-Consulta Agenda MEDIA Recordatorios por tags, formularios de chequeo X horas antes
10 Galeria Fotos Antes/Despues Expedientes MEDIA Galeria comparativa de progreso visual
11 Timestamp Ultima Conexion Expedientes BAJA Visualizacion en listados para monitorear abandono
12 Filtros de Desempeno Dashboard BAJA “Pacientes Top” (>90% adherencia)
13 Metrica Last Active Dashboard BAJA Leaderboard para seguimiento y felicitacion
14 Onboarding Guiado Roles BAJA Wizard para usuarios invitados
15 Base SMAE 1500+ alimentos Nutricion CRITICA Solo hay 55 alimentos mock. Requiere datos reales de Gerardo
Nota: Estos gaps deben resolverse durante Sprint 0 (Discovery Workshop) o documentarse como parte del backlog con la aprobacion del cliente.
↑ Volver arriba
GR Wellness Platform — Fase 1  |  HIXION  |  Marzo 2026  |  Documento interno para equipo de desarrollo