Blueprints ADDA

Ordena formas de despliegue y adopción según el contexto.

Para equipos que planifican cómo llevar ADDA a su realidad.

Blueprints ADDA

Arquitecturas de referencia para desplegar DNS, WAF, Access y la distribución pública de ADDA fuera del repo.

Blueprints

Kits

Packages release

Assets públicos

dns / Cloudflare Worker

ADDA DNS Edge / Cloudflare Worker

operational

Bundle defensivo DNS con heartbeat de borde, resolver policy y telemetría operativa lista para desplegar fuera del repo.

APIs

/api/adda/v1/dns/edge/bundle
/api/adda/v1/dns/edge/telemetry
/api/adda/v1/dns/dashboard

Commands

curl "$BASE_URL/api/adda/v1/dns/edge/bundle?target=cloudflare-worker&domain=capacero.ar"
npm run adda:smoke

Artifacts

lib/adda/dns-waf-runtime.ts
app/api/adda/v1/dns/edge/bundle/route.ts
app/api/adda/v1/dns/edge/telemetry/route.ts

Verificación

POST /api/adda/v1/dns/edge/telemetry con heartbeat healthy/degraded
Validar bundle y p95LatencyMs desde consola ADDA

waf / Nginx reverse proxy

ADDA WAF Edge / Nginx Reverse Proxy

operational

Reverse proxy con snippets WAF, reglas adaptativas y telemetry/heartbeat para rutas sensibles.

APIs

/api/adda/v1/waf/edge/bundle
/api/adda/v1/waf/edge/telemetry
/api/adda/v1/waf/dashboard

Commands

curl "$BASE_URL/api/adda/v1/waf/edge/bundle?target=nginx&domain=capacero.ar"
npm run adda:smoke

Artifacts

lib/adda/dns-waf-runtime.ts
app/api/adda/v1/waf/edge/bundle/route.ts
app/api/adda/v1/waf/edge/telemetry/route.ts

Verificación

Emitir heartbeat WAF y revisar blocked/challenged/allowed en dashboard
Validar snippets Nginx y matched rules desde consola

access / systemd + agente liviano

ADDA Access Watch Agent / systemd rollout

ready

Runbook de despliegue para heartbeats y peer telemetry sobre túneles Access con clave compartida y device/tunnel IDs.

APIs

/api/adda/v1/access/status
/api/adda/v1/access/agents/manifest
/api/adda/v1/access/agents/heartbeats
/api/adda/v1/access/peers/telemetry
/api/adda/v1/access/policies/evaluate

Commands

curl "$BASE_URL/api/adda/v1/access/agents/manifest?deviceId=access-device-001"
npm run adda:cli -- agent install --profile access-watch
node examples/adda-access-agent-heartbeat.mjs
npm run adda:cli -- access status

Artifacts

examples/adda-access-agent-heartbeat.mjs
app/api/adda/v1/access/agents/manifest/route.ts
scripts/adda-cli.mjs
packages/adda-cli/bin/adda.mjs

Verificación

Confirmar heartbeat online y peer healthy en AddaAccessPanel
Revisar risk score, stale y acciones recomendadas por peer/agente

tooling / publicación versionada

ADDA SDK + CLI blueprint de publicación

ready

Blueprint de publicación para `@capacero/adda-sdk` y `@capacero/adda-cli`, con bin `adda`, verificaciones de publicación y piezas públicas.

APIs

/api/adda/v1/release/manifest
/api/adda/v1/blueprints
/api/adda/v1/kits

Commands

npm run typecheck
node scripts/adda-cli.mjs --help
node packages/adda-cli/bin/adda.mjs --help

Artifacts

packages/adda-sdk/package.json
packages/adda-cli/package.json
app/adda/badge.js/route.ts
app/adda/widget.js/route.ts

Verificación

Validar métodos Access y release manifest en SDK/CLI
Abrir `/adda/badge.js` y `/adda/widget.js` como assets públicos reales