Tienda MiCholo es un sistema de gestión retail desarrollado en ASP.NET Core que centraliza el control de inventario, registro de ventas, administración de proveedores y reportes en una sola plataforma. Está diseñado para equipos de tienda con roles diferenciados: administradores que gestionan el catálogo y el personal, y vendedores que registran ventas en el punto de venta.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/interezante456-pixel/proyecto-dise-o/llms.txt
Use this file to discover all available pages before exploring further.
Inicio Rápido
Configura y ejecuta Tienda MiCholo en minutos: base de datos, usuarios semilla y primer acceso.
Inventario
Gestiona productos, categorías, stock y alertas de inventario crítico.
Ventas
Registra ventas con BOLETA o FACTURA, búsqueda de productos en tiempo real y anulación automática.
Proveedores
Administra proveedores con validación de RUC peruano y control de productos asociados.
Reportes
Consulta los 5 productos más vendidos y el resumen de ventas en el dashboard.
Referencia Técnica
Arquitectura MVC, modelos de datos, controladores y configuración del sistema.
¿Cómo empezar?
Configura la base de datos
Apunta la cadena de conexión
CadenaMiCholo en appsettings.json a tu instancia de SQL Server. El sistema crea la base de datos y aplica migraciones automáticamente.Ejecuta la aplicación
Corre
dotnet run desde la raíz del proyecto. Al iniciar, se crean automáticamente los roles Admin y Vendedor, el usuario administrador y los productos iniciales desde productos.json.Inicia sesión
Accede a
/Account/Login con las credenciales semilla: admin@micholo.com / admin123 para el rol Admin, o vendedor@micholo.com / Vendedor123 para el rol Vendedor.Características principales
Control de Inventario
Catálogo paginado con filtros por nombre, categoría y proveedor. Alertas automáticas para productos con stock ≤ 5 unidades.
Punto de Venta
Registro de ventas con búsqueda AJAX de productos, soporte para BOLETA y FACTURA, y deducción automática de stock al confirmar.
Gestión de Roles
Dos roles integrados: Admin con acceso total y Vendedor con permisos de lectura/venta. Administración de usuarios desde el panel.
Anulación Segura
Las ventas anuladas restauran el stock automáticamente y quedan registradas con el usuario responsable de la anulación.
Tienda MiCholo requiere .NET 10 y SQL Server (incluyendo LocalDB). Consulta la guía de inicio rápido para los requisitos completos de instalación.