Crystal Reporter · Manual del Operador

Versión 1.0 · Fecha 2026-09-29 · Audiencia Dealing desk Bridge Markets, analistas de riesgo, back-office.

Crystal Reporter es el observatorio del broker. Se conecta al feed de operaciones cerradas de todos los tenants (Kraken, Nexxus, Athenea, Pulse, Gansi), enriquece cada deal con metadata de señales, tags, notas y riesgo, y expone tres vistas complementarias: un pulso en tiempo real, una sala de rayos X para investigación granular y un laboratorio de informes con exportación auditable.

Este manual no explica MT5 ni forex. Explica cómo usar Crystal Reporter para hacer bien tu trabajo: detectar fraude, medir concentración, atribuir PnL, producir reportes ejecutivos y escalar casos con evidencia.

Índice

1. Filosofía de datos
2. Dashboard — pulso del día
3. X Ray — investigación forense
4. Reporter — laboratorio de informes
5. Casos prácticos
6. Glosario operativo
7. Escalamiento y límites
8. Atajos y consejos

1. Filosofía de datos

1.1 Perspectiva del broker (no del cliente)

Crystal Reporter mira las operaciones desde la mesa, no desde la app del cliente. Esto invierte el significado de los colores respecto a plataformas retail:

Si tomás una card y ves neto verde, es una buena noticia para nosotros. Si es rojo, el cliente nos sacó plata. Esto vale para todas las vistas, todas las gráficas y todos los reportes exportados.

1.2 Tres números que siempre están juntos

Cualquier deal cerrado se descompone en:

• Recogido — suma de PnL cliente negativo (el cliente perdió, el broker recogió). Siempre positivo, siempre verde.
• Pagado — suma de PnL cliente positivo (el cliente ganó, el broker pagó). Siempre positivo, siempre rojo.
• Net (broker) — Recogido − Pagado. Puede ser positivo (broker ganador del período) o negativo (broker perdedor).

Cuando el manual dice "PnL" sin adjetivo, es siempre PnL del broker.

1.3 Universos

Todo símbolo se clasifica en uno de cuatro universos que definen sobre qué se filtran las vistas:

Regla mental: cuando alguien pregunta "cómo estamos hoy" sin más detalle, la respuesta canónica se calcula sobre BM Synth (que es donde efectivamente somos market maker). General es agregado; Forex y Otros Synth son informativos.

1.4 Fondeadas — el toggle silencioso

Todas las vistas por defecto excluyen cuentas fondeadas (propfirm/challenge). Estas cuentas viven en grupos especiales (FUNDED-*, CHALLENGE-*, etc.) y su PnL no representa flujo comercial real: son cuentas de habilitación que la mesa nunca cobra ni paga.

Cuando activás Incluir fondeadas, las volvés a meter. Cuándo hacerlo:

• Para auditar concursos de propfirm (¿quién pasó challenge?).
• Para detectar abuso: cuentas fondeadas repetidas con misma IP → farming de challenges.
• Nunca en reportes ejecutivos de PnL: distorsiona el neto.

2. Dashboard — pulso del día

dealing.kinero.co/crystalball/

Es la home page. Pensada para el vistazo de 5 segundos: ¿cómo va el día del broker? ¿algo se prendió en rojo?

2.1 Anatomía de una card

Cada card representa un símbolo activo hoy en el universo seleccionado:

┌────────────────────────────────────────────┐
│ Bull400                    248 closes      │
│ Bull                                        │
│                                             │
│  Recogido $4,141   Pagado $2,196            │
│  ─────────────────────────────────         │
│  Net (broker)      +$1,945                  │
│                                             │
│  ▂▃▅▇▆▄▃▂  hourly sparkline                 │
└────────────────────────────────────────────┘

• Header: símbolo + count de closes (deals cerrados hoy en UTC).
• Subtítulo: familia a la que pertenece.
• KPIs: Recogido / Pagado / Net del día.
• Sparkline: perfil horario de closes (últimas 24h UTC).

Click en cualquier card → salta a X Ray con f-symbol=Bull400 preseleccionado. Ese es el pattern que uses cuando algo llama la atención: identificás en Dashboard, drilleás en X Ray.

2.2 Sort toggle

Arriba a la derecha, un pill toggle:

• NET DESC — cards ordenadas de más ganador para nosotros a más perdedor.
• NET ASC — inverso. Este es el modo forense: los símbolos que más nos pegan aparecen primero.
• VOL DESC — por volumen (Recogido + Pagado). Útil para "dónde está la acción" sin importar quién gana.

