Tienda Mi Cholo S.A.C is a full-stack point-of-sale and inventory management web application built on ASP.NET Core MVC (.NET 10). It provides everything a retail store needs to run daily operations: a real-time sales dashboard, receipt generation (Boleta and Factura), product and stock management, client tracking, and role-based access control for Administrators, Managers, and Cashiers.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.
Quickstart
Set up the database, run migrations, and log in for the first time in minutes.
Configuration
Configure the SQL Server connection string and application settings.
Roles & Permissions
Understand the three built-in roles and what each can access.
Data Model
Explore the entity relationships — Products, Sales, Clients, Users, and more.
Key Features
Point of Sale
Live product search, cart management, and automatic stock deduction when a sale is finalized.
Receipt Generation
Automatically generate sequential Boleta (B001-XXXXXXXX) or Factura (F001-XXXXXXXX) numbers per sale.
Inventory Management
Track purchase and sale prices, monitor stock levels, and get low-stock alerts on the dashboard.
Client Management
Register clients with DNI or RUC document validation and associate them with sales records.
Dashboard
Real-time KPIs: daily revenue, sales count, total products, and low-stock warnings.
User Administration
Create users, assign roles, and enable or disable accounts — available to Administrators only.
How it Works
Set up the database
Configure your SQL Server connection string in
appsettings.json and run dotnet ef database update to apply migrations and seed initial data.Log in
Open the app — it redirects to
/Acceso/Login. Use the seeded administrator account (admin@micholo.com / admin123) to log in for the first time.Add products and categories
Create product categories, then add your product catalog with purchase price, sale price, and initial stock levels.
The default administrator credentials seeded by the database (
admin@micholo.com / admin123) should be changed immediately after the first login in any production deployment.