===============================================================================
                       ZUNGO COUNTER TOOLKIT (FREEWARE)
                          Official User Guide / README
===============================================================================
Developer: Andrias Hammer | Website: https://zungo.co.ke
Contact:   support@zungo.co.ke | +254 743447540
System:    Windows PC & Laptop (100% Offline, Zero Monthly Fees)
Version:   Build 1.2.0 (Latest Update)
===============================================================================

Thank you for downloading the freeware Zungo Counter Toolkit, engineered to 
help local retail counters, kiosk operators, and wholesale desks manage daily 
operations offline without monthly fees.

-------------------------------------------------------------------------------
CRUCIAL WINDOWS INSTALLATION STEP
-------------------------------------------------------------------------------
If Windows displays a blue "SmartScreen" warning upon launching:
1. Click "More info" on the blue popup window.
2. Select "Run anyway" to complete the installation safely.

===============================================================================
HOW TO USE THE 3 INCLUDED SOFTWARE TOOLS
===============================================================================
1. ZUNGO COUNTER TOOLKIT: CASHFLOAT BALANCER (LINEAR WORKFLOW)
   * Purpose: Balance physical cash drawers and digital mobile money receipts 
     against start-of-day funds to generate a complete reconciliation ledger.
   * How to Use (Follow the New Guided 1-5 Step System):
     1. STEP 1 - START: Click the "Start New Count" action button to initialize 
        a secure local database entry row.
     2. STEP 2 - COUNT TELLER: Move down to type the actual NUMBER (QUANTITY) 
        of physical banknotes and coins present—NOT their total monetary value. 
        (Example: If you have five 1,000 Ksh notes, type "5", NOT "5000"). 
        The Zungo engine multiplies values automatically.
     3. STEP 3 - M-PESA: Move to the top center panel. Type a mobile transaction 
        amount and click "Add M-Pesa Transaction" or hit your keyboard ENTER 
        key. The field clears automatically; repeat this loop until all 
        transactions from your till log are typed in.
     4. STEP 4 - TELLER COUNTED: Review your total metrics in the center box 
        and click the "Finalize" button to commit the values.
 5. STEP 5 - TELLER REPORT: Look at the generated white receipt card on the 
        right to verify your balances. CRUCIAL RULE: You MUST click "Print Report" 
        to lock in and output your daily numbers BEFORE the system will unlock 
        the "View Report" historical log audit feature.

2. ZUNGO COUNTER TOOLKIT: M-PESA & MARGIN CALCULATOR
   * Purpose: Safely compute exact retail customer transaction totals with 
     built-in reference thresholds for local M-Pesa business operations.
   * How to Use:
     1. Type your desired cash transaction target into the "Amount" field.
     2. Use the bracket dropdown menu to lock in the proper tier structure.
     3. Check the real-time breakdown fields to view the total required to 
        send to a registered M-Pesa/Poshi/Till line, or the total needed 
        for an Agent withdrawal.
     4. Consult the "Global Parameters" panel to confirm local regulatory 
        thresholds (Max Account Balance, Transaction Limits, etc.).

3. ZUNGO COUNTER TOOLKIT: QUICK SHELF-TAG PRINTER
   * Purpose: Generate on-demand scannable item barcodes without expensive 
     dedicated sheet layouts.
   * How to Use:
     1. Complete the entry blocks: input your Business Name, Product No, 
        Product Name, and Price Tag details.
     2. Review the live visual canvas module to check the layout rendering.
     3. Click the "Print 58mm" button to commit the job.
   * CRUCIAL HARDWARE & PAPER COMPATIBILITY RULES:
     - Designed natively for continuous 58mm thermal receipt paper rolls.
     - Does NOT support standard separate layout barcode label sheets.
     - If printing onto adhesive sticker stock, you MUST load an "endless 
       continuous roll" matching the 58mm width constraint.
   * BONUS UNIVERSAL OFFICE A4 PRINTER TRICK:
     If you do not own a 58mm thermal printer, you can still print tags:
     1. Set your system printer target to "Print to PDF".
     2. Click "Print 58mm" to compile and save your tag layout as a PDF file.
     3. Open the saved PDF file using your standard computer PDF viewer.
     4. Click Print, select your standard office A4 printer, and CRUCIAL 
        STEP: Make sure to select "Scale to Default" (or "Actual Size") 
        in your printer settings layout so the barcode remains perfectly 
        proportioned and crisp for your USB scanners!

===============================================================================
UPGRADE CHANNELS & PROFESSIONAL SUITES
===============================================================================
Need advanced features? Scale up your business setup seamlessly:
* Need to log individual retail sales? Try ZUNGO RECEIPT PRO!
* Need a complete double-entry cash ledger? Try ZUNGO BESA PRO!
* Run a multi-lane store? Get INVOICE PRO - TOUCHPOS (Ksh 50,000 one-time).

Copyright (c) 2026 Andrias Hammer. All Systems Run 100% Offline.
===============================================================================