What is the best way to handle different but similar models hierarchy in Django?

Viewed 176

What is the deal: I'm crating a site where different types of objects will be evaluated, like restaurants, beautysalons, car services (and much more).

At the beginning I start with one app with with Polymorfic Model:

models.py:

from django.db import models
from users.models import ProfileUser
from django.utils import timezone
from polymorphic.models import PolymorphicModel

class Object(PolymorphicModel):
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    title = models.CharField(max_length=300)
    city = models.ForeignKey(City, on_delete=models.CASCADE)
    address = models.CharField(max_length=300)
    phone = models.CharField(max_length=20, default='')
    email = models.CharField(max_length=100, default='')
    site = models.CharField(max_length=100, default='')
    facebook = models.CharField(max_length=100, default='')
    instagram = models.CharField(max_length=100, default='')
    content = models.TextField()
    rating = models.DecimalField(default=10.0, max_digits=5, decimal_places=2)
    created_date = models.DateTimeField(default=timezone.now)
    approved_object = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)

    def __str__(self):
        return f"{self.title}"


class Restaurant(Object):
    seats = models.IntegerField()
    bulgarian_kitchen = models.BooleanField(default=False)
    italian_kitchen = models.BooleanField(default=False)
    french_kitchen = models.BooleanField(default=False)
    sea_food = models.BooleanField(default=False)
    is_cash = models.BooleanField(default=False)
    is_bank_card = models.BooleanField(default=False)
    is_wi_fi = models.BooleanField(default=False)
    category_en_name = models.CharField(max_length=100, default='restaurants')
    category_bg_name = models.CharField(max_length=100, default='Ресторанти')
    bg_name = models.CharField(max_length=100, default='Ресторант')
    is_garden = models.BooleanField(default=False)
    is_playground = models.BooleanField(default=False)


class SportFitness(Object):
    is_fitness_trainer = models.BooleanField(default=False)
    category_en_name = models.CharField(max_length=100, default='sportfitness')
    category_bg_name = models.CharField(max_length=100, default='Спорт и фитнес')
    bg_name = models.CharField(max_length=100, default='Спорт и фитнес')


class CarService(Object):
    is_parts_clients = models.BooleanField(default=False)
    category_en_name = models.CharField(max_length=100, default='carservice')
    category_bg_name = models.CharField(max_length=100, default='Автосервизи')
    bg_name = models.CharField(max_length=100, default='Автосервиз')

class Comment(models.Model):
    object = models.ForeignKey(Object, on_delete=models.CASCADE, related_name='comments')
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    content = models.TextField()
    rating = models.TextField()
    approved_object = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)
    created_date = models.DateTimeField(default=timezone.now)

    def __str__(self):
        return f"{self.content}"


class Images(models.Model):
    object = models.ForeignKey(Object, default=None, on_delete=models.CASCADE)
    image = models.ImageField(upload_to='attachments',
                              verbose_name='Image')

class ObjectCoordinates(models.Model):
    object = models.ForeignKey(Object, on_delete=models.CASCADE, related_name='coordinates')
    latitude = models.CharField(max_length=60)
    longitude = models.CharField(max_length=60)

Don't mention that name Object is wrong, I already know that :)

So all logic about different objects was in one App and this start to cause some problems, like:

views.py:

def show_object(request, category, pk, page_num):
    categories = {'restaurants' : 'Restaurant', 'sportfitness' : 'SportFitness', 'carservice' : 'CarService'} # probably this is not good way to do it
    obj = apps.get_model('objects', categories[category]).objects.get(id=pk)

def show_all_objects(request, category, page_num, city=None):
    params_map = {
        'restaurants': Restaurant,
        'sportfitness': SportFitness,
        'carservice': CarService,
    }

    objects = Object.objects.instance_of(params_map.get(category))

and other problems in templates (a lot of if-else blocks) etc.

So I decide to change whole structure and put every model in different app, so now I have app:restaurants, app:sportfitness, app:carservices, etc. But it begin to cause some problems, again, like this model:

