Estatuto del Proyecto
Plataforma Integral de Nutricion y Fitness — Fase 1: Plataforma Base de Nutricion + Cascaron Fitness
I. Informacion General
1.1 Datos de las Partes
1.2 Equipo de Trabajo
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
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 |
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 Workshop | Semana 1 |
| Pruebas de Aceptacion | Semanas 2 y 4 |
| Pruebas de Usabilidad | Semanas 6 y 8 |
| Pruebas de Funcionalidad | Semanas 9–10 y 11–12 |
III. Alcance Tecnico — Fase 1
3.1 Modulos Funcionales
7 modulos principales + cascaron visual de fitness. Haz clic para expandir cada modulo.
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)
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)
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)
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)
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)
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)
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
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
3.3 Entregables Tecnicos
Web App + PWA instalable (iOS / Android)
Identidad visual del Cliente aplicada a toda la plataforma
Repositorio completo, 100% propiedad del Cliente
2–3 horas grabadas + manuales de uso
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)
IV. Arquitectura y Seguridad
4.1 Stack Tecnologico
| Capa | Tecnologia | Proposito |
|---|---|---|
| Frontend | Next.js + React | SSR, rendimiento optimo |
| UI Components | shadcn/ui + Tailwind | Componentes profesionales reutilizables |
| Backend | NestJS | API robusta, cifrado, escalable |
| Base de Datos | Firebase (Firestore) | Tiempo real, escalable, serverless |
| CDN / Seguridad | Cloudflare | SSL/TLS, proteccion DDoS |
| Pagos | Stripe | Procesamiento seguro de pagos |
| App Nativa | Capacitor | PWA wrapper para iOS y Android |
| Multi-idioma | i18next o React-Intl | Espanol 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
HTTPS / TLS obligatorio. Cloudflare SSL para todas las conexiones.
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
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 |
5.2 Costos Recurrentes (No Incluidos en el Proyecto)
| Servicio | Costo Estimado |
|---|---|
| Firebase | Pago por uso escalable (free tier generoso para inicio) |
| Dominio | ~$15–30 USD / ano |
| Stripe | 3.6% + $3 MXN por transaccion |
VI. Calidad y Soporte
6.1 Criterios de Exito
- 7 modulos operativos sin bugs criticos
- 20 pacientes migrados exitosamente
- Calculos nutricionales validados (<1% desviacion)
- Uso sin ayuda post-capacitacion
- Creacion de plan alimenticio en <20% del tiempo actual
- Carga de pagina <4 segundos
- Uptime >99%
- 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)
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
- 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
- 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
- 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
- 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.
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 |