# 0001 — Stack de la aplicación

- **Estado:** Reemplazada por `0003` (el mantenedor eligió Drizzle en lugar de Prisma)
- **Fecha:** 11/11/2026
- **Registro:** `docs/revisiones/20261111-02_propuesta-implementacion.md`

## Contexto

El cliente fija Next.js y MariaDB (`docs/borradores/Aplicación Zeitune
Logística.md`). Queda por elegir el resto. Es una aplicación interna con
ingreso, que se usa sobre todo desde el celular en los depósitos, con escaneo
de EAN13 por cámara y por lector. Desarrollo y producción comparten el
servidor (AlmaLinux 9.8, Apache 2.4.62, MariaDB 10.11.18, sin Node ni Docker).

## Opciones

| Capa | Opciones consideradas | Elegida |
|---|---|---|
| Acceso a datos | Prisma · Drizzle · SQL con `mariadb` | Prisma |
| Interfaz | Mantine · Tailwind + shadcn/ui | Mantine |
| Escaneo por cámara | `BarcodeDetector` nativo · `@zxing/browser` · `html5-qrcode` | `@zxing/browser` |
| Autenticación | Auth.js · sesión propia | Sesión propia |
| Validación | Zod · validación a mano | Zod |
| Tests | Vitest + Playwright | Vitest + Playwright |

- **Prisma:** migraciones versionadas (que `CLAUDE.md` exige) y tipos
  generados del modelo. Drizzle es más liviano, pero sus migraciones son menos
  maduras sobre MariaDB.
- **Mantine:** trae los componentes que hacen falta (calendario, tablas,
  paneles laterales, diálogos de confirmación, notificaciones) sin armarlos a
  mano, y es responsivo. Tailwind + shadcn/ui exige construir más piezas.
- **`@zxing/browser`:** `BarcodeDetector` no existe en Safari de iPhone. El
  lector USB o Bluetooth no necesita librería: escribe como un teclado y
  termina con Enter, así que basta un campo con foco.
- **Sesión propia:** solo hay ingreso con usuario y contraseña (`PR-01`).
  Una tabla de sesiones y una cookie `httpOnly` alcanzan, y permiten cerrar
  sesiones desde el servidor. Auth.js suma complejidad para proveedores que no
  se usan.

## Decisión

- Next.js con App Router y TypeScript, un solo proyecto. Versión estable
  vigente al crear el proyecto.
- Node.js 24 LTS.
- MariaDB 10.11 con Prisma.
- 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.

## Consecuencias

- Un solo servicio por entorno detrás de Apache como reverse proxy.
- La lógica de negocio vive en `src/server/` como funciones de TypeScript,
  llamadas desde Server Actions o Route Handlers, para no atarla al framework.
- La cámara exige HTTPS en ambos entornos (`PT-06`).
- Si hiciera falta trabajar sin conexión (`PR-22`), se agrega una cola local
  en la PWA; el stack no cambia.
