Emi Shop Backend

• Django Backend for Mobile Application

Setup

• Run ./run.sh (Linux) or run.bat (Windows) to skip the instructions below
• Use python3 if you are on linux for the following,
• Create a virtual environment python -m venv venv
• Activate virtual environment call venv/Scripts/activate
• Install dependencies pip install -r requirements.txt
• Migrate python manage.py migrate
• Load Categories python manage.py loaddata category_data.json
• Load User Emica Solutions python manage.py loaddata user_data.json
• Load Welcome Post python manage.py loaddata post_data.json
• Load Welcome Post Image python manage.py loaddata post_image_data.json
• Create superuser python manage.py createsuperuser
• Run application python manage.py runserver
• Optionally you can make django listen on all ips python manage.py runserver 0.0.0.0:8000

Endpoints

Recommendation System

View 775 lines of Code - Recommender

• Utilized 6 separate recommenders:
  • Item-Item Collaborative Filtering: Find items similar to the items that the user liked or interacted with.
  • User-User Collaborative Filtering: Find items that other similar users liked or interacted with.
  • User-Category Collaborative Filtering: Find sellers and their items in categories that user liked or interacted with.
  • Following: Items that are sold by the user's following.
  • New Posts: New posts in the categories user has interacted with. This recommender helps new posts get reach if seller had no previous interaction yet.
  • Category: Unlike User-Category Collaborative Filtering, this recommender searches directly for items in a category and sort by amount of interactions they have.
• Ads are personalized by:
  • Categories user has interacted with.
  • If a user is viewing a product, similar ads are shown below.
  • If a user is viewing a category, ads in that category are shown.
  • For each 10 organic posts, there are 3 ads in feed.

Routes

View Definition of Routes - urls.py | View Implementation of Routes - views.py

• There are 46 API endpoints mainly for:
  • Post details, create new post, edit post, list a profile's posts ...
  • Categories list, posts in a category, ...
  • User Interaction (liking post, following users, viewing posts and profiles), ...
  • Transactions, Payment methods, Packages, ....
  • Boost posts for more reach, bidding prices, ...
  • Authentication, firebase related, ....

Database Models

View Models

• There are 18 database models for:
  • User Details, Followers, Notifications, Recommendations
  • Post Details, Favourite Posts, Liked Posts, Post Images, Seen Posts, Ads, Categories
  • Transactions, Payment Methods, Packages,
  • Interactions (User-User, User-Category, User-Item, Category-Seller)