mirror of
https://github.com/marcogll/gloria_app.git
synced 2026-03-15 11:24:43 +00:00
180 lines
3.4 KiB
Markdown
180 lines
3.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 Wells. 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.
|
||
|
||
---
|
||
|
||
## 🚀 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
|
||
├── 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
|
||
```
|
||
|
||
---
|
||
|
||
## 🛠 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 Wells**
|
||
|
||
Uso interno y confidencial.
|
||
|