Sistema de Ventas y Hotelería

Introducción

Sistema diseñado para la gestión y administración de negocios de ventas y de hotelería. Permite realizar CRUD completo para diversas entidades y gestionar operaciones comerciales y de hospedaje.

Instalación y Configuración Inicial

Requisitos Previos

• Node.js
• MongoDB
• Express

Instalación del Sistema

1. Clona el repositorio del proyecto.

   git clone https://github.com/Aleixs-Trejo/inventario-aprendedor.git

2. Navega al directorio del proyecto.

   cd inventario

3. Instala las dependencias ejecutando:

   npm install

Configuración inicial

1. Configura las variables de entorno en el archivo .env.
2. Ejecuta el servidor con:

   npm start

Guía del usuario

Diseño de la BD

1. Creación de Roles de trabajadores

• 1. Navega a la ruta /users-rol.
• 2. Haz click en "Nuevo Rol" (+).

• 3. Completa los campos: "Nombre" y "Descripción".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

2. Registro de Trabajadores

• 1. Navega a la ruta /employees.
• 2. Haz click en "Nuevo Trabajador" (+).

• 3. Completa los campos: "Rol", "Nombre", "Apellidos", "Correo", "Celular", estado (Activo/Inactivo).

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

• 8. Para exportar, haz click en "Exportar"

3. Registro de Proveedores

• 1. Navega a la ruta /providers.
• 2. Haz click en "Nuevo Proveedor" (+).

• 3. Completa los campos: "Documento / RUC", "Nombre", "Celular", "Correo", "Dirección".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

-8 Para exportar, haz click en "Exportar"

4. Registro de Categorias de Productos

• 1. Navega a la ruta /categories.
• 2. Haz click en "Nueva Categoría" (+).

• 3. Completa los campos: "Nombre", "Descripción".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

5. Registro de Productos

• 1. Navega a la ruta /products.
• 2. Haz click en "Nuevo Producto" (+).

• 3. Completa los campos: "Proveedor", "Categoria", "Código", "Nombre", "Descripción", "Precio".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

• 8. Para exportar, haz click en "Exportar"

6. Registro de Sucursales de almacén

• 1. Navega a la ruta /stock-locations.
• 2. Haz click en "Nueva Ubicación" (+).

• 3. Completa los campos: "Ubicación", "Descripción".

• 4. Haz click en "Crear Ubicación".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

7. Ingreso de Productos a almacén

• 1. Navega a la ruta /stores.
• 2. Haz click en "Agregar Producto" (+).

• 3. En la barra de búsqueda busca los productos que desees agregar al almacén.

• 4. Elige la ubicación (Sucursal), el stock entrante y el stock mínimo para crear una alerta.

• 5. Haz click en "Guardar".
• 6. Para editar, haz click en "Editar"

• 7. Para eliminar, haz click en "Eliminar"

• 8. Para ver el historial, haz click en "Historial"

• 9. Para exportar, haz click en "Exportar"

8. Registro de Clientes

• 1. Navega a la ruta /clients.
• 2. Haz click en "Nuevo Cliente" (+).

• 3. Completa los campos: "DNI/RUC", "Nombres Completos", "Correo", "Celular".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

9. Proceso de Venta

• 1. Navega a la ruta /sales.

• 2. Haz click en "Nueva Venta" (+).
• 3. Completa el campo de "Documento", si el cliente no se quiere registrar, solo déjalo tal cual con el documento de Clientes Varios (00000000).

• 4. En la barra de búsqueda busca los productos del almacén que desees agregar al carrito.

• 5. Añade la cantidad de productos, y aplica descuento si es necesario.

• 6. Haz click en "Vender".
• 7. Para ver los detalles de la venta, haz click en "Detalles"

• 8. Puedes cancelar la venta al clickar en "Cancelar Venta"
• 9. Puedes ver el comprobante de la venta en formato ticket o A4

10. Cierre de caja y Gestión de Ventas

• 1. Navega a la ruta /sales.
• 2. Haz click en "Exportar Excel".

• 3. Haz click en "Cerrar Caja".
• 4. Puedes ver el historial de ventas

• 5. Puedes ver los balances al cerrar la caja

