José Miguel Gómez

Volver al inicio

Aforo

One contract and conformance suite for ten polyglot booking APIs

Los datos de cada proyecto se muestran en inglés; vienen tal cual de su repositorio.

Estado
Próximamente
Tipo
Herramienta de desarrollo
En marcha desde
noviembre de 2026
Rol
Architect and sole engineer
Dominios
API design, contract testing, concurrency, reference architecture
Reparto
OpenAPI, JSON Schema, Hurl, Schemathesis, Java, Spring Boot, Csharp, Aspnetcore, Go, Gin, Ruby, Rails, React, Angular

Contexto y problema

One API contract, four implementations (Spring Boot, ASP.NET Core, Go, Rails), 379/379 cases each.

Comparing stacks without a shared, executable spec is anecdote: RealWorld-style apps have no invariant that can break under concurrency. The Aforo suite fires 300 simultaneous clients at a 50-seat event.

Pantallas

Cómo se construyó

Construido en 13,95 h entre 5 repositorios · conformidad 379/379 en cada uno

Fuente: Each repository states its own figures: r1 1.95 h, USD 65.77, 403 tests; L01 3.50 h, USD 54.84; L02 2.10 h; L04 4.40 h, USD 40.46; L08 2.00 h (L02 and L08 cost not computed), con fecha 21 de noviembre de 2026.

Resultados con evidencia fechada

Resultados tal como los declara el manifiesto; las cifras medidas son las que llevan fecha.

  • Full Aforo conformance profile 379/379 on contract 2.0.0 in Spring Boot (L01), ASP.NET Core (L02), Go (L04) and Rails (L08).
  • L04: own race with 500 goroutines through the HTTP API, exactly 50 confirmed, 25 waitlisted, 425 event-full.
  • L08: one process, two SQLite files; Litestream restores the data in 70 ms, verified by a hash of every row.
  • L09 React client: all 28 shared end-to-end scenarios pass on desktop and mobile against the reference implementation.

Caso de estudio en preparación

El caso de estudio completo añade estas secciones cuando se publique:

  • Restricciones
  • Diagramas de arquitectura (contexto y contenedores C4)
  • Tres decisiones clave
  • Qué salió mal
  • Vídeo de la demo
  • Qué haría distinto

Destacados

contract first, conformance suite, optimistic concurrency, polyglot