Skip to main content

System Capabilities

Sistema de Ventas provides a complete suite of business management features organized into specialized microservices. Each service handles a specific domain with its own database and business logic.

Core Features

Sales Management

Process sales transactions with automatic tax calculations and invoice generation

Inventory Control

Manage products, categories, and stock levels with real-time tracking

Purchase Orders

Handle supplier purchases and procurement workflows efficiently

Customer Management

Maintain detailed customer records and relationship data

Supplier Management

Manage supplier information and vendor relationships

Payment Processing

Support multiple payment methods including mobile payments

Analytics & Reporting

Gain insights with comprehensive sales analytics and dashboards

Architecture Highlights

Sistema de Ventas is built on a modern microservices architecture with the following key components:

Microservices

Authentication

JWT-based authentication with role-based access control

Catalog

Product and category management with image support

Sales

Sales transactions with automated tax calculations

Purchases

Purchase order management and supplier integration

Orders

Customer order processing with fulfillment tracking

Customers

Customer master data management

Suppliers

Supplier master data management

Payments

Payment method catalog and integration

Infrastructure Services

API Gateway

Centralized routing and authentication filtering

Service Registry

Eureka-based service discovery and load balancing

Config Server

Centralized configuration management

Technology Stack

Backend

  • Spring Boot 2.5.4 / 3.3.3
  • Spring Cloud (Eureka, Gateway, Config)
  • Spring Security with JWT
  • JPA/Hibernate for persistence

Frontend

  • Angular 18.2.0
  • Angular Material Design
  • Chart.js for analytics
  • RxJS for reactive programming

Databases

  • MySQL 8.0+ (6 databases)
  • PostgreSQL 13+ (2 databases)
  • Database-per-service pattern

Infrastructure

  • Docker containerization
  • Service mesh architecture
  • Circuit breaker patterns
  • Feign HTTP clients

Key Capabilities

Automated Business Logic

Sistema de Ventas automates critical business processes:
  • Tax Calculations: Automatic 18% IGV (Peru tax) calculation on all transactions
  • Document Numbering: Auto-generation of series and invoice numbers
  • Inventory Updates: Real-time stock adjustments on sales and purchases
  • Customer Data: Integration of customer information across services

Security & Access Control

Comprehensive security features protect your business data:
  • JWT Authentication: Secure token-based authentication with 1-hour expiration
  • Role-Based Access: Three-tier role system (ADMIN, USER, ALMACENERO)
  • API Gateway Protection: Centralized authentication filtering
  • Encrypted Passwords: BCrypt password hashing

Integration & Communication

Microservices communicate seamlessly through:
  • OpenFeign Clients: Type-safe HTTP clients for inter-service communication
  • Service Discovery: Automatic service registration and discovery via Eureka
  • Circuit Breakers: Resilience4j for fault tolerance
  • Centralized Config: Spring Cloud Config for environment management

Analytics & Reporting

Built-in analytics provide business insights:
  • Top Selling Products: Track best-performing items
  • Monthly Sales Reports: Aggregated revenue by month
  • Customer Analytics: Purchase history and patterns
  • Inventory Reports: Stock levels and turnover rates

Getting Started

Quick Start Guide

Follow our comprehensive guide to set up and deploy Sistema de Ventas

Learn More

Architecture

Dive deep into the microservices architecture

API Reference

Explore the complete API documentation

Deployment

Deploy Sistema de Ventas to production

GitHub Repository

View the source code on GitHub

Build docs developers (and LLMs) love