Gestión de Hotelería

1 Pisos:

• 1. Navega a la ruta /floors.
• 2. Haz click en "Nuevo Piso" (+).

• 3. Completa los campos: "Número" y "Descripción".
• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"
• 6. Para eliminar, haz click en "Eliminar"

2 Categorias de Habitación:

• 1. Navega a la ruta /categories-room.
• 2. Haz click en "Nueva Categoría" (+).

• 3. Completa los campos: "Nombre", "Descripción".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

3 Estados de Habitación:

• 1. Navega a la ruta /status-room.
• 2. Haz click en "Nuevo Estado" (+).

• 3. Completa los campos: "Nombre", "Descripción", "Trabajos en habitación".
• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"
• 6. Para eliminar, haz click en "Eliminar"

4 Registro de Habitación:

• 1. Navega a la ruta /rooms.
• 2. Haz click en "Nueva Habitación" (+).

• 3. Completa los campos: "Piso", "Número", "Categoría", "Descripción", "Precio".

• 4. Haz click en "Registrar".
• 5. Para editar, haz click en "Editar"

• 6. Para eliminar, haz click en "Eliminar"

• 7. Para ver el historial, haz click en "Historial"

5. Mantenimiento de Habitación

• 1. En la vista principal de Hotel, selecciona la habitación que desees mantener.

• 2. Haz click en "Mantenimiento".
• 3. Elige el tipo de mantenimiento que desees realizar.
• 4. Elige el usuario a cargo del mantenimiento.
• 5. Añade algunas observaciones o comentarios.

• 6. Haz click en "Actualizar".
• 7. Para finalizar, haz click en "Detalles"

• 8. Y luego en "Finalizar".

6. Ocupación de Habitación

• 1. En la vista principal de Hotel, selecciona la habitación que desees ocupar.

• 2. Haz click en "Ocupar".
• 3. Llenar campos de "DNI", "Nombres Completos", "Celular", "Correo".
• 4. Establecer la fecha de fin del periodo de ocupación.
• 5. Agregar monto del pago adelantado.
• 6. Agregar algunas observaciones o comentarios.

• 7. Haz click en "Ocupar".

7. Reserva de Habitación

• 1. En la vista principal de Hotel, selecciona la habitación que desees reservar.

• 2. Haz click en "Reservar".
• 3. Llenar campos de "DNI", "Nombres Completos", "Celular", "Correo".
• 4. Establecer la fecha de incicio y fin del periodo de reserva.
• 5. Agregar monto del pago adelantado.
• 6. Agregar algunas observaciones o comentarios.

• 7. Haz click en "Reservar".

8. Limpieza Intermedia de Habitación

• 1. En la vista principal de Hotel, selecciona la habitación que desees limpiar.

• 2. Haz click en "Detalles".

• 3. Haz click en "Limpieza intermedia".

• 4. Elige el usuario a cargo de la limpieza.
• 5. Añade algunas observaciones o comentarios.

• 6. Haz click en "Actualizar".

9. Venta a la habitación

• 1. En la vista principal de Hotel, selecciona la habitación en la que desees realizar una venta.

• 2. Haz click en "Detalles".

• 3. Haz click en "Vender".

• 4. En la barra de búsqueda busca los productos del almacén del hotel que desees agregar al carrito.
• 5. Añade la cantidad de productos, y aplica descuento si es necesario.
• 6. Agrega un importe de adelanto o descuento si es necesario.
• 7. Añade algunas observaciones o comentarios.

• 8. Haz click en "Vender".

10. CheckOut

• 1. En la vista principal de Hotel, selecciona la habitación en la que desees realizar un checkout.

• 2. Haz click en "Detalles".

• 3. Haz click en "CheckOut".
• 4. Agrega costo adiciona, descuento y comentarios si es necesario.

• 5. Haz click en "CheckOut".

11. Salidas de hotel

• 1. Navega a la ruta /checkouts.

12. Cierre de caja de hotel

• 1. Navega a la ruta /checkouts.
• 2. Haz click en "Cerrar Checkouts".

23. Balance de hotel

• 1. Navega a la ruta /balance-hotel.

Contactar a soporte