Changelog da documentação
Histórico de alterações da documentação kroz.
2026-07-01: v1.5 (FAQ e busca)
Conteúdo
- Nova página Perguntas frequentes (piloto, matriz, conciliação, integração)
- Correção de pontuação e separadores nas tabelas (artefatos da limpeza de travessões)
Interface
- Busca indexa resumos, blockquotes e perguntas H3
- Busca com múltiplas palavras (ex.:
wallet contrato) - Link para FAQ no hero da homepage
2026-07-01: v1.4 (UX)
Interface
- Fluxo visual do piloto na homepage
- Busca com índice de páginas e seções (atalho
/) - Navegação Anterior/Próximo entre páginas
- Tabelas com scroll horizontal no mobile
- Destaque visual nos passos do guia
- Botão voltar ao topo
2026-07-01: v1.3 (tom e escopo)
Conteúdo
- Fatura Híbrida Premium fora da docs pública (rascunho no repo)
- Textos revisados: menos tom de manual genérico, sem travessões
- "Visão geral" virou "Em resumo" onde era seção de doc (abas da UI mantidas)
UX
- Hero da homepage mais leve
- Footer da home simplificado
2026-07-01: v1.2 (docs pública segura)
Privacidade / conteúdo
openapi.jsonellms.txtremovidos do deploy público (permanecem no repo)- Referências a parceiro BaaS específico neutralizadas, IP "em contratação"
- Seção Desenvolver reescrita: resumo público, spec completa sob demanda
- Rule Engine, Webhooks e Adaptadores sem env vars, curls ou payloads sensíveis
UX
- Header só com kroz.co + Abrir app
- Breadcrumb, TOC "Nesta página", callouts de piloto
- Banner em páginas Desenvolver
2026-07-01: v1.1 (polish homepage)
UX / visual
- Homepage redesenhada com cards (Populares, Operar, Desenvolver, Legal)
- Removido conteúdo interno da homepage (build, deploy, mapa da sidebar, docs FÁBRICA)
- CSS alinhado à paleta kroz v0.2 (obsidian + aqua)
- Tabelas com cabeçalho vazio não exibem mais linha fantasma
- Sidebar: OpenAPI só no header; Changelog movido para Legal; seção Meta removida
docs-v2-handoff.mdexcluído do build (documento interno)
Conteúdo
- Referências a
docs/kroz/e repo FÁBRICA corrigidas nas páginas públicas llms.txtsem links para specs internas
2026-07-01: v1.0 (fase 4)
Publicação
- Site estático
docs/dist/, sidebar, busca, mermaid, CSS kroz - Build:
npm run build:docs→scripts/build-kroz-docs.py - Deploy Cloudflare Pages → docs.kroz.co
OpenAPI
docs/openapi.json, OpenAPI 3.1, 14 paths principais, schemas, security
Legal
- Compliance v1.0, RC 16, subprocessadores, LGPD, DPA outline, retenção
2026-07-01: v0.3 (fase 3)
Desenvolver
- Autenticação, login, Bearer, token HMAC, env vars, rate limit
- Webhooks, POST /api/baas-webhook, eventos, conciliação, dedup, auto-sweep
- Adaptadores BaaS, split[], pagadoria, subcontas, dry-run vs real, confirmações tipadas
- Rule Engine, POST /api/rules-dry-run, gatilhos, settlement via webhook
- Referência de API, catálogo 18 endpoints com exemplos curl
2026-07-01: v0.2 (fase 2)
Operar
- Matriz de rateio, deal, split, 3ª parcela, payload, troubleshooting
- Cobranças (Pagadoria), tipos, carregar matriz, dry-run, captabilidade
- Conciliação, fila DF, confiança, aprovar/rejeitar, demo PS-0421-P12
- Contratos e unidades, 3 caminhos de config (deal, pagadoria, backend)
- Auditoria e prova, Fechamento, Governança, prova selada, export JSON
2026-07-01: v0.1 (fase 1)
Guia de início
- Sequência operacional completa com nomes exatos da UI (Recebedores → Governança)
- Passo a passo: Oficina de Recebedores, Ajustar deal, Fechamento, Pagadoria
- Modos dry-run vs execução real
- Demo 30s, checklist de piloto, boas práticas e armadilhas
- Documentado: empreendimento/contrato sem tela dedicada (via Ajustar deal)
Conceitos
- Pagador vs recebedor (regra de ouro)
- Glossário UI ↔ backend
- SPE emissora, walletId, CPC 47, comissão na 3ª parcela
- Fechamento, conciliação, governança, dry-run por módulo
- Exemplos numéricos PS-0421 / 72-18-10
- Tabelas de armadilhas e modelos RC 16
2026-07-01: v0 (fase 0)
- Lançamento do esqueleto em
docs/ - Homepage com cards de navegação
- Guia de início e Conceitos (rascunho com conteúdo real)
- Stubs para Operar, Desenvolver, Legal e Módulos
llms.txtpara indexação por agentes de IA- Rule Engine e Fatura Híbrida com conteúdo inicial publicável