Tienda Mi Cholo S.A.C is a full-stack point-of-sale and inventory management system built with ASP.NET Core MVC on .NET 10, backed by Entity Framework Core 10 and SQL Server. Designed for small to mid-size retail stores, it combines a responsive Bootstrap 5 interface with a secure, cookie-based authentication model to give store staff everything they need — from ringing up sales and printing receipts to managing stock levels and tracking clients — all in a single, self-hosted web application.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/interezante456-pixel/nuevo-proyecto-viernes/llms.txt
Use this file to discover all available pages before exploring further.
What’s Included
Dashboard
A real-time overview of today’s sales totals, low-stock alerts, and recent transaction history to keep management informed at a glance.
Sales (Ventas)
Process new sales, issue Boletas and Facturas, apply client lookups, and manage the full transaction lifecycle from cart to receipt.
Products (Productos)
Add, edit, and deactivate products with category assignment, unit pricing, and stock quantity tracking across six built-in categories.
Clients (Clientes)
Maintain a client directory with document type, contact details, and purchase history. A default “Público General” client is seeded for anonymous walk-in sales.
Users & Roles
Manage system users and assign them to one of three roles — Administrador, Gerente, or Cajero — each with its own access level and permitted actions.
Tech Stack
| Layer | Technology | Version |
|---|---|---|
| Web Framework | ASP.NET Core MVC | .NET 10 |
| ORM | Entity Framework Core | 10.0.9 |
| Database | SQL Server / LocalDB | — |
| Frontend | Bootstrap | 5.3.3 |
| Frontend | Bootstrap Icons | 1.11.3 |
| Auth | Cookie Authentication | ASP.NET Core built-in |
Built-in Seed Data
When you run EF Core migrations for the first time, the application automatically seeds a minimal but complete starting dataset so the store is operational immediately after setup. Roles (3) — Access control is enforced through three built-in roles, each mapped to a distinct set of permissions within the application:| ID | Role Name | Intended For |
|---|---|---|
| 1 | Administrador | Full system access — user management, configuration, all reports |
| 2 | Gerente | Sales, inventory, and client management; no user administration |
| 3 | Cajero | Point-of-sale operations and client lookup only |
- Full name: Administrador del Sistema
- Username:
admin - Email:
admin@micholo.com - Password:
admin123 - Role: Administrador
The seeded admin password
admin123 is intentionally simple for first-run convenience. You must change it before deploying to production. Any user with network access to the application can attempt to log in with these credentials.| ID | Category | Description |
|---|---|---|
| 1 | Lácteos | Leche, queso, yogurt y derivados |
| 2 | Bebidas | Gaseosas, jugos, agua y bebidas |
| 3 | Snacks | Galletas, papas, dulces y golosinas |
| 4 | Limpieza | Detergentes, lejía, jabones |
| 5 | Abarrotes | Arroz, azúcar, aceite, fideos |
| 6 | Frutas y Verduras | Productos frescos del día |