Cambio de sort persiste en localStorage.

2.3 Charts strip

Debajo de las cards hay tres mini-charts:

• Top winners (broker) — 5 símbolos que más neto verde nos dieron.
• Top losers (broker) — 5 símbolos que más neto rojo nos pegaron.
• Actividad horaria — barras de closes agregados por hora UTC.

Click en barra de winner/loser → X Ray con símbolo filtrado.

2.4 Pills de universo

Arriba de las cards está el toggle General | Forex | BM Synth | Otros Synth. Cambia el conjunto de símbolos y también el KPI global de la card. Persiste.

3. X Ray — investigación forense

dealing.kinero.co/crystalball/deals

Aquí bajás al detalle. La vista tiene filtros globales en el sidebar izquierdo y 6 pestañas en el contenido principal.

3.1 Sidebar de filtros

Todos los filtros se aplican simultáneamente. El botón APLICAR los ejecuta; RESET los limpia todos.

Regla forense: combiná filtros. IP=X + familia=Bull es muy distinto a solo IP=X. El propósito es aislar el patrón, no ver todo.

3.2 Tab EXPOSURE

Muestra la exposición viva por símbolo (posiciones abiertas ahora, no closes históricos). Es el puente al motor de MM: si acá ves un rojo grande en Bull400, el equipo de MM está lidiando con eso en tiempo real.

• Heatmap: cuadros de tamaño proporcional al volumen expuesto, color según neto broker (verde = a favor, rojo = en contra).
• Sección superior: resumen scope-aware con Recogido / Pagado / Net del día (no de la exposición viva).

Uso típico: antes de aprobar una señal grande, chequeás Exposure para ver si ya estamos direccionalmente comprometidos en ese símbolo.

3.3 Tab DEALS

El corazón del X Ray. Tiene dos modos:

Modo A · vista general (sin login seleccionado)

Tres gráficas apiladas horizontalmente:

Top cuentas · broker gana / pierde Ranking bidireccional. Arriba en rojo, las cuentas que más nos hicieron pagar hoy. Abajo en verde, las que más nos aportaron. Un divisor punteado los separa. Click en cualquier fila → filtra la vista al login de esa cuenta.

Distribución PnL por cuenta Histograma con rango P95 (95% de las cuentas dentro del eje; el 5% más extremo se acumula en los bordes). Esto evita que un outlier de $10k aplaste la resolución del gráfico. Leelo:

• Campana centrada en 0 con leve sesgo verde a la izquierda = distribución sana, broker ligeramente ganador.
• Campana con cola verde larga = pocos ganadores muy grandes en nuestro contra.
• Campana descentrada = flujo direccional dominante (posible copy trading, EA masivo).

El meta line dice N cuentas · rango P95 · X outliers para transparencia.

Pareto · concentración de PnL Curva de Lorenz. Ver sección 5, Caso C para lectura completa. Regla corta: mientras más pegada al ángulo superior izquierdo, más concentración; mientras más pegada a la diagonal, más distribución sana.

Debajo hay una tabla de deals paginada con todos los closes que coinciden con los filtros. Columnas: hora UTC, login, name, group, IP, símbolo, familia, side (buy/sell), lots, price, profit. Click en un login o IP en la tabla → aplica ese valor como filtro y recarga.

Modo B · perfil de login (cuando f-login está seteado)

La vista cambia por completo a un profile card con:

• Curva de equity del login para el día seleccionado.
• Session bias (barras ASIA / LDN / NY / LATE con % concentración y net por sesión).
• Lifetime metrics (30d / 90d / 365d) — para saber si el patrón de hoy es habitual o excepcional.
• Tags y notas del CRM (leídos de mt5_user_tags / mt5_user_notes).

Cuándo entrás en modo B: cada vez que un login se vuelve interesante. Le hacés click al login en cualquier tabla y ya estás en su perfil.

3.4 Tab IP REPEATS

Cards por IP que tienen ≥3 logins únicos operando desde ella. Cada card muestra:

• IP.
• Cantidad de logins, deals, lots.
• Net broker del conjunto.
• Chips con los login IDs (click → filtra).

Cuándo escalar: IP con ≥5 logins que en total suman −$500 o más para el broker en un día. Es candidato a farming o a un grupo organizado.

3.5 Tab GROUP COHORTS

Treemap de los grupos MT5. Cada rectángulo es un real\BRIDGEMARKETS\<GRUPO> proporcional al volumen. El color codifica el neto broker (verde = ganamos, rojo = perdemos) con intensidad según magnitud.

