SISTEMA
AGROBOTANIKA

Documentación completa del stack tecnológico, modelos de base de datos, endpoints de la API, credenciales de prueba y flujo operativo del sistema.

Stack Tecnológico

Arquitectura del Sistema

AgroBotanika es una aplicación full-stack desacoplada: API REST en Node.js/Express y frontend en Next.js, comunicados via HTTP/JSON.

⬡

Frontend

▸Next.js 16 (Pages Router)

▸Tailwind CSS v4 (CSS-native)

▸Framer Motion (animaciones)

▸Axios + interceptor JWT

▸SWR para data fetching

▸HeadlessUI (modales)

▸react-countup / swiper

◈

Backend

▸Node.js + Express 4

▸Prisma ORM v5

▸JWT (jsonwebtoken)

▸bcrypt (hash passwords)

▸helmet + cors + rate-limit

▸swagger-jsdoc + swagger-ui

▸nodemailer + twilio (pending)

▣

Base de Datos

▸SQL Server (Express Edition)

▸Prisma Migrations + db push

▸Relaciones con NoAction cascade

▸Transacciones atómicas ($transaction)

▸Seed script incluido

⊛

Seguridad

▸CORS whitelist desde .env

▸Rate limiting: 100 req/15min (general), 10 req/15min (auth)

▸Body size limit: 512kb

▸No stack traces en producción

▸Email normalizado a lowercase

▸Prisma error codes mapeados (P2025, P2002, P2003)

⊹

Estructura de Archivos

▸backend/src/app.js — Express + middlewares

▸backend/src/routes/*.routes.js — rutas

▸backend/src/controllers/*.controller.js

▸backend/src/middlewares/ — auth, errorHandler

▸frontend-public/src/pages/ — Next.js pages

▸frontend-public/src/components/ — UI

▸frontend-public/src/services/api.js — Axios