UOCL-315: adding payment types

C4_ARCHITECTURE.md

@@ -0,0 +1,729 @@
+# Unicenta oPOS - C4 Architecture Diagram
+
+## Overview
+
+Unicenta oPOS (v5.4.0) is an enterprise-level Point of Sale system built with Java. It provides comprehensive sales, inventory, customer, and reporting management capabilities with support for multiple operating systems (Windows, Linux, macOS).
+
+---
+
+## Level 1: System Context Diagram
+
+```mermaid
+graph TB
+    user["👤 POS Operators/Staff"]
+
+    system["📱 Unicenta oPOS System<br/>Java Desktop Application<br/>v5.4.0"]
+
+    devices["🖨️ Peripheral Devices<br/>Printer • Scale<br/>Barcode Scanner<br/>Card Reader"]
+
+    db["💾 Database<br/>MySQL • Derby<br/>SQLite • PostgreSQL"]
+
+    fs["📂 File System<br/>Reports • Templates<br/>Locales • Config"]
+
+    user -->|interacts| system
+    system -->|controls| devices
+    system -->|reads/writes| db
+    system -->|reads/writes| fs
+    devices -.->|feedback| system
+
+    style system fill:#4A90E2,stroke:#2E5C8A,color:#fff,stroke-width:3px
+    style user fill:#50C878,stroke:#2D7A4A,color:#fff
+    style devices fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style db fill:#FFB84D,stroke:#8B6914,color:#fff
+    style fs fill:#9B59B6,stroke:#5B2C6F,color:#fff
+```
+
+---
+
+## Level 2: Container Architecture
+
+```mermaid
+graph TB
+    subgraph app["🏗️ UNICENTA oPOS APPLICATION"]
+        subgraph ui["PRESENTATION LAYER<br/>(Swing/JavaFX)"]
+            ui1["StartPOS Entry Point"]
+            ui2["Sales Screens<br/>Simple • Restaurant<br/>Shared Modes"]
+            ui3["Admin Panels<br/>User Mgmt • Settings"]
+            ui4["Forms & Dialogs<br/>Customers • Suppliers<br/>Inventory"]
+            ui5["Reporting Dashboards<br/>JFreeChart"]
+        end
+
+        subgraph service["SERVICE LAYER<br/>(Business Logic)"]
+            svc1["Sales Service"]
+            svc2["Inventory Service"]
+            svc3["Customer Service"]
+            svc4["Payment Service"]
+            svc5["Reporting Service"]
+            svc6["Config/Admin Service"]
+        end
+
+        subgraph dao["DATA ACCESS LAYER<br/>(DAOs)"]
+            dao1["ProductDAO"]
+            dao2["TicketDAO"]
+            dao3["CustomerDAO"]
+            dao4["EmployeeDAO"]
+            dao5["CompanyDAO"]
+            dao6["SupplierDAO"]
+        end
+
+        subgraph peripheral["PERIPHERAL INTEGRATION<br/>(Drivers & APIs)"]
+            per1["Printer Drivers<br/>ESC-POS • JavaPOS"]
+            per2["Scale Reader<br/>Serial Comm"]
+            per3["Barcode Scanner<br/>ZXing"]
+            per4["Card Reader<br/>USB/Serial"]
+        end
+
+        subgraph utils["UTILITIES & SUPPORT"]
+            util1["Logging<br/>Logback"]
+            util2["Formatting<br/>Date • Currency"]
+            util3["Localization<br/>i18n"]
+            util4["Reporting<br/>JasperReports"]
+            util5["Scripting<br/>BeanShell"]
+            util6["Plugins"]
+        end
+    end
+
+    subgraph external["📦 EXTERNAL SYSTEMS"]
+        extdb["💾 Database<br/>MySQL/Derby/SQLite<br/>PostgreSQL"]
+        extfs["📂 File System<br/>Configs • Templates<br/>Locales • Reports"]
+        devices["🖨️ Physical Devices<br/>Printers • Scales<br/>Scanners • Card Readers"]
+    end
+
+    ui -->|calls| service
+    service -->|uses| dao
+    service -->|uses| peripheral
+    service -->|uses| utils
+    ui -->|uses| utils
+
+    dao -->|reads/writes| extdb
+    peripheral -->|controls| devices
+    service -->|reads/writes| extfs
+    ui -->|reads/writes| extfs
+
+    style app fill:#E8F4F8,stroke:#2E5C8A,stroke-width:2px
+    style ui fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style service fill:#50C878,stroke:#2D7A4A,color:#fff
+    style dao fill:#FF9F43,stroke:#B8690F,color:#fff
+    style peripheral fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style utils fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style external fill:#F0F0F0,stroke:#666
+    style extdb fill:#FFB84D,stroke:#8B6914,color:#fff
+    style extfs fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style devices fill:#FF6B6B,stroke:#A53D3D,color:#fff
+```
+
+---
+
+## Level 3: Component Architecture
+
+### Sales Module
+
+```mermaid
+graph LR
+    subgraph sales["com.unicenta.pos.sales"]
+        simple["simple/<br/>Simple POS Mode"]
+        restaurant["restaurant/<br/>Table/Order Mode"]
+        shared["shared/<br/>Shared Ticket Logic"]
+    end
+
+    simple -.-> shared
+    restaurant -.-> shared
+
+    style sales fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style simple fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style restaurant fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style shared fill:#6BB3E0,stroke:#2E5C8A,color:#fff
+```
+
+### Inventory & Catalog Modules
+
+```mermaid
+graph TB
+    subgraph inventory["com.unicenta.pos.inventory"]
+        inv_prod["Product Management"]
+        inv_stock["Stock Tracking"]
+        inv_cat["Category Management"]
+    end
+
+    subgraph catalog["com.unicenta.pos.catalog"]
+        cat_prod["Product Categorization"]
+        cat_search["Product Search/Filter"]
+        cat_display["Display Management"]
+    end
+
+    inv_prod ---|shared data| cat_prod
+    inv_cat ---|manages| cat_display
+
+    style inventory fill:#50C878,stroke:#2D7A4A,color:#fff
+    style catalog fill:#50C878,stroke:#2D7A4A,color:#fff
+    style inv_prod fill:#68D989,stroke:#2D7A4A,color:#fff
+    style inv_stock fill:#68D989,stroke:#2D7A4A,color:#fff
+    style inv_cat fill:#68D989,stroke:#2D7A4A,color:#fff
+    style cat_prod fill:#68D989,stroke:#2D7A4A,color:#fff
+    style cat_search fill:#68D989,stroke:#2D7A4A,color:#fff
+    style cat_display fill:#68D989,stroke:#2D7A4A,color:#fff
+```
+
+### Ticket & Payment Processing
+
+```mermaid
+graph TB
+    subgraph ticket["com.unicenta.pos.ticket"]
+        ticket_create["Ticket Creation"]
+        ticket_items["Line Items Mgmt"]
+        ticket_lifecycle["Lifecycle Management"]
+    end
+
+    subgraph payment["com.unicenta.pos.payment"]
+        pay_method["Payment Methods"]
+        pay_process["Payment Processing"]
+        pay_card["Card Integration"]
+    end
+
+    ticket_create -->|on completion| pay_method
+    ticket_items -->|on finalize| pay_process
+    pay_process -->|if card| pay_card
+
+    style ticket fill:#FF9F43,stroke:#B8690F,color:#fff
+    style payment fill:#FF9F43,stroke:#B8690F,color:#fff
+    style ticket_create fill:#FDB44B,stroke:#B8690F,color:#fff
+    style ticket_items fill:#FDB44B,stroke:#B8690F,color:#fff
+    style ticket_lifecycle fill:#FDB44B,stroke:#B8690F,color:#fff
+    style pay_method fill:#FDB44B,stroke:#B8690F,color:#fff
+    style pay_process fill:#FDB44B,stroke:#B8690F,color:#fff
+    style pay_card fill:#FDB44B,stroke:#B8690F,color:#fff
+```
+
+### Reporting & Administration
+
+```mermaid
+graph TB
+    subgraph reports["com.unicenta.pos.reports"]
+        report_gen["Report Generation"]
+        report_chart["Chart Generation<br/>JFreeChart"]
+        report_export["PDF/Excel Export"]
+    end
+
+    subgraph admin["com.unicenta.pos.admin"]
+        admin_user["User Management"]
+        admin_config["System Configuration"]
+        admin_security["Access Control"]
+    end
+
+    report_gen -->|uses| report_chart
+    report_chart -->|renders to| report_export
+    admin_user -->|applies| admin_security
+
+    style reports fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style admin fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style report_gen fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style report_chart fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style report_export fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style admin_user fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style admin_config fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style admin_security fill:#B76AC2,stroke:#5B2C6F,color:#fff
+```
+
+### Printer System
+
+```mermaid
+graph LR
+    subgraph printer["com.unicenta.pos.printer"]
+        escpos["escpos/<br/>ESC-POS Driver"]
+        javapos["javapos/<br/>JavaPOS Driver"]
+        screen["screen/<br/>Screen Preview"]
+    end
+
+    reports["JasperReports<br/>JFreeChart"]
+
+    reports -->|routes to| escpos
+    reports -->|routes to| javapos
+    reports -->|routes to| screen
+
+    style printer fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style escpos fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style javapos fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style screen fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style reports fill:#9B59B6,stroke:#5B2C6F,color:#fff
+```
+
+### Communication & Integration
+
+```mermaid
+graph TB
+    subgraph comm["com.unicenta.pos.comm"]
+        serial["Serial Communication<br/>RXTX • jSerialComm"]
+        usb["USB Communication<br/>USB4Java"]
+    end
+
+    scale["Scale Reader"]
+    scanner["Barcode Scanner<br/>ZXing"]
+    reader["Card Reader"]
+
+    serial -->|reads| scale
+    serial -->|reads| scanner
+    usb -->|reads| reader
+
+    style comm fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style serial fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style usb fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style scale fill:#D9534F,stroke:#A53D3D,color:#fff
+    style scanner fill:#D9534F,stroke:#A53D3D,color:#fff
+    style reader fill:#D9534F,stroke:#A53D3D,color:#fff
+```
+
+---
+
+## Level 4: Data Flow Diagrams
+
+### Sales Transaction Flow
+
+```mermaid
+sequenceDiagram
+    actor User as POS Operator
+    participant UI as Sales Screen
+    participant Service as Sales Service
+    participant DAO as TicketDAO
+    participant DB as Database
+    participant Payment as Payment Service
+    participant Printer as Printer Service
+
+    User->>UI: Create/Edit Ticket
+    UI->>Service: Process Ticket
+    Service->>DAO: Save Ticket
+    DAO->>DB: INSERT/UPDATE
+    DB-->>DAO: Confirm
+    DAO-->>Service: Ticket ID
+    User->>UI: Process Payment
+    UI->>Service: Payment Request
+    Service->>Payment: Process Payment
+    Payment-->>Service: Payment Confirmed
+    Service->>Printer: Print Receipt
+    Printer-->>Service: Print Complete
+    Service-->>UI: Transaction Complete
+    UI-->>User: Display Confirmation
+```
+
+### Product Lookup Flow
+
+```mermaid
+sequenceDiagram
+    actor Device as Barcode Scanner
+    participant UI as Sales Screen
+    participant DAO as ProductDAO
+    participant DB as Database
+
+    Device->>UI: Scan Barcode
+    UI->>DAO: Query Product
+    DAO->>DB: SELECT Product
+    DB-->>DAO: Product Data
+    DAO-->>UI: Product Details
+    UI-->>Device: Display Product Info
+```
+
+### Report Generation Flow
+
+```mermaid
+sequenceDiagram
+    actor User as Admin/Manager
+    participant UI as Admin Panel
+    participant Service as Reporting Service
+    participant JasperReports as JasperReports Engine
+    participant DB as Database
+    participant FileSystem as File System
+
+    User->>UI: Request Report
+    UI->>Service: Generate Report
+    Service->>DB: Query Data
+    DB-->>Service: Report Data
+    Service->>JasperReports: Render Report
+    JasperReports->>FileSystem: Generate PDF/Excel
+    FileSystem-->>JasperReports: File Path
+    JasperReports-->>Service: Report Ready
+    Service-->>UI: Display/Download
+    UI-->>User: Provide Report
+```
+
+---
+
+## Level 5: Package Structure
+
+```mermaid
+graph TB
+    com["com.unicenta"]
+
+    com -->|core| basic["basic<br/>Exception Handling<br/>Logging"]
+    com -->|ui| beans["beans<br/>Custom UI Components<br/>Dialogs • Date Pickers<br/>Number Pads"]
+    com -->|ui| orderpop["orderpop<br/>Order Popup Module"]
+    com -->|plugins| plugins["plugins<br/>Plugin Architecture<br/>Metrics System"]
+
+    pos["com.unicenta.pos"]
+    com -->|main| pos
+
+    pos -->|sales| sales["sales<br/>Simple • Restaurant<br/>Shared Modes"]
+    pos -->|inventory| inventory["inventory<br/>Products • Stock<br/>Categories"]
+    pos -->|customers| customers["customers<br/>Customer Management<br/>Loyalty Programs"]
+    pos -->|catalog| catalog["catalog<br/>Product Catalog<br/>Display Management"]
+    pos -->|ticket| ticket["ticket<br/>Ticket Lifecycle<br/>Line Items"]
+    pos -->|payment| payment["payment<br/>Payment Methods<br/>Card Integration<br/>Cash Handling"]
+    pos -->|reports| reports["reports<br/>JasperReports<br/>JFreeChart<br/>PDF/Excel Export"]
+    pos -->|admin| admin["admin<br/>User Management<br/>System Configuration<br/>Access Control"]
+    pos -->|printer| printer["printer<br/>ESC-POS • JavaPOS<br/>Screen Preview"]
+    pos -->|comm| comm["comm<br/>Serial • USB<br/>Scale • Scanner<br/>Card Reader"]
+    pos -->|scripting| scripting["scripting<br/>BeanShell<br/>Custom Logic"]
+    pos -->|forms| forms["forms<br/>Main UI<br/>Data Entry Forms"]
+    pos -->|config| config["config<br/>Configuration Mgmt<br/>Settings"]
+    pos -->|instance| instance["instance<br/>Instance Management<br/>Singleton Patterns"]
+    pos -->|mant| mant["mant<br/>Maintenance<br/>Utilities"]
+
+    style com fill:#E8F4F8,stroke:#2E5C8A
+    style pos fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style basic fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style beans fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style orderpop fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style plugins fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style sales fill:#50C878,stroke:#2D7A4A,color:#fff
+    style inventory fill:#50C878,stroke:#2D7A4A,color:#fff
+    style customers fill:#50C878,stroke:#2D7A4A,color:#fff
+    style catalog fill:#50C878,stroke:#2D7A4A,color:#fff
+    style ticket fill:#FF9F43,stroke:#B8690F,color:#fff
+    style payment fill:#FF9F43,stroke:#B8690F,color:#fff
+    style reports fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style admin fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style printer fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style comm fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style scripting fill:#FFB84D,stroke:#8B6914,color:#fff
+    style forms fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style config fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style instance fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style mant fill:#4A90E2,stroke:#2E5C8A,color:#fff
+```
+
+---
+
+## Level 6: Database Schema Overview
+
+```mermaid
+graph TB
+    subgraph core["CORE ENTITIES"]
+        company["COMPANY<br/>company_id<br/>name<br/>code"]
+        location["LOCATION<br/>location_id<br/>name<br/>address"]
+        products["PRODUCTS<br/>product_id<br/>name<br/>code<br/>price"]
+        categories["CATEGORIES<br/>category_id<br/>name<br/>description"]
+    end
+
+    subgraph transactions["TRANSACTION ENTITIES"]
+        tickets["TICKETS<br/>ticket_id<br/>number<br/>date<br/>customer_id"]
+        lines["TICKETLINES<br/>line_id<br/>ticket_id<br/>product_id<br/>qty"]
+        payments["PAYMENTS<br/>payment_id<br/>ticket_id<br/>method<br/>amount"]
+    end
+
+    subgraph master["MASTER DATA"]
+        customers["CUSTOMERS<br/>customer_id<br/>name<br/>email<br/>phone"]
+        suppliers["SUPPLIERS<br/>supplier_id<br/>name<br/>contact<br/>products"]
+        employees["EMPLOYEES<br/>employee_id<br/>name<br/>role<br/>access_level"]
+        taxes["TAXCATEGORIES<br/>tax_id<br/>name<br/>rate"]
+    end
+
+    subgraph inventory["INVENTORY ENTITIES"]
+        stock["STOCK<br/>stock_id<br/>product_id<br/>location_id<br/>quantity"]
+        movements["STOCKMOVEMENTS<br/>movement_id<br/>product_id<br/>qty<br/>type"]
+    end
+
+    company -->|operates| location
+    location -->|manages| products
+    products -->|in| categories
+    location -->|in| stock
+    products -->|in| stock
+
+    customers -->|creates| tickets
+    employees -->|processes| tickets
+    products -->|in| lines
+    tickets -->|contains| lines
+    tickets -->|has| payments
+    tickets -->|has| taxes
+
+    products -->|from| suppliers
+    stock -->|tracks| movements
+
+    style core fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style transactions fill:#FF9F43,stroke:#B8690F,color:#fff
+    style master fill:#50C878,stroke:#2D7A4A,color:#fff
+    style inventory fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style company fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style location fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style products fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style categories fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style tickets fill:#FDB44B,stroke:#B8690F,color:#fff
+    style lines fill:#FDB44B,stroke:#B8690F,color:#fff
+    style payments fill:#FDB44B,stroke:#B8690F,color:#fff
+    style customers fill:#68D989,stroke:#2D7A4A,color:#fff
+    style suppliers fill:#68D989,stroke:#2D7A4A,color:#fff
+    style employees fill:#68D989,stroke:#2D7A4A,color:#fff
+    style taxes fill:#68D989,stroke:#2D7A4A,color:#fff
+    style stock fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style movements fill:#B76AC2,stroke:#5B2C6F,color:#fff
+```
+
+---
+
+## Technology Stack
+
+```mermaid
+graph TB
+    subgraph frontend["FRONTEND"]
+        swing["Swing<br/>Traditional UI"]
+        javafx["JavaFX<br/>Modern UI"]
+        flatlaf["FlatLAF<br/>Modern Look & Feel"]
+    end
+
+    subgraph backend["BACKEND"]
+        java["Java 8+<br/>Core Logic"]
+        lombok["Lombok<br/>Boilerplate Reduction"]
+        beanshell["BeanShell<br/>Dynamic Scripting"]
+    end
+
+    subgraph data["DATA & PERSISTENCE"]
+        jdbc["JDBC<br/>Database Abstraction"]
+        mysql["MySQL<br/>Primary Database"]
+        derby["Derby<br/>Embedded DB"]
+        sqlite["SQLite<br/>Lightweight DB"]
+        postgres["PostgreSQL<br/>Enterprise DB"]
+    end
+
+    subgraph reporting["REPORTING & ANALYTICS"]
+        jasper["JasperReports<br/>Report Generation"]
+        jfreechart["JFreeChart<br/>Charts & Graphs"]
+        poi["Apache POI<br/>Excel Export"]
+        itext["iText<br/>PDF Generation"]
+    end
+
+    subgraph devices["DEVICE INTEGRATION"]
+        rxtx["RXTX/jSerialComm<br/>Serial Communication"]
+        usb4j["USB4Java<br/>USB Communication"]
+        zxing["ZXing<br/>Barcode Processing"]
+        jpos["JavaPOS<br/>POS Device Standard"]
+    end
+
+    subgraph support["SUPPORT LIBRARIES"]
+        logback["Logback<br/>Logging"]
+        gson["GSON<br/>JSON Processing"]
+        xstream["XStream<br/>XML Serialization"]
+        velocity["Apache Velocity<br/>Template Engine"]
+    end
+
+    style frontend fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style backend fill:#50C878,stroke:#2D7A4A,color:#fff
+    style data fill:#FF9F43,stroke:#B8690F,color:#fff
+    style reporting fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style devices fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style support fill:#FFB84D,stroke:#8B6914,color:#fff
+
+    style swing fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style javafx fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style flatlaf fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style java fill:#68D989,stroke:#2D7A4A,color:#fff
+    style lombok fill:#68D989,stroke:#2D7A4A,color:#fff
+    style beanshell fill:#68D989,stroke:#2D7A4A,color:#fff
+    style jdbc fill:#FDB44B,stroke:#B8690F,color:#fff
+    style mysql fill:#FDB44B,stroke:#B8690F,color:#fff
+    style derby fill:#FDB44B,stroke:#B8690F,color:#fff
+    style sqlite fill:#FDB44B,stroke:#B8690F,color:#fff
+    style postgres fill:#FDB44B,stroke:#B8690F,color:#fff
+    style jasper fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style jfreechart fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style poi fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style itext fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style rxtx fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style usb4j fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style zxing fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style jpos fill:#FF8E8E,stroke:#A53D3D,color:#fff
+    style logback fill:#F5B041,stroke:#8B6914,color:#fff
+    style gson fill:#F5B041,stroke:#8B6914,color:#fff
+    style xstream fill:#F5B041,stroke:#8B6914,color:#fff
+    style velocity fill:#F5B041,stroke:#8B6914,color:#fff
+```
+
+---
+
+## Key Architectural Patterns
+
+```mermaid
+graph TB
+    subgraph patterns["DESIGN PATTERNS"]
+        dao_pat["📋 DAO Pattern<br/>Data Abstraction"]
+        service_pat["🔧 Service Pattern<br/>Business Logic"]
+        singleton_pat["🎯 Singleton Pattern<br/>Resource Management"]
+        factory_pat["🏭 Factory Pattern<br/>Object Creation"]
+        plugin_pat["🔌 Plugin Pattern<br/>Extensibility"]
+    end
+
+    subgraph layers["ARCHITECTURAL LAYERS"]
+        presentation["📱 Presentation<br/>UI Components"]
+        business["💼 Business Logic<br/>Services"]
+        data["💾 Data Access<br/>DAOs & Queries"]
+        external["🔌 External Integration<br/>Devices & Files"]
+    end
+
+    subgraph principles["DESIGN PRINCIPLES"]
+        sep_concern["Separation of Concerns<br/>Distinct responsibilities"]
+        loose_coupling["Loose Coupling<br/>Independent modules"]
+        high_cohesion["High Cohesion<br/>Related functionality"]
+        abstraction["Abstraction<br/>Hide complexity"]
+    end
+
+    presentation -->|calls| business
+    business -->|uses| data
+    business -->|uses| external
+
+    dao_pat -->|implements| data
+    service_pat -->|implements| business
+    singleton_pat -->|ensures| resource_management["Resource<br/>Management"]
+    factory_pat -->|creates| objects["Objects"]
+    plugin_pat -->|enables| extensions["Extensions"]
+
+    style patterns fill:#4A90E2,stroke:#2E5C8A,color:#fff
+    style layers fill:#50C878,stroke:#2D7A4A,color:#fff
+    style principles fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style dao_pat fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style service_pat fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style singleton_pat fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style factory_pat fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style plugin_pat fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style presentation fill:#68D989,stroke:#2D7A4A,color:#fff
+    style business fill:#68D989,stroke:#2D7A4A,color:#fff
+    style data fill:#68D989,stroke:#2D7A4A,color:#fff
+    style external fill:#68D989,stroke:#2D7A4A,color:#fff
+    style sep_concern fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style loose_coupling fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style high_cohesion fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style abstraction fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style resource_management fill:#FFB84D,stroke:#8B6914,color:#fff
+    style objects fill:#FFB84D,stroke:#8B6914,color:#fff
+    style extensions fill:#FFB84D,stroke:#8B6914,color:#fff
+```
+
+---
+
+## Core Features Architecture
+
+```mermaid
+graph TB
+    system["🏪 Unicenta oPOS<br/>Enterprise POS System"]
+
+    system -->|Sales Management| sales_feat["Sales Processing<br/>Multiple modes<br/>Ticket management<br/>Payment handling"]
+
+    system -->|Inventory Management| inventory_feat["Product Management<br/>Stock tracking<br/>Category organization<br/>Quantity monitoring"]
+
+    system -->|Customer Management| customer_feat["Customer Database<br/>Transaction history<br/>Loyalty programs<br/>Communication"]
+
+    system -->|Supplier Management| supplier_feat["Supplier Directory<br/>Purchase orders<br/>Product sourcing<br/>Vendor info"]
+
+    system -->|Employee Management| employee_feat["User Accounts<br/>Access Control<br/>Role Assignment<br/>Activity Logging"]
+
+    system -->|Reporting & Analytics| reporting_feat["Sales Reports<br/>Inventory Reports<br/>Financial Reports<br/>Charts & Graphs"]
+
+    system -->|Device Integration| device_feat["Thermal Printers<br/>Barcode Scanners<br/>Weight Scales<br/>Card Readers"]
+
+    system -->|Multi-platform| platform_feat["Windows Support<br/>Linux Support<br/>macOS Support<br/>Cross-platform UI"]
+
+    style system fill:#4A90E2,stroke:#2E5C8A,color:#fff,stroke-width:3px
+    style sales_feat fill:#50C878,stroke:#2D7A4A,color:#fff
+    style inventory_feat fill:#50C878,stroke:#2D7A4A,color:#fff
+    style customer_feat fill:#50C878,stroke:#2D7A4A,color:#fff
+    style supplier_feat fill:#50C878,stroke:#2D7A4A,color:#fff
+    style employee_feat fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style reporting_feat fill:#9B59B6,stroke:#5B2C6F,color:#fff
+    style device_feat fill:#FF6B6B,stroke:#A53D3D,color:#fff
+    style platform_feat fill:#FFB84D,stroke:#8B6914,color:#fff
+```
+
+---
+
+## Deployment Architecture
+
+```mermaid
+graph TB
+    subgraph client["CLIENT TIER"]
+        desktop["💻 Desktop Machine<br/>Windows • Linux • macOS<br/>Java Runtime (JRE 8+)"]
+    end
+
+    subgraph app_tier["APPLICATION TIER"]
+        jar["📦 unicentaopos.jar<br/>Version 5.4.0<br/>Java Swing/JavaFX"]
+    end
+
+    subgraph data_tier["DATA TIER"]
+        db_choice["Database Engine<br/>MySQL 5.x<br/>Derby<br/>SQLite<br/>PostgreSQL"]
+        db_instance["Database Instance<br/>Schema: unicentaopos<br/>Tables & Indexes"]
+    end
+
+    subgraph files["FILE STORAGE"]
+        reports_dir["📁 Reports Directory<br/>Generated PDFs<br/>Excel Files"]
+        config_dir["📁 Config Directory<br/>Application Settings<br/>User Preferences"]
+        templates["📁 Templates<br/>Report Templates<br/>Print Layouts"]
+        locales["📁 Localization<br/>Language Files<br/>i18n Resources"]
+    end
+
+    desktop -->|runs| jar
+    jar -->|connects to| db_choice
+    db_choice -->|manages| db_instance
+    jar -->|reads/writes| reports_dir
+    jar -->|reads/writes| config_dir
+    jar -->|reads| templates
+    jar -->|reads| locales
+
+    style client fill:#E8F4F8,stroke:#2E5C8A,stroke-width:2px
+    style app_tier fill:#4A90E2,stroke:#2E5C8A,color:#fff,stroke-width:2px
+    style data_tier fill:#FF9F43,stroke:#B8690F,color:#fff,stroke-width:2px
+    style files fill:#9B59B6,stroke:#5B2C6F,color:#fff,stroke-width:2px
+    style desktop fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style jar fill:#5BA3D0,stroke:#2E5C8A,color:#fff
+    style db_choice fill:#FDB44B,stroke:#B8690F,color:#fff
+    style db_instance fill:#FDB44B,stroke:#B8690F,color:#fff
+    style reports_dir fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style config_dir fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style templates fill:#B76AC2,stroke:#5B2C6F,color:#fff
+    style locales fill:#B76AC2,stroke:#5B2C6F,color:#fff
+```
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- Java 8+ (JRE)
+- MySQL 5.x (or Derby/SQLite/PostgreSQL)
+- Create database schema: `unicentaopos`
+
+### Build
+
+```bash
+mvn clean package
+```
+
+### Run
+
+```bash
+java -jar ./target/unicentaopos.jar
+```
+
+### Platform Support
+
+- ✅ Windows
+- ✅ Linux
+- ✅ macOS
+
+---
+
+## Summary
+
+**Unicenta oPOS** is a layered, modular Java desktop application with clear separation between:
+
+1. **Presentation Layer** - Swing/JavaFX UI
+2. **Service Layer** - Business logic & orchestration
+3. **Data Access Layer** - DAO pattern for database abstraction
+4. **Peripheral Integration** - Hardware device drivers
+5. **Support Layer** - Utilities, logging, plugins
+
+The architecture supports **multi-database backends**, **multiple POS sales modes** (simple, restaurant), **comprehensive reporting**, and **extensive peripheral device integration**, making it a flexible, enterprise-grade point-of-sale system.

