Skip to content

Ambiente: Producción ​

Status: ⏳ No provisionado todavía — dominios decididos/previstos (2026-07-28), infraestructura pendiente. Última actualización: 2026-10-06 (G1: el Terraform de producción trae el bucket S3 de los soportes de pago, escrito y validado, no aplicado; antes, 2026-10-05: decisiones de Carlos: producción arranca con el tarifario provisional de 50 USD fijos, el mismo client_secret que el sandbox y los pasos de modo Real en pausa hasta que Soterex mande la URL y el secret; antes, el cliente OAuth de Soterex y la alineación de la API C2P al contrato de Soterex)

Sigue en AWS. El ADR-006 planteaba construir producción directo en Azure; esa migración se descartó el 2026-08-07 (ver ADR-006). El Terraform de infra/terraform/environments/production/ es el que vale — y desde el 2026-08-07 además planea: hasta ese día tenía un error que lo hacía fallar (al módulo github_oidc le faltaban dos argumentos requeridos), invisible porque nunca se había corrido terraform validate con el binario real.

Qué falta para provisionar Producción ​

  • [ ] Proyecto Firebase de Producción (Hosting + Authentication), separado de Dev/Staging.
  • [ ] Crear el cliente OAuth de Soterex en producción. Desde ADR-012 no hay credenciales de Soterex que esperar: es Soterex quien llama a CIS con credenciales nuestras. El hash y el comando exacto están en Cliente OAuth de Soterex.
  • [ ] Cargar el tarifario real de comisiones cuando Tesorería (Teresa) lo defina, en Parámetros → Comisiones. Ya no es un requisito para abrir: producción arranca con el provisional de Guatemala, 50 USD fijos por transacción para cualquier monto, que el sistema siembra en todos los ambientes (decisión de Carlos, 2026-10-05, que reemplaza a «en producción no se siembra nada»); la pantalla de Comisiones lo marca PROVISIONAL. Dos cosas a saber antes de abrir: con montos menores a 50 USD la comisión es mayor que el principal (se da de alta y se paga igual), y Soterex ve fee: "50.00" en cada respuesta. Un SendRequest solo se rechaza con 2026 si un Admin desactiva todos los tramos o deja un monto sin cubrir. El tramo llega con CountrySeeder (db:seed, la primera vez, cuando se crea Guatemala: ver «Cómo llegar de cero» en Staging) o con la migración de datos si Guatemala ya existe. Antes de abrir, comprobar en Parámetros → Comisiones que aparece el tramo PROVISIONAL (si falta, todo SendRequest da 2026). Ver ADR-018 (Actualización 2026-10-05).
  • [ ] Pasar Soterex a modo Real en Configuración, con la Notifications URL (https://) y el secret de la firma. En pausa hasta que Soterex mande la URL y el secret (Carlos todavía no los tiene). El modo por defecto es mock, y en producción el mock no manda nada ni da nada por entregado: las notificaciones fallan y terminan FAILED hasta que se cambie, y se reenvían con notifications:retry --all-failed.
  • [ ] Prender el scheduler de producción (notifications:deliver y c2p:expire). En pausa, junto con el paso anterior: sin scheduler no sale ninguna notificación y no vence ninguna transacción. En Staging el estado y sus consecuencias están en «Con el scheduler apagado»; al prenderlo se envía lo acumulado, así que antes hay que revisar la cola.
  • [ ] Bucket S3 de los soportes de pago (módulo documents, ADR-019). environments/production/main.tf ya lo trae, escrito y validado, no aplicado, junto con la política mínima del task role (guardar, leer y listar; sin DeleteObject) y las variables DOCUMENTS_DISK_DRIVER=s3, DOCUMENTS_BUCKET y AWS_DEFAULT_REGION. Sin el bucket, los soportes se guardarían en el disco del contenedor y se perderían en cada deploy: no se abre Producción sin esto. El orden del primer apply es el del runbook de Staging: primero la imagen con league/flysystem-aws-s3-v3 (ninguna tarea puede arrancar con s3 sin la librería: da 500 en todo soporte), después el apply leído a mano, después un deploy que tome las variables y recién ahí la verificación (subir, forzar un redeploy y abrir; los controles del bucket con la CLI de AWS; el smoke de subida de 1 MB y 15 MB). Dos cosas para decidir antes: las versiones no vigentes se conservan 365 días (decisión conservadora y reversible, no un requisito del cliente: si CIS-EC tiene un plazo de retención regulatorio, se ajusta en noncurrent_version_retention_days), y la retención del soporte vigente, que hoy no expira nunca (pregunta abierta #7 del análisis funcional de Pago). Producción no tiene soportes que perder: nunca se aplicó.
  • [ ] Decidir el registro de accesos del bucket de soportes (identificaciones de personas migrantes). El módulo no prende logs de acceso de S3 ni eventos de datos de CloudTrail (GetObject / PutObject), así que lo único que dice quién leyó un soporte es TRANSACTION_DOCUMENT_VIEWED, y solo si la lectura pasó por la app. Quien entra con las credenciales del task role queda fuera de ese registro: hoy eso incluye a run-artisan-command.yml, que corre un comando artisan de texto libre en una tarea con ese rol y por lo tanto equivale a poder leer todos los soportes (el Environment production está pensado con reviewers obligatorios, como dice terraform-apply.yml: confirmarlo antes de abrir; el de Staging no se ve desde el repositorio), y a quien use credenciales de administración. Opciones: eventos de datos de CloudTrail acotados a este bucket, o aws_s3_bucket_logging hacia un bucket de logs aparte. Es una decisión de costo y de qué se le promete al cliente, no un default: se toma antes del primer apply de Producción.
  • [ ] Backend desplegado con monitoreo/observabilidad (Architect + DevOps).
  • [ ] Base de datos de Producción con backups configurados.
  • [ ] Certificado ACM para el ALB del backend — cubre únicamente api.soterex.cislatam.net (un solo dominio exacto, sin wildcard: docs.*/docs.api.* van por Firebase Hosting, con TLS automático propio, no pasan por este ALB). Ver infra/terraform/environments/production/variables.tf (acm_certificate_arn) y el runbook de Staging (doc/plans/2026-07-25-staging-go-live-runbook.md) como referencia del mismo procedimiento.
  • [ ] Templating por ambiente de la config de Firebase en doc/site/public/. Sigue pendiente, aunque cambió de forma: los literales "REEMPLAZAR" se reemplazaron el 2026-07-28 por la config real, pero hardcodeada a soterex-staging. Deployado tal cual en producción, el portal autenticaría contra el proyecto de staging. (No es un secreto filtrado: una config de cliente de Firebase es pública por diseño.) El job deploy-docs-api de .github/workflows/deploy-staging.yml deploya doc/site/public tal cual, sin build ni inyección de variables, así que no lo resuelve. Opciones: envsubst en el entrypoint de nginx, build por ambiente en CI, o un config.json externo fetcheado antes de initializeApp.
  • [ ] Volver a poner production en la matriz de .github/workflows/terraform-plan.yml. Se sacó el 2026-08-07 porque el rol de IAM que ese workflow asume por OIDC lo crea el propio terraform apply de producción: hasta el primer apply no hay rol que asumir, así que planear producción falla siempre — un rojo permanente que no señala ningún problema real. Después del primer apply, el plan sí es señal útil.
  • [ ] Crear el GitHub Environment production (con reviewers obligatorios). Los jobs que asumen un rol por OIDC tienen que declarar environment:, porque la trust policy exige que el claim sub termine en :environment:production — sin esa línea GitHub no emite el claim y AWS rechaza el AssumeRole. Es el mismo error que tuvo terraform-plan.yml con staging hasta el 2026-08-09.
  • [ ] Revisión de security (JWT, manejo de credenciales de Soterex, timeout de sesión, logs de auditoría) antes del primer deploy.
  • [ ] Runbook de incidentes (tech-writer + devops).

URL(s) ​

Dominios decididos/previstos (2026-07-28) — mismo patrón que Staging (doc/plans/2026-07-25-staging-go-live-runbook.md), sin el segmento stag. El de la web app principal es el único a confirmar cuando llegue el momento (el runbook lo deja explícito así), los otros 3 ya están en uso real en el esquema de Staging:

ComponenteURL ProducciónEstado
Web app principalhttps://soterex.cislatam.net (a confirmar)⏳
Backend / API propia (donde Soterex se conecta, ej. webhook — ver Pregunta Abierta #2b del Análisis Funcional)https://api.soterex.cislatam.net⏳ dominio decidido, no provisionado
Documentación funcional (VitePress)https://docs.soterex.cislatam.net⏳ dominio decidido, no provisionado
Referencia de API (Scalar)https://docs.api.soterex.cislatam.net⏳ dominio decidido, no provisionado

Cliente OAuth de Soterex (C2P entrante) ​

Soterex (Salesforce) llama a nuestra API con OAuth 2.0 Client Credentials (ADR-012). En producción hay que crearle su cliente después del primer deploy (con las migraciones ya aplicadas).

Decisión de Carlos (2026-10-04): el mismo client_secret vale para sandbox y producción. Lo que cambia entre ambientes es el client_id y las URLs. Reafirmada el 2026-10-05: se mantiene el mismo, riesgo aceptado aunque la especificación de Soterex pide credenciales separadas por ambiente (ver «Riesgos y decisiones de Carlos» en ADR-017). Si el secret se filtra en un ambiente, vale para los dos: la rotación (api-client:rotate-secret) hay que hacerla en ambos.

Hash del secret (Argon2id en base64, generado el 2026-10-04 con api-client:generate-secret). Se puede versionar: es lo mismo que guarda la base y no permite reconstruir el secret.

JGFyZ29uMmlkJHY9MTkkbT02NTUzNix0PTQscD0xJGNXd3hlSFZ6ZEVOa1FVVlFUMjVYTHckam9rZzgvWG9SUVEvbEl0V05OSloxNjgycUxJRzNXVmNxNTkzeTNmRFBYcw==

El secret en claro no está en el repo. Lo tienen Carlos y Sean Rahimi (Soterex/Prutech).

Pasos ​

  1. GitHub → Actions → "Ejecutar comando artisan (manual)" → environment production:

    api-client:create soterex --secret-hash-b64=JGFyZ29uMmlkJHY9MTkkbT02NTUzNix0PTQscD0xJGNXd3hlSFZ6ZEVOa1FVVlFUMjVYTHckam9rZzgvWG9SUVEvbEl0V05OSloxNjgycUxJRzNXVmNxNTkzeTNmRFBYcw==
  2. Anotar el client_id que devuelve. Va a empezar con cis_prod_: el prefijo lo pone el código según el ambiente (ApiClientCreate), así que no es el mismo que el de staging.

  3. Verificar con el mismo workflow: api-client:list.

  4. Pasarle a Sean el client_id de producción y las URLs (el secret ya lo tiene):

    • Token URL: https://api.soterex.cislatam.net/api/oauth/token
    • Base URL: https://api.soterex.cislatam.net (POST /api/c2p/v1/SendRequest, POST /api/c2p/v1/Cancel)
  5. Si Soterex pidió IP allowlist para producción (se le preguntó en el mail de onboarding), configurarla antes de avisarle.

    Reemplazado el 2026-10-05 (ADR-017, D10): CIS no exige una allowlist de IP a Soterex y ya no se la pide en ningún mail. Lo que Soterex sí quiere (la especificación lo dice) son las IP desde las que CIS le manda las notificaciones: en producción salen por NAT Gateways, uno por zona de disponibilidad (single_nat_gateway = false en el Terraform de producción), o sea un conjunto chico de direcciones fijas, y se le informan cuando se provisione. El allowed_ips por cliente sigue en el código, vacío, sin usarse.

El mismo secret en staging ​

El cliente de staging es cis_stg_mxlighrgiydwibea. Para que use este secret hay que rotarlo (mismo workflow, environment staging):

api-client:rotate-secret cis_stg_mxlighrgiydwibea --secret-hash-b64=JGFyZ29uMmlkJHY9MTkkbT02NTUzNix0PTQscD0xJGNXd3hlSFZ6ZEVOa1FVVlFUMjVYTHckam9rZzgvWG9SUVEvbEl0V05OSloxNjgycUxJRzNXVmNxNTkzeTNmRFBYcw== --overlap=1h

Hecho el 2026-10-04 (run 37245365860: "Secret rotado para soterex (cis_stg_mxlighrgiydwibea). Solapamiento: 1h."). El secret anterior dejó de valer una hora después.

Checklist de go-live ​

  • [ ] Todas las Preguntas Abiertas bloqueantes del Análisis Funcional resueltas (doc/functional/2026-07-24-soterex-integracion/06-preguntas-abiertas.md).
  • [ ] ADRs de arquitectura aprobados (doc/architecture/).
  • [ ] Revisión de seguridad completa.
  • [ ] Un soporte subido en Producción sobrevive a un redeploy y se abre (ADR-019; la prueba que habría detectado el defecto original), y la prueba de humo de subida pasó después del último apply que tocó waf o ecs (Staging).
  • [ ] Prueba end-to-end con Soterex en sandbox exitosa antes de pasar a credenciales reales.

Notas ​

Ninguna decisión de producción se toma en este documento sin que exista antes su ADR correspondiente en doc/architecture/.

Documentación viva — se actualiza junto con el código, no es un anexo aparte.