class ObjectCoordinates(models.Model):
    object = models.ForeignKey(Object, on_delete=models.CASCADE, related_name='coordinates')
    latitude = models.CharField(max_length=60)
    longitude = models.CharField(max_length=60)

All of objects (restaurants, car services) has coordinates of map, so I'm not sure how to handle it, with Model ObjectCoordinates . If I create ObjectCoordinates for each of them, respectively a table in BD (then I will have some tables with different names but same structure, which is not very good, because except ObjectCoordinates, models share and other common models like Images and others, so at the end I will have a lot of tables with different names and same structure). Probably I should add one more column for object category, if I got two rows with same id of objects?

Probably change ObjectCoordinates and other common models to ManyToMany relation will prevent identical tables, but I'm not quite sure about that. Other problem is that there is a lot of repeated code (in views, templates). Also, now, I don't know how to get all objects (restaurants, car services) when they do not have common point, like Object model in first scenario with Polymorphic Model. Or I should keep different apps but to create common Model for all objects, and all of them to to inherit it.

Questions:

  1. What structure is better, first one or second one?
  2. What is the best wayt to implement such site (model structure)?
  3. Should I create common point (model) for all models who they will inherit?

Here is my third attempt (notice that Object is renamed to Venue):

from django.db import models
from users.models import ProfileUser
from django.utils import timezone
from polymorphic.models import PolymorphicModel

# Create your models here.

class City(models.Model):
    name = models.CharField(max_length=20)

    def __str__(self):
        return f"{self.name}"

class Category(models.Model):
    name = models.CharField(max_length=20)
    bg_name = models.CharField(max_length=20, default=None)
    category_bg_name = models.CharField(max_length=100, default=None)

    def __str__(self):
        return f"{self.name}"

class Venue(models.Model):
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    title = models.CharField(max_length=300)
    city = models.ForeignKey(City, on_delete=models.CASCADE)
    address = models.CharField(max_length=300)
    phone = models.CharField(max_length=20, default='')
    email = models.CharField(max_length=100, default='')
    site = models.CharField(max_length=100, default='')
    facebook = models.CharField(max_length=100, default='')
    instagram = models.CharField(max_length=100, default='')
    content = models.TextField()
    rating = models.DecimalField(default=10.0, max_digits=5, decimal_places=2)
    created_date = models.DateTimeField(default=timezone.now)
    approved_venue = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)
    venue_category = models.ForeignKey(Category, on_delete=models.CASCADE, related_name='category')

    def __str__(self):
        return f"{self.title}"


class VenueFeatures:
    seats = models.IntegerField()
    bulgarian_kitchen = models.BooleanField(default=False)
    italian_kitchen = models.BooleanField(default=False)
    french_kitchen = models.BooleanField(default=False)
    sea_food = models.BooleanField(default=False)
    is_cash = models.BooleanField(default=False)
    is_bank_card = models.BooleanField(default=False)
    is_wi_fi = models.BooleanField(default=False)
    is_garden = models.BooleanField(default=False)
    is_playground = models.BooleanField(default=False)
    is_fitness_trainer = models.BooleanField(default=False)
    is_parts_clients = models.BooleanField(default=False)
    is_hair_salon = models.BooleanField(default=False)
    is_laser_epilation = models.BooleanField(default=False)
    is_pizza = models.BooleanField(default=False)
    is_duner = models.BooleanField(default=False)
    is_seats = models.BooleanField(default=False)
    is_external_cleaning = models.BooleanField(default=False)
    is_internal_cleaning = models.BooleanField(default=False)
    is_engine_cleaning = models.BooleanField(default=False)
    is_working_weekend = models.BooleanField(default=False)
    is_kids_suitable = models.BooleanField(default=False)
    is_working_weekend = models.BooleanField(default=False)
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE, related_name='venue')

