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ódulogithub_oidcle faltaban dos argumentos requeridos), invisible porque nunca se había corridoterraform validatecon 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. UnSendRequestsolo se rechaza con2026si un Admin desactiva todos los tramos o deja un monto sin cubrir. El tramo llega conCountrySeeder(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, todoSendRequestda2026). 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 esmock, y en producción el mock no manda nada ni da nada por entregado: las notificaciones fallan y terminanFAILEDhasta que se cambie, y se reenvían connotifications:retry --all-failed. - [ ] Prender el scheduler de producción (
notifications:deliveryc2p: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.tfya lo trae, escrito y validado, no aplicado, junto con la política mínima del task role (guardar, leer y listar; sinDeleteObject) y las variablesDOCUMENTS_DISK_DRIVER=s3,DOCUMENTS_BUCKETyAWS_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 conleague/flysystem-aws-s3-v3(ninguna tarea puede arrancar cons3sin la librería: da 500 en todo soporte), después elapplyleí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 ennoncurrent_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 esTRANSACTION_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 arun-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 Environmentproductionestá pensado con reviewers obligatorios, como diceterraform-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, oaws_s3_bucket_logginghacia 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 primerapplyde 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). Verinfra/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 asoterex-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 jobdeploy-docs-apide.github/workflows/deploy-staging.ymldeployadoc/site/publictal 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 unconfig.jsonexterno fetcheado antes deinitializeApp. - [ ] Volver a poner
productionen 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 propioterraform applyde 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 declararenvironment:, porque la trust policy exige que el claimsubtermine en:environment:production— sin esa línea GitHub no emite el claim y AWS rechaza el AssumeRole. Es el mismo error que tuvoterraform-plan.ymlcon 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:
| Componente | URL Producción | Estado |
|---|---|---|
| Web app principal | https://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
GitHub → Actions → "Ejecutar comando artisan (manual)" → environment
production:api-client:create soterex --secret-hash-b64=JGFyZ29uMmlkJHY9MTkkbT02NTUzNix0PTQscD0xJGNXd3hlSFZ6ZEVOa1FVVlFUMjVYTHckam9rZzgvWG9SUVEvbEl0V05OSloxNjgycUxJRzNXVmNxNTkzeTNmRFBYcw==Anotar el
client_idque devuelve. Va a empezar concis_prod_: el prefijo lo pone el código según el ambiente (ApiClientCreate), así que no es el mismo que el de staging.Verificar con el mismo workflow:
api-client:list.Pasarle a Sean el
client_idde 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)
- Token URL:
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 = falseen el Terraform de producción), o sea un conjunto chico de direcciones fijas, y se le informan cuando se provisione. Elallowed_ipspor 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=1hHecho 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
applyque tocówafoecs(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/.