src/main/java/com/unicenta/pos/payment/PaymentInfoCash.java

@@ -27,11 +27,13 @@ public class PaymentInfoCash extends PaymentInfo {
   private double m_dPaid;
   private double m_dTotal;
   private double m_dTendered;
-    private String m_dCardName =null;
+  private String m_dCardName = null;
-//    private double m_dTip;    
+  private String m_sName = "cash";
+  // private double m_dTip;
 
   /**
    * Creates a new instance of PaymentInfoCash
+   * 
    * @param dTotal
    * @param dPaid
    * @param dTendered
@@ -44,6 +46,7 @@ public class PaymentInfoCash extends PaymentInfo {
 
   /**
    * Creates a new instance of PaymentInfoCash
+   * 
    * @param dTotal
    * @param dPaid
    * @param dTendered
@@ -54,9 +57,12 @@ public class PaymentInfoCash extends PaymentInfo {
     this.prePayAmount = prePayAmount;
   }
 
-    /** Creates a new instance of PaymentInfoCash
+  /**
+   * Creates a new instance of PaymentInfoCash
+   * 
    * @param dTotal
-     * @param dPaid */
+   * @param dPaid
+   */
   public PaymentInfoCash(double dTotal, double dPaid) {
     m_dTotal = dTotal;
     m_dPaid = dPaid;
@@ -65,7 +71,7 @@ public class PaymentInfoCash extends PaymentInfo {
   @Override
   public PaymentInfo copyPayment() {
     return new PaymentInfoCash(m_dTotal, m_dPaid, m_dTendered, prePayAmount);
-//        return new PaymentInfoCash(m_dTotal, m_dPaid, prePayAmount);        
+    // return new PaymentInfoCash(m_dTotal, m_dPaid, prePayAmount);
   }
 
   @Override
@@ -77,13 +83,15 @@ public class PaymentInfoCash extends PaymentInfo {
   public String getName() {
     return "cash";
   }
+
   @Override
   public double getTotal() {
     return m_dTotal;
   }
-//    public double getTip() {
+
-//        return m_dTip;
+  // public double getTip() {
-//    }
+  // return m_dTip;
+  // }
   @Override
   public double getPaid() {
     return m_dPaid;
@@ -95,7 +103,7 @@ public class PaymentInfoCash extends PaymentInfo {
   }
 
   @Override
-   public double getChange(){
+  public double getChange() {
     return m_dPaid - m_dTotal;
   }
 
@@ -118,9 +126,11 @@ public class PaymentInfoCash extends PaymentInfo {
   public String printTendered() {
     return Formats.CURRENCY.formatValue(m_dTendered);
   }
+
   public String printPaid() {
     return Formats.CURRENCY.formatValue(m_dPaid);
   }
+
   public String printChange() {
     return Formats.CURRENCY.formatValue(m_dPaid - m_dTotal);
   }

src/main/java/com/unicenta/pos/payment/PaymentInfoCash_original.java

@@ -30,24 +30,28 @@ public class PaymentInfoCash_original extends PaymentInfo {
   private final double m_dPaid;
   private final double m_dTotal;
   private double m_dTendered;
-    private final String m_dCardName =null;
+  private final String m_dCardName = null;
-//    private double m_dTip;    
+  private String m_sName = "cash";
+  // private double m_dTip;
 
-    /** Creates a new instance of PaymentInfoCash
+  /**
+   * Creates a new instance of PaymentInfoCash
+   * 
    * @param dTotal
-     * @param dPaid */
+   * @param dPaid
+   */
   public PaymentInfoCash_original(double dTotal, double dPaid) {
     m_dTotal = dTotal;
     m_dPaid = dPaid;
   }
 
   @Override
-    public PaymentInfo copyPayment(){
+  public PaymentInfo copyPayment() {
     return new PaymentInfoCash_original(m_dTotal, m_dPaid);
   }
 
   @Override
-    public String getTransactionID(){
+  public String getTransactionID() {
     return "no ID";
   }
 
@@ -55,15 +59,19 @@ public class PaymentInfoCash_original extends PaymentInfo {
   public String getName() {
     return "cash";
   }
+
   @Override
   public double getTotal() {
     return m_dTotal;
   }
-/**    public double getTip() {
+
-        return m_dTip;
+  /**
-    }
+   * public double getTip() {
+   * return m_dTip;
+   * }
+   * 
    * @return
-*/
+   */
   @Override
   public double getPaid() {
     return m_dPaid;
@@ -75,7 +83,7 @@ public class PaymentInfoCash_original extends PaymentInfo {
   }
 
   @Override
-    public double getChange(){
+  public double getChange() {
     return m_dPaid - m_dTotal;
   }
 
@@ -83,9 +91,11 @@ public class PaymentInfoCash_original extends PaymentInfo {
   public String getCardName() {
     return m_dCardName;
   }
+
   public String printPaid() {
     return Formats.CURRENCY.formatValue(m_dPaid);
   }
+
   public String printChange() {
     return Formats.CURRENCY.formatValue(m_dPaid - m_dTotal);
   }

src/main/java/com/unicenta/pos/payment/PaymentInfoMagcard.java

@@ -21,6 +21,7 @@ package com.unicenta.pos.payment;
 
 public class PaymentInfoMagcard extends PaymentInfo {
 
+  private String m_sName = "creditcard";
   protected double m_dTotal;
   protected double m_dTip;
   protected String m_sHolderName;
@@ -33,10 +34,10 @@ public class PaymentInfoMagcard extends PaymentInfo {
   protected String m_sAuthorization;
   protected String m_sErrorMessage;
   protected String m_sReturnMessage;
-    //JG Jan 2018 
+  // JG Jan 2018
   protected String encryptedTrack;
   protected String encryptionKey;
-    protected String m_dCardName =null;
+  protected String m_dCardName = null;
 
   protected Boolean chipAndPin = Boolean.FALSE;
   protected String verification;
@@ -44,6 +45,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
 
   /**
    * Creates a new instance of PaymentInfoMagcard
+   * 
    * @param sHolderName
    * @param sCardNumber
    * @param sExpirationDate
@@ -69,7 +71,6 @@ public class PaymentInfoMagcard extends PaymentInfo {
     m_sTransactionID = sTransactionID;
     m_dTotal = dTotal;
 
-
     m_sAuthorization = null;
     m_sErrorMessage = null;
     m_sReturnMessage = null;
@@ -77,6 +78,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
 
   /**
    * Creates a new instance of PaymentInfoMagcard
+   * 
    * @param sHolderName
    * @param sCardNumber
    * @param sExpirationDate
@@ -100,7 +102,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
   }
 
   public String getName() {
-//        return "magcard";
+    // return "magcard";
     return "ccard";
   }
 
@@ -123,7 +125,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
 
   @Override
   public String getCardName() {
-        if (chipAndPin){
+    if (chipAndPin) {
       return m_dCardName;
     }
     return getCardType(m_sCardNumber);
@@ -156,10 +158,11 @@ public class PaymentInfoMagcard extends PaymentInfo {
     return encryptionKey;
   }
 
-    /** @param sCardNumber
+  /**
+   * @param sCardNumber
    * @return
    */
-    public String getCardType(String sCardNumber){
+  public String getCardType(String sCardNumber) {
     String c = "UNKNOWN";
 
     if (sCardNumber.startsWith("4")) {
@@ -251,7 +254,6 @@ public class PaymentInfoMagcard extends PaymentInfo {
     throw new UnsupportedOperationException("Not supported yet.");
   }
 
-
   public void setIsProcessed(boolean value) {
     throw new UnsupportedOperationException("Not supported yet.");
   }
@@ -262,7 +264,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
   }
 
   @Override
-    public double getChange(){
+  public double getChange() {
     return 0.00;
   }
 
@@ -276,7 +278,7 @@ public class PaymentInfoMagcard extends PaymentInfo {
     return null;
   }
 
-    public void setCardName(String m_dCardName){
+  public void setCardName(String m_dCardName) {
     this.m_dCardName = m_dCardName;
   }
 

src/main/java/com/unicenta/pos/ticket/TicketInfo.java

@@ -48,7 +48,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public static final int RECEIPT_PAYMENT = 2;
   public static final int RECEIPT_NOSALE = 3;
 
-// JG Jun 2017 - contain partial/full refunds    
+  // JG Jun 2017 - contain partial/full refunds
   public static final int REFUND_NOT = 0; // is a non-refunded ticket
   public static final int REFUND_PARTIAL = 1;
   public static final int REFUND_ALL = 2;
@@ -82,7 +82,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   private static String hostname;
 
   public static void setHostname(String name) {
-        hostname =name;
+    hostname = name;
   }
 
   public static String getHostname() {
@@ -103,7 +103,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     payments = new ArrayList<>();
     taxes = null;
     m_sResponse = null;
-        oldTicket=false;
+    oldTicket = false;
 
     AppConfig config = new AppConfig(new File(new File(
         System.getProperty("user.home")), AppLocal.APP_ID + ".properties"));
@@ -112,6 +112,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     m_isProcessed = false;
     m_locked = null;
     ticketstatus = 0;
+    m_sHost = String.valueOf(config.getProperty("machine.hostname"));
   }
 
   @Override
@@ -197,7 +198,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     payments.forEach((p) -> {
       t.payments.add(p.copyPayment());
     });
-        t.oldTicket=oldTicket;
+    t.oldTicket = oldTicket;
     // taxes are not copied, must be calculated again.
 
     t.ticketstatus = ticketstatus;
@@ -212,6 +213,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public int getTicketType() {
     return tickettype;
   }
+
   public void setTicketType(int tickettype) {
     this.tickettype = tickettype;
   }
@@ -219,6 +221,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public int getTicketId() {
     return m_iTicketId;
   }
+
   public void setTicketId(int iTicketId) {
     m_iTicketId = iTicketId;
   }
@@ -226,10 +229,11 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public int getTicketStatus() {
     return ticketstatus;
   }
+
   public void setTicketStatus(int ticketstatus) {
-        if (m_iTicketId >0) {
+    if (m_iTicketId > 0) {
       this.ticketstatus = m_iTicketId;
-        }else{
+    } else {
       this.ticketstatus = ticketstatus;
     }
   }
@@ -243,7 +247,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   }
 
   public String getName(Object info) {
-// JG Aug 2014 - Add User info
+    // JG Aug 2014 - Add User info
     List<String> name = new ArrayList<>();
 
     String nameprop = getProperty("name");
@@ -289,7 +293,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     AppConfig m_config_host = new AppConfig(new File((System.getProperty("user.home")),
         AppLocal.APP_ID + ".properties"));
     m_config_host.load();
-      String machineHostname =(m_config_host.getProperty("machine.hostname"));
+    String machineHostname = (m_config_host.getProperty("machine.hostname"));
     m_config_host = null;
     return machineHostname;
   }
@@ -318,15 +322,15 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     }
   }
 
-    public String getTransactionID(){
+  public String getTransactionID() {
-        return (getPayments().size()>0)
+    return (getPayments().size() > 0)
-            ? ( getPayments().get(getPayments().size()-1) ).getTransactionID()
+        ? (getPayments().get(getPayments().size() - 1)).getTransactionID()
-            : StringUtils.getCardNumber(); //random transaction ID
+        : StringUtils.getCardNumber(); // random transaction ID
   }
 
-    public String getReturnMessage(){
+  public String getReturnMessage() {
-        return ( (getPayments().get(getPayments().size()-1)) instanceof PaymentInfoMagcard )
+    return ((getPayments().get(getPayments().size() - 1)) instanceof PaymentInfoMagcard)
-            ? ((PaymentInfoMagcard)(getPayments().get(getPayments().size()-1))).getReturnMessage()
+        ? ((PaymentInfoMagcard) (getPayments().get(getPayments().size() - 1))).getReturnMessage()
         : LocalRes.getIntString("button.OK");
   }
 
@@ -403,9 +407,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
 
   public double getSubTotal() {
     double sum = 0.0;
-        sum = m_aLines.stream().map((line) -> 
+    sum = m_aLines.stream().map((line) -> line.getSubValue()).reduce(sum, (accumulator, _item) -> accumulator + _item);
-                line.getSubValue()).reduce(sum, (accumulator, _item) -> 
-                        accumulator + _item);
     return sum;
   }
 
@@ -418,9 +420,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
         nsum = sum;
       }
     } else {
-            sum = m_aLines.stream().map((line) -> 
+      sum = m_aLines.stream().map((line) -> line.getTax()).reduce(sum, (accumulator, _item) -> accumulator + _item);
-                    line.getTax()).reduce(sum, (accumulator, _item) -> 
-                            accumulator + _item);
     }
     return sum;
   }
@@ -437,10 +437,8 @@ public final class TicketInfo implements SerializableRead, Externalizable {
 
   public double getTotalPaid() {
     double sum = 0.0;
-        sum = payments.stream().filter((p) -> 
+    sum = payments.stream().filter((p) -> (!"debtpaid".equals(p.getName()))).map((p) -> p.getTotal()).reduce(sum,
-                (!"debtpaid".equals(p.getName()))).map((p) -> 
+        (accumulator, _item) -> accumulator + _item);
-                        p.getTotal()).reduce(sum, (accumulator, _item) -> 
-                                accumulator + _item);
     return sum;
   }
 
@@ -533,24 +531,24 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     AppConfig m_config = new AppConfig(new File(
         (System.getProperty("user.home")), AppLocal.APP_ID + ".properties"));
     m_config.load();
-      String receiptSize =(m_config.getProperty("till.receiptsize"));
+    String receiptSize = (m_config.getProperty("till.receiptsize"));
-      String receiptPrefix =(m_config.getProperty("till.receiptprefix"));
+    String receiptPrefix = (m_config.getProperty("till.receiptprefix"));
 
-      m_config =null;
+    m_config = null;
 
     if (m_iTicketId > 0) {
-            String tmpTicketId=Integer.toString(m_iTicketId);
+      String tmpTicketId = Integer.toString(m_iTicketId);
-            if (receiptSize == null || (Integer.parseInt(receiptSize) <= tmpTicketId.length())){
+      if (receiptSize == null || (Integer.parseInt(receiptSize) <= tmpTicketId.length())) {
-                if (receiptPrefix != null){
+        if (receiptPrefix != null) {
-                    tmpTicketId=receiptPrefix+tmpTicketId;
+          tmpTicketId = receiptPrefix + tmpTicketId;
         }
         return tmpTicketId;
       }
-            while (tmpTicketId.length()<Integer.parseInt(receiptSize)){
+      while (tmpTicketId.length() < Integer.parseInt(receiptSize)) {
-                tmpTicketId="0"+tmpTicketId;
+        tmpTicketId = "0" + tmpTicketId;
       }
-            if (receiptPrefix != null){
+      if (receiptPrefix != null) {
-                    tmpTicketId=receiptPrefix+tmpTicketId;
+        tmpTicketId = receiptPrefix + tmpTicketId;
       }
       return tmpTicketId;
     } else {
@@ -571,29 +569,28 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     return m_sHost;
   }
 
-    
+  // Added JDL 28.05.13 for loyalty card functions
-// Added JDL 28.05.13 for loyalty card functions
 
   /**
    *
    */
-        public void clearCardNumber(){
+  public void clearCardNumber() {
-        loyaltyCardNumber=null;
+    loyaltyCardNumber = null;
   }
 
   /**
    *
    * @param cardNumber
    */
-    public void setLoyaltyCardNumber(String cardNumber){
+  public void setLoyaltyCardNumber(String cardNumber) {
-        loyaltyCardNumber=cardNumber;
+    loyaltyCardNumber = cardNumber;
   }
 
   /**
    *
    * @return
    */
-    public String getLoyaltyCardNumber(){
+  public String getLoyaltyCardNumber() {
     return (loyaltyCardNumber);
   }
 
@@ -629,8 +626,8 @@ public final class TicketInfo implements SerializableRead, Externalizable {
     return Formats.CURRENCY.formatValue(getTendered());
   }
 
-    public String VoucherReturned(){
+  public String VoucherReturned() {
-        return Formats.CURRENCY.formatValue(getTotalPaid()- getTotal());
+    return Formats.CURRENCY.formatValue(getTotalPaid() - getTotal());
   }
 
   public boolean getOldTicket() {
@@ -642,28 +639,27 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   }
 
   public String getTicketHeaderFooterData(String data) {
-        AppConfig m_config = new AppConfig(new File((System.getProperty("user.home"))
+    AppConfig m_config = new AppConfig(new File((System.getProperty("user.home")), AppLocal.APP_ID + ".properties"));
-                , AppLocal.APP_ID + ".properties"));        
     m_config.load();
-        String row =(m_config.getProperty("tkt."+data));
+    String row = (m_config.getProperty("tkt." + data));
 
     return row;
   }
 
-    public String printQRCode(String nameHeader, String vatHeader, String vatLabel){
+  public String printQRCode(String nameHeader, String vatHeader, String vatLabel) {
     String name = getTicketHeaderFooterData(nameHeader);
     String vatNumberHeader = getTicketHeaderFooterData(vatHeader);
     String vatNumber = vatNumberHeader.split(vatLabel)[1];
     String date = new SimpleDateFormat("yyyy-mm-dd hh:mm:ss").format(getDate());
     String total = String.valueOf(getTotal());
     String vatValue = String.valueOf(getTax());
-        return name+","+vatNumber+","+date+","+total+","+vatValue;
+    return name + "," + vatNumber + "," + date + "," + total + "," + vatValue;
   }
 
   public String printTicketHeaderLine1() {
     String lineData = getTicketHeaderFooterData("header1");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -673,7 +669,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketHeaderLine2() {
     String lineData = getTicketHeaderFooterData("header2");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -683,7 +679,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketHeaderLine3() {
     String lineData = getTicketHeaderFooterData("header3");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -693,7 +689,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketHeaderLine4() {
     String lineData = getTicketHeaderFooterData("header4");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -703,7 +699,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketHeaderLine5() {
     String lineData = getTicketHeaderFooterData("header5");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -713,7 +709,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketHeaderLine6() {
     String lineData = getTicketHeaderFooterData("header6");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -723,7 +719,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine1() {
     String lineData = getTicketHeaderFooterData("footer1");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -733,7 +729,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine2() {
     String lineData = getTicketHeaderFooterData("footer2");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -743,7 +739,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine3() {
     String lineData = getTicketHeaderFooterData("footer3");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -753,7 +749,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine4() {
     String lineData = getTicketHeaderFooterData("footer4");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -763,7 +759,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine5() {
     String lineData = getTicketHeaderFooterData("footer5");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";
@@ -773,7 +769,7 @@ public final class TicketInfo implements SerializableRead, Externalizable {
   public String printTicketFooterLine6() {
     String lineData = getTicketHeaderFooterData("footer6");
 
-        if(lineData != null) {
+    if (lineData != null) {
       return lineData;
     } else {
       return "";