Documentación de Moveat
Moveat es un producto de nutrición y fitness pensado para que los usuarios registren comidas, peso corporal y entrenamientos con la menor fricción posible. El sistema combina una aplicación web, un backend de negocio llamado Platform y un Agent conversacional que puede operar por canales como WhatsApp. Esta documentación está escrita para producto, operaciones e ingeniería. Explica qué busca resolver Moveat, cómo funcionan los flujos principales de negocio y cómo la arquitectura técnica sostiene esos flujos.Lógica de producto
Entiende qué problema resuelve Moveat y cómo funcionan los loops principales del producto.
Estado del proyecto
Revisa qué existe hoy, qué está en progreso y cuáles son las próximas prioridades.
API specs
Entiende las APIs públicas de Platform, las APIs internas para Agent y los endpoints de Agent.
Operaciones
Mira cómo encajan Vercel, DigitalOcean, Komodo, Grafana y Mintlify.
Qué hace Moveat
Moveat ayuda a los usuarios a:- Crear una cuenta y completar un onboarding fitness.
- Definir objetivos como pérdida de grasa, ganancia muscular o mantenimiento.
- Registrar comidas y calorías.
- Registrar peso corporal en el tiempo.
- Registrar entrenamientos, ejercicios, series, repeticiones y cargas.
- Usar un agente conversacional para reducir la fricción del registro manual.
Componentes principales
| Componente | Propósito |
|---|---|
| Web app | Cliente para signup, login, onboarding y dashboards. |
| Platform | Backend de negocio y fuente de verdad para datos de usuario, nutrición, entrenamiento y progreso. |
| Agent | Servicio conversacional que recibe mensajes, interpreta intención y delega acciones a Platform. |
| PostgreSQL | Fuente durable de datos de producto. |
| Redis | Estado de sesión y conversación de corta duración. |
| Grafana y Loki | Observabilidad operativa para logs, errores y comportamiento de servicios. |
| Komodo | Gestión visual de contenedores y operación. |
| Mintlify | Hosting y renderizado de documentación. |
| Vercel | Hosting del frontend y preview deployments. |
Mapa de documentación
- Overview explica lógica de producto, estado actual y arquitectura general.
- Producto explica el ciclo de vida del usuario y los módulos de tracking.
- Técnico explica Platform, Agent, APIs, auth, testing y ownership de datos.
- Operaciones explica deploy, infraestructura, entornos, observabilidad y runbooks.