htb
HTB es una pizarra de tickets headless para equipos y agentes IA. Prioriza la CLI y la API, con un portal web ligero para clientes. Usa Zitadel para autenticación y PostgreSQL como base de datos. Soporta despliegue autoalojado o hosted.
Ficha actualizada 24 sept 2026, 22:16 · upstream 24 sept 2026, 21:44 · release v0.4.0
Qué es htb
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
HTB es una herramienta headless para gestionar tickets técnicos en equipos y agentes IA, priorizando la interacción vía CLI y API. Ofrece un portal web ligero exclusivo para clientes que siguen historias de usuario publicadas, comentan propuestas y solicitan cambios, sin exponer el tablero interno del equipo. La autenticación se gestiona mediante Zitadel, mientras que HTB controla el acceso a proyectos y tickets.
Soporta despliegue autoalojado o servicio hosted. En modo self-hosted, requiere una instancia de PostgreSQL y configuración de aplicaciones en Zitadel (CLI nativa con Device Code flow y Web con Authorization Code + PKCE). El despliegue es de baja complejidad, ejecutándose en un solo núcleo CPU y 1 GB de RAM mínimo.
El modelo de trabajo distingue entre historias de usuario (publicables para clientes) y tareas técnicas (privadas por defecto). Los administradores pueden publicar historias para mostrar progreso sin revelar detalles técnicos internos. Además, permite gestionar solicitudes externas vinculadas a tickets existentes, manteniendo la separación entre el flujo interno del equipo y las peticiones de los clientes.
- Gestión de tickets técnicos vía CLI para desarrolladores
- Portal web para clientes ver progreso de historias de usuario
- Sincronización de estado entre equipos y agentes IA
- Gestión de solicitudes externas (requests) vinculadas a tickets internos
- Autenticación centralizada con Zitadel para múltiples proyectos
- Despliegue autoalojado en infraestructura propia o uso del servicio hosted
- Arquitectura headless con CLI-first y API-driven
- Integración nativa con Zitadel para autenticación segura
- Separación clara entre tickets técnicos privados y historias publicadas
- Soporte para despliegue autoalojado (Dockerfile presente) o hosted
- Export de datos a JSON/CSV para integración en scripts
- Gestión granular de roles: admin publica, clientes ven solo lo publicado
- Requiere configuración manual de Zitadel (Client IDs, Redirect URIs)
- No incluye Docker Compose por defecto (solo Dockerfile)
- El portal no muestra comentarios técnicos internos ni detalles de tareas técnicas
- La autenticación depende completamente de una instancia externa de Zitadel
- Las pruebas de integración requieren una base de datos dedicada separada
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 self-hosting, configurar PostgreSQL y Zitadel antes que HTB. Crear dos aplicaciones en Zitadel: una para CLI (Device Code) y otra para Web (Authorization Code + PKCE). Asegurar HTTPS en el redirect URI del portal. Usar variables de entorno para credenciales de Zitadel. No usar IDs del servicio hosted en la instalación propia. Ejecutar go build o usar Dockerfile. Separar base de datos de pruebas de producción.
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.