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
|
# 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
|
||||||
|
|||||||
Reference in New Issue
Block a user