Short Introduction

Masbastestore is a web-based platform designed to empower Sari-Sari store owners by providing digital visibility and analytics for their businesses. Customers can easily find nearby stores, explore products, generate PDFs of selected items, and receive personalized recommendations—all from an intuitive map-based interface.

---

Technologies Used

• Backend: Python, Django
• Frontend: JavaScript, HTML, CSS
• Databases: PostgreSQL, MySQL, SQLite
• Deployment & OS: Linux, PythonAnywhere
• Libraries / Tools: ReportLab (PDF generation), Leaflet (interactive maps)

---

Process on How I Built It

1. Requirement Analysis: Understanding needs of store owners and customers.
2. Database Design: Created models for Users, Stores, Products, Reviews, Transactions, Analytics.
3. Backend Development: Implemented REST APIs and user authentication with Django.
4. Frontend Development: Developed UI with HTML, CSS, and JavaScript; integrated Leaflet for mapping.
5. PDF Generation: Implemented ReportLab to export selected products.
6. Analytics & POS: Added mini-point-of-sale system and sales analytics dashboard.
7. Testing & Deployment: Tested on Linux environment and deployed via PythonAnywhere.

---

What I Learned

• Advanced Django model relationships and query optimizations.
• How to integrate maps using Leaflet for real-time store visualization.
• Generating structured PDFs dynamically with ReportLab.
• Handling multiple databases (PostgreSQL, MySQL, SQLite) and deployment challenges.
• UX considerations for both store owners and customers in web apps.

---

Overall Growth

This project helped me strengthen full-stack web development skills and exposed me to real-world challenges like data handling, deployment, and user experience design. I also improved my problem-solving and project planning skills.

---

How It Can Be Improved

• Add a mobile app version for easier access by store owners.
• Integrate real-time notifications for customers and store updates.
• Implement machine learning for personalized recommendations.
• Enhance analytics dashboard with more visualizations and insights.

---

Running the Project

1. Clone the repository:

git clone https://github.com/astigPree/masbatestore_original.git

2. Navigate to the project folder:

cd masbatestore_original

3. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

4. Install dependencies:

pip install -r requirements.txt

5. Apply migrations:

python manage.py migrate

6. Run the development server:

python manage.py runserver

7. Open http://127.0.0.1:8000 in your browser.

---

Video Demonstration Of Guest User

0307.2.mp4