Portfolio Details

Project information

  • Category: Retail Software
  • Client: alliance supermarket
  • Project date: 10 December, 2024
  • Project URL: pdv.jhoncleyton.dev
  • Project Repository: GitHub
  • Take a test: User: admin | Password: admin
  • for cashier type user: User: caixa | Password: caixa

PDV JC Byte - Complete Point of Sale System

A comprehensive Point of Sale (POS) system developed to meet the needs of small businesses starting their operations. With a modern and intuitive interface, the system offers all necessary functionalities to efficiently and securely manage sales, inventory, customers, and finances.

🎨 PDV Professional with Customizable Themes!
Complete redesign with advanced theme system allowing real-time customization of colors, tones, transparencies, and styles across the entire interface.

🆕 Recent Updates & Improvements

Promotions & Campaigns
  • Create, edit, and manage product promotions and discount campaigns
  • Automatic application of promotional discounts in PDV Professional
  • View active promotions and campaign history
  • Clear display of promotions to operators
Sales Editing
  • Change payment type (cash, card, PIX, ticket) directly in management screen
  • Edit discounts applied to sales and items
  • Modify products in a sale
  • Complete audit trail of changes
Advanced Analytics
  • Real-time dashboard with comprehensive overview
  • Detailed reports on sales, products, finances, and customers
  • Analysis of best-selling and most profitable products
  • Discount Analysis page with dynamic charts (Chart.js)
  • Export reports to Excel
Customizable Layout
  • Modern two-column interface (60%/40%)
  • Dynamic themes with real-time preview
  • Per-browser persistence (localStorage)
  • Global default theme for all terminals
  • Protected default theme for security

🌟 Main Features

  • ✅ Quick sales registration with barcode scanner
  • ✅ Multiple PDV interfaces (Professional, Modern, Standard)
  • ✅ Receipt printing with operator name
  • ✅ Multiple payment methods (cash, credit card, debit, PIX)
  • ✅ Sales installment and credit control
  • ✅ Exit confirmation to prevent sale loss
  • ✅ Integrated real-time clock
  • ✅ Automatic application of promotions and discounts

  • ✅ Product registration with barcode
  • ✅ Automatic entry and exit control
  • ✅ Low stock alerts
  • ✅ Supplier management
  • ✅ Invoice entry registration
  • ✅ Cost and selling price control

  • ✅ Accounts payable and receivable with due date control
  • ✅ Cash register control with opening and closing
  • ✅ Detailed cash reports including debt payments
  • ✅ Cash withdrawal support with approval
  • ✅ Complete financial reports
  • ✅ Installment and payment control

  • ✅ Complete registration with automatic enrollment
  • ✅ Detailed purchase history
  • ✅ Credit control and limit per customer
  • ✅ Delinquency management
  • ✅ Debt payment receipts

  • ✅ Real-time updating dashboard
  • ✅ Detailed sales reports
  • ✅ Daily and monthly performance analysis
  • ✅ Excel export
  • ✅ Dynamic charts and visualizations

🚀 Technology Stack

Backend
Python 3.11+
Flask Framework
SQLAlchemy ORM
Frontend
HTML5/CSS3
Bootstrap 5
jQuery & Chart.js
Database
SQLite/PostgreSQL
Flask-Migrate
Auto migrations
Printing
Reportlab
FPDF
Thermal printers

💻 System Requirements

  • Python 3.11 or higher
  • Modern web browser (Chrome, Firefox, Edge)
  • 4GB RAM (minimum)
  • 500MB disk space
  • Windows 10/11 (primary support)
  • Thermal printer for receipts (optional)

🔒 Security Features

  • User authentication with encrypted passwords
  • Permission control by user profile
  • Detailed activity logging
  • Automatic data backup
  • SQL Injection protection
  • Input validation on all forms

🛠️ Quick Installation

# Clone the repository
git clone https://github.com/JhonCleyton/pdv-jcbyte.git

# Install dependencies
pip install -r requirements.txt

# Run the system
python app.py

# Or double-click
iniciar_pdv.bat

Access: http://localhost:5000
Default user: admin | Password: admin