https://github.com/bienvenuushindi/btq-ms
A comprehensive solution designed to streamline and simplify the process of managing product requisitions for a small boutique.
https://github.com/bienvenuushindi/btq-ms
api e-commerce innovation rails ruby
Last synced: 2 months ago
JSON representation
A comprehensive solution designed to streamline and simplify the process of managing product requisitions for a small boutique.
- Host: GitHub
- URL: https://github.com/bienvenuushindi/btq-ms
- Owner: bienvenuushindi
- License: mit
- Created: 2023-06-25T14:02:14.000Z (about 3 years ago)
- Default Branch: dev
- Last Pushed: 2024-07-10T23:50:00.000Z (almost 2 years ago)
- Last Synced: 2025-03-28T09:43:33.089Z (over 1 year ago)
- Topics: api, e-commerce, innovation, rails, ruby
- Language: Ruby
- Homepage: https://btqms.vercel.app/
- Size: 519 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Boutique Purchase Requisition ( [click here for the frontend](https://github.com/bienvenuushindi/btq-ms-front))
## Description
The Boutique Purchase Requisition project is a comprehensive solution designed to streamline and simplify the process of managing product requisitions for a small boutique. The primary goal is to alleviate the challenges faced by the person in charge of purchasing supplies by digitizing and automating various tasks associated with the traditional paper-based requisition process.
## BTQ_MS High-Level Architecture Diagram
Both the Customer App (React Native and Web App) and the Management App (Next.js Frontend) communicate with a single Monolithic API, which is a Rails API serving both functionalities. The Monolithic API handles all requests from the client applications and contains all the business logic and functionalities. A shared database is still used for data storage, ensuring data consistency across the platform.
## Purpose and Challenges
In the traditional process, the person responsible for purchases encounters numerous challenges, including:
- **Supplier Knowledge and Price Estimation:** The individual must be familiar with different suppliers and have accurate price estimates for various products to determine the required budget.
- **Price Variation Management:** Fluctuating prices necessitate keeping track of price changes to ensure accurate cost estimations and updates at the store.
- **Inventory Updates and Shortages:** Awareness of product shortages and anticipated restock dates is essential for managing inventory effectively.
- **Human Error and Inconsistencies:** The paper-based system is prone to errors, leading to inconsistent purchasing decisions and inaccuracies.
- **Dependency on a Single Individual:** In case of absence of the person in charge, continuity of the process becomes challenging, as someone else must take over without sufficient knowledge.
## Project Objectives
The primary objective of the Boutique Purchase Requisition application is to address these challenges and offer a comprehensive solution to improve requisition management. The application aims to provide the following functionalities:
- **Requisition Management:** Users can create and update product requisitions digitally, eliminating the need for paper documents. This feature enhances accuracy and provides a clear overview of required items.
- **Product Management:** The application allows users to add, update, and manage product information. This ensures accurate product data and seamless integration with requisitions.
- **Supplier Management:** Users can maintain supplier information, including contact details and product offerings. This simplifies the process of selecting and reaching out to suppliers.
## Features
- Digitizes requisitions, streamlining the requisition creation and update process.
- Manages product information to ensure accuracy and integration with requisitions.
- Maintains supplier details, simplifying supplier selection and interaction.
## Contributing
We welcome contributions to the Boutique Purchase Requisition project. To contribute:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/new-feature`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature/new-feature`).
6. Create a new Pull Request.
## License
This project is licensed under the [MIT License](LICENSE).