FiveM Store - Marketplace Premium

Una plataforma moderna de comercio electrónico diseñada específicamente para la comunidad de FiveM, donde los usuarios pueden comprar y descargar scripts, assets y recursos premium para sus servidores.

🚀 Resumen del Proyecto

FiveM Store ofrece una experiencia de usuario premium con soporte multi-idioma (Español/Inglés), sistema de tickets en tiempo real, notificaciones vía WebSockets y un panel de administración completo para gestionar el inventario y las órdenes.

🛠️ Stack Tecnológico

• Framework: Next.js 16 (App Router) con React 19.
• Base de Datos: PostgreSQL con Prisma ORM.
• Pagos: Integración completa con Stripe Checkout.
• Autenticación: Sistema personalizado basado en Cookies de sesión seguras.
• Comunicación: Socket.io para actualizaciones en tiempo real y notificaciones.
• Estilos: Tailwind CSS con componentes de UI modernos.
• Internacionalización: next-intl para soporte multi-idioma.
• Correos: Nodemailer para confirmaciones de compra y notificaciones.

✨ Funcionalidades

• E-commerce: Carrito de compras, sistema de descuentos y pasarela de pago segura.
• Descargas Seguras: Sistema de tokens temporales de un solo uso para proteger el contenido digital.
• Panel de Administración: Gestión de productos, categorías, pedidos (órdenes) y soporte al cliente.
• Soporte Real-time: Chat de tickets integrado con notificaciones instantáneas.
• Diseño Premium: Interfaz responsive, modo oscuro y animaciones fluidas.
• Autocorrección de Dependencias: Script postinstall integrado para corregir errores conocidos de declaración de Next.js.

🌍 Guía de Despliegue

1. Variables de Entorno

Copia .env.example a .env y configura todas las variables necesarias:

• DATABASE_URL: Conexión de PostgreSQL.
• STRIPE_SECRET_KEY y STRIPE_WEBHOOK_SECRET: Credenciales de Stripe.
• ADMIN_EMAIL y ADMIN_PASSWORD: Credenciales para el panel de administración.
• GMAIL_USER y GMAIL_PASS: Configuración para el envío de correos electrónicos.

2. Despliegue en Vercel

1. Repositorio: Sube tu código a GitHub/GitLab.
2. Importar: Crea un nuevo proyecto en Vercel e importa tu repositorio.
3. Configuración:
   • Framework Preset: Next.js.
   • Build Command: next build.
   • Install Command: npm install. (El script postinstall se ejecutará automáticamente para reparar archivos corruptos de Next.js).
4. Variables de Entorno: Añade manualmente todas las variables listadas en tu .env.
5. Base de Datos: Asegúrate de que tu base de Datos PostgreSQL sea accesible desde Vercel.

3. Despliegue en Coolify

Si prefieres auto-alojar la aplicación con Coolify:

1. Recurso: Crea un nuevo recurso "Next.js" o "Dockerfile" (recomendado).
2. Dockerfile: El proyecto está optimizado para ejecutarse en contenedores. Asegúrate de configurar el puerto 3000.
3. Base de Datos: Puedes usar una base de datos PostgreSQL gestionada por Coolify en la misma red.
4. Health Check: Configura un health check para la ruta / o una API pública.
5. Variables: Configura el entorno en la pestaña "Environment Variables".

🛠️ Desarrollo Local

# Instalar dependencias
npm install

# Generar cliente Prisma
npx prisma generate

# Iniciar servidor de desarrollo
npm run dev

---

Desarrollado con ❤️ para la comunidad de FiveM.