# BeeLife Social Post - Manual de Uso, Tecnologías y Control de Costes IA

## Tecnologías utilizadas

- **Frontend:** HTML, CSS (Tailwind), JavaScript (modular, con componentes como sidebar y API helpers)
- **Backend:** Node.js + Express
- **APIs IA integradas:**
  - Google Vertex AI (Imagen y Veo Video)
  - OpenAI (DALL-E 3)
  - Deepseek (texto)
  - Google Gemini
- **Base de datos:** Firebase Firestore (para historial, posts, favoritos, etc.)

## Estructura de carpetas relevante

- `/public` → Archivos estáticos y páginas web
- `/public/js/` → Lógica JS compartida (API, sidebar, helpers)
- `/veo2-proxy.js` → Backend proxy para generación de video con Veo
- `/vertexai-proxy.js` → Backend proxy para generación de imágenes

## Puertos por defecto y cómo cambiarlos

- **Frontend:** 3000 (`http-server ./public -p 3000`)
- **Backend imágenes:** 3080 (`vertexai-proxy.js`)
- **Backend video:** 3090 (`veo2-proxy.js`)

Si cambias algún puerto (por ejemplo, porque ya está ocupado):
- Modifica el número de puerto en el correspondiente archivo `.js` (busca `const PORT = ...` o en los scripts `start-app.cmd`)
- Asegúrate de actualizar las URLs en los archivos JS del frontend que hagan llamadas directas (ej: `/public/js/video-api.js`)
- Si tienes un proxy de desarrollo (React, Vite, etc.), actualiza la configuración del proxy para redirigir correctamente.

## Requisitos para ejecutar

1. Tener instalado **Node.js** y **npm**.
2. Tener instalado **FFmpeg** si quieres calcular la duración real de los videos (para control de costes).
3. Ejecutar el script `start-app.cmd` para lanzar todos los servicios necesarios.

## Control y consulta de gastos IA

### Google Vertex AI
- [Panel de facturación Google Cloud](https://console.cloud.google.com/billing)
- [Precios Vertex AI Imagen y Veo](https://cloud.google.com/vertex-ai/generative-ai/pricing)
- [Historial de uso de Vertex AI](https://console.cloud.google.com/vertex-ai)

### OpenAI (DALL-E, GPT, etc)
- [Dashboard de gastos OpenAI](https://platform.openai.com/usage)
- [Precios OpenAI](https://openai.com/api/pricing/)

### Deepseek
- [Página oficial de precios Deepseek](https://deepseek.com/pricing) *(si existe, consulta tu panel de control)*

### Gemini (Google)
- [Precios Gemini](https://ai.google.dev/pricing)
- [Facturación Google Cloud](https://console.cloud.google.com/billing)

## Control de gastos dentro de la app
- El archivo `/public/js/ai-cost-config.js` centraliza los precios por operación (token, imagen, segundo de video, etc.)
- El historial (`beelife-history.html`) muestra el coste real de cada operación, incluyendo duración real de videos y coste calculado.
- Si integras nuevas IAs, añade su coste en `ai-cost-config.js` y actualiza el historial para reflejarlo.

## Advertencias importantes
- **La duración de los videos generados por Veo puede ser mayor a la solicitada.** El coste se calcula según la duración real, no la solicitada.
- Revisa periódicamente los dashboards de cada proveedor para evitar sorpresas en la facturación.
- Si cambias de servidor o puertos, revisa todas las URLs de conexión y los scripts de inicio.

---

¿Dudas? Consulta la documentación oficial de cada proveedor o contacta con el desarrollador principal del proyecto.
