Sistema de Inventario y Stock - RK

Sistema de gestión de inventario y stock desarrollado con React y Node.js.

📋 Descripción

Sistema completo para la gestión de inventario que incluye:

• Backend API REST con Node.js/Express
• Frontend web con React + TypeScript + Vite
• Gestión de productos, categorías y stock
• Control de usuarios y roles
• Sistema de autenticación con JWT
• Interfaz moderna con Shadcn/UI y TailwindCSS

🚀 Tecnologías

Backend

• Node.js + Express.js
• PostgreSQL (Base de datos)
• JWT (Autenticación)
• Bcrypt (Encriptación de contraseñas)
• Multer (Manejo de archivos)
• Nodemailer (Envío de correos)

Frontend

• React 18 + TypeScript
• Vite (Build tool)
• TailwindCSS (Estilos)
• Shadcn/UI (Componentes UI)
• React Router (Navegación)
• TanStack Query (Gestión de estado)
• React Hook Form + Zod (Formularios y validación)
• Axios (Peticiones HTTP)
• Recharts (Gráficos)
• jsPDF (Generación de PDFs)

📦 Instalación

Backend

1. Navega a la carpeta del backend:

cd backend

2. Instala las dependencias:

npm install

3. Configura las variables de entorno:

   • Copia el archivo .env.example a .env
   • Configura tus credenciales de base de datos PostgreSQL

4. Inicia el servidor:

node server.js

Frontend

1. Navega a la carpeta del frontend:

cd Inventario_AL

2. Instala las dependencias:

npm install

3. Configura las variables de entorno:

   • Crea un archivo .env con la URL del backend

4. Inicia el servidor de desarrollo:

npm run dev

5. Para producción:

npm run build
npm run preview

📁 Estructura del Proyecto

API/
├── backend/              # API REST (Node.js + Express)
│   ├── config/          # Configuración de BD
│   ├── controllers/     # Lógica de negocio
│   ├── middlewares/     # Autenticación y validación
│   ├── models/          # Modelos de datos
│   ├── routes/          # Endpoints de la API
│   ├── utils/           # Funciones auxiliares
│   ├── uploads/         # Archivos subidos
│   └── server.js        # Punto de entrada
├── Inventario_AL/       # Frontend (React + Vite)
│   ├── src/
│   │   ├── components/  # Componentes reutilizables
│   │   ├── pages/       # Páginas de la aplicación
│   │   ├── hooks/       # Custom hooks
│   │   ├── lib/         # Utilidades
│   │   └── App.tsx      # Componente principal
│   ├── public/          # Archivos estáticos
│   └── index.html       # HTML principal
└── README.md

🔐 Variables de Entorno

Backend (backend/.env)

DB_HOST=localhost
DB_USER=tu_usuario
DB_PASSWORD=tu_contraseña
DB_NAME=inventario_db
DB_PORT=5432
PORT=3000
JWT_SECRET=tu_secreto_super_seguro
JWT_EXPIRES_IN=24h
NODE_ENV=development

Frontend (Inventario_AL/.env)

VITE_API_URL=http://localhost:3000

📝 Documentación

• Especificación de Casos de Uso
• Historias de Usuario
• Formato IEEE 830

🔧 Scripts Disponibles

Backend

npm start          # Inicia el servidor

Frontend

npm run dev        # Servidor de desarrollo
npm run build      # Build de producción
npm run preview    # Preview del build
npm run lint       # Linter

✉️ Contacto

Proyecto desarrollado por RisK - Keep