🏢 PYSYSTEM - Business Management System

A comprehensive Python desktop application for business management with Clean Architecture, featuring company registration, product management, and sales order processing with external API integrations.

🎯 Overview

PYSYSTEM is a modern desktop business management application built with Python and Tkinter, implementing Domain-Driven Design (DDD) and Clean Architecture principles. The system provides comprehensive CRUD operations for companies, products, and sales orders, with advanced features like address autocomplete and document validation through Brazilian APIs.

✨ Key Features

🏢 Company Management

• Complete CRUD Operations - Create, read, update, and delete companies
• Smart Validation - CPF/CNPJ validation with verification digits
• Address Autocomplete - Automatic address completion using CEP via BrasilAPI
• Contact Management - Email and phone validation with proper formatting
• Document Integration - Real-time CNPJ lookup with company data retrieval

📦 Product Management

• Excel Integration - Import products from .xlsx/.xls files with validation
• Inventory Control - Real-time stock management with oversell prevention
• Advanced Search - Search by name, SKU, or any product attribute
• Bulk Operations - Mass updates and data management capabilities
• Category Management - Product categorization and organization

📊 Sales Order Management

• Complete Order Processing - From creation to completion
• Stock Integration - Automatic inventory updates and validation
• Dynamic Calculations - Real-time subtotals and totals
• Multi-item Orders - Support for complex orders with multiple products
• Order History - Complete audit trail and order tracking

🌐 External Integrations

• BrasilAPI Integration - CEP, CNPJ, and bank data validation
• Intelligent Caching - Performance optimization with automatic cache management
• Fallback Mechanisms - Robust error handling with offline capabilities
• Rate Limiting - Respectful API usage with built-in throttling

🎨 User Interface

• Corporate Theme - Professional and consistent design
• Responsive Layout - Adaptive to different screen sizes
• Intuitive Navigation - Clear workflow and user experience
• Real-time Feedback - Immediate validation and status updates

🚀 Quick Start

Prerequisites

• Python 3.8+
• Virtual environment (recommended)

Installation

1. Clone the repository

   git clone https://github.com/teusdrz/PYSYSTEM.git
   cd PYSYSTEM

2. Create virtual environment

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies

   pip install -r requirements.txt

4. Run the application

   python run_system.py

📁 Project Structure

PYSYSTEM/
├── src/
│   ├── application/          # Use cases and DTOs
│   │   ├── dtos/            # Data Transfer Objects
│   │   └── use_cases/       # Business logic
│   ├── domain/              # Core business entities
│   │   ├── entities/        # Domain models
│   │   ├── repositories/    # Repository interfaces
│   │   └── services/        # Domain services
│   ├── infrastructure/      # External concerns
│   │   ├── external_services/  # API integrations
│   │   ├── persistence/     # Data storage
│   │   └── report_generators/  # Report services
│   ├── presentation/        # UI layer
│   │   ├── controllers/     # Application controllers
│   │   └── gui/            # Tkinter interface
│   └── shared/             # Common utilities
├── data/                   # JSON data files
├── assets/                # Icons and resources
├── tests/                 # Test suite
└── requirements.txt       # Python dependencies

🏗️ Architecture

This project follows Clean Architecture principles:

• Domain Layer: Core business logic and entities
• Application Layer: Use cases and application services
• Infrastructure Layer: External services and data persistence
• Presentation Layer: User interface and controllers

💻 Usage

Main Features

1. Companies: Manage customer and supplier information
2. Products: Track inventory with stock levels and pricing
3. Sales Orders: Create orders and manage order items
4. BrasilAPI: Automatic address lookup and data validation

Navigation

• Use the tab interface to switch between different modules
• All forms include validation and error handling
• Data is automatically saved to JSON files in the data/ directory

🧪 Testing

The project includes comprehensive test suites:

# Run ultra comprehensive tests
python ultra_comprehensive_gui_tests.py

# Run automated GUI tests  
python automated_gui_tests.py

Test Results: 82.3% success rate (93/113 tests passing)

🔧 Configuration

The system uses JSON files for data storage located in the data/ directory:

• companies.json - Company data
• products.json - Product catalog
• sales_orders.json - Sales order records

📊 API Integration

BrasilAPI Integration:

• CEP address lookup
• CNPJ validation
• Bank information retrieval
• Product categorization suggestions

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Matheus Souza

• GitHub: @teusdrz

📈 Status

• ✅ Core functionality implemented
• ✅ GUI interface complete
• ✅ Data persistence working
• ✅ API integration functional
• ⚠️ Minor optimizations pending

---

Built with ❤️ using Python and Clean Architecture principles