lastwar/README.md

Last War - Sistema de Mensajería Multiplataforma

Sistema de mensajería automatizada para Discord y Telegram con traducción automática, asistente IA y soporte multi-idioma.

Características

Mensajería

• Discord Bot: Envío de mensajes, traducción automática, comandos (#lista)
• Telegram Bot: Webhook para mensajes, traducción con botones inline
• Traducción Automática: LibreTranslate con detección de idioma
• Asistente IA: Integración con Groq para respuestas inteligentes

Panel de Administración

• Gestión de usuarios y permisos (admin/user)
• Administración de destinatarios por plataforma
• Gestión de idiomas con banderas personalizables
• Mensajes programados y recurrentes
• Galería de imágenes integrada
• Configuración del bot de Telegram
• Configuración del agente IA

Diseño y UX

• Tema Militar/Táctico: Diseño inspirado en interfaces de videojuegos
• Multi-idioma: Soporte completo para traducción de la interfaz vía LibreTranslate
• Tema Claro/Oscuro: Cambio dinámico de tema
• Navbar Horizontal: Navegación optimizada con dropdown para admin
• Responsive: Adaptado para móviles y tablets

Requisitos

• PHP 8.3+
• MySQL 8.0+
• Composer
• Servidor web (Apache/Nginx)
• LibreTranslate (para traducciones)
• Cuenta de Discord Developer
• Bot de Telegram

Instalación

1. Clonar el repositorio
2. Instalar dependencias: composer install
3. Configurar .env con las variables de entorno
4. Importar estructura de base de datos
5. Configurar webhooks de Telegram y Discord
6. Configurar idiomas activos en el panel admin

Variables de Entorno

# Aplicación
APP_ENV=production
APP_URL=https://tudominio.com
TZ=America/Mexico_City

# Base de datos
DB_HOST=localhost
DB_PORT=3306
DB_NAME=lastwar
DB_USER=root
DB_PASS=

# Telegram
TELEGRAM_BOT_TOKEN=
TELEGRAM_WEBHOOK_TOKEN=

# Discord
DISCORD_GUILD_ID=
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_BOT_TOKEN=

# LibreTranslate
LIBRETRANSLATE_URL=http://localhost:5000

# IA (Groq)
GROQ_API_KEY=

# Knowledge Base (para IA)
KB_DB_HOST=
KB_DB_PORT=
KB_DB_NAME=
KB_DB_USER=
KB_DB_PASS=

# JWT
JWT_SECRET=

Comandos

Telegram

• /start - Iniciar el bot
• #plantilla - Enviar plantilla por nombre
• /comandos - Ver comandos disponibles
• /setlang [código] - Cambiar idioma
• /bienvenida - Mensaje de bienvenida
• /agente - Activar modo IA

Discord

• #plantilla - Enviar plantilla por nombre
• /comandos - Ver comandos disponibles
• /setlang [código] - Cambiar idioma
• /bienvenida - Mensaje de bienvenida
• /agente - Activar modo IA

Estructura

├── admin/              # Panel de administración
│   ├── users.php       # Gestión de usuarios
│   ├── recipients.php  # Gestión de destinatarios
│   ├── languages.php   # Gestión de idiomas
│   ├── comandos.php    # Lista de comandos
│   ├── ia_agent.php    # Configuración IA
│   └── system.php      # Info del sistema
├── discord/            # Archivos de Discord
│   ├── senders/        # Enviadores de mensajes
│   └── converters/     # Conversores de formato
├── includes/           # Funciones principales
│   ├── db.php          # Conexión BD
│   ├── i18n.php        # Sistema de traducción
│   ├── auth.php        # Autenticación
│   └── session_check.php
├── src/                # Clases principales
│   ├── IA/             # Agente IA
│   └── Translate.php   # Traductor
├── telegram/           # Archivos de Telegram
│   ├── admin/          # Configuración Telegram
│   ├── senders/        # Enviadores de mensajes
│   └── converters/     # Conversores de formato
├── templates/          # Plantillas HTML
│   ├── header.php      # Cabecera con navbar
│   └── footer.php      # Pie de página
├── galeria/            # Imágenes para mensajes
├── logs/               # Logs del sistema
└── *.php               # Archivos principales

Sistema Multi-idioma

El sistema traduce automáticamente toda la interfaz usando LibreTranslate:

• Los idiomas se gestionan desde Admin > Idiomas
• Solo los idiomas activos aparecen en el selector
• El idioma base es español
• Las traducciones se cachean automáticamente

Licencia

MIT