v3.2.0 · Ciszu Network

Información

Identidad, marca y arquitectura de CiszuBot: la guía completa del bot de Discord de Ciszu Network, su paleta, su stack y todas las secciones del sitio.

72

Comandos

9 categorías

cz!

Prefijo

Slash incluidos

60s

Heartbeat

Estado en vivo

100%

Gratis

Sin pay-to-win

Identidad Visual

Isotipo · Logotipo · Composición

Isotipo de CiszuBot

Isotipo

Visión artística

Un brote de conversación digital que combina el azul de marca con el cian del ecosistema: un bot cercano, rápido y siempre presente en el servidor.

Especificación técnica

Pieza vectorial con variantes color y monocroma, contorno opcional y muestras sobre fondo, círculo y contorno. Entrega en .svg, .png y .webp vía CDN.

Logotipo de CiszuBot

Logotipo

Tipografía de marca

El logotipo «ciszubot» con trazo outline, disponible en color, degradado y monocromo (black/white) para fondos claros y oscuros.

Bot
Imagotipo horizontal de CiszuBot sobre fondo

Composición Maestra

El imagotipo horizontal (isotipo + logotipo) sobre fondo es la pieza de cabecera y de ancho completo. Reglas: no deformar, no rotar, no recomponer el símbolo y respetar el contraste en cada fondo.

Contraste garantizado

Variantes black y white para fondos claros y oscuros, listas para cualquier superficie.

Trazo consistente

Familia outline para máxima visibilidad y not-outline para superficies planas.

Uso en cabeceras

El imagotipo horizontal se reserva para cabeceras y piezas de ancho completo.

Colorología de Marca

Toca un valor para copiarlo

Acentos neón · tema oscuro

Valores activos con la clase .dark (tema por defecto de la web).

Acentos neón · tema claro

Mismos tokens, oscurecidos lo mínimo para mantener contraste AA.

Superficies · tema oscuro

Tokens semánticos de fondo, tarjeta, borde y tinta sobre negro.

Superficies · tema claro

Tokens semánticos de la variante clara, inspirada en la superficie del bot en Discord.

Formatos de Archivo

Entrega y fuente de los assets de marca

Vectoriales

.ai.svg

Fuente Illustrator y entrega web escalable del isotipo y del logotipo sin pérdida de calidad.

Raster

.png.webp

Isotipo, imagotipo de muestra y piezas de fondo optimizadas para carga web.

Editable

.psd

Composición del imagotipo horizontal sobre fondo, lista para retoque y maquetación.

Documentación

.md.docx.pdf.txt

Pipeline canónico de documentación del bot: texto, markdown, Word y PDF.

Nuestra Misión

Declaración central

Declaración Central

Dar a cualquier servidor de Discord una capa de comunidad completa —diversión, moderación, economía, música y utilidades— en español, gratis y sin fricción, con la calidad de ingeniería del ecosistema Ciszu Network.

72

Comandos

9 categorías en v3.2.0

cz!

Prefijo

También slash commands

60s

Heartbeat

Estado en vivo en la web

100%

Gratis

Sin pay-to-win

Visión de Futuro

Fases del proyecto

2026

Fase actual · v3.x

  • 72 comandos en 9 categorías
  • Dashboard OAuth por servidor
  • Estado en vivo vía heartbeat
  • Votos automáticos en bot lists

2027

Fase de escala

  • Hosting 24/7 en VPS
  • Sharding al acercarse al límite de guilds por proceso
  • Más módulos de economía y niveles
  • Métricas y analíticas del bot

2028+

Fase ecosistema

  • PDWA de escritorio instalable
  • Integración con las webs de Ciszu Network
  • API pública documentada
  • Eventos y torneos de comunidad

Objetivos

Macro estrategia · Micro táctica

Objetivos Generales

Macro estrategia

  • 1

    Consolidar a CiszuBot como el bot de Discord de referencia en español para comunidades gamer de Latinoamérica.

  • 2

    Mantener el servicio gratuito, estable y sin funciones encerradas tras un muro de pago.

  • 3

    Hacer crecer la comunidad de servidores y usuarios alrededor de CiszuGamens y Ciszu Network.

  • 4

    Documentar cada módulo para que cualquier servidor lo configure sin depender de soporte externo.

Objetivos Específicos

Micro táctica

  • 01

    Publicar versiones estables con changelog y pruebas previas a cada despliegue.

  • 02

    Cubrir el ciclo completo de comunidad: bienvenidas, autoroles, tickets, niveles, economía y moderación.

  • 03

    Mantener el heartbeat público cada 60 s y el dashboard OAuth operativos como panel de control.

  • 04

    Preparar la arquitectura para sharding antes de alcanzar el límite de guilds por proceso.

