Integracion con CSB
y despliegue en Cloud Run

{
  "eventType":   "order_delivered",
  "orderId":     "ORD-MX-2024-001",
  "status":      "completed",
  "trackingUrl": "https://track.bringoz.com/BRZ-789456",
  "details": {
    "driverName":      "Carlos M.",
    "deliveredAt":     "2026-09-01T14:28:00.000Z",
    "signatureUrl":    "https://bringoz.com/sig/abc123.png",
    "photoUrl":        "https://bringoz.com/photo/abc123.jpg"
  },
  "timestamp":  "2026-09-01T14:30:00.000Z"
}

# Crear cada secret (reemplaza VAL con el valor real)
for name in bringoz-host bringoz-api-key bringoz-tenant-id \
            pubsub-result-topic delivery-provider; do
  echo -n "VAL" | gcloud secrets create "csb-dev-$name" \
    --data-file=- \
    --project=rtp-transversal-dev
done

resource "google_cloud_run_v2_service" "api" {
  name     = "${local.prefix}-api"
  location = var.region

  template {
    service_account = google_service_account.run.email

    containers {
      image = "...csb-delivery-adapter:${var.image_tag}"

      // Secrets inyectados directamente como env vars:
      dynamic "env" {
        for_each = local.secret_env_map  // BRINGOZ_HOST, BRINGOZ_API_KEY, etc.
        content {
          name = env.key
          value_source {
            secret_key_ref {
              secret  = "${local.secret_prefix}-${env.value}"
              version = "latest"
            }
          }
        }
      }

      liveness_probe  { http_get { path = "/health" } }
      startup_probe   { http_get { path = "/health" } }
    }

    vpc_access {
      connector = var.vpc_connector_id
      egress    = "PRIVATE_RANGES_ONLY"
    }
  }
}

substitutions:
  _REGION:  us-central1
  _ENV:     dev
  _SERVICE: csb-delivery-adapter

options:
  logging:     CLOUD_LOGGING_ONLY
  machineType: E2_HIGHCPU_8

tags:
  - csb-delivery-adapter
  - ${_ENV}

src/
 ├── main.ts                              Bootstrap: ValidationPipe, CORS, GlobalExceptionFilter
 ├── app.module.ts                        Root: Health, Delivery, Webhooks, PubSub + middlewares
 │
 ├── config/
 │   └── app.config.ts                    loadDeliveryConfig() — env vars o Secret Manager
 │
 ├── delivery/
 │   ├── delivery.controller.ts           POST /create-order, GET /track/:id, POST /cancel/:id
 │   ├── delivery.service.ts              Provider pattern — selecciona Bringoz o Nexus
 │   ├── delivery.module.ts               DI: DELIVERY_CONFIG, providers, PubSubModule
 │   ├── dto/
 │   │   └── delivery-payload.dto.ts      DeliveryPayloadDto, DeliveryEnvelopeDto, TaskMetadataDto
 │   └── providers/
 │       ├── delivery-provider.interface.ts DeliveryProvider + DeliveryResult
 │       ├── bringoz.provider.ts          Bringoz (default) — TODO: implementar API real
 │       └── nexus.provider.ts            Nexus (alternativo) — TODO: implementar API real
 │
 ├── webhooks/
 │   ├── webhooks.controller.ts           POST /webhooks/bringoz
 │   ├── webhooks.service.ts              mapToDeliveryResult() → pubsub.publishResult()
 │   ├── webhooks.module.ts
 │   └── dto/
 │       └── webhook-event.dto.ts         WebhookEventDto: eventType, orderId, status, details
 │
 ├── pubsub/
 │   ├── pubsub.service.ts                publishResult() → topic.publishMessage() con attributes
 │   └── pubsub.module.ts
 │
 ├── health/
 │   ├── health.controller.ts             GET /health (liveness) + GET /health/ready (readiness)
 │   └── health.module.ts
 │
 └── common/
     ├── filters/
     │   └── global-exception.filter.ts   Catch-all: log estructurado + correlationId
     └── middlewares/
         ├── correlation-id.middleware.ts X-Correlation-ID: propaga o genera UUID
         └── request-logger.middleware.ts Log JSON: method, path, status, duration_ms

URL=$(gcloud run services describe csb-delivery-adapter-dev-api \
  --region=us-central1 --format='value(status.url)')
TOKEN=$(gcloud auth print-identity-token)

curl -X POST "$URL/delivery/create-order" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "envelope": {
      "id": "test-evt-001",
      "entityId": "ORD-TEST-001",
      "data": {
        "orderId": "ORD-TEST-001",
        "customerName": "Test Bebbia",
        "deliveryAddress": "Calle Test 1, CDMX",
        "postalCode": "06600",
        "phone": "5500000000"
      }
    }
  }' | jq .

# Respuesta esperada:
# {
#   "status": "ok",
#   "provider": "bringoz",
#   "result": { "orderId": "ORD-TEST-001", "status": "pending", ... }
# }

curl -H "Authorization: Bearer $TOKEN" \
  "$URL/delivery/track/ORD-TEST-001" | jq .

# { "status": "ok", "result": { "orderId": "ORD-TEST-001", "status": "pending" } }

curl -X POST "$URL/webhooks/bringoz" \
  -H "Content-Type: application/json" \
  -d '{
    "eventType": "order_delivered",
    "orderId": "ORD-TEST-001",
    "status": "completed",
    "trackingUrl": "https://track.bringoz.com/test",
    "details": { "driverName": "Test Driver" },
    "timestamp": "2026-08-27T20:00:00Z"
  }' | jq .

# { "status": "ok", "acknowledged": true }