MP-Manager/docs/casos/INDEX.md

Registro de casos — MP Manager

Qué es esto: bitácora cronológica de operaciones e investigaciones reales sobre Bucéfalo (GHL). Optimizada para recall del agente, no para humanos. Cada caso = síntoma → diagnóstico (con comandos exactos) → causa raíz → acción (run_ids) → verificación → edge-cases → snippets reutilizables.

Cómo encaja con el resto:

• docs/PLAYBOOK_*.md = teoría atemporal (metodología, taxonomía). No cambian por caso.
• memory/*.md = hechos atómicos recuperables (reglas, gotchas, bugs). Indexados en MEMORY.md.
• Este registro = narrativa investigable de cada operación, con comandos y artefactos. Liga todo.

No dupliques: enlaza al playbook para la teoría y a la memoria para los hechos; aquí va lo específico del caso.

Cuándo registrar un caso (disparador)

Crea una entrada siempre que:

1. Mutes Bucéfalo (cualquier escritura a GHL con run_id/snapshot), o
2. Cierres una investigación no trivial que llegue a una causa raíz (aunque no haya mutación).

No registres: lecturas triviales, consultas de un solo dato, o trabajo puramente de código del repo (eso va a git).

Cómo registrar

1. Copia _PLANTILLA.md a docs/casos/YYYY-MM-DD-<slug>.md y rellena (denso, comandos exactos, ids literales).
2. Agrega la fila a la tabla de abajo (más reciente arriba).
3. Crea/actualiza la(s) memoria relacionada(s) y enlázala(s) con [[slug]] desde el caso.
4. Si el caso revela teoría nueva reutilizable, considera además actualizar el PLAYBOOK_* correspondiente.

Categorías

descuadre · enlace_opp · duplicado · fantasma · cascada_n8n · custom_field · config_location · playwright · otro

Casos (cronológico inverso)

Fecha	ID	Categoría	Triggers (keywords para grep)	Status	Enlace
2026-05-30	CASE-2026-05-30-comparativa-auditoria-completa-buckets	descuadre, cascada_n8n, config_location	Comparativa Marca vs Sucursales auditar todos los buckets, opps +1 opportunities_in_brand_duplicate_link, present_in_other_branch_not_assigned 84 falsos positivos, TIENDA=METEPEC vive en Pilares 85935, DIGITAL_HUB_BY_SHELL hub-map en código, audit lee Verificador CSV no Baserow, PATRICIA PARRA zzBzWC4adBrdTA8WhQph réplica abandoned $0, redirect Windows cp1252 no utf-8, re-sync Marca antes de re-auditar	resuelto	caso
2026-05-30	CASE-2026-05-30-descuadre-opp-deadlink	descuadre, cascada_n8n	DIFERENCIA OPORTUNIDADES +2, descuadre positivo todos los buckets de opps en 0, opp Marca link muerto GET 400 Opportunity doesn't exist or is deleted, réplica obsoleta n8n no borró id rotado, contacto 2 opps Marca 1 sola viva sucursal, cleanup scripts no atrapan dead-link único, re-enlazar vs borrar opp 1:1	resuelto	caso
2026-05-30	CASE-2026-05-30-descuadre-opp-replica-duplicada-marca	descuadre, cascada_n8n, duplicado	DIFERENCIA OPORTUNIDADES +10, descuadre positivo Marca > Sucursales, réplicas duplicadas mismo ID Oportunidad Sucursal, dos opps Marca misma opp sucursal, opportunities_in_brand_duplicate_link, Cfgwp0bOtDW8zuKW CREATE en vez de UPDATE, Decidir Match Create vs Update, cleanup_brand_orphan cero huérfanas pero descuadre, antelmo anselmo mismo teléfono distinto contacto, cleanup_brand_duplicate_replica_opps.py	parcial	caso
2026-05-30	CASE-2026-05-30-sucursal-tag-en-leads-digitales	custom_field, cascada_n8n	tag sucursal y facebook-ads juntos, falsa atribución digital, createdBy.source INTEGRATION channel OAUTH, origen real facebook ads vs creado por sucursal, quitar tag sucursal lead digital, audit_origin_for_contact_list.py, fix_remove_sucursal_tag_digital.py, n8n no re-añade tag sucursal, Miza Olguin contacto SUCURSAL opp FORMULARIO, no sobrescribir Fuente PROSPECCIÓN	resuelto	caso
2026-05-30	CASE-2026-05-30-verificador-tipo-de-tienda-colapso	config_location, cascada_n8n, custom_field	TIPO DE TIENDA, field 7279, NO DIGITAL, colapsar filas digitales, 1 fila canónica por location, hub digital Pilares, Metepec 85937 vacío, premisa no-digital 0 contactos, fix_baserow_tipo_de_tienda.py, baserow delete_row	resuelto	caso
2026-05-29	CASE-2026-05-29-tienda-vacia-formulario-sitio-web	custom_field, cascada_n8n, config_location	TIENDA vacía, Formulario - Sitio Web TIENDA, Baserow 750 más de un resultado, Si hay más de un resultado, Toluca Metepec 3 filas, SUCURSAL contains ambiguo, createdBy INTEGRATION, delete Guco Villahermosa	parcial	caso
2026-05-29	CASE-2026-05-29-backfill-cf-vehiculo-temixco-marca	custom_field, cascada_n8n	contacto Marca sin datos de vehículo, customFields count 0 en Marca, réplica Sucursal→Marca sin custom fields, Sincronización Sucursal CFs vacíos, nombres CF idénticos descarta name-mismatch, Temixco, Cristhian Hugo, cache stale synced_at anterior	parcial	caso
2026-05-29	CASE-2026-05-29-corrector-baserow-verificador	config_location	Baserow, tabla 749 750, SC BUCEFALO, Verificador desactualizado, n8n no encuentra sucursal, PLAZA EL SALADO 85932 85956, cuentas_oficiales.csv, corrector baserow	resuelto	caso
2026-05-29	CASE-2026-05-29-n8n-2004-canal-origen-tiempo-real	cascada_n8n	[2004], ddUEORBEtZLzsQF2, webhook 8d574598, Canal de Origen tiempo real, Verificador 750 devuelve 0, Eugenia no está en Baserow 750, esUsuario IF n8n, n8n executions includeData	resuelto	caso
2026-05-29	CASE-2026-05-29-origen-sucursal-contactos-usuario	custom_field	createdBy.source, WEB_USER, MOBILE_USER, createdBy no viene en el listado, fix_web_user_branch_contacts roto, origen sucursal, no sobrescribir Fuente de Prospecto, ALIANZA	resuelto	caso
2026-05-29	CASE-2026-05-29-descuadre-opp-multiempeno	descuadre, config_location, duplicado	descuadre +1 opp, Can not create duplicate opportunity, allowDuplicateOpportunity, multi-empeño no replica, link muerto, réplica obsoleta	resuelto (5 mislinks pendientes)	caso