Debajo del treemap hay un rollup por grupo con expand inline (click en cualquier fila para ver los símbolos que operó ese grupo).

Uso: segmentación comercial. SYNALLBM-B100 es el bulk del synth propio. Si ves un grupo raro creciendo, alguien creó un plan comercial nuevo o hay una migración de clientes en curso.

3.6 Tab TIMING RINGS

Session bias horario, pero a nivel familia/símbolo (no login). Muestra en qué franjas UTC se concentra la actividad. Útil para:

• Ver si un símbolo específico se usa casi solo en ASIA (típico de bots de un timezone).
• Detectar cambios de comportamiento tras un cambio de sesión.

3.7 Tab LOT MIRROR

El detector de copy trading más directo que tenemos. Muestra cards agrupadas por (símbolo, lots). Si ves una card Bull400 · lot 0.10 con 29 logins operando exactamente eso, no es coincidencia: es un MASTER MT5 replicando a 29 slaves o un canal de Telegram con lot fija.

Cada card muestra:

• Símbolo · lots.
• Logins, deals, net broker.
• Chips con todos los logins involucrados (dots naranja indican logins tagueados).

Bulk actions arriba: SELECCIONAR TODO + dropdown para taggear todo el grupo con una etiqueta común (ej: CANAL_TG_XX) o mandarlos a blacklist.

Cuándo escalar: card con ≥10 logins compartiendo lot exacto y net rojo (−$500 en adelante) es alerta inmediata al equipo de riesgo.

4. Reporter — laboratorio de informes

dealing.kinero.co/crystalball/reporter

Es donde producís evidencia auditable: XLSX / CSV firmados con timestamps para compartir con dirección, compliance o el equipo legal. El resto de vistas son operativas (te muestran algo); esta produce un documento.

4.1 El wizard 3 pasos

La interfaz está organizada como un stepper horizontal. Los tres pasos son:

Paso 1 · Universo & rango

Fija sobre qué operan todos los módulos:

• Pills de universo (General / Forex / BM Synth / Otros Synth).
• Rango: Día, Semana (7d), Mes (30d).
• Fecha "Desde" (inicio del rango).
• Toggle Incluir fondeadas.

El summary del paso muestra BM Synth · Día o similar para que sepas qué elegiste sin bajar a mirar.

Paso 2 · Módulos

Aquí elegís qué análisis correr. Click en + Agregar módulo abre un popover con búsqueda en vivo. Cada opción muestra su descripción. Podés seleccionar todos los que quieras; se listan como chips debajo con una × para removerlos.

El summary del paso lista los nombres seleccionados. El contador mods-count a la derecha del label dice cuántos hay.

Ver 4.2 para el detalle de cada módulo.

Paso 3 · Correlación

Dos toggles frontend-only que operan sobre los datos ya cargados:

• Solo cuentas en ≥N módulos — filtra las tablas de módulos login-céntricos para mostrar únicamente logins que aparecen en al menos N de los módulos seleccionados. Esto es la clave del análisis forense multi-dimensional.
• Matriz de overlap entre módulos — habilita una tab nueva con una matriz N×N de intersecciones de logins entre pares de módulos.

Ver 4.3 para el uso forense.

Botones a la derecha:

• GENERAR INFORME — ejecuta la query, muestra preview en pantalla con tabs por módulo.
• ↓ XLSX — descarga XLSX (una hoja por módulo, con estilos y totales).
• ↓ CSV — descarga CSV plano (todos los módulos concatenados con headers).

4.2 Los 9 módulos

4.3 Correlación entre módulos (paso 3)

Este es el diferencial del Reporter contra un reporte plano.

4.3.1 Filtro "≥N módulos"

Cuando activás el toggle y ponés N=2:

• Se extraen los logins presentes en cada módulo login-céntrico (Riesgo, Session bias, IP Farms, Magic clusters, Concentración).
• Se cuenta cuántos módulos "vieron" cada login.
• Se ocultan las filas de logins que aparecen en <N módulos.

Ejemplo práctico: seleccionás Logins de riesgo + IP Farms + Session bias, marcás ≥2 módulos. Solo verás logins que al mismo tiempo están flaggeados como riesgo Y operan desde una IP granja Y tienen bias horario extremo. Ese es tu top-priority list.

El contador en el head de cada tabla dice X / Y · filtrados Z por correlación.

4.3.2 Matriz de overlap

Activás el toggle → aparece una tab Overlap con matriz N×N:

                Riesgo    Session    Farms    Magic    Conc
