Blueprint

Modelli di distribuzione e adozione per ogni contesto.

Per i team che pianificano come portare ADDA nel proprio ambiente.

Blueprint ADDA

Architetture di riferimento per distribuire DNS, WAF, Access e la distribuzione pubblica di ADDA al di fuori del repository.

Blueprint

Kit

Pacchetti di release

Asset pubblici

dns / Cloudflare Worker

ADDA DNS Edge / Cloudflare Worker

operativo

Bundle DNS difensivo con heartbeat edge, risoluzione delle policy e telemetria operativa pronta per la distribuzione fuori dal repository.

API

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

Comandi

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

Artefatti

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

Verifica

POST a /api/adda/v1/dns/edge/telemetry con heartbeat healthy/degraded
Convalidare bundle e p95LatencyMs dalla console ADDA

waf / Reverse proxy Nginx

ADDA WAF Edge / Nginx Reverse Proxy

operativo

Reverse proxy con snippet WAF, regole adattive e telemetria/heartbeat per route sensibili.

API

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

Comandi

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

Artefatti

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

Verifica

Emettere un heartbeat WAF e verificare blocked/challenged/allowed nella dashboard
Convalidare snippet Nginx e matched rules dalla console

access / systemd + agente leggero

ADDA Access Watch Agent / systemd rollout

pronto

Runbook di distribuzione per heartbeat e telemetria dei peer sui tunnel Access, con chiave condivisa e ID di dispositivo/tunnel.

API

/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

Comandi

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

Artefatti

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

Verifica

Confermare un heartbeat online e un peer healthy in AddaAccessPanel
Verificare punteggio di rischio, stato stale e azioni consigliate per peer/agente

tooling / pubblicazione versionata

ADDA SDK + CLI blueprint de publicación

pronto

Blueprint di pubblicazione per `@capacero/adda-sdk` e `@capacero/adda-cli`, con binario `adda`, controlli di pubblicazione e componenti pubblici.

API

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

Comandi

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

Artefatti

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

Verifica

Convalidare metodi Access e manifest di release in SDK/CLI
Aprire `/adda/badge.js` e `/adda/widget.js` come asset pubblici reali