dabetai API - Backend Principal

API REST para la plataforma de monitoreo de diabetes que conecta pacientes, médicos y modelos de inteligencia artificial.

� Documentación de la API

La API incluye documentación automática con Swagger UI y Scalar:

• Swagger UI: http://localhost:3000/api/docs
• Scalar UI: http://localhost:3000/api/scalar

🏥 ¿Qué es dabetai API?

dabetai API es el backend central de la plataforma integral para el monitoreo de diabetes que incluye:

• API REST (esta): backend principal para todos los servicios
• App móvil: para pacientes, monitoreo y predicciones
• App web: para médicos, seguimiento de pacientes
• API de IA: predicción de complicaciones diabéticas

La API maneja la autenticación, gestión de usuarios (pacientes y médicos), almacenamiento de datos médicos y comunicación con los modelos de IA para retinopatía, nefropatía, neuropatía y pie diabético.

✨ Funcionalidades

🔐 Autenticación JWT - registro y login de usuarios con roles (paciente, médico, admin)
� Gestión de usuarios - CRUD completo para pacientes y médicos
� Datos médicos - almacenamiento de información de diabetes y comorbilidades
� Registro en 2 pasos - cuenta básica + completar perfil médico
� Documentación automática - Swagger UI y Scalar para testing de APIs
🛡️ Seguridad robusta - hash de contraseñas, validación de datos y tokens seguros
�️ Base de datos relacional - PostgreSQL con Prisma ORM
📈 Estadísticas - endpoints para métricas de pacientes y médicos

🛠 Tecnologías

• NestJS - Framework backend escalable y modular
• TypeScript - Tipado estático para mayor robustez
• Prisma ORM - Gestión de base de datos type-safe
• PostgreSQL - Base de datos relacional
• JWT - Autenticación con tokens seguros
• Swagger/OpenAPI - Documentación automática de APIs
• bcrypt - Hash seguro de contraseñas
• class-validator - Validación de datos de entrada

⚡ Instalación rápida

Prerrequisitos

• Node.js (v18 o superior)
• PostgreSQL (v14 o superior)
• npm o yarn

Pasos

1. Clonar repositorio

bash git clone https://github.com/chrisdev-ts/dabetai-api.git cd dabetai-api

1. Instalar dependencias

bash npm install

1. Configurar base de datos Crea .env en la raíz:

env DATABASE_URL="postgresql://usuario:contraseña@localhost:5432/dabetai_db" JWT_SECRET="tu_jwt_secret_super_seguro" NODE_ENV="development"

1. Ejecutar migraciones de Prisma

bash npx prisma migrate dev npx prisma generate

1. Iniciar servidor

bash npm run start:dev

La API estará disponible en http://localhost:3000

📚 Acceder a la documentación

• Swagger UI: http://localhost:3000/api/docs
• Scalar UI: http://localhost:3000/api/scalar

🏗 Ecosistema dabetai: nuestros repositorios

dabetai está compuesto por múltiples repositorios especializados:

| Repositorio | Propósito | Estado | | ----------------------------------------------------------------------- | --------------------------- | ---------------- | | dabetai-mobileapp | App para pacientes | ✅ En desarrollo | | dabetai-webapp | App web para médicos | ✅ En desarrollo | | dabetai-aiapi | API de IA y predicciones | ✅ En desarrollo | | dabetai-aimodels | Modelos de machine learning | ✅ En desarrollo | | dabetai-landing | Página de aterrizaje | ✅ En desarrollo | | dabetai-api | API principal del backend | ✅ En desarrollo |

🤝 Colaboración interna

Seguimos convenciones específicas para mantener consistencia - consulta CONTRIBUTING.MD.

🤝 Reconocimientos

Este proyecto fue desarrollado por el equipo de autores:

• Cardenas Cabal Fermín
  
• Ortiz Pérez Alejandro
  
• Serrano Puertos Jorge Christian
  

Con la asesoría y guía conceptual de:

• Guarneros Nolasco Luis Rolando
  
• Cruz Ramos Nancy Aracely
  

Y con el apoyo académico de la
- Universidad Tecnológica del Centro de Veracruz