Kickoff / Handoff — Dropout

Mensaje de arranque para el equipo de construcción (Dropout). Define objetivo, alcance, owners, bloqueadores y criterios de aceptación por workstream, anclado a estos docs como fuente única de verdad.

Objetivo: lanzar Vecnet como capa de orquestación, conciliación y liquidación sobre dos rieles — Tonder (en línea / CNP) y Menta (ventanilla / POS) — con Merchant Dashboard, Super Admin y Hosted Checkout.

Fuente única de verdad

https://vecnet-docs.vercel.app — arquitectura, modelo de datos, flujos de finanzas, superficies y fases (M1–M8). Regla: si una duda de alcance no la resuelven los docs, se levanta como bloqueador; no se asume.

Definición de terminado (global): una transacción de Tonder y una de Menta entran por el Listener, se concilian por correlation_id, se ven en el dashboard del comercio y se liquidan automáticamente — todo visible en Super Admin.

No negociables (de los docs)

• Supabase / Postgres — sin Mongo/Dynamo (por qué).
• Doble partida, nunca floats para dinero (centavos / numeric) (posting).
• Idempotencia por constraint, un correlation_id por transacción (modelo).
• Cero PAN en Vecnet — Skyflow + Tonder Lite SDK (seguridad).
• Cada cambio de config en Super Admin escribe audit_log.

---

Workstreams

Cada uno: owner · alcance · criterio de aceptación · dependencia · PRD con ETA.

1. Conexión Menta — riel "ventanilla" (CP)

• Owner: [asignar]
• Alcance: conectar Menta como payment provider de terminales; transacciones visibles como pagos "ventanilla" (Tonder = "en línea").
• Docs: Rails / Listener · The two rails
• Recursos: Docs Menta · Backoffice (credenciales en el gestor — ver Accesos)
• Aceptación: una notificación de Menta → fila en transactions + journals + webhook entregado; idempotente bajo reentrega; visible en el dashboard.
• 🔴 Bloqueador: contrato del API / notificación POS de Menta + esquema de firma. Owner [Menta / Lenin] · fecha límite [ ]
• PRD detallado: @Lenin Gomez — ETA [ ]

2. Backend Vecnet

• Owner: @David Hernandez
• Alcance: Listener + orquestador + posting (doble partida) + fees + settlements + rolling reserve + daily ledger → flujos.
• Aceptación: un PAGO postea y mueve balances atómicamente; un posting desbalanceado se rechaza; el settlement produce OUT + IN por acquirer.
• PRD detallado: @David Hernandez — ETA [ ]

3. Merchant Dashboard

• Owner: [asignar]
• Alcance: analítica, transacciones, evidencias de disputa, webhooks, liquidaciones, links de pago. Scoped por RLS al entity_id del comercio.
• Docs: Merchant Dashboard (catálogo de métricas con fórmulas exactas)
• Mockup: vecnet-dashboard.vercel.app/transactions · Repo: vecnetpay/vecnet-dashboard
• Aceptación: el comercio ve solo su entity, en vivo; aceptación (cards) y conversión (APM) nunca se mezclan; dedup por payment_intent_id.
• PRD detallado: [owner] — ETA [ ]

4. Super Admin Vecnet

• Owner: [asignar]
• Alcance: comercios, fees, finances, config de checkout, reportes de liquidación, webhooks, activar/desactivar comercios.
• Docs: Vecnet Admin — operator platform (11 módulos + matriz)
• Referencia: consola de Finanzas Tonder (credenciales en el gestor)
• Aceptación: cada cambio de config queda auditado; el simulador de fee-rules confirma qué regla gana antes de activar.
• PRD detallado: [owner] — ETA [ ]

---

🔴 Bloqueadores a destrabar esta semana

Esto es lo que define "rápido".

Dependencias críticas

1. Contrato API Menta (notificación POS + firma) — sin esto el Listener de Menta no avanza. Owner [ ] · [ ]
2. Contrato Tonder Lite SDK v2.0 (payment request/response + webhook) — gatea el Hosted Checkout. Owner [ ] · [ ]
3. PRDs detallados (los 4 de arriba) con owner + ETA.
4. Accesos a repos privados para todo el equipo Dropout (vecnet-dashboard, vecnet-pay-checkout). Owner [ ] · [ ]

Lista viva de pendientes y dependencias en Open items.

Plan / hitos

Seguimos las fases M1–M8 → Build phases. Fecha objetivo por hito: [completar].

Operación

• Standup [días/hora] · demo semanal [día].
• Dudas de alcance → [canal Slack]. Bloqueadores → @Yuyo directo.
• Nada se da por terminado sin demo contra su criterio de aceptación.

Accesos / seguridad

Credenciales

Las credenciales (Menta backoffice, consola Tonder, etc.) viven en [1Password / Bitwarden — link] con acceso por tiempo limitado. No se comparten contraseñas en texto plano (estos docs son públicos). Las credenciales enviadas por otros canales se rotarán.