Docs TECHNICAL
By Kruxo Labs
Documentación Técnica · v2.0

La ingeniería detrás de Kruxo Labs. Sin letra pequeña.

Arquitectura completa, decisiones técnicas y endpoints concretos. Todo lo que tu CISO, tu CTO o tu Data Engineer necesita para evaluar la suite en menos de 10 minutos.

Zero-Egress por diseño
Sin binarios ejecutables
Aprobable sin auditoría externa
01 · Quickstart

De cero a modelo dimensional en 3 minutos

Sigue este flujo y tendrás métricas reales de tu Jira sin escribir código ni pedir permisos de administrador.

1

Genera tu API Token personal en Jira

Ve a id.atlassian.com/manage-profile/security/api-tokens y crea un token nuevo.

# Token estándar de Atlassian — seguro y revocable por ti en cualquier momento ATATT3xFfGF0...T7bX8x9Q=
2

Abre el archivo maestro y ve a la hoja Config

El libro .xlsx puro no contiene macros. Abre Excel y completa las celdas asignadas en la pestaña Config.

// Pestaña Config (Rangos nombrados para la conexión Power Query) urlJira: https://tu-empresa.atlassian.net emailJira: usuario@empresa.com tokenJira: ATATT3xFfGF0... claveLicencia: TRIAL /* O tu clave comercial enviada por Lemon Squeezy */ proyectoElegido: PROJ /* Se autocompleta con tu lista de proyectos al refrescar */
3

Ejecuta el atajo maestro Ctrl + Alt + F5

Power Query ejecuta la ingesta cifrada y puebla al instante las hojas DATA, TRANSICIONES y DASHBOARD.

// Diagnóstico de sincronización en vivo ✓ Autenticación TLS 1.3 directa con Atlassian OK ✓ Estado de licencia: VALIDATED ✓ Incidencias extraídas: 3,204 (23 columnas normalizadas) ✓ Changelogs procesados: 14,820 eventos de estado ✓ Lead Time medio: 4.2 días ✓ Cycle Time mediano: 1.8 días

El modelo ya está operativo en tu equipo. Puedes crear tus propias tablas dinámicas desde la pestaña DATA (issues) o presentar directamente el DASHBOARD ejecutivo.

02 · Seguridad

Zero-Egress Architecture™

El principio técnico que define cada decisión de ingeniería de Kruxo Labs.

Flujo criptográfico verificable
Fuente corporativa
Jira Cloud / Data Center
TLS 1.3
HTTPS directo local
Tu equipo local
Excel · RAM · Memoria Privada
Servidores Kruxo Labs interceptados en datos de issues: 0%
Principio Implementación técnica
Cero instalación en servidor Sin plugins de servidor, sin webhooks globales, sin daemons. Solo se necesita un API Token personal generado por el usuario con sus permisos vigentes.
Cero permisos de administrador Hereda estrictamente el control de acceso (RBAC) que la instancia origen ya asigna. Si un usuario no puede ver un proyecto en Jira, jamás aparecerá en el conector.
Cero datos en la nube de Kruxo Las credenciales y los datos viajan cifrados bajo TLS 1.3 directamente entre la API origen y el cliente local. No existe base de datos intermedia ni caché externa.
Cero binarios sospechosos Archivos 100% nativos y auditables: libros .xlsx sin código VBA ni macros, plantillas .pbit y consultas abiertas en Power Query M.
Cumplimiento RGPD/GDPR por diseño Cumple el RGPD sin requerir contratos de encargo de tratamiento complejos (DPA) ya que Kruxo Labs jamás actúa como procesador ni receptor de los datos de trabajo corporativos.
03 · Arquitectura interna

Pipeline de 4 capas de Power Query M

El motor de extracción, normalización y entrega ejecutiva opera íntegramente dentro de Excel.

Capa 01
Ingestión REST
Paginación por lotes
Capa 02
Transformación M
Aplanado de JSON anidado
Capa 03
Estructuración Relacional
Hechos y dimensiones limpias
Capa 04
Dashboard Ejecutivo
Summary Cards y gráficos
Capa 01 · Ingestión paginada por lotes

El conector consulta los endpoints REST estándar de Atlassian mediante peticiones paginadas de 100 incidencias por lote. El scope de consulta se delimita con filtros JQL para minimizar la sobrecarga en el servidor.

// Petición HTTP nativa desde Power Query M GET /rest/api/2/search?jql=project="PROJ"&expand=changelog&startAt=0&maxResults=100 Headers: Authorization: Basic base64(emailJira & ":" & tokenJira) Accept: application/json

Impacto en servidor: < 0.5% del límite de peticiones de Atlassian.

Capa 02 · Transformación y desanidado en memoria

Las listas y diccionarios complejos de Jira se aplanan automáticamente. Las fechas ISO 8601 se convierten en formatos de fecha y hora local con cálculo de deltas temporales.

