Caso técnico · Producto 2 · sep 2026

Inventario

Backend de inventario para el estudio Mena Nails

En pre-lanzamiento, para el mismo cliente que Turnos y señas: una API de inventario en Go con contrato OpenAPI y su frontend PWA.

Código privado: el repositorio es del cliente y no es público. Esta página describe la arquitectura, las decisiones y las pruebas.

Inventario

Un contrato OpenAPI como fuente de verdad.

API en Go 1.24 sobre PostgreSQL (pgx, sqlc) con login por sesión (bcrypt), y un frontend PWA en SvelteKit para operar el inventario del estudio.

El cliente generado a partir del contrato OpenAPI se verifica en CI: si se desvía del contrato, la verificación falla.

Solución API en Go 1.24 con PostgreSQL

Consultas tipadas con pgx y sqlc, y login por sesión con contraseñas hasheadas con bcrypt.

Tradeoffs El contrato manda

OpenAPI define la interfaz: el cliente se genera desde el contrato y una verificación en CI falla ante cualquier desvío.

Calidad Tests de integración en CI

322 tests: 156 de Go —incluidos tests de integración— y 166 de Vitest para el frontend.

Producto 1 Turnos y señas

El mismo cliente usa el sistema de turnos con pagos por Mercado Pago, con caso técnico propio.

Arquitectura

Un contrato OpenAPI entre la PWA y la API.

Diagrama en dos bloques. Operación, de izquierda a derecha: la PWA en SvelteKit habla con la API en Go 1.24, que usa login por sesión con bcrypt y guarda en PostgreSQL con pgx y sqlc. Contrato y CI: el contrato OpenAPI define la interfaz, de él se genera el cliente, y una verificación en CI falla si el cliente generado se desvía del contrato.

Operación

  1. FrontendPWA en SvelteKitoperar el inventario del estudio
  2. APIGo 1.24login por sesión con bcrypt
  3. DatosPostgreSQLconsultas tipadas con pgx y sqlc

OpenAPI define la interfaz entre la PWA y la API.

Contrato y CI

  1. ContratoOpenAPIfuente de verdad
  2. GeneradoClientese genera a partir del contrato
  3. VerificaciónCheck en CIfalla si el cliente se desvía
El contrato manda: el cliente no se escribe a mano, se genera, y la CI frena cualquier desvío.

Stack

Tecnologías del producto.

API

Go 1.24, PostgreSQL (pgx, sqlc), login por sesión (bcrypt)

Contrato

OpenAPI como fuente de verdad del cliente generado

Frontend

PWA en SvelteKit

CI

Tests de Go —incluidos tests de integración—, Vitest/Playwright y una verificación que falla si el cliente generado se desvía del contrato OpenAPI