Skip to main content

MD32_JUNNY_CONTRACT_TESTING_SCHEMA_VALIDATION.md

Contract testing · schema validation

Visão de governança de APIs sobre contratos OpenAPI / GraphQL, incluindo detecção de breaking changes e validação de responses antes de políticas distribuídas ou IA.

Stub backend

Fase: roadmap

Roadmap para validação de contratos contra OpenAPI / GraphQL, detecção de breaking changes e integração futura com collections, runner e CI — execução local-first, sem policy engine obrigatório na v0.

Objetivos: plataforma moderna de governança APIs · governança APIs moderna

Tipos de contrato (roadmap)

REST OpenAPI · GraphQL Schema · SOAP XML Schema futuro

Fluxo principal (alvo)

  1. importar schema
  2. executar request
  3. validar response
  4. detectar inconsistências

OpenAPI — validação

  • · status codes
  • · response body
  • · request body
  • · required fields

GraphQL — validação

  • · query structure
  • · response schema
  • · required fields

Sinais de breaking change (futuro)

  • removed fields
  • changed types
  • renamed endpoints

Backend planejado

/modules/contracts
  validators
  schemas
  comparators

Componentes Angular (planeados)

  • ContractValidator
  • SchemaViewer
  • ValidationResults
  • BreakingChangesPanel

Resultados de validação · estados UX

Tipos: passed · warnings · failed · missing fields

Valid — VerdeWarning — AmareloInvalid — Vermelho

MVP alvo (MD32)

  • OpenAPI validation
  • GraphQL validation
  • response validation
  • basic schema diff

Explicitamente não alvo inicial

  • distributed validation
  • AI schema analysis
  • policy engine
  • realtime governance

UI futura em /features/contracts