Configurar la instancia

Esta página es para quien administra una instancia de Fundaia: quién puede entrar y qué hay que configurar en el servidor para cada integración. Cómo se instala y actualiza el código en la máquina está en deploy/README.md del repositorio, y la entrada pública (TLS, DNS) en deploy/ingress/README.md.

Quién entra

El código de arranque está en ~/.orchestrator/bootstrap-code; tras la primera passkey, el registro de passkeys se cierra para siempre.

El registro está cerrado salvo que se abra: solo entran por GitHub las cuentas de ORCHESTRATOR_ALLOWED_GITHUB_LOGINS (y el dueño). Con ORCHESTRATOR_OPEN_REGISTRATION=true puede entrar cualquiera con cuenta de GitHub, y cada persona que entra puede arrancar contenedores en la máquina. Cerrarlo no echa a nadie que ya tenga cuenta.

Dónde va la configuración

En ~/.orchestrator/infra.env (permisos 600, nunca en git), que la unidad orchestrator.service carga al arrancar. Tras cambiarlo, reinicia el servicio. Toda integración cuya configuración falta se apaga sin romper nada: sin GitHub no hay botón de GitHub, sin Stripe no se cobra.

GitHub

La OAuth App: entrar con GitHub

Registra una OAuth App en GitHub con la URL de callback exacta https://infrastructure.fundaia.com/api/auth/github/callback (una OAuth App admite una sola), y pon su client ID y un secreto recién generado en GITHUB_OAUTH_CLIENT_ID y GITHUB_OAUTH_CLIENT_SECRET. El botón aparece solo con las dos.

En esta instancia la aplicación ya está registrada en la cuenta alex28042:

El secreto se genera en la página de la aplicación y GitHub lo enseña una sola vez: va del portapapeles a infra.env y a ningún otro sitio.

GITHUB_APP_SLUG convierte el botón de entrar en el «Install & Authorize» de la GitHub App, para que una sola autorización cubra la identidad y los repositorios.

La GitHub App: clonar, registrar despliegues y el webhook

Con FUNDAIA_APP_ID y FUNDAIA_APP_PRIVATE_KEY (el PEM, con los saltos de línea como \n), la plataforma clona cada repositorio con un permiso de solo lectura concedido por su dueño, registra los despliegues en GitHub y puede abrir pull requests del autofix.

Los permisos que la App necesita, y para qué:

Al añadir un permiso, cada instalación tiene que aceptarlo en Settings → Applications → Installed GitHub Apps; hasta entonces GitHub responde 403 a lo que lo necesita.

Para que un push llegue en segundos en vez de en el siguiente sondeo de dos minutos:

El webhook solo avisa: la plataforma vuelve a leer la cabeza de la rama con git y aplica la misma regla de aprobación que el sondeo.

Stripe

Sin STRIPE_SECRET_KEY o sin STRIPE_WEBHOOK_SECRET la plataforma calcula el consumo para la pantalla y no cobra a nadie, que es como corre el desarrollo local.

STRIPE_SECRET_KEY=sk_live_…
STRIPE_WEBHOOK_SECRET=whsec_…
STRIPE_METER_EVENT_NAME=fundaia_consumo      # por defecto

STRIPE_PRICE_BASE=price_…                    # el fijo del plan
STRIPE_PRICE_BASE_USAGE=price_…              # el de consumo del plan
STRIPE_PRICE_PRO=price_…
STRIPE_PRICE_PRO_USAGE=price_…

STRIPE_PRICE_CREDITS_C10=price_…             # un precio de pago único por paquete de crédito
STRIPE_PRICE_CREDITS_C25=price_…
STRIPE_PRICE_CREDITS_C50=price_…
STRIPE_PRICE_CREDITS_C100=price_…

INFRA_UNGOVERNED_WORKSPACES=wsp_…,wsp_…      # espacios que no pagan; vacío es lo seguro

Un plan sin sus dos precios no se ofrece, y un paquete de crédito sin el suyo tampoco.

Lo que hay que montar en Stripe:

• Un medidor (fundaia_consumo, agregación sum) cuya unidad es un céntimo de consumo.
• Por plan, un precio fijo mensual y un precio de consumo graduado con el primer tramo a cero (900 unidades en Base, 1800 en Pro): ese tramo es el consumo incluido.
• Un producto de crédito con un precio de pago único por paquete.
• Un webhook a /api/infra/billing/webhook con checkout.session.completed, checkout.session.async_payment_succeeded (los pagos que se confirman días después, como SEPA) y los tres customer.subscription.*.

Esta instancia

Cuenta acct_1U04pMBkszImu6qD, en euros.

Para probar en local con el sandbox, sk_test_… como clave y, en vez de un webhook público:

stripe listen --forward-to localhost:5273/api/infra/billing/webhook

El whsec_… que imprime es el STRIPE_WEBHOOK_SECRET mientras dure esa sesión.

Abonar crédito a mano

El dueño puede abonar crédito de agente a un espacio sin pasar por Stripe (una prueba, una compensación). Queda en el historial como abono, distinto de una compra:

curl -X POST https://infrastructure.fundaia.com/api/infra/workspaces/<espacio>/credits/grant \
  -H "Authorization: Bearer fdi_…" \
  -H "content-type: application/json" \
  -d '{"amountCents": 2000, "detail": "Saldo inicial"}'

Métricas

Las gráficas de la pestaña Métricas salen de un Prometheus que raspa /api/infra/metrics con un token. Sin INFRA_METRICS_TOKEN ese endpoint responde 404; sin INFRA_PROMETHEUS_URL la pestaña enseña solo las cifras del momento. La puesta en marcha está en deploy/observability/README.md.

Buscadores y vistas previas

La portada, las guías y las novedades llegan con su título, su descripción, Open Graph, datos estructurados y el texto de la página ya escrito, así que un buscador o una vista previa de Slack los leen sin ejecutar JavaScript. Quien entra con sesión recibe solo la cabecera; las pantallas de la aplicación van con noindex.

• **/robots.txt y /sitemap.xml** se generan solos, con la dirección pública de la instancia (ORCHESTRATOR_DOMAIN u ORCHESTRATOR_ORIGIN), y dejan fuera la API y las pantallas privadas.
• **Las novedades salen de CHANGELOG.md**, el de la raíz del repositorio, leído una vez al arrancar; en una release es el de releases/<sha>/. Sin el fichero, la página dice que aún no hay versiones.
• **/site.webmanifest** permite instalar la web como aplicación, con los iconos de la marca.

Otras

• Dominios propios. INFRA_CUSTOM_DOMAIN_LIMIT pone un tope al número de dominios propios de toda la instancia; el que lo pasa se rechaza con el motivo.
• Copias fuera de la máquina. INFRA_BACKUP_REMOTE es un remoto de rclone y una ruta (b2:fundaia-backups/nucbox); ver deploy/README.md.
• MCP de solo lectura. INFRA_MCP_READ_ONLY=true deja en el MCP solo las herramientas que leen, para enseñar la plataforma sin dejar tocarla.