Blueprints

Modelos de implantação e adoção para cada contexto.

Para equipes que planejam levar a ADDA ao seu ambiente.

Blueprints ADDA

Arquiteturas de referência para implantar DNS, WAF, Access e a distribuição pública da ADDA fora do repositório.

Blueprints

Kits

Pacotes de release

Assets públicos

dns / Cloudflare Worker

ADDA DNS Edge / Cloudflare Worker

operacional

Bundle defensivo de DNS com heartbeat de edge, resolução de política e telemetria operacional pronta para implantação fora do repositório.

APIs

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

Comandos

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

Artefatos

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ção

POST em /api/adda/v1/dns/edge/telemetry com heartbeat healthy/degraded
Validar o bundle e p95LatencyMs no console ADDA

waf / Proxy reverso Nginx

ADDA WAF Edge / Nginx Reverse Proxy

operacional

Proxy reverso com snippets WAF, regras adaptativas e telemetria/heartbeat para rotas sensíveis.

APIs

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

Comandos

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

Artefatos

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ção

Emitir heartbeat WAF e revisar blocked/challenged/allowed no dashboard
Validar snippets Nginx e matched rules no console

access / systemd + agente leve

ADDA Access Watch Agent / systemd rollout

pronto

Runbook de implantação para heartbeats e telemetria de peers em túneis Access com chave compartilhada e IDs de dispositivo/túnel.

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

Comandos

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

Artefatos

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ção

Confirmar heartbeat online e peer healthy no AddaAccessPanel
Revisar pontuação de risco, estado stale e ações recomendadas por peer/agente

tooling / publicação versionada

ADDA SDK + CLI blueprint de publicación

pronto

Blueprint de publicação para `@capacero/adda-sdk` e `@capacero/adda-cli`, com binário `adda`, verificações de publicação e componentes públicos.

APIs

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

Comandos

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

Artefatos

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

Verificação

Validar métodos Access e manifest de release no SDK/CLI
Abrir `/adda/badge.js` e `/adda/widget.js` como assets públicos reais