Skip to Content
DesarrolladorEstándares técnicosStack y arquitectura

Stack y arquitectura

Resumen — la fuente de verdad completa vive en el vault (PROYECTOS/Arquitectura Base/).

Backend

  • .NET 10 / C# 14, Clean Architecture en 4 capas (Domain ← Application ← Infrastructure ← Api) + CQRS con MediatR.
  • Dapper como único acceso a datos. SQL Server 2022 como motor principal.
  • Flyway para migraciones, Hangfire para trabajos programados.
  • Bases legacy: solo lectura, solo por stored procedures.

Frontend

  • Next.js 16.2.x (App Router), Node 24 LTS, pnpm ≥ 11, TypeScript estricto.
  • Tailwind v4 + shadcn/ui (copy-paste, no librería instalada).
  • Feature-Sliced Design: app → features → entities → shared.
  • El navegador solo habla con su propio origen — todo egreso pasa por el BFF en app/api/.

Reglas duras (condición de aceptación de un PR)

  • Rutas API: api/v1/{kebab-case}.
  • Toda respuesta incluye el header X-App-Code.
  • Validación al inicio del Handler, ExceptionMiddleware primero, sin try/catch en Handlers.
  • SQL siempre parametrizado con :param.

Contenedores

Docker y Docker Compose son obligatorios en ambos stacks, sin excepciones. Ningún repo depende de infraestructura instalada directamente en el equipo del desarrollador.

SISCOConvenciones