Riesgo          [45]       12          8        3        18
Session         12         [67]        4        2        11
Farms           8          4           [24]     6        7
Magic           3          2           6        [18]     4
Conc            18         11          7        4        [55]

• Diagonal (en color acento) = tamaño del set de logins de ese módulo.
• Off-diagonal = intersección de logins entre pares.
• Celdas resaltadas cuando la intersección supera el 50% del módulo más chico del par.

Uso: en el ejemplo, Riesgo ∩ Conc = 18 de un total de min(45, 55) = 45 → 40% de solapamiento. No es alerta. Pero si vieras Farms ∩ Magic = 15 / 18 = 83%, eso te dice que casi todos los magic clusters detectados operan también desde IP farms → operación coordinada muy probable.

4.4 Exportar

• XLSX — cada módulo en su propia hoja, con estilos Bloomberg (fondo oscuro, monospace, headers en gris). Totales y sub-totales calculados.
• CSV — un solo archivo con todos los módulos concatenados. Cada bloque de módulo tiene su header. Útil para pipelines de datos externos (Sheets, PowerBI).

Ambos formatos respetan el universo del paso 1 y NO aplican el filtro de correlación (los filtros de correlación son solo de UI). Si querés exportar el subset correlacionado, generá el preview con el filtro activo y usá el export para el detalle completo, o filtrá el XLSX offline.

5. Casos prácticos

Caso A · "Un cliente ganó $8k anoche, ¿es un pattern?"

Situación: la mesa recibe reporte informal de que el login 7924056 cerró con +$8,500 en Bull400 durante la sesión LATE.

Playbook:

1. Dashboard → filtro BM Synth. Buscá visualmente Bull400 en la lista. Chequeá si el símbolo global fue perdedor grande hoy (indica que este cliente fue parte del daño).
2. X Ray → Deals. Metés login=7924056 en el sidebar, aplicás.
3. Automáticamente entra en modo B (profile): mirás la curva de equity del día — ¿fue una entrada única o rachas? ¿En qué sesión?
4. Bajás a lifetime metrics (30d / 90d / 365d). ¿Es la primera vez que pega números así o hay historia?
5. Session bias — ¿opera solo LATE? Sospechoso.
6. Volvés al sidebar. Removés login, agregás IP=<primera IP del login>. ¿Otros logins desde la misma IP?
7. Si sí → X Ray → IP Repeats, confirmás que aparece la IP con múltiples logins.
8. Si aún no está claro, vas a Reporter con high_risk + session_bias + farms seleccionados y ≥2 módulos. Si el login aparece → está en tu top-priority list.
9. Reporte al equipo de riesgo con el XLSX exportado.

Tiempo total: 5–8 minutos.

Caso B · "Detectamos IP nueva con muchos logins"

Situación: alguien menciona en el chat que la IP 190.129.103.175 apareció con 3 cuentas nuevas.

Playbook:

1. X Ray → IP Repeats. Verificás si la IP ya está listada (≥3 logins detectados).
2. Si sí, click en el card → ves logins, símbolos, net.
3. Sidebar → IP=190.129.103.175, tab Deals. Modo A muestra la distribución de PnL de esa IP.
4. Mirá el Pareto: si la curva es casi vertical, un solo login concentra todo (probablemente el "master").
5. Tab Lot Mirror con esa IP activa: si aparecen cards símbolo · lot idéntico con múltiples logins → confirmación de copy.
6. Anotás notas en cada login (icono en X Ray profile) para dejar trail.
7. Si el net broker es rojo grande, escalás con export XLSX del Reporter (módulos: farms + magic_clusters + high_risk).

Caso C · "Bull400 cambió color en el dashboard"

Situación: hasta las 15:00 UTC estaba verde +$1.2k, ahora está rojo −$800.

Playbook:

1. Dashboard → click en la card Bull400 → X Ray con símbolo filtrado.
2. Tab Exposure → chequeás si estamos abiertos direccionalmente ahí (MM ya está lidiando).
3. Tab Deals → modo A. Mirá el histograma: ¿hay una cola de ganadores nueva en las últimas horas?
4. Top cuentas · broker gana / pierde: mirá los top losers de la lista roja (arriba). Están las cuentas nuevas que nos pegaron.
5. Click en el top loser → modo B. ¿Es un cliente recurrente o alguien que apareció hoy?
6. Si aparece un puñado de logins nuevos que nunca operaron Bull400 antes → sospecha de canal de señales externo que los tiró todos juntos.
7. Reporter con signal_attribution habilitado → ves si alguna de nuestras señales atribuyó el flujo (poco probable si es externo) o si vino "wild".
8. Alerta al MM para ajustar exposición si aplica.