class Comment(models.Model):
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE, related_name='comments')
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    content = models.TextField()
    rating = models.TextField()
    approved_venue = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)
    created_date = models.DateTimeField(default=timezone.now)

    def __str__(self):
        return f"{self.content}"


class Images(models.Model):
    venue = models.ForeignKey(Venue, default=None, on_delete=models.CASCADE)
    image = models.ImageField(upload_to='attachments',
                              verbose_name='Image')

class VenueCoordinates(models.Model):
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE, related_name='coordinates')
    latitude = models.CharField(max_length=60)
    longitude = models.CharField(max_length=60)

Now I do not now how to use Venue with VenueFeatures

Notice that features are just true/false values (checkboxes in form).

2 Answers

Okay, this is probably the best way to abstract anything as much as I can:

from django.db import models
from users.models import ProfileUser
from django.utils import timezone
from polymorphic.models import PolymorphicModel

# Create your models here.

class City(models.Model):
    name = models.CharField(max_length=20)

    def __str__(self):
        return f"{self.name}"

class Category(models.Model):
    name = models.CharField(max_length=20)
    bg_name = models.CharField(max_length=20, default=None)
    category_bg_name = models.CharField(max_length=100, default=None)
    icon = models.CharField(max_length=40, default=None)

    def __str__(self):
        return f"{self.name}"

class Venue(models.Model):
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    title = models.CharField(max_length=300)
    city = models.ForeignKey(City, on_delete=models.CASCADE)
    address = models.CharField(max_length=300)
    phone = models.CharField(max_length=20, default='')
    email = models.CharField(max_length=100, default='')
    site = models.CharField(max_length=100, default='')
    facebook = models.CharField(max_length=100, default='')
    instagram = models.CharField(max_length=100, default='')
    content = models.TextField()
    rating = models.DecimalField(default=10.0, max_digits=5, decimal_places=2)
    created_date = models.DateTimeField(default=timezone.now)
    approved_venue = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)
    category = models.ForeignKey(Category, on_delete=models.CASCADE)

    def __str__(self):
        return f"{self.title}"


class Feature(models.Model):
    name = models.CharField(max_length=100)
    code = models.CharField(max_length=100  )
    category = models.ForeignKey(Category, on_delete=models.CASCADE)
    type = models.CharField(max_length=100)

    def __str__(self):
        return f"{self.name}"

class VenueFeatures(models.Model): # ManyToMany Venues <-> Features
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE)
    feature = models.ForeignKey(Feature, on_delete=models.CASCADE)
    value = models.CharField(max_length=255)

class Comment(models.Model):
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE, related_name='comments')
    author = models.ForeignKey(ProfileUser, on_delete=models.CASCADE)
    content = models.TextField()
    rating = models.TextField()
    approved_venue = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)
    created_date = models.DateTimeField(default=timezone.now)

    def __str__(self):
        return f"{self.content}"


class Images(models.Model):
    venue = models.ForeignKey(Venue, default=None, on_delete=models.CASCADE)
    image = models.ImageField(upload_to='attachments',
                              verbose_name='Image')

class VenueCoordinates(models.Model):
    venue = models.ForeignKey(Venue, on_delete=models.CASCADE, related_name='coordinates')
    latitude = models.CharField(max_length=60)
    longitude = models.CharField(max_length=60)

Now Features are bound with Categories

Also Venues are ManyToMany with Features

I have already linked it to business logic and it works fine.

TL;DR Use a JSONField (JSONB automatically I think) in PostgreSQL WITHOUT a GIN index for your VenueFeatures instead of creating an entirely new model. Postgres has come a long way towards NoSQL/unstructured DB and it's really good. Using a JSONField in your Venue model would work really well. At the very bottom, I talk about how I would design your site's db.

Although I hate saying this, but this could be the job of a NoSQL database. Usually every application uses RDBM which is structured, but you are using unstructured attributes. You could try using PostgreSQL's JSONB field but... stuffing everything into one field would be tiresome for the GIN index + caching.

