📦 INVO

Inventory Management App - A digital solution to streamline donation and supply management for relief and nonprofit organizations.

---

🏆 Mission & Vision

Our project aligns with the mission of ICNA (Islamic Circle of North America), a leading Muslim organization providing community services and relief across the U.S. ICNA Relief focuses on:
✅ Disaster relief
✅ Hunger prevention
✅ Refugee assistance
✅ Free medical services
✅ Social support programs

Mosques often partner with ICNA to distribute donations and provide aid. By developing an Inventory Management System, we aim to:

• 🏛 Help mosques efficiently track and manage donations, supplies, and requests.
• 🔄 Ensure transparency in inventory distribution.
• 📊 Improve accessibility for volunteers and administrators.
• 🚀 Minimize logistical challenges and maximize impact.

Our system will make operations more efficient, transparent, and accessible, ensuring donations reach those in need without delays.

---

🚀 About the App

The Inventory Management App is a React Native and Firebase-powered system that allows organizations to track inventory, monitor stock levels, and notify users when supplies are running low.

🔑 Key Features:

✅ Authentication & User Roles

• Register with an organization
• Log in using Google authentication
• Role-based access: Volunteer, Manager

✅ Inventory Management

• Add, update, and remove stock items
• Set minimum stock thresholds with automated low-stock alerts
• Categorize and search items easily
• Predict future inventory needs using analytics

✅ Reporting & Analytics

• Generate PDF reports of inventory levels and usage
• Visual graphs & charts showing trends in stock and donation levels

✅ Smart Notifications & Alerts

• Email & SMS notifications when stock runs low
• Notify specific users/groups based on role and responsibility

✅ Collaboration & Community Engagement

• Community forum for volunteers & managers
• Track donations and integrate with inventory

✅ Extra Features

• Upload & manage CSV/Excel files
• Dark mode for better accessibility
• Cross-platform support (Web & Mobile)

---

🛠️ Tech Stack

Frontend: React Native (TypeScript)
Backend: Firebase, PostgreSQL
Project Management: Trello

---

🏗️ Project Structure & Contribution

📂 Repository Structure

/inventory-management-app
│── /frontend          # React Native (TypeScript) code
│── /backend           # Firebase & PostgreSQL setup
│── /docs              # Documentation and reports
│── /assets            # Images and icons
│── README.md          # Project Overview
│── .gitignore         # Ignored files
│── package.json       # Dependencies
│── app.json           # Expo configuration

🔥 Git Workflow

1️⃣ Clone the repository:

git clone https://github.com/your-username/Inventory-Management-App.git
cd Inventory-Management-App

2️⃣ Create your branch:

git checkout -b your-branch-name

3️⃣ Make changes & commit:

git add .
git commit -m "feat: Added inventory dashboard"

4️⃣ Push changes:

git push origin your-branch-name

5️⃣ Create a Pull Request (PR) on GitHub and wait for approval.

---

🚀 Getting Started

1️⃣ Install Dependencies

npm install

2️⃣ Start the App

npm start

3️⃣ Backend Setup

• Firebase setup guide in /docs/firebase-setup.md

---

📌 Development Guidelines

✔ Write clear and descriptive commit messages
✔ Follow the branch structure (feature/authentication, fix/low-stock-alerts)
✔ Document new features in the /docs folder
✔ Review PRs before merging into main

---

👥 Team Members

• Afaq Waris
• Marissa Lubow
• Jinan Karimi
• John Distler (📧 [email protected])
• Yaroslav Petrunin

---

📌 Project Management

We use Trello to manage tasks, track progress, and ensure smooth collaboration.

🔗 Project Board: [(https://trello.com/b/QbQqMsG1)]

---

💡 Future Enhancements

🔹 AI-based demand forecasting
🔹 QR code scanning for quick inventory updates
🔹 Multi-language support

---

📞 Contact & Support

For issues, open a GitHub Issue or reach out to the team.

---

🎯 Empowering Communities with Smarter Inventory Management 🚀