Bachene Soft - Professional Stock & Sales Manager

A professional Stock & Sales Management application built to streamline daily business workflows. It addresses common operational pain points such as inventory mismanagement, untracked credit sales, and inefficient reporting. By providing a secure, offline-first platform, it enables business owners to manage their stock, sales, and relationships with precision and ease.

✨ Project Highlights

• End-to-End Inventory Control: Real-time tracking of stock levels with automated alerts for low inventory.
• Sales & Credit Management: Seamlessly record sales and manage client debts with a dedicated credit tracking system.
• Professional Document Generation: Instant generation of PDF receipts and daily closure reports for clear accountability.
• Privacy by Design: Secure biometric authentication (Fingerprint/FaceID) ensuring business data remains confidential.
• Reliable Offline Operation: Built to work perfectly without an internet connection, ideal for fast-paced retail environments.

---

📸 visual Overview

Home Screen	New Sale	Add Inventory

Purchase History	Check Inventory	Daily Closures

Client Management	Supplier Management

---

🏗️ Architecture & Design

This project strictly adheres to Clean Architecture to ensure maintainability, testability, and scalability.

graph TD
    subgraph Presentation_Layer["Presentation Layer (Flutter UI)"]
        UI[Flutter Widgets / Screens]
        Providers[ChangeNotifier Providers]
    end

    subgraph Domain_Layer["Domain Layer (Business Logic)"]
        Entities[Business Entities]
        RepoInterfaces[Repository Interfaces]
        UseCases[Use Cases - Optional]
    end

    subgraph Data_Layer["Data Layer (Infrastructure)"]
        Repos[Repository Implementations]
        Models[Data Models / Serialization]
        
        subgraph Data_Sources["Data Sources"]
            SQL[(SQLite / Local DB)]
        end
    end

    UI --> Providers
    Providers --> RepoInterfaces
    RepoInterfaces --> Repos
    Repos --> Models
    Models --> Entities
    Repos --> SQL

Loading

Key Architectural Highlights:

• Decoupling: Business logic is completely separated from the UI and Data layers.
• Dependency Injection: Constructor-based DI is used throughout, following the Dependency Inversion Principle.
• Type Safety: Explicit type casting and generic handling ensure a stable, runtime-safe experience.
• Mapping: Clear separation between UI-facing Entities and database-focused Models.

---

🛠️ Technology Stack

• Core: Flutter / Dart
• Persistence: sqflite (SQLite) for robust local storage.
• State Management: provider for efficient reactive updates.
• Security:
  • local_auth for Biometric (Fingerprint/Face) authentication.
  • Custom Secure PIN lock system.
• Reporting:
  • pdf & flutter_pdfview for professional receipt generation.
  • share_plus for easy data export.
• Hardware Integration: blue_thermal_printer for Bluetooth printing support.
• Design: google_fonts (Poppins) for a premium, modern aesthetic.

---

🚀 Getting Started

Prerequisites

• Flutter SDK (>= 3.7.2)
• Android Studio / VS Code

Installation

1. Clone the repository:

   git clone https://github.com/your-username/stock_manager.git

2. Install dependencies:

   flutter pub get

3. Run the application:

   flutter run

---

📝 Documentations

The project is thoroughly documented using Triple-Slash DocComments (///), making it easy for other developers to understand the business roles and API contracts of all core components.

---

© 2026 Bachene Soft. Developed by Moundhir Bachene. All rights reserved.