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
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
### 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**: 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
@@ -16,6 +32,9 @@ Sistema de mensajería automatizada para Discord y Telegram con traducción auto
- MySQL 8.0+
- Composer
- Servidor web (Apache/Nginx)
- LibreTranslate (para traducciones)
- Cuenta de Discord Developer
- Bot de Telegram
## 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
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
@@ -37,8 +62,12 @@ DB_PASS=
# Telegram
TELEGRAM_BOT_TOKEN=
TELEGRAM_WEBHOOK_TOKEN=
# Discord
DISCORD_GUILD_ID=
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_BOT_TOKEN=
# LibreTranslate
@@ -47,38 +76,76 @@ LIBRETRANSLATE_URL=http://localhost:5000
# IA (Groq)
GROQ_API_KEY=
# Knowledge Base
# Knowledge Base (para IA)
KB_DB_HOST=
KB_DB_PORT=
KB_DB_NAME=
KB_DB_USER=
KB_DB_PASS=
# JWT
JWT_SECRET=
```
## Comandos
### Telegram
- `#lista` - Enviar plantilla de lista
- `hola` - Mostrar botones de traducción
- `/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
- `#lista` - Enviar plantilla de lista
- `#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
├── 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
│ ├── 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