mirror of
https://github.com/marcogll/gloria_app.git
synced 2026-03-15 14:24:44 +00:00
196 lines
4.4 KiB
Markdown
196 lines
4.4 KiB
Markdown
# 🧠 Gloria – Plataforma de Gestión Terapéutica
|
||
|
||
Sistema modular de alta gama para la gestión de pacientes, triaje de crisis y automatización de agenda terapéutica.
|
||
|
||
---
|
||
|
||
## 📖 Descripción General
|
||
|
||
**Gloria** es una solución digital diseñada para la terapeuta Gloria Niño. El sistema optimiza la interacción entre la terapeuta, su asistente y los pacientes mediante un enfoque *phone-first* (identificación vía WhatsApp) y una estética visual premium inspirada en el bienestar y la sanación integral.
|
||
|
||
---
|
||
|
||
## 🎨 Referencia Visual (Mockup)
|
||
|
||
> **Importante:** Se ha creado un prototipo visual de alta fidelidad en la carpeta `mockup/`.
|
||
> Este prototipo (`index.html` + `styles.css`) debe utilizarse como **referencia estricta de diseño** (colores, tipografía, espaciado, animaciones) para la implementación en Next.js.
|
||
> La carpeta `mockup/` incluye una copia local de los assets en `mockup/src/` para ser totalmente autónoma.
|
||
|
||
### Nota para Desarrollo
|
||
El código de producción se implementará en **Next.js** dentro de la carpeta `src/`. El mockup es un artefacto separado para aprobación de diseño.
|
||
|
||
---
|
||
|
||
## 🚀 Arquitectura del Sistema
|
||
|
||
El proyecto sigue una arquitectura de **Monolito Modular**, manteniendo simplicidad de despliegue en VPS sin sacrificar escalabilidad interna.
|
||
|
||
### Tech Stack
|
||
|
||
**Frontend**
|
||
|
||
* Next.js 14 (App Router)
|
||
* Tailwind CSS
|
||
* Radix UI
|
||
|
||
**Backend**
|
||
|
||
* Next.js Server Actions
|
||
* API Routes
|
||
|
||
**Base de Datos**
|
||
|
||
* SQLite
|
||
* Prisma ORM
|
||
|
||
**Caché y Estado**
|
||
|
||
* Redis (sesiones y disponibilidad)
|
||
|
||
**Integraciones**
|
||
|
||
* Evolution API (WhatsApp)
|
||
* Google Calendar
|
||
|
||
**Infraestructura**
|
||
|
||
* Docker
|
||
* Docker Compose
|
||
* Hostinger VPS
|
||
|
||
---
|
||
|
||
## 📂 Estructura de Carpetas
|
||
|
||
```bash
|
||
├── mockup # ⚠️ HTML/CSS de referencia visual (NO usar en producción)
|
||
│ ├── index.html # Prototipo estático del sitio
|
||
│ └── styles.css # Estilos de referencia
|
||
├── src
|
||
│ ├── app # Rutas, Layouts y Server Components
|
||
│ │ ├── (auth) # Flujo de identificación por teléfono
|
||
│ │ ├── (dashboard) # Paneles de Gloria y Asistente
|
||
│ │ └── api # Webhooks y endpoints
|
||
│ ├── components # UI Kit
|
||
│ ├── core # Casos de uso
|
||
│ ├── infrastructure # Adaptadores externos
|
||
│ └── lib # Utilidades
|
||
├── prisma # Esquema y migraciones
|
||
├── docker # Configuración Docker
|
||
└── scripts # Tareas programadas
|
||
```
|
||
|
||
> **Nota:** La carpeta `mockup/` contiene únicamente prototipos HTML/CSS estáticos para referencia visual durante el desarrollo. El código de producción se implementará en Next.js dentro de `src/`.
|
||
|
||
---
|
||
|
||
## 🛠 Instalación y Configuración
|
||
|
||
### Prerrequisitos
|
||
|
||
* Node.js 18+
|
||
* Docker & Docker Compose
|
||
* Instancia activa de Evolution API
|
||
|
||
---
|
||
|
||
### Pasos de Configuración
|
||
|
||
#### 1. Clonar Repositorio
|
||
|
||
```bash
|
||
git clone https://github.com/usuario/gloria-platform.git
|
||
cd gloria-platform
|
||
```
|
||
|
||
#### 2. Variables de Entorno
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
Configurar valores en `.env`.
|
||
|
||
#### 3. Levantar Redis
|
||
|
||
```bash
|
||
docker-compose up -d redis
|
||
```
|
||
|
||
#### 4. Base de Datos
|
||
|
||
```bash
|
||
npx prisma db push
|
||
```
|
||
|
||
#### 5. Ejecutar en Desarrollo
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
---
|
||
|
||
## 🔐 Variables de Entorno
|
||
|
||
| Variable | Descripción |
|
||
| ------------------ | --------------------------- |
|
||
| DATABASE_URL | Ruta a la base SQLite |
|
||
| REDIS_URL | Conexión Redis |
|
||
| EVOLUTION_API_KEY | Token WhatsApp API |
|
||
| GOOGLE_CALENDAR_ID | ID del calendario principal |
|
||
|
||
---
|
||
|
||
## 🛡 Políticas de Datos y Privacidad
|
||
|
||
### Notas Clínicas
|
||
|
||
* Encriptadas en reposo
|
||
* Acceso exclusivo rol Terapeuta
|
||
|
||
### Audios
|
||
|
||
* Almacenamiento temporal
|
||
* Eliminación automática a 7 días
|
||
|
||
### Identificación
|
||
|
||
* Sin contraseñas
|
||
* Validación vía WhatsApp + Redis
|
||
|
||
---
|
||
|
||
## 🚢 Despliegue en Producción (Hostinger VPS)
|
||
|
||
Usar configuración optimizada:
|
||
|
||
```bash
|
||
docker-compose -f docker-compose.prod.yml up -d --build
|
||
```
|
||
|
||
Características:
|
||
|
||
* Auto-restart
|
||
* Persistencia de datos
|
||
* Volúmenes aislados
|
||
|
||
---
|
||
|
||
## 📌 Mantenimiento
|
||
|
||
* Limpieza automática de audios (`/scripts`)
|
||
* Backups periódicos de SQLite
|
||
* Rotación de logs Docker
|
||
|
||
---
|
||
|
||
## 📄 Licencia y Proyecto
|
||
|
||
Desarrollado para el proyecto:
|
||
|
||
**Sanación Integral – Gloria Niño**
|
||
|
||
Uso interno y confidencial.
|
||
|