CV Chat

CV Chat es el chat de Círculo Vicioso Club: la casa propia de una comunidad que nació en Discord, con su diseño, sus apps y una sola cuenta para el chat, la página y el foro.

• Como Discord, pero propio: el diseño y la forma de usarlo de Discord, en la web (chat.circulovicioso.club), en Android y en Windows.
• Conectado a Discord durante la mudanza: lo que se escribe en un lado aparece en el otro al instante, con las cuentas vinculadas, la identidad verificada, los mismos accesos según los roles y todo el historial desde 2020.
• Una sola cuenta: la misma para el chat, la página y el foro, con verificación en dos pasos y código por email en cada dispositivo nuevo.
• Mensajes privados cifrados de punta a punta, sin que nadie tenga que configurar nada.
• Juegos: Truco, Funball, Ajedrez, GlobalSiege y Pool, contra gente del chat o contra la compu, con su propia página (juegos.circulovicioso.club) para jugar sin tener cuenta.
• El foro adentro del chat: el foro de siempre se abre dentro de la app, se actualiza solo y sus avisos llegan a la misma campanita.
• Lo de la comunidad: Marketplace (también en marketplace.circulovicioso.club, visible sin cuenta), wiki, Guardados, medallas y rachas, "Tu historia", Actividad, el ranking del mes y "Tu año en CV Chat".
• Para administrar: miembros, estadísticas de uso y de los juegos, informe semanal por mail, denuncias y moderación.

Basado en Haven

CV Chat funciona sobre Haven, un chat libre y autoalojado (licencia AGPL-3.0). Haven corre sin modificar sus archivos (salvo un parche pequeño, explicado abajo) y todo lo de CV Chat se suma desde afuera, dentro del mismo proceso.

English summary for Haven developers: CV Chat runs on top of Haven 4.26.4 without touching its core files. It hooks initFerry through a --require preload to reach the same db and io. It adds a live two-way Discord relay (including threads, edits and deletes), Discord account linking via OAuth2 identify, unforgeable verified identity on relayed messages, channel access mirrored from Discord permissions, Discord-based password recovery, full-history sync and member counter channels, plus its own UI and apps. See the issues on ancsemi/Haven for the bugs and proposals that came out of this work.

Cómo funciona (detalle técnico)

Parte	Archivo	Descripción
Puente en tiempo real	tools/puente/puente.js	Discord → Haven por el gateway de Discord, y Haven → Discord con un webhook por canal. Pasa mensajes, respuestas, hilos, ediciones y borrados (un mensaje de Discord que alguien borra en Haven también se borra en Discord; el bot necesita "Gestionar mensajes"), y guarda el ID de Discord de cada mensaje, así que nunca duplica.
Emojis como en Discord	theme/discord-plus.theme.css, tools/puente/web/historia.*	Todos los emojis (mensajes, reacciones, selector, cuadro de escribir y la tarjeta de "Tu historia") con Twemoji, el diseño que usa Discord, en cualquier dispositivo: la fuente Haven Emoji que ya trae Haven (Twemoji 15, CC-BY 4.0, © Twitter y colaboradores) pasa adelante de los emojis del sistema. De paso no hay más cuadraditos en los emojis nuevos que el sistema no conoce.
Invitaciones	tools/puente/invitaciones.js, tools/puente/web/login.js, tools/puente/web/aviso.js	Cada cuenta tiene su enlace (/?invita=<usuario>, botón "🤝 Invitar gente" en la tarjeta propia, para copiar o compartir). Quien entra por ahí ve " te invitó" y, al crearse la cuenta (en las primeras 48 h), queda anotado; cuenta recién cuando vincula su Discord. Da la medalla 🤝 Reclutador (sube con 3, 10 y 25) y los reclutadores de la semana salen en el resumen.
Un día como hoy	tools/puente/logros.js	Todos los días a las 12, en el canal del resumen: el mensaje con más reacciones de esta fecha en años anteriores (charla, no anuncios ni solo un enlace; solo canales que ve cualquiera, sin +18), con el enlace a la conversación en la app. Nunca repite un mensaje. Los emojis personalizados salen como el emoji de Discord.
Editar perfil como Discord ("Nitro gratis")	tools/puente/perfil.js, tools/puente/web/aviso.js	Un solo "Editar perfil" (se abra desde donde se abra), armado como el de Discord: opciones a la izquierda, vista previa en vivo al medio y "Gratis en la app vs. Discord/Nitro" a la derecha (en el celular, pantalla completa con la vista previa arriba). Usa las piezas del editor de Haven (avatar, forma, decoración del avatar = su "marco", biografía, cumpleaños, animaciones, grupos en "Más opciones"; "Personas" solo para admins, también en el servidor) y suma lo de Nitro: estilo del nombre (color, degradé y 8 fuentes), tema del perfil (degradé de dos colores en la tarjeta) y banner (imagen o GIF). Las fuentes (OFL: Fredoka, Pacifico, Orbitron, MedievalSharp, Creepster, Bebas Neue, de Fontsource) van en y se sirven en .

Tema Discord+ (theme/)

Un tema de archivo de Haven con colores, tipografía y disposición parecidos a Discord. Solo cambia el aspecto: canales sin cursiva y con letra Inter, categorías sin recuadro, respuestas con línea curva, mensajes sin separadores, etiquetas DISCORD discretas, sin código de canal ni avisos de apps en la barra superior. Con la preferencia de Haven barra compacta, la barra de escribir queda con el + a la izquierda y GIF y emoji a la derecha. En el celular, el menú lateral queda como el de la app de Discord: la tarjeta del usuario abajo, sin la sección "Servidores" ni la barra de estado.

