Bar Pinguino is a web-based point-of-sale (POS) and management system for a bar. It allows staff to manage sales, inventory, customers, and suppliers. The system is built with ASP.NET Core MVC and uses a SQL Server database.
- Point of Sale (POS): Process sales, calculate totals, and apply discounts.
- Inventory Management: Track product stock levels, set critical stock alerts, and manage product information.
- Customer Management: Keep a record of customer information and track their purchase history.
- Supplier Management: Store supplier details and manage relationships.
- User Management: Different user roles (Admin, Sales) with different levels of access.
- Reporting: Generate reports on sales, stock, and discounts.
- Email Notifications: Automatically send receipts to customers via email.
- Database Backups: Automated background service for database backups.
- Backend: ASP.NET Core 8.0, C#
- Database: Microsoft SQL Server, Entity Framework Core
- Frontend: HTML, CSS, JavaScript, jQuery
- Authentication: Cookie-based authentication
- Email: MailKit, MimeKit
To get a local copy up and running, follow these simple steps.
- Clone the repo
git clone https://github.com/your_username/Proyecto-Pinguino.git
- Navigate to the project directory
cd Proyecto-Pinguino/BarPinguino - Restore NuGet packages
dotnet restore
- Open
appsettings.jsonand update theSqlConnecconnection string with your SQL Server details. - Apply Entity Framework Core migrations to create the database schema.
dotnet ef database update
dotnet runThe application will be available at https://localhost:5001 (or a similar port).
The application has two main user roles:
- Admin: Has full access to all features, including user management, financial reports, and system settings.
- Ventas (Sales): Can process sales, manage customers, and view inventory.
The default login credentials are:
- Username: admin
- Password: admin
The application uses Entity Framework Core to manage the database. The data models are defined in the Models directory.
To create a new migration, use the following command:
dotnet ef migrations add YourMigrationNameTo apply migrations to the database, use the following command:
dotnet ef database updateContributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m '''Add some AmazingFeature''') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request