FlashPOS - Hybrid Point-of-Sale System

FlashPOS is a modern, feature-rich, and highly configurable Hybrid Point-of-Sale (POS) solution for Android devices. Built with Kotlin, Jetpack Compose, and a modular MVVM architecture, it's designed to seamlessly adapt to Retail, Cafe, and Restaurant environments.

🚀 Key Features

Core POS Features

• Intuitive Interface: A minimalist, tablet-optimized UI designed for speed and efficiency.
• Product Catalog: Easily manage products, pricing, and categories.
• Dynamic Cart: Add items, adjust quantities, and apply discounts on the fly.
• Payment Processing: Support for Cash, Card, and QR-based payments.
• User Management: Role-based access control for Admins, Managers, and Cashiers.
• Comprehensive Reporting: Real-time insights into sales, products, and payments.
• Hardware Integration: Robust support for thermal receipt printers and barcode scanners.

🍽️ Restaurant & Cafe Features

• Table Management: Full control over your floor plan with customizable tables.
• Order Management: Create, track, and manage dine-in orders directly from the table layout.
• Kitchen Ticket Printing (KDS): Automatically send dockets to designated kitchen printers.
• Calling Order Numbers: Manage takeaway orders with sequential numbering.

🛍️ Retail Features

• Barcode Scanning: Quickly add products to the cart using a USB or Bluetooth barcode scanner.
• Inventory Management: Track stock levels in real-time with low-stock alerts.
• Customer Management: Attach customers to sales and manage a basic client list.

🔒 App Activation

• 90-Day Free Trial: Full access to all features for 90 days after fresh installation.
• Hardware-Bound Activation: After the trial, the app can be unlocked permanently with an activation key tied to the device's unique hardware ID.

📱 System Requirements

• Minimum Android Version: Android 9 (API 28)
• Target Android Version: Android 14 (API 34)
• RAM: 2GB minimum (4GB recommended)
• Display: 7" screen or larger (tablet-optimized)

🏗️ Architecture

• Language: Kotlin
• UI Framework: Jetpack Compose
• Architecture Pattern: MVVM (Model-View-ViewModel)
• Database: Room (SQLite)
• Async Processing: Kotlin Coroutines & Flow
• Logging: Timber

📦 Installation

1. Clone the repository:

   git clone https://github.com/your-repo/FlashPOS.git

2. Open in Android Studio and let Gradle sync.
3. Build and run on an Android emulator or physical device.

🔧 Configuration

• Initial Setup: On first launch, the app guides you through selecting a business mode (Retail or Restaurant), setting up your store details, and creating an admin account.
• Hardware Setup: Configure receipt printers, kitchen printers, and barcode scanners from the in-app settings menu.

🤝 Contributing

Contributions are welcome! Please fork the repository, create a feature branch, and open a pull request.

📄 License

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