La app de Android de Haven (Google Play) es nativa y no usa temas. Para tener el tema en el celular, la página se instala como app desde Chrome ("Instalar app"); con PUENTE_TITULO configurado, esa app lleva el nombre elegido, el icono del servidor y los colores del tema (tools/puente/instalable.js). En ese caso, los carteles de bienvenida de Haven que recomiendan su app de Android y la de PC se reemplazan por uno propio para instalar esta app, en la PC y en el celular (tools/puente/web/instalar.js).

Con PUENTE_TEMA_FIJO=1, todos ven siempre el tema por defecto del servidor y no se puede elegir otro: se ocultan el botón de temas, la barra de temas del inicio de sesión y la lista de temas en Configuración (tools/puente/tema-fijo.js). El admin lo sigue cambiando para todos desde Settings → Server Branding. Además, las opciones de diseño de Configuración (disposición, densidad, accesibilidad, iconos, imágenes...) quedan solo para los administradores, y lo que elige un administrador se aplica a todos, por separado en la PC y en pantallas táctiles.

Al entrar se abre el último canal que se usó en ese navegador, en vez de la pantalla de bienvenida de Haven; la primera vez, el primero de PUENTE_CANAL_INICIO que la persona puede ver (por ejemplo general,bienvenida).

Instalación: copiar theme/discord-plus.theme.css a /opt/haven/tema/ y descargar allí la fuente Inter (OFL) de Fontsource: inter-latin-wght-normal.woff2 e inter-latin-ext-wght-normal.woff2. Están montados en deploy/docker-compose.yml. Después, en Haven: publicar el tema y elegirlo; y en Settings → Server Branding, compartirlo, junto con la barra compacta, como valor por defecto para los miembros.

Parches a Haven (patches/)

• import-timeout.js: evita que la importación se corte a los 2 minutos. Solo afecta a /api/import/discord/*.

Los parches anteriores del importador (canales con hilos y leer 4 canales a la vez) ya vienen en Haven 4.23.

Al pasar de Haven 4.22 a 4.23: antes de arrancar la 4.23 por primera vez hay que guardar import_authors_cleared = 1 en la tabla server_settings. Esa migración de Haven le quita el dueño a todos los mensajes importados de Discord, y acá son del usuario discord-historial a propósito (de eso dependen la vinculación de cuentas y las reacciones de la gente sin vincular).

Al pasar a Haven 4.26: en el primer arranque Haven revisa todos los archivos subidos para sacarles la ubicación, y los que no puede limpiar los saca de uploads/ (dejan de verse en el chat). Con decenas de miles de imágenes traídas de Discord, que Discord ya publica sin ubicación, conviene saltear esa revisión: antes de arrancar la 4.26 por primera vez, guardar privacy_sweep = {"done":true,"full":true} en server_settings. Lo que se sube después igual se limpia al subirlo.

Instalación (resumen)

Requisitos: un servidor Linux con Docker, un dominio y una aplicación de Discord con su bot. En el Developer Portal:

• Bot: activar Message Content Intent y Server Members Intent, y desactivar Public Bot.
• OAuth2 → Redirects: añadir https://TU-DOMINIO/puente/discord/callback.
• Invitar el bot con permisos de Ver canales, Leer el historial, Enviar mensajes, Gestionar webhooks, Crear hilos públicos y Enviar mensajes en hilos.

Pasos:

1. Copiar el contenido de este repositorio a /opt/haven. Copiar deploy/docker-compose.yml y deploy/Caddyfile a /opt/haven, y poner tu dominio en el Caddyfile.
2. Crear /opt/haven/.env a partir de deploy/env.example.
3. docker compose up -d. Registrar tu cuenta de admin en Haven y, en Settings → Ferry, pegar el token del bot. Ferry tiene que quedar apagado, porque el puente lo reemplaza.
4. Guardar el Client Secret de OAuth2 con sudo tools/guardar-secreto.sh y reiniciar: docker compose up -d.
5. Instalar los temporizadores: copiar deploy/systemd/* a /etc/systemd/system/ y ejecutar systemctl enable --now haven-sync.timer haven-hilos.timer haven-backup.timer. Para la copia de seguridad hace falta configurar un remoto de rclone en tools/rclone.conf.
6. La primera sincronización importa todo el historial. Se puede lanzar a mano con systemctl start haven-sync.service y seguir en tools/sincronizacion.log.

Los mensajes importados se guardan a nombre de un usuario técnico discord-historial (sin permisos ni contraseña). Hay que crearlo en la tabla users antes de la primera importación: así los mensajes no salen con la etiqueta del admin y el conteo de no leídos sigue siendo rápido.

Limitaciones conocidas

• Los adjuntos de Discord se importan como enlaces a Discord, y esos enlaces caducan con el tiempo.
• En Discord, lo que se envía desde Haven lleva la etiqueta "APP" de los webhooks. Discord no permite publicar como la cuenta real de un usuario.
• Los hilos privados de Discord no se puentean.
• La sincronización no aplica las ediciones o borrados que se hicieron en Discord mientras el puente estaba apagado.

Licencia

AGPL-3.0, igual que Haven. Como CV Chat es una versión modificada de Haven que la gente usa por internet, la licencia pide que su código esté a disposición de quien lo use: este repositorio sirve justamente para eso.