Project Requirements

2026-03-15 11:24:43 +00:00 · 2026-01-29 13:30:45 -06:00
parent 7147005297
commit f67ae39761
4 changed files with 682 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -1 +1,179 @@
-# gloria_app
+# 🧠 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.
+