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:
81
README.md
Normal file → Executable file
81
README.md
Normal file → Executable 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
|
||||
|
||||
Reference in New Issue
Block a user