- Diseño militar/táctico - Sistema multi-idioma con LibreTranslate - Tema claro/oscuro - Navbar horizontal - Estructura completa del proyecto - Variables de entorno actualizadas - Comandos de Telegram y Discord
152 lines
4.3 KiB
Markdown
Executable File
152 lines
4.3 KiB
Markdown
Executable File
# 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
|
|
|
|
```env
|
|
# 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
|