kroz docs

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.json e llms.txt removidos 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.md excluído do build (documento interno)

Conteúdo

  • Referências a docs/kroz/ e repo FÁBRICA corrigidas nas páginas públicas
  • llms.txt sem 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:docsscripts/build-kroz-docs.py
  • Deploy Cloudflare Pages → docs.kroz.co

OpenAPI

  • docs/openapi.json, OpenAPI 3.1, 14 paths principais, schemas, security
  • 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.txt para indexação por agentes de IA
  • Rule Engine e Fatura Híbrida com conteúdo inicial publicável