Esta guía te lleva paso a paso desde cero hasta tener Tienda MiCholo funcionando en tu máquina local. Al finalizar, tendrás la base de datosDocumentation 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.
DB_TIENDA_MICHOLO creada y migrada, los usuarios y roles de prueba listos, el catálogo de productos importado automáticamente y la aplicación accesible en el navegador. No se necesita configuración adicional: el proyecto está pensado para arrancar con un solo comando una vez clonado.
Requisitos previos
Asegúrate de tener instaladas las siguientes herramientas antes de comenzar:- .NET 10 SDK — necesario para compilar y ejecutar el proyecto.
- SQL Server o LocalDB — la cadena de conexión por defecto apunta a la instancia
(localdb)\MSSQLLocalDB, que se instala automáticamente con Visual Studio 2022 o posterior. Si prefieres una instancia completa de SQL Server, actualiza la cadena de conexión enappsettings.json. - Git — para clonar el repositorio.
Pasos de instalación
Clonar el repositorio
Abre una terminal y ejecuta:Esto descarga el código fuente y te posiciona en la raíz del proyecto, donde se encuentra el archivo
TiendaMiCholo.csproj.Configurar la cadena de conexión
El archivo Descripción de cada parámetro:
Si usas una instancia distinta de SQL Server, reemplaza el valor de
appsettings.json ya incluye una cadena de conexión lista para LocalDB. No necesitas modificarla si usas Visual Studio o tienes instalado el componente LocalDB:| Parámetro | Valor | Significado |
|---|---|---|
Data Source | (localdb)\MSSQLLocalDB | Instancia LocalDB incluida con Visual Studio |
Initial Catalog | DB_TIENDA_MICHOLO | Nombre de la base de datos que se creará |
Trusted_Connection | True | Usa autenticación de Windows (sin usuario/contraseña) |
TrustServerCertificate | True | Permite la conexión sin validar el certificado TLS (desarrollo) |
Data Source con el nombre de tu servidor y ajusta las credenciales según corresponda.Aplicar las migraciones de base de datos
Desde la raíz del proyecto, ejecuta:Este comando aplica todas las migraciones pendientes y crea la base de datos
DB_TIENDA_MICHOLO en LocalDB si aún no existe. También crea las tablas de ASP.NET Identity (usuarios, roles, claims) y las tablas del dominio: Productos, Proveedores, Ventas y DetallesVentas.Si recibes el error
'dotnet-ef' command not found, instala la herramienta globalmente con dotnet tool install --global dotnet-ef.Ejecutar la aplicación
Inicia el servidor de desarrollo con:Al arrancar, el método
SeedData.Initialize crea automáticamente los roles Admin y Vendedor y los dos usuarios de prueba si todavía no existen. Acto seguido, SeedData.SeedProductos lee el archivo productos.json ubicado en la raíz del proyecto e importa el catálogo completo de productos (en lotes de 1 000 registros) vinculándolos a un proveedor por defecto llamado Proveedor General. Este proceso solo ocurre la primera vez; en arranques posteriores se omite si ya existen registros en la tabla.La aplicación quedará disponible en:Usuarios semilla
Al iniciar la aplicación por primera vez,SeedData crea los siguientes usuarios de prueba listos para usar:
| Contraseña | Rol | |
|---|---|---|
admin@micholo.com | admin123 | Admin |
vendedor@micholo.com | Vendedor123 | Vendedor |
Después del primer acceso
Una vez autenticado, la aplicación te llevará a/Producto/Listar, donde verás el catálogo completo importado desde productos.json con código, nombre, categoría, precio y stock de cada artículo.
Si inicias sesión como Admin, también tienes acceso al dashboard en /Home/Index, que muestra:
- Total de ventas del día — suma de todas las ventas registradas en la fecha actual.
- Gráfico de los últimos 7 días — evolución diaria de ventas para identificar tendencias rápidamente.