// Normalización de changelog de estados en Power Query M let RawChangelog = Table.ExpandRecordColumn(IssuesTable, "changelog", {"histories"}), ExpandedItems = Table.ExpandListColumn(RawChangelog, "histories"), FilteredStatus = Table.SelectRows(ExpandedItems, each ([field] = "status")) in FilteredStatus
Capa 03 · Estructuración dimensional sin Primary Keys artificiales

Los datos se vierten en dos tablas maestras independientes de grano fino: DATA (issues) con 23 columnas estructuradas y TRANSICIONES (changelog) con el registro cronológico completo de cambios de estado.

No se emplean claves primarias artificiales ni identificadores bloqueantes que impidan añadir cálculos personales o segmentaciones en nuevas pestañas.

04 · Modelo de datos

Estructura de tablas y atributos del conector

Tablas de trabajo relacionales limpias sin dependencias de claves primarias cerradas.

TRANSICIONES
EVENT CHANGELOG

Registro temporal de cada cambio de fase para cálculo de cuellos de botella y tiempos de permanencia.

issue_keyIdentificador issue
estado_origenStatus previo
estado_destinoNuevo status
fecha_transicionTimestamp ISO
horas_en_estadoTiempo activo
autor_transicionUsuario
DATA (issues)
23 COLUMNAS

Base de datos tabular normalizada lista para tablas dinámicas y análisis multidimensional.

Issue_KeyTexto (ej. PROJ-101)
Summary & DescriptionTexto descriptivo
Status & PriorityDimensiones operativas
Assignee & ReporterDatos de usuario
Story_PointsEstimación numérica
Lead_Time_DaysDías reales calculados
Medidas y métricas ejecutivas precalculadas
Lead Time (Días)

Duración neta desde la creación de la incidencia hasta el pase al estado de resolución final.

Cycle Time (Días)

Tiempo transcurrido desde el primer estado activo ("En Progreso") hasta la entrega ("Done").

Throughput / Velocity

Volumen de Story Points o tickets finalizados de forma consolidada por iteración o semana.

Bottleneck Aging

Tiempo acumulado de retención por columna para diagnosticar bloqueos en QA o Code Review.

05 · API & Endpoints

Endpoints oficiales consumidos

Consumo exclusivo de las APIs REST públicas y documentadas de Atlassian.

Atlassian Jira REST API v2 / v3
Basic Auth: email + Personal API Token
# Búsqueda paginada con expansión de historial de estados GET /rest/api/2/search?jql=project="PROJ"&expand=changelog&maxResults=100 # Consulta de metadatos de proyectos accesibles GET /rest/api/2/project # Consulta de sprints para tableros Scrum GET /rest/agile/1.0/board/{boardId}/sprint
Protección de límites de tasa (Rate Limiting)
Garantías técnicas de estabilidad
  • Lotes controlados de 100 registros con pausas automáticas para no saturar Jira Cloud ni Data Center.
  • Gestión nativa de respuestas HTTP 429 con reintentos progresivos (backoff).
  • La memoria local de Excel mantiene el snapshot previo para evitar consultas innecesarias si los filtros no han cambiado.
06 · Requisitos

Requisitos del entorno de ejecución

Todo lo necesario para abrir y utilizar la herramienta.

Cliente de usuario

  • Microsoft Excel 2016 o superior
  • Microsoft 365 (Recomendado)
  • Windows 10/11 o macOS 12+
  • Motor Power Query nativo activado

Instancia Jira

  • Jira Cloud (.atlassian.net)
  • Jira Data Center / Server 8.0+
  • Conectividad HTTPS hacia la API REST
  • Token de API personal de Atlassian

Red y Seguridad

  • Tráfico HTTPS saliente (puerto 443)
  • Cero puertos de entrada abiertos
  • No requiere permisos de administrador
  • Cero binarios ejecutables externos
07 · CISO & Compliance

Cuestionario técnico para CISO y Ciberseguridad

Respuestas formales a las comprobaciones de seguridad corporativas más habituales.

¿Se transfieren datos confidenciales a la nube de Kruxo Labs?

Rotundamente no. Los registros transaccionales jamás salen del equipo del usuario ni se transmiten a servidores de Kruxo Labs. El conector enlaza directamente el cliente local con la API de Atlassian mediante TLS 1.3.

¿Dónde se guardan las credenciales y el API Token?

El token se almacena localmente en la hoja de control del libro Excel del propio usuario. No se envía a ningún servidor de Kruxo Labs. El usuario puede revocar o renovar su token en Atlassian en cualquier momento sin afectar la infraestructura.

¿Qué información valida el servidor de licencias de Kruxo Labs?

Únicamente la autenticidad de la clave de licencia, la URL de Jira autorizada y un hash anónimo de la máquina (SHA-256) para controlar el límite de puestos contratados. No recibimos títulos de issues, ni descripciones, ni métricas de velocidad.

¿Se requiere instalar plugins o modificar la instancia Jira?

No. Cero instalación en el servidor. El conector opera consumiendo la API REST estándar con el usuario y token habituales del miembro del equipo.

¿Tu equipo de seguridad necesita más información?

Facilitamos el cuestionario completo de evaluación técnica, diagrama de flujo criptográfico y soporte de ingeniería directo.