chore: restructured project

This commit is contained in:
ITQ
2025-03-07 19:32:09 +03:00
parent bfb7ad901a
commit 0a35951c62
178 changed files with 304 additions and 376 deletions
+120
View File
@@ -0,0 +1,120 @@
from django.contrib import admin
from django.http import HttpRequest
from apps.campaign.forms import CampaignForm, CampaignReportForm
from apps.campaign.models import (
Campaign,
CampaignClick,
CampaignImpression,
CampaignReport,
)
class CampaignAdmin(admin.ModelAdmin):
form = CampaignForm
readonly_fields = (
Campaign.id.field.name,
Campaign.advertiser.field.name,
)
fields = (
Campaign.id.field.name,
Campaign.advertiser.field.name,
Campaign.impressions_limit.field.name,
Campaign.clicks_limit.field.name,
Campaign.cost_per_impression.field.name,
Campaign.cost_per_click.field.name,
Campaign.ad_title.field.name,
Campaign.ad_text.field.name,
Campaign.ad_image.field.name,
Campaign.start_date.field.name,
Campaign.end_date.field.name,
Campaign.gender.field.name,
Campaign.age_from.field.name,
Campaign.age_to.field.name,
Campaign.location.field.name,
)
def has_add_permission(
self, request: HttpRequest, obj: Campaign = None
) -> bool:
return False
class CampaignImpressionAdmin(admin.ModelAdmin):
readonly_fields = (
CampaignImpression.id.field.name,
CampaignImpression.campaign.field.name,
CampaignImpression.client.field.name,
CampaignImpression.date.field.name,
)
fields = (
CampaignImpression.id.field.name,
CampaignImpression.campaign.field.name,
CampaignImpression.client.field.name,
CampaignImpression.date.field.name,
CampaignImpression.price.field.name,
)
def has_add_permission(
self, request: HttpRequest, obj: CampaignImpression = None
) -> bool:
return False
class CampaignClickAdmin(admin.ModelAdmin):
readonly_fields = (
CampaignClick.id.field.name,
CampaignClick.campaign.field.name,
CampaignClick.client.field.name,
CampaignClick.date.field.name,
)
fields = (
CampaignClick.id.field.name,
CampaignClick.campaign.field.name,
CampaignClick.client.field.name,
CampaignClick.date.field.name,
CampaignClick.price.field.name,
)
def has_add_permission(
self, request: HttpRequest, obj: CampaignClick = None
) -> bool:
return False
class CampaignReportAdmin(admin.ModelAdmin):
form = CampaignReportForm
readonly_fields = (
CampaignReport.id.field.name,
CampaignReport.campaign.field.name,
CampaignReport.client.field.name,
CampaignReport.message.field.name,
CampaignReport.flagged_by_llm.field.name,
)
fields = (
CampaignReport.id.field.name,
CampaignReport.campaign.field.name,
CampaignReport.client.field.name,
CampaignReport.state.field.name,
CampaignReport.message.field.name,
CampaignReport.flagged_by_llm.field.name,
)
list_filter = (
CampaignReport.state.field.name,
CampaignReport.flagged_by_llm.field.name,
)
list_display = (
"__str__",
CampaignReport.flagged_by_llm.field.name,
)
def has_add_permission(
self, request: HttpRequest, obj: CampaignReport = None
) -> bool:
return False
admin.site.register(Campaign, CampaignAdmin)
admin.site.register(CampaignImpression, CampaignImpressionAdmin)
admin.site.register(CampaignClick, CampaignClickAdmin)
admin.site.register(CampaignReport, CampaignReportAdmin)
+6
View File
@@ -0,0 +1,6 @@
from django.apps import AppConfig
class CampaignConfig(AppConfig):
name = "apps.campaign"
label = "campaign"
+35
View File
@@ -0,0 +1,35 @@
from typing import Any
from django import forms
from apps.campaign.models import Campaign, CampaignReport
class CampaignForm(forms.ModelForm):
class Meta:
model = Campaign
fields = "__all__"
def clean(self) -> dict[str, Any]:
cleaned_data = super().clean()
location = cleaned_data.get("location")
if location == "":
cleaned_data["location"] = None
return cleaned_data
class CampaignReportForm(forms.ModelForm):
class Meta:
model = CampaignReport
fields = "__all__"
def clean(self) -> dict[str, Any]:
cleaned_data = super().clean()
message = cleaned_data.get("message")
if message == "":
cleaned_data["message"] = None
return cleaned_data
@@ -0,0 +1,35 @@
from typing import Any
from django.core.management.base import BaseCommand
from apps.campaign.models import Campaign
from apps.mlscore.models import Mlscore
class Command(BaseCommand):
help = (
"Initialize cache with current counts of "
"impressions, clicks, and ML scores."
)
def handle(self, *args: Any, **kwargs: Any) -> None:
for campaign in Campaign.objects.all():
campaign.setup_cache()
self.stdout.write(
self.style.SUCCESS(
f"Initialized cache for Campaign {campaign.id}: "
f"{campaign.impressions_count} impressions, "
f"{campaign.clicks_count} clicks."
)
)
for mlscore in Mlscore.objects.all():
mlscore.setup_cache()
self.stdout.write(
self.style.SUCCESS(
f"Initialized cache for MLscore: "
f"Client {mlscore.client_id}, "
f"Advertiser {mlscore.advertiser_id}, "
f"Score {mlscore.score}."
)
)
@@ -0,0 +1,84 @@
# Generated by Django 5.1.6 on 2025-02-21 03:50
import apps.campaign.models
import django.core.validators
import django.db.models.deletion
import uuid
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
('advertiser', '0001_initial'),
('client', '0001_initial'),
]
operations = [
migrations.CreateModel(
name='Campaign',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('impressions_limit', models.PositiveBigIntegerField()),
('clicks_limit', models.PositiveBigIntegerField()),
('cost_per_impression', models.FloatField(validators=[django.core.validators.MinValueValidator(0)])),
('cost_per_click', models.FloatField(validators=[django.core.validators.MinValueValidator(0)])),
('ad_title', models.TextField()),
('ad_text', models.TextField()),
('ad_image', models.ImageField(blank=True, max_length=256, null=True, upload_to=apps.campaign.models.Campaign.ad_image_directory_path)),
('start_date', models.PositiveIntegerField(db_index=True)),
('end_date', models.PositiveIntegerField(db_index=True)),
('gender', models.CharField(blank=True, choices=[('MALE', 'MALE'), ('FEMALE', 'FEMALE'), ('ALL', 'ALL')], db_index=True, max_length=6, null=True)),
('age_from', models.PositiveSmallIntegerField(blank=True, db_index=True, null=True, validators=[django.core.validators.MaxValueValidator(100)])),
('age_to', models.PositiveSmallIntegerField(blank=True, db_index=True, null=True, validators=[django.core.validators.MaxValueValidator(100)])),
('location', models.TextField(blank=True, db_index=True, null=True, validators=[django.core.validators.MinLengthValidator(1)])),
('advertiser', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='campaigns', to='advertiser.advertiser')),
],
options={
'abstract': False,
},
),
migrations.CreateModel(
name='CampaignClick',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('price', models.FloatField()),
('date', models.PositiveIntegerField(db_index=True)),
('campaign', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='clicks', to='campaign.campaign')),
('client', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='clicks', to='client.client')),
],
options={
'unique_together': {('campaign', 'client')},
},
),
migrations.CreateModel(
name='CampaignImpression',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('price', models.FloatField()),
('date', models.PositiveIntegerField(db_index=True)),
('campaign', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='impressions', to='campaign.campaign')),
('client', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='impressions', to='client.client')),
],
options={
'unique_together': {('campaign', 'client')},
},
),
migrations.CreateModel(
name='CampaignReport',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('state', models.CharField(choices=[('s', 'Sent'), ('r', 'Under review'), ('t', 'Took action'), ('f', 'Skipped')], default='s', max_length=1)),
('message', models.TextField(blank=True, null=True)),
('flagged_by_llm', models.BooleanField(blank=True, null=True)),
('timestamp', models.DateTimeField(auto_now_add=True)),
('campaign', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='reports', to='campaign.campaign')),
('client', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='reports', to='client.client')),
],
options={
'unique_together': {('campaign', 'client')},
},
),
]
+531
View File
@@ -0,0 +1,531 @@
import random
from decimal import ROUND_HALF_UP, Decimal
from logging import Logger
from typing import Any, Self
from uuid import UUID
from django.conf import settings
from django.core.cache import cache
from django.core.validators import (
MaxValueValidator,
MinLengthValidator,
MinValueValidator,
)
from django.db import models
from apps.advertiser.models import Advertiser
from apps.campaign.validators import (
CampaignAgeValidator,
CampaignDurationValidator,
CampaignLimitsValidator,
CampaignReportMessageValidator,
CampaignStartDateValidator,
CampaignTargetingGenderValidator,
CampaignTargetingLocationValidator,
)
from apps.client.models import Client
from apps.core.models import BaseModel
from config.errors import ConflictError, ForbiddenError
logger: Logger = settings.LOGGER
class Campaign(BaseModel):
class GenderChoices(models.TextChoices):
MALE = "MALE", "MALE"
FEMALE = "FEMALE", "FEMALE"
ALL = "ALL", "ALL"
def ad_image_directory_path(instance, filename: str) -> str: # noqa: N805
return f"campaigns/{instance.id}/{filename}"
advertiser = models.ForeignKey(
Advertiser,
on_delete=models.CASCADE,
related_name="campaigns",
)
impressions_limit = models.PositiveBigIntegerField()
clicks_limit = models.PositiveBigIntegerField()
cost_per_impression = models.FloatField(validators=[MinValueValidator(0)])
cost_per_click = models.FloatField(validators=[MinValueValidator(0)])
ad_title = models.TextField()
ad_text = models.TextField()
ad_image = models.ImageField(
max_length=256,
blank=True,
null=True,
upload_to=ad_image_directory_path,
)
start_date = models.PositiveIntegerField(db_index=True)
end_date = models.PositiveIntegerField(db_index=True)
gender = models.CharField(
max_length=6,
blank=True,
null=True,
db_index=True,
choices=GenderChoices,
)
age_from = models.PositiveSmallIntegerField(
blank=True,
null=True,
db_index=True,
validators=[MaxValueValidator(100)],
)
age_to = models.PositiveSmallIntegerField(
blank=True,
null=True,
db_index=True,
validators=[MaxValueValidator(100)],
)
location = models.TextField(
blank=True,
null=True,
db_index=True,
validators=[MinLengthValidator(1)],
)
READONLY_AFTER_START_FIELDS = (
"impressions_limit",
"clicks_limit",
"start_date",
"end_date",
)
def __str__(self) -> str:
return self.ad_title
def clean(self) -> None:
CampaignTargetingGenderValidator()(self)
CampaignTargetingLocationValidator()(self)
CampaignAgeValidator()(self)
CampaignDurationValidator()(self)
CampaignLimitsValidator()(self)
CampaignStartDateValidator()(self)
def save(self, *args: Any, **kwargs: Any) -> None:
created = self.pk is None
super().save(*args, **kwargs)
if created:
self.setup_cache()
def setup_cache(self) -> None:
cache.add(
f"campaign_{self.id}_impressions_count", self.impressions.count()
)
cache.add(f"campaign_{self.id}_clicks_count", self.clicks.count())
cache.set(
f"campaign_{self.id}_impressions_count", self.impressions.count()
)
cache.set(f"campaign_{self.id}_clicks_count", self.clicks.count())
def inc_views(self) -> None:
try:
cache.incr(f"campaign_{self.id}_impressions_count", 1)
except ValueError:
self.setup_cache()
logger.warning("Seems that %s missing caches", self.campaign_id)
def inc_clicks(self) -> None:
try:
cache.incr(f"campaign_{self.id}_clicks_count", 1)
except ValueError:
self.setup_cache()
logger.warning("Seems that %s missing caches", self.campaign_id)
@property
def ad_id(self) -> UUID:
return self.id
@property
def campaign_id(self) -> UUID:
return self.id
@campaign_id.setter
def campaign_id(self, value: UUID) -> None:
self.id = value
@property
def started(self) -> bool:
return isinstance(
self.start_date, int
) and self.start_date <= cache.get("current_date", default=0)
@property
def active(self) -> bool:
return (
self.started
and cache.get("current_date", default=0) <= self.end_date
)
@property
def impressions_count(self) -> int:
return cache.get(f"campaign_{self.id}_impressions_count", 0)
@property
def clicks_count(self) -> int:
return cache.get(f"campaign_{self.id}_clicks_count", 0)
def view(self, client: Client) -> None:
try:
CampaignImpression.objects.create(
campaign_id=self.id,
client_id=client.id,
price=self.cost_per_impression,
date=cache.get("current_date", default=0),
)
self.inc_views()
except ConflictError:
pass
def click(self, client: Client) -> None:
try:
CampaignImpression.objects.get(campaign=self, client=client)
except CampaignImpression.DoesNotExist:
raise ForbiddenError from None
try:
CampaignClick.objects.create(
campaign_id=self.id,
client_id=client.id,
price=self.cost_per_click,
date=cache.get("current_date", default=0),
)
self.inc_clicks()
except ConflictError:
pass
def get_statistics(self) -> dict[str, Any]:
impressions = self.impressions.aggregate(
total=models.Count("id"), spent=models.Sum("price")
)
clicks = self.clicks.aggregate(
total=models.Count("id"), spent=models.Sum("price")
)
return self._calculate_metrics(impressions, clicks)
def get_daily_statistics(self) -> list[dict[str, Any]]:
last_click_date = self.clicks.aggregate(last_date=models.Max("date"))[
"last_date"
]
if not last_click_date:
last_click_date = self.end_date
current_day = cache.get("current_date", 0)
start_day = self.start_date
end_day = min(last_click_date, current_day)
days_range = list(range(start_day, end_day + 1))
impressions = self.impressions.values("date").annotate(
total=models.Count("id"),
spent=models.Sum("price", default=0.0),
)
clicks = self.clicks.values("date").annotate(
total=models.Count("id"),
spent=models.Sum("price", default=0.0),
)
imp_map = {imp["date"]: imp for imp in impressions}
clk_map = {clk["date"]: clk for clk in clicks}
daily_stats = []
for day in days_range:
imp = imp_map.get(day, {"total": 0, "spent": 0})
clk = clk_map.get(day, {"total": 0, "spent": 0})
metrics = self._calculate_metrics(imp, clk)
metrics["date"] = day
daily_stats.append(metrics)
daily_stats.sort(key=lambda x: x["date"])
return daily_stats
@staticmethod
def _calculate_metrics(
impressions: dict[str, Any], clicks: dict[str, Any]
) -> dict[str, Any]:
impressions_count = impressions.get("total", 0) or 0
clicks_count = clicks.get("total", 0) or 0
conversion = (
(
Decimal(str(clicks_count))
/ Decimal(str(impressions_count))
* Decimal("100")
)
if impressions_count > 0
else Decimal("0")
)
spent_impressions = Decimal(str(impressions.get("spent", 0) or 0))
spent_clicks = Decimal(str(clicks.get("spent", 0) or 0))
spent_total = spent_impressions + spent_clicks
return {
"impressions_count": impressions_count,
"clicks_count": clicks_count,
"conversion": float(
conversion.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
),
"spent_impressions": float(
spent_impressions.quantize(
Decimal("0.000000001"), rounding=ROUND_HALF_UP
)
),
"spent_clicks": float(
spent_clicks.quantize(
Decimal("0.000000001"), rounding=ROUND_HALF_UP
)
),
"spent_total": float(
spent_total.quantize(
Decimal("0.000000001"), rounding=ROUND_HALF_UP
)
),
}
@classmethod
def get_available_campaigns(
cls, client: Client
) -> models.manager.BaseManager[Self]:
current_date = cache.get("current_date", default=0)
date_filter = models.Q(start_date__lte=current_date) & models.Q(
end_date__gte=current_date
)
location_filter = models.Q(location__isnull=True) | models.Q(
location=client.location
)
gender_filter = (
models.Q(gender__isnull=True)
| models.Q(gender=cls.GenderChoices.ALL)
| models.Q(gender=client.gender)
)
age_filter = (
models.Q(age_from__lte=client.age)
| models.Q(age_from__isnull=True)
) & (models.Q(age_to__gte=client.age) | models.Q(age_to__isnull=True))
return cls.objects.filter(
date_filter,
location_filter,
gender_filter,
age_filter,
).only(
Campaign.id.field.name,
Campaign.advertiser_id.field.name,
Campaign.impressions_limit.field.name,
Campaign.clicks_limit.field.name,
Campaign.cost_per_impression.field.name,
Campaign.cost_per_click.field.name,
)
@classmethod
def suggest(cls, client: Client) -> Self:
campaigns = cls.get_available_campaigns(client)
if not campaigns or campaigns == []:
return None
campaign_ids = [c.id for c in campaigns]
client_impressions = CampaignImpression.objects.filter(
client=client, campaign_id__in=campaign_ids
).values_list("campaign_id", flat=True)
client_clicks = CampaignClick.objects.filter(
client=client, campaign_id__in=campaign_ids
).values_list("campaign_id", flat=True)
prioritized = []
ml_values = []
profit_values = []
exceed_impressions_chance = ( # oh, can i just skip commenting this?
*(0 for i in range(3)),
*(1 for i in range(1)),
)
for campaign in campaigns:
has_impression = campaign.id in client_impressions
has_click = campaign.id in client_clicks
campaign_impressions_count = campaign.impressions_count
if not has_impression:
allow_exceed_impressions = random.choice(
exceed_impressions_chance
)
impressions_limit = round(
campaign.impressions_limit
+ campaign.impressions_limit
* 0.1
* allow_exceed_impressions
)
if campaign_impressions_count >= impressions_limit:
continue
ml_score = cache.get(
f"mlscore_{client.id}_{campaign.advertiser_id}", 0
)
ml_values.append(ml_score)
if has_impression:
profit = campaign.cost_per_click if not has_click else 0
else:
profit = campaign.cost_per_impression + campaign.cost_per_click
profit_values.append(profit)
remaining_imp = (
campaign.impressions_limit - campaign_impressions_count
)
capacity_ratio = (
remaining_imp / campaign.impressions_limit
if campaign.impressions_limit > 0
else 1
)
prioritized.append(
(
campaign,
{
"profit": profit,
"ml": ml_score,
"capacity": 1 - capacity_ratio,
},
)
)
if not ml_values or not profit_values:
return None
max_ml = max(ml_values)
max_profit = max(profit_values)
min_profit = min(profit_values)
profit_range = (
max_profit - min_profit if max_profit != min_profit else 1
)
final_list = []
for campaign, metrics in prioritized:
norm_profit = (metrics["profit"] - min_profit) / profit_range
norm_ml = metrics["ml"] / max_ml if max_ml > 0 else 0
priority = (
0.8 * norm_profit + 0.4 * norm_ml + 0.05 * metrics["capacity"]
)
final_list.append((campaign, priority))
final_list.sort(key=lambda x: -x[1])
if len(final_list) != 0:
campaign = final_list[0][0]
return Campaign.objects.only(
Campaign.id.field.name,
Campaign.advertiser_id.field.name,
Campaign.ad_title.field.name,
Campaign.ad_text.field.name,
Campaign.ad_image.field.name,
Campaign.cost_per_impression.field.name,
Campaign.cost_per_click.field.name,
).get(id=campaign.id)
return None
class CampaignImpression(BaseModel):
campaign = models.ForeignKey(
Campaign,
on_delete=models.CASCADE,
related_name="impressions",
)
client = models.ForeignKey(
Client,
on_delete=models.CASCADE,
related_name="impressions",
)
price = models.FloatField()
date = models.PositiveIntegerField(db_index=True)
def __str__(self) -> str:
return f"{self.client.login} > {self.campaign.ad_title}"
class Meta:
unique_together = (
"campaign",
"client",
)
class CampaignClick(BaseModel):
campaign = models.ForeignKey(
Campaign,
on_delete=models.CASCADE,
related_name="clicks",
)
client = models.ForeignKey(
Client,
on_delete=models.CASCADE,
related_name="clicks",
)
price = models.FloatField()
date = models.PositiveIntegerField(db_index=True)
def __str__(self) -> str:
return f"{self.client.login} > {self.campaign.ad_title}"
class Meta:
unique_together = (
"campaign",
"client",
)
class CampaignReport(BaseModel):
class CampaignReportState(models.TextChoices):
SENT = "s", "Sent"
UNDER_REVIEW = "r", "Under review"
TOOK_ACTION = "t", "Took action"
SKIPPED = "f", "Skipped"
campaign = models.ForeignKey(
Campaign,
on_delete=models.SET_NULL,
related_name="reports",
blank=True,
null=True,
)
client = models.ForeignKey(
Client,
on_delete=models.SET_NULL,
related_name="reports",
blank=True,
null=True,
)
state = models.CharField(
max_length=1,
choices=CampaignReportState,
default=CampaignReportState.SENT,
)
message = models.TextField(null=True, blank=True)
flagged_by_llm = models.BooleanField(null=True, blank=True)
timestamp = models.DateTimeField(auto_now_add=True)
class Meta:
unique_together = (
"campaign",
"client",
)
def __str__(self) -> str:
login = self.client.login if self.client else "(client deleted)"
ad_title = (
self.campaign.ad_title if self.campaign else "(campaign deleted)"
)
return f"{login} > {ad_title}"
def clean(self) -> None:
CampaignReportMessageValidator()(self)
+38
View File
@@ -0,0 +1,38 @@
import contextlib
from concurrent.futures import ThreadPoolExecutor
from celery import shared_task
from apps.campaign.models import CampaignReport
from integrations.yandexai.generators.ad_text import YandexAIAdTextGenerator
from integrations.yandexai.moderation import YandexAIModerator
@shared_task
def generate_ad_text_task(advertiser_name: str, ad_title: str) -> str | None:
return YandexAIAdTextGenerator().generate_ad_text(
advertiser_name, ad_title
)
@shared_task(ignore_result=True)
def moderate_campaign_task(
report_id: int, ad_title: str, ad_text: str
) -> None:
with ThreadPoolExecutor(max_workers=2) as executor:
future_text = executor.submit(
YandexAIModerator().get_moderation_verdict, ad_text
)
future_title = executor.submit(
YandexAIModerator().get_moderation_verdict, ad_title
)
ad_text_verdict = future_text.result()
ad_title_verdict = future_title.result()
overall_verdict = ad_title_verdict or ad_text_verdict
with contextlib.suppress(CampaignReport.DoesNotExist):
report = CampaignReport.objects.get(id=report_id)
report.flagged_by_llm = overall_verdict
report.save()
@@ -0,0 +1,55 @@
from django.core.cache import cache
from django.test import TestCase, override_settings
from apps.advertiser.models import Advertiser
from apps.campaign.models import Campaign, CampaignClick
from apps.client.models import Client
from config.errors import ConflictError
class CampaignClickModelTest(TestCase):
@classmethod
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUpTestData(cls) -> None:
cache.set("current_date", 1)
cls.advertiser = Advertiser.objects.create(name="Test Advertiser")
cls.campaign = Campaign.objects.create(
advertiser=cls.advertiser,
impressions_limit=1000,
clicks_limit=500,
cost_per_impression=0.05,
cost_per_click=0.10,
ad_title="Test Campaign",
ad_text="This is a test campaign.",
start_date=1,
end_date=10,
)
cls.client_instance = Client.objects.create(
login="test_client", age=15, location="Moscow", gender="FEMALE"
)
cls.click = CampaignClick.objects.create(
campaign=cls.campaign,
client=cls.client_instance,
price=0.10,
date=1,
)
def test_campaign_click_creation(self) -> None:
self.assertIsInstance(self.click, CampaignClick)
self.assertEqual(self.click.price, 0.10)
def test_unique_together_constraint(self) -> None:
with self.assertRaises(ConflictError):
CampaignClick.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=0.10,
date=1,
)
@@ -0,0 +1,52 @@
from django.test import TestCase, override_settings
from apps.advertiser.models import Advertiser
from apps.campaign.models import Campaign, CampaignImpression
from apps.client.models import Client
from config.errors import ConflictError
class CampaignImpressionModelTest(TestCase):
@classmethod
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUpTestData(cls) -> None:
cls.advertiser = Advertiser.objects.create(name="Test Advertiser")
cls.campaign = Campaign.objects.create(
advertiser=cls.advertiser,
impressions_limit=1000,
clicks_limit=500,
cost_per_impression=0.05,
cost_per_click=0.10,
ad_title="Test Campaign",
ad_text="This is a test campaign.",
start_date=1,
end_date=10,
)
cls.client_instance = Client.objects.create(
login="test_client", age=15, location="Moscow", gender="FEMALE"
)
cls.impression = CampaignImpression.objects.create(
campaign=cls.campaign,
client=cls.client_instance,
price=0.05,
date=1,
)
def test_campaign_impression_creation(self) -> None:
self.assertIsInstance(self.impression, CampaignImpression)
self.assertEqual(self.impression.price, 0.05)
def test_unique_together_constraint(self) -> None:
with self.assertRaises(ConflictError):
CampaignImpression.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=0.05,
date=1,
)
@@ -0,0 +1,120 @@
from uuid import uuid4
from django.core.cache import cache
from django.core.exceptions import ValidationError
from django.test import TestCase, override_settings
from apps.advertiser.models import Advertiser
from apps.campaign.models import Campaign
from apps.client.models import Client
class CampaignModelTest(TestCase):
@classmethod
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUpTestData(cls) -> None:
cls.advertiser = Advertiser.objects.create(name="Test Advertiser")
cls.campaign = Campaign.objects.create(
advertiser=cls.advertiser,
impressions_limit=1000,
clicks_limit=500,
cost_per_impression=0.05,
cost_per_click=0.10,
ad_title="Test Campaign",
ad_text="This is a test campaign.",
start_date=1,
end_date=10,
)
def test_campaign_creation(self) -> None:
self.assertIsInstance(self.campaign, Campaign)
self.assertEqual(self.campaign.ad_title, "Test Campaign")
def test_campaign_str_method(self) -> None:
self.assertEqual(str(self.campaign), "Test Campaign")
def test_campaign_id_property(self) -> None:
self.assertEqual(self.campaign.campaign_id, self.campaign.id)
new_id = uuid4()
self.campaign.campaign_id = new_id
self.assertEqual(self.campaign.id, new_id)
def test_ad_id_property(self) -> None:
self.assertEqual(self.campaign.ad_id, self.campaign.id)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_started_property(self) -> None:
cache.set("current_date", 5)
self.assertTrue(self.campaign.started)
cache.set("current_date", 0)
self.assertFalse(self.campaign.started)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_active_property(self) -> None:
cache.set("current_date", 5)
self.assertTrue(self.campaign.active)
cache.set("current_date", 11)
self.assertFalse(self.campaign.active)
cache.set("current_date", 5)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_clean_method(self) -> None:
self.campaign.start_date = -1
with self.assertRaises(ValidationError):
self.campaign.clean()
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_view_method(self) -> None:
client = Client.objects.create(
login="test_client", age=15, location="Moscow", gender="FEMALE"
)
self.campaign.view(client)
self.assertEqual(self.campaign.impressions.count(), 1)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_click_method(self) -> None:
client = Client.objects.create(
login="test_client", age=15, location="Moscow", gender="FEMALE"
)
self.campaign.view(client)
self.campaign.click(client)
self.assertEqual(self.campaign.clicks.count(), 1)
@@ -0,0 +1,66 @@
from django.test import TestCase, override_settings
from apps.advertiser.models import Advertiser
from apps.campaign.models import Campaign, CampaignReport
from apps.client.models import Client
from config.errors import ConflictError
class CampaignReportModelTest(TestCase):
@classmethod
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUpTestData(cls) -> None:
cls.advertiser = Advertiser.objects.create(name="Test Advertiser")
cls.campaign = Campaign.objects.create(
advertiser=cls.advertiser,
impressions_limit=1000,
clicks_limit=500,
cost_per_impression=0.05,
cost_per_click=0.10,
ad_title="Test Campaign",
ad_text="This is a test campaign.",
start_date=1,
end_date=10,
)
cls.client_instance = Client.objects.create(
login="test_client",
age=30,
gender="MALE",
location="Test Location",
)
def test_campaign_report_creation(self) -> None:
report = CampaignReport.objects.create(
campaign=self.campaign,
client=self.client_instance,
state=CampaignReport.CampaignReportState.SENT,
message="Inappropriate content",
flagged_by_llm=True,
)
self.assertIsInstance(report, CampaignReport)
self.assertEqual(report.campaign, self.campaign)
self.assertEqual(report.client, self.client_instance)
self.assertEqual(report.state, CampaignReport.CampaignReportState.SENT)
self.assertEqual(report.message, "Inappropriate content")
self.assertTrue(report.flagged_by_llm)
def test_campaign_report_unique_together_constraint(self) -> None:
CampaignReport.objects.create(
campaign=self.campaign,
client=self.client_instance,
state=CampaignReport.CampaignReportState.SENT,
)
with self.assertRaises(ConflictError):
CampaignReport.objects.create(
campaign=self.campaign,
client=self.client_instance,
state=CampaignReport.CampaignReportState.UNDER_REVIEW,
)
@@ -0,0 +1,149 @@
from django.core.cache import cache
from django.test import TestCase, override_settings
from apps.advertiser.models import Advertiser
from apps.campaign.models import Campaign, CampaignClick, CampaignImpression
from apps.client.models import Client
class CampaignStatisticsTest(TestCase):
@classmethod
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUpTestData(cls) -> None:
cls.advertiser = Advertiser.objects.create(name="Test Advertiser")
cls.campaign = Campaign.objects.create(
advertiser=cls.advertiser,
impressions_limit=1000,
clicks_limit=500,
cost_per_impression=0.05,
cost_per_click=0.10,
ad_title="Test Campaign",
ad_text="This is a test campaign.",
start_date=1,
end_date=10,
)
cls.client_instance = Client.objects.create(
login="test_client",
age=30,
gender="MALE",
location="Test Location",
)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def setUp(self) -> None:
cache.clear()
cache.set("current_date", 5)
def test_get_statistics_no_data(self) -> None:
stats = self.campaign.get_statistics()
expected_stats = {
"impressions_count": 0,
"clicks_count": 0,
"conversion": 0,
"spent_impressions": 0,
"spent_clicks": 0,
"spent_total": 0,
}
self.assertEqual(stats, expected_stats)
def test_get_statistics_with_data(self) -> None:
CampaignImpression.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=self.campaign.cost_per_impression,
date=5,
)
CampaignClick.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=self.campaign.cost_per_click,
date=5,
)
stats = self.campaign.get_statistics()
expected_stats = {
"impressions_count": 1,
"clicks_count": 1,
"conversion": 100.0,
"spent_impressions": 0.05,
"spent_clicks": 0.10,
"spent_total": 0.15,
}
self.assertEqual(stats, expected_stats)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_get_daily_statistics_no_data(self) -> None:
daily_stats = self.campaign.get_daily_statistics()
expected_stats = [
{
"date": day,
"impressions_count": 0,
"clicks_count": 0,
"conversion": 0,
"spent_impressions": 0,
"spent_clicks": 0,
"spent_total": 0,
}
for day in range(
self.campaign.start_date, cache.get("current_date") + 1
)
]
self.assertEqual(daily_stats, expected_stats)
@override_settings(
CACHES={
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
)
def test_get_daily_statistics_with_data(self) -> None:
CampaignImpression.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=self.campaign.cost_per_impression,
date=5,
)
CampaignClick.objects.create(
campaign=self.campaign,
client=self.client_instance,
price=self.campaign.cost_per_click,
date=5,
)
daily_stats = self.campaign.get_daily_statistics()
expected_stats = [
{
"date": day,
"impressions_count": 1 if day == 5 else 0,
"clicks_count": 1 if day == 5 else 0,
"conversion": 100.0 if day == 5 else 0,
"spent_impressions": 0.05 if day == 5 else 0,
"spent_clicks": 0.10 if day == 5 else 0,
"spent_total": 0.15 if day == 5 else 0,
}
for day in range(
self.campaign.start_date, cache.get("current_date") + 1
)
]
self.assertEqual(daily_stats, expected_stats)
@@ -0,0 +1,77 @@
from typing import TYPE_CHECKING
from django.core.cache import cache
from django.core.exceptions import ValidationError
if TYPE_CHECKING:
from apps.campaign.models import Campaign, CampaignReport
class CampaignTargetingLocationValidator:
def __call__(self, instance: "Campaign") -> None:
if instance.location == "":
err = "targeting.location can't be blank."
raise ValidationError(err)
class CampaignTargetingGenderValidator:
def __call__(self, instance: "Campaign") -> None:
if instance.gender == "":
err = "gender can't be blank."
raise ValidationError(err)
class CampaignAgeValidator:
def __call__(self, instance: "Campaign") -> None:
if (
isinstance(instance.age_from, int)
and isinstance(instance.age_to, int)
and instance.age_from > instance.age_to
):
err = "targeting.age_from can't be greater than targeting.age_to."
raise ValidationError(err)
class CampaignDurationValidator:
def __call__(self, instance: "Campaign") -> None:
if (
isinstance(instance.start_date, int)
and isinstance(instance.end_date, int)
and instance.start_date > instance.end_date
):
err = "start_date can't be greater than end_date."
raise ValidationError(err)
class CampaignLimitsValidator:
def __call__(self, instance: "Campaign") -> None:
if (
isinstance(instance.impressions_limit, int)
and isinstance(instance.clicks_limit, int)
and instance.impressions_limit < instance.clicks_limit
):
err = "clicks_limit can't be greater than impressions_limit."
raise ValidationError(err)
class CampaignStartDateValidator:
def __call__(self, instance: "Campaign") -> None:
current_date = cache.get("current_date", default=0)
err = "start_date must be greater or equal than the current_date."
try:
original = type(instance).objects.get(id=instance.id or "")
if (
original.start_date != instance.start_date
and instance.start_date < current_date
):
raise ValidationError(err)
except type(instance).DoesNotExist:
if instance.start_date < current_date:
raise ValidationError(err) from None
class CampaignReportMessageValidator:
def __call__(self, instance: "CampaignReport") -> None:
if instance.message == "":
err = "message can't be blank."
raise ValidationError(err)