Ideología

Los cuatro pilares

Gratis para siempre

Todos los comandos están disponibles sin muros de pago. Las donaciones son opcionales y solo financian el hosting.

Privacidad primero

No se almacenan mensajes ni datos personales. Solo contadores de uso y el estado de conexión del servidor.

Comunidad primero

El roadmap se decide con el feedback del servidor: reportes de bugs, ideas y votos en las listas de bots.

Open source

Código en GitHub bajo licencia MIT, con documentación pública y migraciones de base de datos versionadas.

Filosofía

Nuestra razón de ser

Nuestra razón de ser

El bot se construye para aguantar

Un bot de comunidad se juzga por lo que no se nota: que responda al instante, que no pierda datos y que siga en pie cuando el servidor crece.

Rendimiento máximo

«Cada milisegundo cuenta.» Respuestas inmediatas, caché donde hace falta y cero procesos innecesarios.

Estabilidad antes que features

«Un comando que falla borra diez que funcionan.» Nada llega a producción sin pasar por pruebas y staging.

Simple fuera, estricto dentro

«El usuario ve un comando; dentro hay tipos, validación y logs.» La complejidad se queda en el código.

Documentación como producto

«Si no está documentado, no existe.» Cada módulo, migración y despliegue tiene su guía pública.

Librería de Iconos Maestra

Iconos registrados de @ciszu/ui · propiedad intelectual de CiszuBot

Ecosistema Tecnológico

El stack real que sostiene el bot y la web

ri-filled-discord iconGateway, comandos y voz

Discord.js v14

Gateway, comandos y voz

discord.js ^14.27 · @discordjs/voice · play-dl

Documentación oficial
ri-filled-nodejs iconRuntime del bot y del tooling

Node.js 24

Runtime del bot y del tooling

Node ≥24 · pnpm 10 · Docker node:24-alpine

Documentación oficial
ri-typescript iconTipado estricto del monorepo

TypeScript 6

Tipado estricto del monorepo

tsc --noEmit · modo strict · tipos compartidos

Documentación oficial
Servidor de estadísticas interno

NestJS + Fastify

Servidor de estadísticas interno

@nestjs/core · fastify · puerto 5000

Documentación oficial
ri-filled-supabase iconDatos del bot y estado en vivo

Supabase (Postgres)

Datos del bot y estado en vivo

schema ciszubot · 13 tablas · RLS activo

Documentación oficial
ri-filled-nextjs iconWeb oficial y dashboard

Next.js 15

Web oficial y dashboard

App Router · SSR · API routes

Documentación oficial
ri-filled-reactjs iconInterfaz del sitio y del panel

React 19

Interfaz del sitio y del panel

Hooks · componentes de @ciszu/ui

Documentación oficial
ri-filled-tailwind-css iconDiseño y tema de las webs

Tailwind CSS 4

Diseño y tema de las webs

Tailwind 4 · PostCSS · tokens semánticos

Documentación oficial
Estado global de la web

Zustand

Estado global de la web

Sesión, menú y preferencias locales

Documentación oficial
Captura de errores en bot y web

Sentry

Captura de errores en bot y web

@sentry/node · @sentry/nextjs

Documentación oficial
Despliegue aislado del bot

Docker

Despliegue aislado del bot

Multi-stage · usuario no root · ffmpeg

Documentación oficial
Despliegue de la web

Vercel

Despliegue de la web

CI desde main · previews · CDN

Documentación oficial

Explora el Proyecto

Todas las secciones del sitio

Orígenes & Arquitectura

De herramienta interna a bot oficial del ecosistema

Origen

CiszuBot nace como herramienta interna de CiszuGamens y crece hasta convertirse en el bot oficial de Ciszu Network.

Cliente Discord.js v14

Cliente con intents Guilds, GuildMessages, MessageContent y GuildMembers. Prefijo cz! y slash commands refrescados por REST v10 en cada arranque.

Registro de comandos

44 archivos de comandos en 9 categorías gestionados por CommandRegistry; cada comando reutiliza la lógica de prefijo para responder también como slash.

Estado y datos

Heartbeat cada 60 s a la tabla ciszubot.bot_status en Supabase (13 tablas con RLS) y stats internas servidas por el proceso del bot.

Música

@discordjs/voice y play-dl reproducen audio con ffmpeg instalado dentro del contenedor.

Despliegue

Bot en Docker multi-stage (node:24-alpine, usuario no root); web en Vercel desplegada desde main a través de GitHub Actions.

Monitorización

Sentry captura errores con contexto de comando y usuario; los logs del proceso quedan en el contenedor y las stats son consultables.

Escalabilidad

Proceso único preparado para sharding cuando el número de guilds se acerque al límite por instancia.