🛡️ SentriX Security Bot

Sistema Global de Seguridad para WhatsApp

Bot de seguridad avanzado para WhatsApp con soporte global, blacklist automática, reportes y auditoría completa.

Características • Instalación • Comandos • Docker • Arquitectura

✨ Características

🔐 Seguridad Avanzada

✅ Blacklist Global: Sistema de baneos permanentes con sincronización automática
✅ Auto-Expulsión: Expulsa automáticamente usuarios baneados al unirse a grupos
✅ Validación Internacional: Soporte para números de +195 países (formato E.164)
✅ Auditoría Completa: Registro detallado de todas las acciones con timestamps

📊 Gestión y Reportes

✅ Sistema de Reportes: Seguimiento de usuarios sospechosos con historial
✅ Exportación Múltiple: Genera reportes en PDF y Excel profesionales
✅ Búsqueda Avanzada: Localiza usuarios en blacklist y reportes instantáneamente
✅ Panel Web: Interfaz moderna con Next.js 15 y React 19

🚀 Tecnología

✅ TypeScript: Código type-safe y mantenible
✅ Arquitectura Modular: Comandos y eventos separados
✅ Docker Ready: Despliegue 24/7 con un solo comando
✅ Reconexión Automática: Sistema resiliente con backoff exponencial
✅ QR Code Auth: Autenticación segura sin pairing code

🚀 Instalación

Requisitos Previos

Node.js 22+ (Descargar)
npm o pnpm
Docker Desktop (opcional, para despliegue 24/7)

Instalación Rápida

# Clonar el repositorio
git clone https://github.com/tu-usuario/sentrix-security-bot.git
cd sentrix-security-bot

# Instalar dependencias
npm install

# Iniciar en modo desarrollo
npm run dev

Opciones de Ejecución

🔹 Modo Desarrollo (Bot + Panel Web)

npm run dev
# Bot: Terminal
# Panel: http://localhost:3000

🔹 Solo Bot

npm run bot

🔹 Solo Panel Web

npm run dev:web

🔹 Producción

npm run build
npm start

🐳 Docker

Despliegue 24/7 con Docker

La forma más fácil y confiable de ejecutar SentriX 24/7:

# Iniciar bot y panel web
npm run docker:up

# Ver logs en tiempo real
npm run docker:logs

# Ver estado de contenedores
npm run docker:status

# Reiniciar servicios
npm run docker:restart

# Detener todo
npm run docker:down

# Reconstruir después de cambios
npm run docker:build

Servicios Docker

sentrix-bot: Bot de WhatsApp (puerto interno)
sentrix-web: Panel web en http://localhost:3000

Persistencia de Datos

Los siguientes directorios se montan como volúmenes:

src/auth/ - Sesión de WhatsApp (QR code)
src/data/ - Blacklist, reportes, configuración
src/logs/ - Auditoría y logs del sistema
src/exports/ - Archivos PDF y Excel generados

📱 Comandos

🔐 Seguridad

Comando	Descripción	Ejemplo
`/ban <número> <motivo>`	Banear usuario permanentemente	`/ban +573001234567 spam`
`/blacklist`	Ver lista completa de baneados	`/blacklist`
`/kick black <número>`	Expulsar usuario específico del grupo	`/kick black +573001234567`
`/kick allblack`	Expulsar todos los baneados del grupo	`/kick allblack`

📋 Reportes

Comando	Descripción	Ejemplo
`/addreport <número> <motivo>`	Agregar reporte de usuario	`/addreport +573001234567 comportamiento sospechoso`
`/report`	Ver todos los reportes activos	`/report`
`/buscar <número>`	Buscar usuario en blacklist y reportes	`/buscar +573001234567`

⚙️ Sistema

