Skip to content

Whoolab-Technologies/multistore-inventory-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Centralized Multi-Store Inventory Management Platform

A scalable inventory management platform designed for organizations that operate multiple projects, work sites, or branch stores — such as construction companies, infrastructure projects, contracting firms, and warehouse networks.

The system follows a Central Store + Multiple Sub-Stores workflow and allows organizations to track, transfer, issue, return, and consume materials across locations with full user-level accountability.

🧩 This platform is modular and can be tweaked or extended to match any workflow that follows similar inventory movement or approval processes.


✨ Key Capabilities

  • Centralized inventory visibility across stores / sites
  • Store-wise stock tracking
  • Material movement between stores
  • Material Request (MR) workflow for engineers
  • Purchase Request (PR) workflow for stock-out items
  • Configurable transaction lifecycle statuses
    (processing, in-transfer, delivered, etc.)
  • Item consumption tracking
  • Engineer-based material accountability
  • Return workflows (site → store / store → central)
  • Auto-generated QR codes for all products
  • QR scanning enabled across workflows
  • Role-based access for:
    • Central Storekeepers
    • Site Storekeepers
    • Engineers
    • Admin Users

🧩 Platform Modules

This platform is implemented as multiple repositories:

📦 Shared Flutter Components

Reusable widgets & UI components used in both mobile apps
👉 https://github.com/Whoolab-Technologies/inventory-flutter-common


🔧 API Server (Laravel + PostgreSQL)

Business logic, workflows, MR/PR lifecycle, inventory operations
👉 https://github.com/Whoolab-Technologies/inventory-api


🖥️ Admin Web Dashboard (Angular)

System configuration, users, stores, products, reports & control center
👉 https://github.com/Whoolab-Technologies/inventory-admin-web


📱 Storekeeper Mobile App (Flutter)

Operations interface for central & site storekeepers
👉 https://github.com/Whoolab-Technologies/inventory-storekeeper-flutter


📱 Engineer Mobile App (Flutter)

Engineers can raise MR, check stock & track transfers
👉 https://github.com/Whoolab-Technologies/inventory-engineer-flutter


🔗 Connecting the Shared Flutter Components

Both mobile apps reuse UI and utility components from the shared Flutter library:

Repository:
https://github.com/Whoolab-Technologies/inventory-flutter-common
Package name: mvp_shared_components

This shared package ensures consistent UI, behavior, and code reuse across the Engineer App and Storekeeper App.


📥 Clone All Repositories

Ensure the shared package and both apps exist inside the same parent folder:

projects/
├── inventory-flutter-common
├── inventory-storekeeper-flutter
└── inventory-engineer-flutter

(You may use any folder structure — just ensure correct path references.)


🛠️ Linking the Shared Package (Local Path Dependency)

Both mobile apps reference the shared library via a local path dependency.

Open pubspec.yaml in each mobile app and add:

dependencies:
  mvp_shared_components:
    path: ../inventory-flutter-common

Then install dependencies:

 flutter pub get

🏗️ System Architecture (High Level)

Admin Web App  →  API Server  →  Database (PostgreSQL)
Storekeeper App → API Server
Engineer App    → API Server

Shared Flutter Components are reused across both mobile apps

All inventory transactions & workflows are centrally processed while each store operates independently with controlled permissions.


🔧 Primary Use Cases

  • Multi-site construction companies
  • Central warehouse + site store operations
  • Project-based inventory consumption tracking
  • Material accountability against engineers / users
  • Organizations with frequent in-store transfers
  • Businesses requiring QR-code-based inventory scanning

🧰 Tech Stack

  • Backend — Laravel + PostgreSQL
  • Admin Panel — Angular
  • Mobile Apps — Flutter
  • Shared Mobile UI — Flutter Component Library
  • QR Support — Auto-generated codes + scanner integration

🚀 Adaptable to Other Domains

This platform can be tweaked to fit:

  • Warehousing & logistics systems
  • Field-operations material management
  • Maintenance & spares management
  • Tool-tracking solutions
  • Multi-branch business inventory

Workflows & roles can be customized based on real-world needs.


🤝 Customization, Deployment & Support

This project is open-source for demonstration and learning purposes.
If you are a business looking for:

  • Custom workflow implementation
  • Feature extensions
  • Self-hosted / on-premise deployment
  • Mobile & web customization
  • Long-term support & maintenance

we would be happy to help.

📩 Contact Whoolab Technologies
🌐 Website: https://whoolab.com
📧 Email: mail@whoolab.com


🏷️ License

This project is open-source for learning and evaluation purposes.

❗ Commercial use, resale, or re-distribution is not permitted.

For commercial licensing, customization, or deployment:

📩 mail@whoolab.com


⭐ Acknowledgements

Built by Whoolab Technologies as a modular, scalable, enterprise-ready inventory management solution.

Releases

No releases published

Packages

 
 
 

Contributors