Initial commit — Sistema Generador de Guiones V4.0

Pipeline completo: URL → Whisper → GPT-4o → pgvector → Supabase
Frontend Vue 3 + Tailwind, Backend Express + Vercel serverless functions

README.md

@@ -0,0 +1,70 @@
+# Sistema Generador de Guiones IA
+
+Este repositorio contiene el sistema completo de análisis y generación de guiones virales utilizando Whisper, GPT-4o y Supabase, con una interfaz web construida en Vue 3 y Tailwind CSS.
+
+## Estructura del Proyecto
+
+El proyecto está diseñado bajo una arquitectura modular y escalable:
+
+```
+/
+├── backend/            # Lógica central (API, IA, Transcripción, Embeddings)
+│   ├── api/            # Serverless handlers (ej. api/analizar.js)
+│   ├── lib/            # Módulos de orquestación y LLM
+│   └── server.js       # Servidor Express.js para testeo y desarrollo local
+│
+├── frontend/           # Interfaz de usuario "Obsidian Architecture"
+│   ├── src/            # Vistas en Vue 3 y componentes
+│   └── tailwind...     # Configuración del Design System
+│
+├── database/           # Archivos SQL para gestionar Supabase
+│   ├── migrations/     # Setup de tablas (schema), funciones y RLS
+│   └── seeds/          # Datos de prueba para iniciar la aplicación
+│
+└── docs/               # Archivos HTML originales del diseño (referencia)
+```
+
+## 1. Configuración de Variables de Entorno
+
+En la carpeta `/backend/`, crea un archivo `.env` o renombra el existente con tus credenciales:
+
+```env
+RAPIDAPI_KEY=               # Key de Social Download All In One
+OPENAI_API_KEY=             # Key de OpenAI para GPT-4o y Whisper
+SUPABASE_URL=               # URL de tu base de datos Supabase (https://xxxx.supabase.co)
+SUPABASE_SERVICE_ROLE_KEY=  # Tu Service Role Key (no exponer en el frontend)
+```
+
+## 2. Iniciar el Sistema en Local
+
+Abre dos terminales para correr ambos entornos en simultáneo:
+
+**Terminal 1 — Backend:**
+```powershell
+cd backend
+npm install
+npm run dev
+```
+> El servicio de IA y base de datos estará corriendo en `http://localhost:3001`
+
+**Terminal 2 — Frontend:**
+```powershell
+cd frontend
+npm install
+npm run dev
+```
+> La interfaz estará disponible en `http://localhost:5173` (o `5174`)
+
+## 3. Base de Datos (Supabase)
+
+Si es la primera vez que despliegas el proyecto, dirígete a la consola SQL de tu proyecto en Supabase y ejecuta los archivos de la carpeta `/database` en el siguiente orden:
+
+1. `database/migrations/01_schema.sql`
+2. `database/migrations/02_funciones.sql`
+3. `database/migrations/03_rls.sql`
+4. `database/seeds/04_datos_prueba.sql` (Opcional)
+
+## 4. Arquitectura de Despliegue
+
+- **Frontend:** Preparado para desplegar de manera estática en Vercel, Netlify o Cloudflare Pages.
+- **Backend:** Configurado con `vercel.json` para despliegues Serverless Edge/Node en Vercel (la ruta principal será `/api/analizar`). Alternativamente, funciona como un backend en la nube utilizando el `server.js` provisto.