Docs: Actualizar README con nuevas características

- 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
This commit is contained in:
2026-02-20 17:01:00 -06:00
parent 509c7e1709
commit 880940f515

81
README.md Normal file → Executable file
View File

@@ -1,14 +1,30 @@
# Last War - Sistema de Mensajería Multiplataforma # Last War - Sistema de Mensajería Multiplataforma
Sistema de mensajería automatizada para Discord y Telegram con traducción automática y asistente IA. Sistema de mensajería automatizada para Discord y Telegram con traducción automática, asistente IA y soporte multi-idioma.
## Características ## Características
### Mensajería
- **Discord Bot**: Envío de mensajes, traducción automática, comandos (#lista) - **Discord Bot**: Envío de mensajes, traducción automática, comandos (#lista)
- **Telegram Bot**: Webhook para mensajes, traducción con botones inline - **Telegram Bot**: Webhook para mensajes, traducción con botones inline
- **Traducción Automática**: LibreTranslate con detección de idioma - **Traducción Automática**: LibreTranslate con detección de idioma
- **Asistente IA**: Integración con Groq para respuestas inteligentes - **Asistente IA**: Integración con Groq para respuestas inteligentes
- **Panel de Administración**: Gestiona usuarios, mensajes, plantillas y configuración
### 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 ## Requisitos
@@ -16,6 +32,9 @@ Sistema de mensajería automatizada para Discord y Telegram con traducción auto
- MySQL 8.0+ - MySQL 8.0+
- Composer - Composer
- Servidor web (Apache/Nginx) - Servidor web (Apache/Nginx)
- LibreTranslate (para traducciones)
- Cuenta de Discord Developer
- Bot de Telegram
## Instalación ## Instalación
@@ -24,10 +43,16 @@ Sistema de mensajería automatizada para Discord y Telegram con traducción auto
3. Configurar `.env` con las variables de entorno 3. Configurar `.env` con las variables de entorno
4. Importar estructura de base de datos 4. Importar estructura de base de datos
5. Configurar webhooks de Telegram y Discord 5. Configurar webhooks de Telegram y Discord
6. Configurar idiomas activos en el panel admin
## Variables de Entorno ## Variables de Entorno
```env ```env
# Aplicación
APP_ENV=production
APP_URL=https://tudominio.com
TZ=America/Mexico_City
# Base de datos # Base de datos
DB_HOST=localhost DB_HOST=localhost
DB_PORT=3306 DB_PORT=3306
@@ -37,8 +62,12 @@ DB_PASS=
# Telegram # Telegram
TELEGRAM_BOT_TOKEN= TELEGRAM_BOT_TOKEN=
TELEGRAM_WEBHOOK_TOKEN=
# Discord # Discord
DISCORD_GUILD_ID=
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_BOT_TOKEN= DISCORD_BOT_TOKEN=
# LibreTranslate # LibreTranslate
@@ -47,38 +76,76 @@ LIBRETRANSLATE_URL=http://localhost:5000
# IA (Groq) # IA (Groq)
GROQ_API_KEY= GROQ_API_KEY=
# Knowledge Base # Knowledge Base (para IA)
KB_DB_HOST= KB_DB_HOST=
KB_DB_PORT= KB_DB_PORT=
KB_DB_NAME= KB_DB_NAME=
KB_DB_USER= KB_DB_USER=
KB_DB_PASS= KB_DB_PASS=
# JWT
JWT_SECRET=
``` ```
## Comandos ## Comandos
### Telegram ### Telegram
- `#lista` - Enviar plantilla de lista - `/start` - Iniciar el bot
- `hola` - Mostrar botones de traducción - `#plantilla` - Enviar plantilla por nombre
- `/comandos` - Ver comandos disponibles
- `/setlang [código]` - Cambiar idioma
- `/bienvenida` - Mensaje de bienvenida
- `/agente` - Activar modo IA
### Discord ### Discord
- `#lista` - Enviar plantilla de lista - `#plantilla` - Enviar plantilla por nombre
- `/comandos` - Ver comandos disponibles - `/comandos` - Ver comandos disponibles
- `/setlang [código]` - Cambiar idioma
- `/bienvenida` - Mensaje de bienvenida
- `/agente` - Activar modo IA - `/agente` - Activar modo IA
## Estructura ## Estructura
``` ```
├── admin/ # Panel de administración ├── 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 ├── discord/ # Archivos de Discord
│ ├── senders/ # Enviadores de mensajes
│ └── converters/ # Conversores de formato
├── includes/ # Funciones principales ├── includes/ # Funciones principales
├── src/ # Clases (IA, Translate) │ ├── 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 ├── telegram/ # Archivos de Telegram
│ ├── admin/ # Configuración Telegram
│ ├── senders/ # Enviadores de mensajes
│ └── converters/ # Conversores de formato
├── templates/ # Plantillas HTML ├── templates/ # Plantillas HTML
│ ├── header.php # Cabecera con navbar
│ └── footer.php # Pie de página
├── galeria/ # Imágenes para mensajes
├── logs/ # Logs del sistema ├── logs/ # Logs del sistema
└── *.php # Archivos principales └── *.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 ## Licencia
MIT MIT