Comando	Descripción	Ejemplo
`/ping`	Verificar latencia del bot	`/ping`
`/menu`	Mostrar menú completo de comandos	`/menu`
`/setprefijo <nuevo>`	Cambiar prefijo de comandos	`/setprefijo !`
`/export <tipo>`	Exportar datos (pdf/excel)	`/export pdf` o `/export excel`

🏗️ Arquitectura

Diseño del Sistema

SentriX utiliza una arquitectura de dos procesos independientes que se comunican vía WebSocket:

┌─────────────────────────────────────────────────────────┐
│                    SENTRIX SYSTEM                       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────────────┐         ┌──────────────────┐    │
│  │   Panel Web      │         │   WhatsApp Bot   │    │
│  │  (Next.js 15)    │◄───────►│   (Baileys)      │    │
│  │  Express + WS    │  Socket │   TypeScript     │    │
│  └──────────────────┘         └──────────────────┘    │
│         │                              │               │
│         │                              │               │
│         ▼                              ▼               │
│  ┌─────────────────────────────────────────────────┐  │
│  │         Persistent Storage (JSON)               │  │
│  │  • blacklist.json  • reports.json              │  │
│  │  • config.json     • audit.json                │  │
│  └─────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘

Flujo de Eventos

Conexión: Bot se conecta a WhatsApp vía QR code
Monitoreo: Escucha eventos de mensajes y grupos
Validación: Verifica comandos y permisos de admin
Procesamiento: Ejecuta comandos modulares
Persistencia: Guarda cambios en JSON local
Auditoría: Registra todas las acciones
Sincronización: Actualiza panel web vía WebSocket

� Estructura del Proyecto

``` src/ ├── index.ts # Punto de entrada ├── handler.ts # Manejador de comandos ├── types/ # Definiciones TypeScript ├── commands/ # Comandos individuales │ ├── ban.ts │ ├── blacklist.ts │ ├── addreport.ts │ ├── report.ts │ ├── buscar.ts │ ├── ping.ts │ ├── menu.ts │ ├── setprefix.ts │ ├── export.ts │ ├── kickBlack.ts │ └── kickAllBlack.ts ├── events/ # Manejadores de eventos │ ├── groupJoin.ts │ └── connection.ts ├── utils/ # Utilidades │ ├── storage.ts │ ├── validator.ts │ └── formatter.ts ├── data/ # Almacenamiento JSON │ ├── blacklist.json │ ├── reports.json │ └── config.json ├── logs/ # Auditoría │ └── audit.json ├── exports/ # Exportaciones └── auth/ # Sesión de WhatsApp ```

🌍 Validación Internacional

El bot utiliza libphonenumber-js para validar números de teléfono de todos los países del mundo en formato E.164.

Ejemplos de números válidos:

+1 555 123 4567 (USA)
+52 55 1234 5678 (México)
+58 424 201 1278 (Venezuela)
+34 612 34 56 78 (España)
+86 138 0000 0000 (China)

🔐 Seguridad

Expulsión automática de usuarios blacklisted al unirse a grupos
Auditoría completa de todas las acciones
Validación de permisos de administrador
Registro de actores en cada acción

📊 Exportación de Datos

El bot puede exportar todos los datos a:

PDF: Reporte completo con formato profesional
Excel: Hojas separadas para blacklist, reportes y auditoría

🛠️ Stack Tecnológico

Backend (Bot)

TypeScript 5 - Type-safe JavaScript
@whiskeysockets/baileys - WhatsApp Web API
libphonenumber-js - Validación internacional de números
Pino - Logger de alto rendimiento
tsx - TypeScript execution

Frontend (Panel)

Next.js 15.2.4 - React framework
React 19 - UI library
TailwindCSS 4 - Utility-first CSS
shadcn/ui - Componentes modernos
Lucide React - Iconos

Exportación

ExcelJS - Generación de archivos Excel
PDFKit - Generación de PDFs
Sharp - Procesamiento de imágenes

DevOps

Docker - Containerización
Docker Compose - Orquestación multi-contenedor
PM2 - Process manager (alternativa)