Caso D · "Informe consolidado del cierre del día"

Situación: son las 19:00 COL, hay que producir el informe del día para dirección.

Playbook (ya automatizado, pero manual como fallback):

1. Reporter → paso 1: universo General, rango Día, fecha de hoy.
2. Paso 2: módulos Consolidado + P&L por group + Signal attribution.
3. Paso 3: dejar correlación off (no aplica a un informe general).
4. Generar informe → preview en pantalla, review visual.
5. ↓ XLSX → descarga.
6. Adjuntar al email de cierre.

Alternativa: el sistema envía este informe automáticamente a las 19:00 COL a la lista distribuida. Este playbook es para el operador cuando alguien pide un corte a hora distinta.

Caso E · "Detección de copy trading masivo"

Situación: mensaje del CRM: "vemos 40 registros nuevos con dominios parecidos en la última hora".

Playbook:

1. Reporter paso 1: BM Synth, día de hoy.
2. Paso 2: módulos magic_clusters + farms + high_risk + book_imbalance.
3. Paso 3: activar Matriz de overlap.
4. Generar informe.
5. Tab Overlap. Mirá el par farms ∩ magic_clusters. Si el número resaltado supera 50% → confirmado que las cuentas nuevas están coordinando por IP y magic.
6. Tab IP Farms para el detalle: cuáles IPs concretas, cuántos logins cada una.
7. Tab Magic clusters para el detalle: cuáles magics compartidos.
8. Bajás a X Ray → Lot Mirror para visualización adicional (mismo lote por símbolo).
9. Exportás XLSX del Reporter, adjuntás al email de escalamiento.
10. Notificás al equipo de compliance con los logins listados para revisión KYC.

6. Glosario operativo

7. Escalamiento y límites

7.1 Cuándo escalar al equipo de riesgo

7.2 Nunca hagas esto directo

• No editás ni ejecutás UPDATE sobre engine.db, oracle.db de precios ni Redis de lastPrice. Cualquier ajuste va al equipo de infra.
• No borrás tags ni notas sin registro. Si vas a limpiar, dejá una nota final con la razón.
• No mandes correos automáticos con el XLSX exportado a clientes; el output es interno.
• No compartas capturas de X Ray con nombres reales fuera del dealing desk.

7.3 Latencia esperada

• Dashboard: refresco cada 30s, cards nuevas al segundo.
• X Ray: filtros se aplican en <2s en día actual, <5s en rango semanal.
• Reporter: preview 3-10s según módulos y rango. XLSX 5-20s. CSV instantáneo.
• Overlap matrix: instantáneo (frontend).

Si algo tarda más de 30s, refrescá y si persiste avisá en el chat de infra.

8. Atajos y consejos

• Click en cualquier login en cualquier tabla te lleva al perfil (modo B) en X Ray.
• Click en IP filtra la vista por esa IP.
• Click en símbolo/familia filtra la vista.
• Universo se propaga: si estás en Otros Synth y click en una card, X Ray abre ya filtrado a Otros Synth.
• localStorage guarda tus últimas selecciones (universo, sort, módulos del Reporter, correlación toggles). Cambio de tenant o reset manual las limpia.
• URL con parámetros: podés compartir links como /crystalball/deals?symbol=Bull400&day=2026-09-29&scope=synth para que otro operador abra exactamente la misma vista.
• Hard-refresh (Cmd+Shift+R en Safari) después de un deploy — el JS puede estar cacheado.
• XLSX pesan más que CSV (5-20× más). Para pipelines automáticos, usá CSV.
• Correlación multi-módulo: la joya del Reporter. Úsala siempre que investigues fraude coordinado.
• Cuando en duda, filtrá más: 3 filtros bien elegidos > 1 filtro amplio. El objetivo es ver el patrón, no toda la data.

Anexo · Contactos y links

• App live: https://dealing.kinero.co/crystalball/
• Oracle (dealing desk): https://dealing.kinero.co/
• Market Maker: https://dealing.kinero.co/mm/signals/active
• Este manual (versionado): docs/manuals/crystal-reporter.md en el repo synth-oracle.
• Escalamiento riesgo: canal #dealing-risk en Telegram.
• Bugs / feature requests: canal #crystal-reporter o directamente a Asher Lambragno.

Crystal Reporter · Bridge Markets · 2026