Feat/create ambassadors app (#14)

Создано приложение ambassadors, добавлена большая часть необходимых
моделей, созданы вспомогательные файлы constants.py и validators.py

crm_yandex/ambassadors/admin.py

@@ -0,0 +1,16 @@
+from django.contrib import admin
+
+from ambassadors.models import (Activity, Ambassador, AmbassadorActivity,
+                                AmbassadorPreference, Content, MerchOnShipping,
+                                MerchShipment, Preference, Venue)
+
+
+admin.site.register(Activity)
+admin.site.register(Ambassador)
+admin.site.register(AmbassadorActivity)
+admin.site.register(AmbassadorPreference)
+admin.site.register(Content)
+admin.site.register(MerchOnShipping)
+admin.site.register(MerchShipment)
+admin.site.register(Preference)
+admin.site.register(Venue)

crm_yandex/ambassadors/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class AmbassadorsConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "ambassadors"

crm_yandex/ambassadors/constants.py

@@ -0,0 +1,65 @@
+STATUS_MAX_LEN: int = 50
+NAME_MAX_LEN: int = 100
+SIZE_MAX_LEN: int = 10
+GOAL_MAX_LEN: int = 255
+DECIMAL_MAX_DIGITS: int = 10
+DECIMAL_PLACES: int = 2
+AMBASSADOR_STATUS_CHOICES = [
+    ('active', 'Активный'),
+    ('paused', 'На паузе'),
+    ('left', 'Ушёл'),
+    ('pending', 'Уточняется'),
+]
+GUIDE_STATUS_CHOICES = [
+    ('not_completed', 'Не пройден'),
+    ('partially_completed', 'Пройдена 1 часть гайда'),
+    ('completed', 'Полностью пройден'),
+]
+SEX_CHOICES = [
+    ('М', 'Мужчина'),
+    ('Ж', 'Женщина')
+]
+SEX_MAX_LEN: int = 1
+COURSE_CHOICES = [
+        ('analyst', 'Аналитик данных'),
+        ('data_scientist', 'Специалист по Data Science'),
+        ('python_dev', 'Python-разработчик'),
+        ('web_dev', 'Веб-разработчик'),
+        ('qa_engineer', 'Инженер по тестированию(QA)'),
+        ('ux_ui_designer', 'UX/UI-дизайнер'),
+        ('marketing', 'Маркетинг'),
+        ('graphic_designer', 'Графический дизайнер'),
+        ('middle_python', 'Middle Python'),
+        ('c_plus_plus', 'C++'),
+        ('data_engineer', 'Инженер данных'),
+        ('it_recruiter', 'IT-рекрутер'),
+        ('management', 'Управление'),
+        ('english', 'Английский'),
+        ('critical_thinking', 'Критическое мышление'),
+        ('business_communication', 'Рабочая коммуникация'),
+        ('developer_algorithms', 'Алгоритмы для разработчиков'),
+        ('product_design', 'Продуктовый дизайн'),
+        ('sql_data_analytics', 'SQL для работы с данными и аналитики'),
+        ('java_dev', 'Java-разработчик'),
+        ('commercial_illustrator', 'Коммерческий иллюстратор'),
+        ('fullstack_dev', 'Фулстек разработчик'),
+        ('advanced_go_dev', 'Продвинутый GO-разработчик'),
+        ('devops', 'DevOps для эксплуатации и разработки'),
+        ('ios_dev', 'IOS-разработчик'),
+        ('business_analyst', 'Бизнес-аналитик'),
+        ('product_manager_exp', 'Продакт-менеджер для специалистов с опытом'),
+        ('android_dev', 'Андроид-разработчик'),
+        ('project_manager', 'Менеджер проектов'),
+    ]
+PHONE_NUM_MAX_LEN: int = 20
+CLOTHING_SIZE_CHOICES = [
+    ('xs', 'XS'),
+    ('s', 'S'),
+    ('m', 'M'),
+    ('l', 'L'),
+    ('xl', 'XL'),
+]
+CLOTHING_SIZE_MAX_LEN: int = 2
+PROMOCODE_MAX_LEN: int = 20
+PREFERENCE_MAX_LEN: int = 255
+TELEGRAM_MAX_LEN: int = 32

crm_yandex/ambassadors/models.py

@@ -0,0 +1,305 @@
+from django.db import models
+
+from ambassadors.constants import (AMBASSADOR_STATUS_CHOICES,
+                                   CLOTHING_SIZE_CHOICES,
+                                   CLOTHING_SIZE_MAX_LEN, COURSE_CHOICES,
+                                   DECIMAL_MAX_DIGITS, DECIMAL_PLACES,
+                                   GOAL_MAX_LEN, NAME_MAX_LEN,
+                                   PHONE_NUM_MAX_LEN, PREFERENCE_MAX_LEN,
+                                   PROMOCODE_MAX_LEN, SEX_CHOICES, SEX_MAX_LEN,
+                                   STATUS_MAX_LEN, TELEGRAM_MAX_LEN)
+from ambassadors.validators import (POSTAL_CODE_VALIDATOR,
+                                    TELEGRAM_USERNAME_VALIDATOR)
+
+
+class Activity(models.Model):
+    name = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Действие"
+    )
+
+    class Meta:
+        verbose_name = "Действие в рамках амбассадорства"
+        verbose_name_plural = "Действия в рамках амбассадорства"
+        ordering = ["name"]
+
+    def __str__(self):
+        return self.name
+
+
+class Preference(models.Model):
+    name = models.CharField(
+        max_length=PREFERENCE_MAX_LEN,
+        verbose_name="Предпочтение"
+    )
+
+    class Meta:
+        verbose_name = "Предпочтение в рамкха амбассадорства"
+        verbose_name_plural = "Предпочтения в рамкха амбассадорства"
+        ordering = ["name"]
+
+    def __str__(self):
+        return self.name
+
+
+class Ambassador(models.Model):
+    fio = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Фамилия Имя Отчество"
+    )
+    sex = models.CharField(
+        max_length=SEX_MAX_LEN,
+        choices=SEX_CHOICES,
+        verbose_name="Пол амбассадора"
+    )
+    course = models.CharField(
+        max_length=NAME_MAX_LEN,
+        choices=COURSE_CHOICES,
+        verbose_name="Программа обучения"
+    )
+    country = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Страна",
+    )
+    city = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Город",
+    )
+    address = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Адрес проживания"
+    )
+    postal_code = models.PositiveIntegerField(
+        verbose_name="Почтовый индекс",
+        validators=(POSTAL_CODE_VALIDATOR,)
+    )
+    email = models.EmailField(verbose_name="Электронная почта")
+    phone_number = models.CharField(
+        max_length=PHONE_NUM_MAX_LEN,
+        verbose_name="Номер телефона"
+    )
+    telegram = models.CharField(
+        max_length=TELEGRAM_MAX_LEN,
+        verbose_name="Телеграм",
+        validators=(TELEGRAM_USERNAME_VALIDATOR,)
+    )
+    education = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Образование"
+    )
+    job = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Текущая работа"
+    )
+    goal = models.CharField(
+        max_length=GOAL_MAX_LEN,
+        verbose_name="Цель в Практикуме"
+    )
+    activities = models.ManyToManyField(
+        Activity,
+        through="AmbassadorActivity",
+        verbose_name="Амбассадорские действия",
+        related_name="ambassadors",
+        through_fields=("ambassador", "activity")
+    )
+    blog_link = models.URLField(verbose_name="Ссылка на блог")
+    clothing_size = models.CharField(
+        max_length=CLOTHING_SIZE_MAX_LEN,
+        choices=CLOTHING_SIZE_CHOICES,
+        verbose_name="Размер одежды"
+    )
+    foot_size = models.PositiveSmallIntegerField(
+        verbose_name="Размер ноги"
+    )
+    comment = models.TextField(
+        verbose_name="Комментарий"
+    )
+    registration_date = models.DateField(verbose_name="Дата регистрации")
+    promocode = models.CharField(
+        max_length=PROMOCODE_MAX_LEN,
+        verbose_name="Промокод"
+    )
+    status = models.CharField(
+        max_length=STATUS_MAX_LEN,
+        choices=AMBASSADOR_STATUS_CHOICES,
+        verbose_name="Статус амбассадора"
+    )
+    preferences = models.ManyToManyField(
+        Preference,
+        through="AmbassadorPreference",
+        verbose_name="Предпочтения амбассадора",
+        related_name="ambassadors",
+        through_fields=("ambassador", "preference")
+    )
+    guide_one = models.BooleanField(verbose_name="Гайд 1")
+    guide_two = models.BooleanField(verbose_name="Гайд 2")
+    onboarding = models.BooleanField(verbose_name="Онбординг")
+
+    class Meta:
+        verbose_name = "Амбассадор"
+        verbose_name_plural = "Амбассадоры"
+        ordering = ["-registration_date"]
+
+    def __str__(self):
+        return self.fio
+
+
+class AmbassadorPreference(models.Model):
+    ambassador = models.ForeignKey(
+        Ambassador,
+        on_delete=models.CASCADE,
+        related_name="ambassador_preferences",
+        verbose_name="ID амбассадора"
+    )
+    preference = models.ForeignKey(
+        Preference,
+        on_delete=models.CASCADE,
+        related_name="ambassador_preferences",
+        verbose_name="ID предпочтения"
+    )
+
+    class Meta:
+        verbose_name = "Амбассадор-Предпочтение"
+        verbose_name_plural = "Амбассадор-Предпочтения"
+
+    def __str__(self):
+        return f"{self.ambassador} - {self.preference}"
+
+
+class AmbassadorActivity(models.Model):
+    ambassador = models.ForeignKey(
+        Ambassador,
+        on_delete=models.CASCADE,
+        related_name="ambassador_activities",
+        verbose_name="ID амбассадора"
+    )
+    activity = models.ForeignKey(
+        Activity,
+        on_delete=models.CASCADE,
+        related_name="ambassador_activities",
+        verbose_name="ID действия"
+    )
+
+    class Meta:
+        verbose_name = "Амбассадор-Действие"
+        verbose_name_plural = "Амбассадор-Действия"
+
+    def __str__(self):
+        return f"{self.ambassador} - {self.activity}"
+
+
+class Merch(models.Model):
+    merch_type = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Мерч"
+    )
+    cost = models.DecimalField(
+        max_digits=DECIMAL_MAX_DIGITS,
+        decimal_places=DECIMAL_PLACES,
+        verbose_name="Стоимость"
+    )
+
+    class Meta:
+        verbose_name = "Мерч"
+        verbose_name_plural = "Мерчи"
+        ordering = ["merch_type"]
+
+    def __str__(self):
+        return f"{self.merch_type} - {self.cost}"
+
+
+class MerchShipment(models.Model):
+    curator = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Куратор"
+    )
+    ambassador = models.ForeignKey(
+        Ambassador,
+        on_delete=models.CASCADE,
+        related_name="merch_shipments",
+        verbose_name="ID амбассадора"
+    )
+    date = models.DateField()
+    merches = models.ManyToManyField(
+        Merch,
+        through="MerchOnShipping",
+        verbose_name="Амбассадорские действия",
+        related_name="merch_shipments",
+        through_fields=("shipping", "merch")
+    )
+    comment = models.TextField(
+        verbose_name="Комментарий"
+    )
+
+    class Meta:
+        verbose_name = "Отправка мерча"
+        verbose_name_plural = "Отправки мерча"
+        ordering = ["-date"]
+
+    def __str__(self):
+        return f"Ambassador ID: {self.ambassador.id} - {self.date}"
+
+
+class MerchOnShipping(models.Model):
+    shipping = models.ForeignKey(
+        MerchShipment,
+        on_delete=models.CASCADE,
+        related_name="merches_on_shipping",
+        verbose_name="ID отправки"
+    )
+    merch = models.ForeignKey(
+        Merch,
+        on_delete=models.CASCADE,
+        related_name="merches_on_shipping",
+        verbose_name="Мерч"
+    )
+
+    class Meta:
+        verbose_name = "Мерч в отправке"
+        verbose_name_plural = "Мерч в отправке"
+
+    def __str__(self):
+        return f"{self.shipping} - {self.merch}"
+
+
+class Venue(models.Model):
+    name = models.CharField(
+        max_length=NAME_MAX_LEN,
+        verbose_name="Название площадки"
+    )
+
+    class Meta:
+        verbose_name = "Площадка"
+        verbose_name_plural = "Площадки"
+        ordering = ["name"]
+
+    def __str__(self):
+        return self.name
+
+
+class Content(models.Model):
+    ambassador = models.ForeignKey(
+        Ambassador,
+        on_delete=models.CASCADE,
+        related_name="content",
+        verbose_name="Амбассадор"
+    )
+    link = models.URLField()
+    venue = models.ForeignKey(
+        Venue,
+        on_delete=models.CASCADE,
+        related_name="content",
+        verbose_name="Площадка"
+    )
+    date = models.DateField()
+    guide_followed = models.BooleanField(verbose_name="По гайду да/нет")
+
+    class Meta:
+        verbose_name = "Контент амбассадора"
+        verbose_name_plural = "Контент амбассадора"
+        ordering = ["-date"]
+
+    def __str__(self):
+        return (
+            f"Амбассадор: {self.ambassador} {self.link}"
+        )