rikrdo/mercadodevida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
425fedd13eb351d5f1f8d81894ee00140d50e0e4
mercadodevida/spec/tech.md
rikrdo 425fedd13e feat(F-002): database foundation with migrations and dev compose 
- node-pg-migrate + pg: baseline migration (extensions, app_meta) with working down
- src/infrastructure/db fail-fast pool and typed query helper
- docker-compose: postgres:16-alpine + redis:7-alpine with one-command up
- table naming convention <module>_<table> documented in README
- integration tests (6) against real PostgreSQL; strict identifier validation
  for test DDL after security-gate hardening round
- deps justified in spec/tech.md; all gates approved; verify.sh green
2026-08-14 22:00:16 +02:00

1.7 KiB
Raw Blame History

Technical Spec — MercadoDeVida vNext

Stack

  • Lenguaje: TypeScript (strict) — backend y frontend
  • Framework backend: Fastify 5 (monolito modular; elegido por tipado, simplicidad y ausencia de magia)
  • Framework frontend: Next.js + React + Tailwind (llega en F-013; SSG/ISR para SEO)
  • Runtime: Node.js >= 22
  • Base de datos: PostgreSQL (fuente de verdad) + Redis (solo caché) — desde F-002

Dependencias (justificación obligatoria por política de seguridad)

Dependencia Versión Justificación
fastify ^5.2 Servidor HTTP tipado, maintained, sin magia; única dep de runtime en F-001
typescript ^5.7 Tipado estricto (dev)
vitest ^3 Tests unit/integración TS-native (dev)
eslint + @eslint/js + typescript-eslint + eslint-config-prettier ^9 / ^8 / ^10 Linting estándar (dev)
prettier ^3 Formato consistente (dev)
pg ^8 Driver PostgreSQL estándar; única forma de hablar con la DB (F-002)
node-pg-migrate ^8 Migraciones SQL up/down trackeadas en DB; elegida sobre runner propio (no reinvención) y sobre Flyway/golang-migrate (toolchains ajenos a Node) (F-002)
@types/pg ^8 Tipos para pg (dev) (F-002)

Regla: toda dependencia nueva debe agregarse a esta tabla con justificación en el ticket que la introduce.

Restricciones

  • Seguridad: nunca confiar en frontend para precio/stock/descuento/estado de pago; envelopes de error sin stack traces; sin secretos en repo
  • Rendimiento: caché solo donde sea medible (F-027)
  • Compatibilidad: URLs públicas estables /productos/, /categoria/, /marca/

Observabilidad

  • Logging: estructurado con request_id (F-003)
  • Métricas: Prometheus con métricas de negocio (F-029)
  • Alertas: fuera de alcance inicial