Arquitectura v2 ERP

ERP / POS / Sistema contable
            │
            ▼
      OrderFast API v2
          NestJS
            │
            ▼
 Application Services
            │
            ▼
 Supabase/PostgreSQL
            │
            ▼
 Webhooks / Outbox / Jobs

Principios

• /v1 queda como API RESTful general.
• /v2 se diseña para casos ERP/POS.
• Los integradores nunca acceden directo a Supabase.
• Las respuestas públicas usan DTOs estables.
• Todo se filtra por location_id.
• Las operaciones críticas son idempotentes.
• Los webhooks usan outbox pattern.
• Los imports/exports grandes deben ser batch jobs.
• Los batch jobs usan PGMQ (cola Postgres en Supabase) para procesamiento async.
• Los webhooks usan PGMQ para delivery inicial y reintentos (webhook_events, webhook_retries).

Componentes recomendados

NestJS API
  ├── Bearer Auth
  ├── Permission Guard
  ├── Idempotency Guard
  ├── Rate Limit
  ├── Sync Jobs (PGMQ consumer)
  ├── Webhook Dispatcher (PGMQ consumer)
  ├── OpenAPI
  └── Audit Logs

Supabase
  ├── PGMQ (`api_sync_jobs`, `webhook_events`, `webhook_retries` queues)
  ├── locations
  ├── products
  ├── product_stock
  ├── categories
  ├── orders
  ├── order_items
  ├── order_payments
  ├── turns
  └── webhook_* tables

---