# 0003 — Stack de la aplicación, con Drizzle

- **Estado:** Aceptada (`PT-02`, 11/11/2026)
- **Reemplaza a:** `0001`
- **Fecha:** 11/11/2026
- **Registro:** `docs/revisiones/20261111-03_respuestas-cliente.md`

## Contexto

La decisión `0001` proponía Prisma para el acceso a datos. Al revisarla
(`PT-02`), el mantenedor pidió usar Drizzle. El resto del stack de `0001` se
acepta sin cambios.

## Opciones

| | Prisma | Drizzle |
|---|---|---|
| Esquema | Archivo `schema.prisma`, lenguaje propio | TypeScript |
| Consultas | API propia | Cercanas a SQL, tipadas |
| Migraciones | `prisma migrate`, con base sombra | `drizzle-kit generate` (SQL versionado) y `drizzle-kit migrate` |
| MariaDB | Soportada | Por el dialecto MySQL con el driver `mysql2` |
| Peso en ejecución | Motor propio | Liviano, sin motor |

## Decisión

- Next.js (App Router) + TypeScript, un solo proyecto. Versión estable
  vigente al crear el proyecto.
- Node.js 24 LTS.
- MariaDB 10.11 con **Drizzle ORM** (dialecto MySQL, driver `mysql2`) y
  **drizzle-kit** para las migraciones.
- Mantine para la interfaz; PWA instalable.
- `@zxing/browser` para la cámara; lector como teclado.
- Sesión propia en la base, cookie `httpOnly`, contraseñas con bcrypt.
- Zod para validar, con los mismos esquemas en formulario y servidor.
- Vitest para reglas de negocio y Playwright para flujos.

Los motivos de cada pieza, salvo el ORM, están en `0001`.

## Consecuencias

- El esquema vive en `src/db/schema/` y las migraciones son archivos SQL en
  `drizzle/`, generados con `drizzle-kit generate` y revisados antes de
  aplicarse.
- **Prohibido `drizzle-kit push`:** aplica cambios sin dejar migración. Es el
  equivalente a un `ALTER` a mano.
- No hace falta base sombra: el usuario de desarrollo necesita DDL solo sobre
  `logistica_dev`.
- MariaDB no es un dialecto propio de Drizzle. En la Etapa 0 se prueba una
  migración completa (crear, modificar y aplicar en una base vacía) antes de
  modelar los documentos.
- drizzle-kit no tiene un comando de estado de migraciones: se consulta la
  tabla `__drizzle_migrations` con un script del proyecto (`npm run
  db:estado`).