📸 Screenshots

Bot en Acción

╔═══════════════════════════════════════╗
║   ✅ SENTRIX SECURITY BOT ACTIVO     ║
╚═══════════════════════════════════════╝

🔐 Bot conectado y listo para moderar
💠 Desarrollado por Andres
♻️ Modo 24/7 activado

Panel Web

Dashboard con estadísticas en tiempo real
Gestión de blacklist y reportes
Visualización de auditoría
Exportación de datos

🔒 Seguridad y Privacidad

✅ Sin almacenamiento en la nube: Todos los datos se guardan localmente
✅ Autenticación QR: No requiere número de teléfono ni pairing code
✅ Validación de permisos: Solo administradores pueden ejecutar comandos
✅ Auditoría completa: Registro de quién, qué, cuándo y dónde
✅ Formato E.164: Validación estricta de números internacionales

🐛 Troubleshooting

El bot no se conecta

# Eliminar sesión anterior
rm -rf src/auth/*

# Reiniciar bot
npm run bot

Error con PM2 en Windows

PM2 tiene problemas con Node.js 22 en Windows. Usa Docker:

npm run docker:up

Puerto 3000 ocupado

# Cambiar puerto en docker-compose.yml
ports:
  - "3001:3000"  # Usa 3001 en lugar de 3000

🤝 Contribuir

¿Quieres mejorar SentriX? ¡Las contribuciones son bienvenidas!

Fork el proyecto
Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
Commit tus cambios (git commit -m 'Add: AmazingFeature')
Push a la rama (git push origin feature/AmazingFeature)
Abre un Pull Request

📞 Soporte

¿Necesitas ayuda?

📧 Email: soporte@sentrix.com
💬 Discord: Únete al servidor
📖 Documentación: Wiki del proyecto

🗺️ Roadmap

API REST para integración externa
Base de datos PostgreSQL (opcional)
Comandos con IA (OpenAI/Gemini)
Multi-idioma (i18n)
Sistema de roles y permisos
Estadísticas avanzadas con gráficos
Webhooks para notificaciones
App móvil (React Native)

👨‍💻 Desarrollador

Desarrollado por Andres 💠

📄 Licencia

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
.next		.next
.vscode		.vscode
app		app
components		components
hooks		hooks
lib		lib
logs		logs
node_modules		node_modules
public		public
src		src
styles		styles
.dockerignore		.dockerignore
Dockerfile		Dockerfile
README.md		README.md
blacklist.py		blacklist.py
components.json		components.json
docker-compose.yml		docker-compose.yml
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

JDProgramer802/sentrix-security-bot

Folders and files

Latest commit

History

Repository files navigation

🛡️ SentriX Security Bot

✨ Características

🔐 Seguridad Avanzada

📊 Gestión y Reportes

🚀 Tecnología

🚀 Instalación

Requisitos Previos

Instalación Rápida

Opciones de Ejecución

🔹 Modo Desarrollo (Bot + Panel Web)

🔹 Solo Bot

🔹 Solo Panel Web

🔹 Producción

🐳 Docker

Despliegue 24/7 con Docker

Servicios Docker

Persistencia de Datos

📱 Comandos

🔐 Seguridad

📋 Reportes

⚙️ Sistema

🏗️ Arquitectura

Diseño del Sistema

Flujo de Eventos

� Estructura del Proyecto

🌍 Validación Internacional

🔐 Seguridad

📊 Exportación de Datos

🛠️ Stack Tecnológico

Backend (Bot)

Frontend (Panel)

Exportación

DevOps

📸 Screenshots

Bot en Acción

Panel Web

🔒 Seguridad y Privacidad

🐛 Troubleshooting

El bot no se conecta

Error con PM2 en Windows

Puerto 3000 ocupado

🤝 Contribuir

📞 Soporte

🗺️ Roadmap

👨‍💻 Desarrollador

📄 Licencia

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages