evc-team-relay
EVC Team Relay es un servidor de colaboración en tiempo real y publicación web autocontenido para repositorios de Obsidian. Utiliza CRDT (CRDT-based) sincronización vía y-sweet, arquitectura local-first con persistencia en PostgreSQL y almacenamiento S3/MinIO.
Ficha actualizada 23 sept 2026, 16:08 · upstream 23 sept 2026, 16:04 · release v1.13.3
Qué es evc-team-relay
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Obsidian es excelente para notas personales, pero cuando un equipo necesita colaborar, la solución nativa de Obsidian Sync no ofrece colaboración en tiempo real ni permite publicar documentos al web. Team Relay resuelve estos problemas mediante una infraestructura autocontenida que añade funcionalidades sin abandonar el ecosistema de Obsidian.
La arquitectura se basa en CRDT (CRDT-based) sincronización, lo que elimina los conflictos de merge y garantiza consistencia incluso con editores concurrentes. El sistema es local-first: los cambios se guardan en disco del servidor y se sincronizan cuando la conexión se restablece. Esto permite editar sin conexión y publicar documentos al web desde cualquier dispositivo.
Para el despliegue, Team Relay soporta Docker Compose como unidad de orquestación. Las imágenes son nativas para ARM64 (Apple Silicon, Graviton, Ampere, Raspberry Pi), lo que elimina la necesidad de exportar o compilar imágenes cruzadas. El repositorio contiene solo scripts de pull de imágenes publicadas y no Dockerfile ni docker-compose.yml.
- Colaboración en tiempo real entre miembros del equipo sobre notas de proyecto sin conflictos de merge
- Publicación de documentación interna a un dominio personalizado (ej: docs.yourcompany.com)
- Sincronización bidireccional entre repositorio y carpeta local para desarrollo colaborativo
- Acceso controlado al contenido con permisos por roles o tokens
- Integración con pipelines CI/CD mediante webhooks de publicación
- Monitoreo de actividad a través de logs auditables y dashboards Prometheus/Grafana
- Sincronización CRDT basada en y-sweet (Yjs) que elimina conflictos de merge por completo
- Arquitectura offline-first: edición sin conexión con sincronización automática al volver online
- Soporte nativo para ARM64 mediante imágenes binarias, eliminando dependencias de cross-compilation
- Almacenamiento escalable vía S3/MinIO con persistencia en disco local
- API REST y GraphQL para acceso programático a la infraestructura
- Monitoreo completo con Prometheus metrics + Grafana dashboards integrados
- La sincronización CRDT no garantiza consistencia de datos en caso de fallo del servidor o red, requiriendo mecanismos de retry y retransmisión
- El almacenamiento S3/MinIO debe configurarse con permisos adecuados para cumplir con políticas de seguridad empresarial
- La persistencia local puede generar latencia en la sincronización si el disco es lento o se llena
- No incluye un editor de notas nativo: los documentos deben ser editados desde Obsidian (plugin) o herramientas externas
- El despliegue requiere configuración manual del DNS y certificados TLS antes de que sea accesible
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar Team Relay, se recomienda usar Docker Compose en un entorno local para pruebas. La configuración mínima incluye: 1) Un servidor control plane (control-plane) con API REST, 2) Un servidor de publicación web (web-publish) que serve la documentación, y 3) Un servidor relay (relay-server) que maneja la sincronización CRDT. Se debe configurar un proxy reverse (Caddy o nginx) en el dominio base para servir las páginas web sin exponer los endpoints internos. Las imágenes se pullan desde GitHub Actions con variables de entorno como DOMAIN_BASE, ACME_EMAIL y RELAY_PRIVATE_KEY. Para producción, se recomienda usar Docker Compose con volumes persistentes, systemd o Kubernetes para orquestación. Se debe habilitar autenticación OAuth/OIDC en el control plane y configurar webhooks para integraciones con herramientas de CI/CD. El plugin oficial de Obsidian se instala desde la página de Gi
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.