For now, I'll ignore a lot of weird practices such as needing to partition a couple of attributes, max_length for char field is typically 255 length for all databases, making sure the most accessed tables don't have too many attributes so that caching is better (i.e. you don't have to invalidate your cache every time a user updates your table), GeoDjango for your coordinate system with the standard Mercator projection system on Postgres Geography mode, and you could use sets instead of dicts (sets are iterables and use {} but nothing is repeated)...


Stay away from this option: For one, I NEVER recommend MongoDB, but it could be useful for you... so long as your application doesn't grow too large as in a couple million records could break your system.

The other RECOMMENDED option is PostgreSQL's JSONB or Django's JSONField withOUT a GIN index (I strongly recommend you don't index this field since venues could change them sooo often to the point that REINDEXING and caching would burn your server and slow your app). It can be useful to store a venue's "Features" inside of this JSONB field since everything is super unstructured.

Lowering the number of attributes is better. You've got A LOT of them too which could slow down querying. I recommend you use Django-cachalot for caching since they support JSONField which can avoid your issue of having a LOT of attributes.


Other recommendations in general

Instead of using default='', just do blank=True, null=True since you're basically saying the user doesn't have to fill out the email field.

Kind of like how you would have a user profile instead of stuffing ALL of your attributes inside of the main User model, you want to partition your Venue data into different models.


The way I would've designed this:

Since you originally had these three venues, just make the "Categories" table into choices.

from django.contrib.gis.db import models  # This also imports standard models
from django.contrib.postgres.fields import JSONField  # Remember to turn on GeoDjango with PostgreSQL's PostGIS extension
from django.contrib.postgres.indexes import BrinIndex

class Venue(models.Model):
    id = models.BigAutoField(primary_key=True)
    title = models.CharField(max_length=255)
    rating = models.DecimalField(default=10.0, max_digits=5, decimal_places=2)
    created_date = models.DateTimeField(default=timezone.now)
    approved_venue = models.BooleanField(default=False)
    admin_seen = models.BooleanField(default=False)

    VENUE_TYPES = [
        (1, "restaurant"),
        (2, "concert"),
        (3, "art night")
    ]
    category = SmallPositiveIntegerField(choices=VENUE_TYPES)
    location = models.PointField(srid=4326) # mercator projection from GeoDjango. You don't have to use this; you can stick to your old city and address thing

    class Meta:
        indexes = (
            BrinIndex(fields=['category']),  # this is in case you have a LOT of categories later on.
        )

class VenueProfile(models.Model):
    venue = models.OneToOneField(Venue, on_delete=models.CASCADE, primary_key=True)
    misc_features = JSONField()  # This field is for stuff like your restaurant features OR your concert features. You can put whatever you want in there. Just make sure you have a list of features that people have when trying to access the JSON so you don't run into exceptions.
    created_date = models.DateTimeField(auto_now_add=True)
    facebook = models.CharField(max_length=100, blank=True, null=True)
    instagram = models.CharField(max_length=100, blank=True, null=True)
    city = models.ForeignKey(City, on_delete=models.SET_NULL, null=True)  # SET_NULL in case you accidentally delete a city. You don't want to also delete the venue.
    image = models.ImageField(upload_to='attachments',
                              verbose_name='Image')
    # These attributes are universal for ANY venue so that's why they don't need to be in the JSONField

    """
    For the rest of the features, I have no concern EXCEPT for city. Because you're using GeoDjango, you should also use MaxMind's free city database to determine location based on coordinates. That way, you've essentially scraped the need to store the user and such. You could probably save the address field since it could make things easier that a simple coordinate. It's really up to you. You could also use both!
    """

The attributes I've added to the Venue model are THE MOST important things in my opinion that a user would immediately want to know about.

The VenueFeature model is something that isn't updated that much. It's PRIME for using Django-cachalot to take over since it's not modified that often. (50 modifications per second makes invalidation of caches per modification a big hassle).

Comments model is fine.

Related