Quickstart: Install and Run the Tienda Mi Cholo POS

This guide walks you through everything needed to get Tienda Mi Cholo S.A.C running locally — from cloning the repository and configuring the database connection to logging in for the first time and registering your first sale.

Prerequisites

Make sure you have the following installed before you begin:

.NET 10 SDK
SQL Server or SQL Server Express LocalDB (included with Visual Studio)
Visual Studio 2022+ with ASP.NET workload or VS Code with the C# Dev Kit extension
EF Core CLI tools: dotnet tool install --global dotnet-ef

Clone the repository

git clone https://github.com/interezante456-pixel/nuevo-proyecto-viernes.git
cd "nuevo-proyecto-viernes/Final proyecto"

Configure the connection string

Open appsettings.json and locate the CadenaSQL key:

appsettings.json

{
  "ConnectionStrings": {
    "CadenaSQL": "Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=TIENDA_MICHOLO;Trusted_Connection=True;TrustServerCertificate=True;"
  }
}

The default points to SQL Server LocalDB using Windows Authentication. To connect to a different SQL Server instance, replace the connection string:

appsettings.json

{
  "ConnectionStrings": {
    "CadenaSQL": "Server=YOUR_SERVER;Database=TIENDA_MICHOLO;User Id=sa;Password=YOUR_PASSWORD;TrustServerCertificate=True;"
  }
}

Component	Default value	Description
`Data Source`	`(localdb)\\MSSQLLocalDB`	SQL Server instance
`Initial Catalog`	`TIENDA_MICHOLO`	Database name
`Trusted_Connection`	`True`	Use Windows auth (LocalDB only)
`TrustServerCertificate`	`True`	Skip TLS cert validation (dev only)

Apply database migrations

From the Final proyecto directory, run:

dotnet ef database update

This creates the TIENDA_MICHOLO database, applies all three migrations (schema creation, product status column, nullable client fields), and seeds the following initial data:

Roles: Administrador, Gerente, Cajero
Admin user: admin@micholo.com / admin123
Default client: Público General (used for anonymous Boleta sales)
Product categories: Lácteos, Bebidas, Snacks, Limpieza, Abarrotes, Frutas y Verduras

If dotnet ef is not found, install the EF Core CLI: dotnet tool install --global dotnet-ef

Run the application

dotnet run

The application starts on the port defined in Properties/launchSettings.json (default http://localhost:5020). It automatically redirects to the login page at /Acceso/Login.

In Visual Studio, press F5 to run with the debugger attached. The browser opens automatically on the correct port.

Use the seeded administrator credentials:

Field	Value
Email	`admin@micholo.com`
Password	`admin123`

Change this password immediately after your first login. In the current implementation, passwords are stored as plain text in the database. Navigate to Usuarios → select the admin user → Editar to update the password.

After a successful login, you are redirected to the Dashboard (/Home/Index) showing today’s KPIs.

Navigate to Ventas → Nueva Venta in the sidebar.
Select a receipt type — Boleta (default) or Factura.
Type a product name in the search box (at least 2 characters). Results appear after 300ms.
Click a product to add it to the cart. Adjust the quantity if needed.
Click Registrar Venta. The stock is decremented automatically and a sequential receipt number is generated.

See the New Sale guide for full details on the POS interface.

SQL Server LocalDB is only available on Windows. On macOS or Linux, use a full SQL Server instance via Docker:

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=YourStrong@Passw0rd" -p 1433:1433 -d mcr.microsoft.com/mssql/server:2022-latest

Getting Started

Core Concepts

Quickstart: Install and Run the Tienda Mi Cholo POS

Build docs developers (and LLMs) love

Getting Started

Core Concepts

Documentation Index

Build docs developers (and LLMs) love