01 / 16
Ambiso
Documentação viva · 2026-06-24

Arquitetura
do
Workspace

A jornada completa — do negócio à stack técnica — em um só lugar. Deslize para baixo.

2
motores de receita
5
apps · 1 worker
50+
endpoints
deslize ↓
02 / 1602
O modelo de negócio

Dois motores, um workspace

A. E-commerce

A marca AMBISO — camisetas básica/oversized, loja Shopify, Pix, frete Sul/Sudeste. Aposta de longo prazo, hoje movida a conteúdo orgânico (TikTok-first).

B. DTF local

O serviço de estampa sob demanda (uniformes, eventos, brindes na região). É o motor de receita real — vendas por WhatsApp + draft order.

"A marca é o experimento financiado pelo serviço — não o contrário."

03 / 1603
Visão geral

O mapa da stack

Shopifytema Liquid · loja + checkout
Cloudflare Workero hub que conecta tudo
Pages
KV + R2
Integrações
Dashboard
04 / 1604
Jornada 1 · passo a passo

Compra e-commerce

Cliente navega a loja (tema Shopify) e escolhe o produto.
PDP cota frete → POST /shipping (Frenet + cache).
Checkout nativo Shopify, paga via Pix.
order-paid → baixa estoque + CAPI Purchase.
Dashboard reflete o pedido; NF-e + Frenet no fulfillment.
05 / 1605
Jornada 2 · passo a passo

Venda local DTF

Cliente chega por Google Meu Negócio / WhatsApp.
Operador gera Draft Order + manda orçamento.
Cliente paga Pix pelo link do draft.
Worker vê shopify_draft_order → pula CAPI.
Impressão DTF + entrega — o motor de receita real.
06 / 1606
O cérebro

O worker unificado

index.js roteia tudo: 8 handlers, 50+ endpoints, webhooks com HMAC.

webhooks

Pedido pago, checkout, cancelamento → CAPI + estoque.

frete

Carrier Service + Frenet SOAP + regras Ambiso.

kpi

Dashboard: Shopify + Meta + GA4 + Google Ads.

estoque

Sync MP↔Shopify (GraphQL) + R2 + auditoria.

07 / 1607
Fluxo · frete

Cotação em ~64 ms

O gargalo é o SOAP da Frenet (~5,6 s). Um cache de isolate (30 min, por CEP+peso) derruba o hit pra dezenas de ms — zero write em KV.

  • POST /shipping — Carrier Service oficial, chamado pela PDP/carrinho.
  • Frete grátis para Sul + Sudeste (7 estados), sem mínimo.
  • Retirada local CEP 875xx = R$0 (LOCAL_PICKUP).
08 / 1608
Fluxo · Meta CAPI

Conversões sem ruído

Eventos server-side pro Pixel Meta — com filtros que evitam conversão falsa.

Purchase InitiateCheckout ViewContent
  • Skip venda local — draft order não conta como Purchase.
  • Skip amostra grátis — tag do TikTok não infla ROAS.
09 / 1609
Fluxo · estoque

KV é a fonte da verdade

MP-* no KV = modelo·cor·tamanho com a quantidade real.
Sync via GraphQL por inventory_item_id (nunca variant_id).
CRON 9h e 21h (ou /api/sync-shopify).
Dirty-check antes de escrever (free tier: 1000 writes/dia).
10 / 1610
Operação

O dashboard

SPA em dashboard.ambiso.com.br, login por PIN de 4 dígitos.

  • KPIs agregados — Shopify + Meta + GA4 + Google Ads.
  • auditOrderForKpi — exclui teste, refund, venda local, amostra.
  • evaluateCampaign — D1–D3 lê, D4+ troca criativo; nunca pausa.
11 / 1611
Conteúdo

Sistema UGC orgânico

ugc.ambiso.com.br (protegido por PIN), TikTok-first. Três abas:

Referências

91 posts curados — tendências + estética Ambiso.

Conteúdo

Calendário + heróis + roteiros (Seg/Qua/Sex).

Ideias

39 ideias estruturadas pra gravar.

Métrica real

Vídeos publicados/semana — não mais infra.

12 / 1612
Pipeline · lançamento

Nova estampa → loja

Selecionar + otimizar imagens (ranking → WebP 2000²).
Cadastrar no Shopify (8 variantes: 4 tam × 2 cores).
Sync KV → Shopify + checklist de metafields/tags.
GMC obrigatório — feed; categoria por ID numérico → 0 erros.
13 / 1613
Atualizado · 2026-06-24

Ferramentas de dev (MCP)

Servidores MCP versionados em .mcp.json turbinam o trabalho assistido.

shopify-dev novo

Schema GraphQL validado + docs + validação de Liquid. Caça campo inventado antes de tocar a loja.

chrome-devtools

DOM/console/network no Chrome logado — auditorias e debug.

yt-dlp

Baixar/otimizar mídia de redes pro UGC.

Guard

Editar .mcp.json é bloqueado pelo classifier — operador faz manual.

14 / 1614
Onde tudo mora

Mapa de deploys

Lojaambiso.com.br
Worker…workers.dev
Dashboarddashboard.ambiso.com.br
Guia UGCugc.ambiso.com.br
Orçamentosorcamentos.ambiso.com.br
Este deckambiso-arquitetura.pages.dev
15 / 1615
O que mantém de pé

Disciplina & lições

  • Hierarquia de verdade — filesystem real > CONTEXTO-MASTER > copilot.
  • inventory_item_id ≠ variant_id — a confusão zerou syncs.
  • HMAC sempre — todo webhook é validado.
  • KV discipline — dirty-check + TTL obrigatórios.
16 / 1616
Ambiso
O que importa

O motor real é
a impressora

A stack é sólida e está pronta. O gargalo não é técnico: é volume de DTF local + vídeos orgânicos publicados.

"Infra pronta não vende. Conteúdo postado e impressora ligada, sim."