feat: 통계에 대한 기본 조회 기간 추가

Author: MU-Software

app/admin_api/dashboard/params.py

@@ -5,8 +5,9 @@
 from uuid import UUID
 
 from core.const.datetime import Granularity
-from core.serializer.date_range_serializer import DateRangeSerializer
+from core.serializer.date_range_serializer import DateRangeSerializer, day_start, next_day_start
 from django.db.models import QuerySet
+from event.models import Event
 from rest_framework import serializers
 from shop.order.models import OrderProductRelation
 
@@ -42,7 +43,23 @@ class CounterParamsSerializer(serializers.Serializer):
 
 
 class _TimeSeriesParamsSerializer(CounterParamsSerializer):
-    date_range = DateRangeSerializer(required=True, label="조회 기간")
+    date_range = DateRangeSerializer(required=False, label="조회 기간")
+
+    def validate(self, attrs: dict) -> dict:
+        if not attrs.get("date_range") and (event_id := attrs.get("event_id")):
+            period = (
+                Event.objects.filter_active()
+                .filter(id=event_id)
+                .values_list("stats_start_date", "stats_end_date")
+                .first()
+            )
+            if period and all(period):
+                start, end = period
+                attrs["date_range"] = {"date_from": day_start(start), "date_to": next_day_start(end)}
+        if not attrs.get("date_range"):
+            err_msg = "조회 기간을 지정하거나, 통계 기간이 설정된 이벤트를 선택하세요."
+            raise serializers.ValidationError({"date_range": err_msg})
+        return attrs
 
 
 class SalesTrendParamsSerializer(_TimeSeriesParamsSerializer):

app/admin_api/serializers/event/event.py

@@ -14,4 +14,15 @@ class Meta:
             "name_en",
             "event_start_at",
             "event_end_at",
+            "stats_start_date",
+            "stats_end_date",
         )
+
+    def validate(self, attrs: dict) -> dict:
+        merged = {**attrs}
+        for field in ("stats_start_date", "stats_end_date"):
+            merged.setdefault(field, getattr(self.instance, field, None))
+        start, end = merged["stats_start_date"], merged["stats_end_date"]
+        if start and end and start > end:
+            raise serializers.ValidationError({"stats_end_date": "통계 종료일은 시작일보다 이전일 수 없습니다."})
+        return attrs

app/admin_api/test/event/event_test.py

@@ -0,0 +1,29 @@
+from datetime import date
+
+from admin_api.serializers.event.event import EventAdminSerializer
+from model_bakery import baker
+
+
+def test_admin_serializer_exposes_stats_period_fields():
+    assert {"stats_start_date", "stats_end_date"} <= set(EventAdminSerializer().fields)
+
+
+def test_admin_serializer_accepts_valid_stats_period(db):
+    event = baker.make("event.Event")
+    serializer = EventAdminSerializer(
+        instance=event,
+        data={"stats_start_date": "2026-08-14", "stats_end_date": "2026-08-16"},
+        partial=True,
+    )
+    assert serializer.is_valid(), serializer.errors
+
+
+def test_admin_serializer_rejects_inverted_stats_period(db):
+    event = baker.make("event.Event", stats_start_date=date(2026, 8, 1))
+    serializer = EventAdminSerializer(
+        instance=event,
+        data={"stats_start_date": "2026-08-16", "stats_end_date": "2026-08-14"},
+        partial=True,
+    )
+    assert not serializer.is_valid()
+    assert "stats_end_date" in serializer.errors

app/admin_api/test/shop/dashboard_test.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import date, datetime
 
 import pytest
 from core.const.datetime import KST
@@ -197,6 +197,51 @@ def test_sales_trend_missing_date_range_is_400(api_client):
     assert "date_range" in {e["attr"] for e in resp.json()["errors"]}
 
 
+# --- 이벤트별 통계 기간 프리셋 ---
+def _attach_event(ticket_product, **stats):
+    event = baker.make("event.Event", name="파이콘 한국 2026", **stats)
+    ticket_product.category.event = event
+    ticket_product.category.save()
+    return event
+
+
+def test_time_series_defaults_to_event_stats_period(api_client, ticket_product):
+    """date_range 미전송 + 통계 기간이 설정된 이벤트 선택 → 그 기간(inclusive)을 기본값으로 사용."""
+    event = _attach_event(ticket_product, stats_start_date=date(2026, 8, 14), stats_end_date=date(2026, 8, 16))
+    body = _chart_data(api_client, "line-sales-trend", {"event_id": str(event.id), "granularity": "day"}).json()
+    assert [d["label"] for d in body["data"]] == ["2026-08-14", "2026-08-15", "2026-08-16"]
+
+
+def test_explicit_date_range_overrides_event_preset(api_client, ticket_product):
+    event = _attach_event(ticket_product, stats_start_date=date(2026, 8, 1), stats_end_date=date(2026, 8, 31))
+    body = _chart_data(
+        api_client,
+        "line-sales-trend",
+        {
+            "event_id": str(event.id),
+            "date_range": {"date_from": "2026-08-14", "date_to": "2026-08-15"},
+            "granularity": "day",
+        },
+    ).json()
+    assert [d["label"] for d in body["data"]] == ["2026-08-14", "2026-08-15"]
+
+
+def test_event_without_stats_period_still_requires_date_range(api_client, ticket_product):
+    event = _attach_event(ticket_product)  # 통계 기간 미설정
+    resp = _chart_data(api_client, "line-sales-trend", {"event_id": str(event.id), "granularity": "day"})
+    assert resp.status_code == status.HTTP_400_BAD_REQUEST
+    assert "date_range" in {e["attr"] for e in resp.json()["errors"]}
+
+
+def test_event_option_carries_stats_period(api_client, ticket_product):
+    """프론트 프리필용: event 옵션이 통계 기본 기간을 동봉."""
+    event = _attach_event(ticket_product, stats_start_date=date(2026, 8, 14), stats_end_date=date(2026, 8, 16))
+    params = next(c for c in api_client.get(CHARTS_URL).json() if c["id"] == "line-sales-trend")["params"]
+    opt = next(o for p in params if p["key"] == "event_id" for o in p["options"] if o["value"] == str(event.id))
+    assert opt["date_from"] == "2026-08-14"
+    assert opt["date_to"] == "2026-08-16"
+
+
 def test_sales_trend_invalid_granularity_is_400(api_client):
     resp = _chart_data(
         api_client,

app/admin_api/views/dashboard.py

@@ -35,17 +35,31 @@ def list(self, request: Request) -> Response:
             .order_by("category__priority", "name")
             .values("id", "name", "category__event_id")  # event_id: 프론트의 이벤트→티켓 종속 필터용
         )
-        es = Event.objects.filter_active().filter(category__is_ticket=True).distinct().order_by("name")
+        es = (
+            Event.objects.filter_active()
+            .filter(category__is_ticket=True)
+            .values("id", "name", "stats_start_date", "stats_end_date")
+            .distinct()
+            .order_by("name")
+        )
         dynamic_options = {
             "tickets": [
                 {
                     "value": str(t["id"]),
                     "label": t["name"],
-                    "event_id": str(t["category__event_id"]) if t["category__event_id"] else None,
+                    "event_id": t["category__event_id"] and str(t["category__event_id"]),
                 }
                 for t in ts
             ],
-            "events": [{"value": str(e.id), "label": e.name} for e in es],
+            "events": [
+                {
+                    "value": str(e["id"]),
+                    "label": e["name"],
+                    "date_from": e["stats_start_date"] and e["stats_start_date"].isoformat(),
+                    "date_to": e["stats_end_date"] and e["stats_end_date"].isoformat(),
+                }
+                for e in es
+            ],
         }
         return Response([handler.to_dict(dynamic_options) for handler in CHART_REGISTRY.values()])
 

app/core/serializer/date_range_serializer.py

@@ -4,15 +4,25 @@
 from rest_framework import serializers
 
 
+def day_start(value: date) -> datetime:
+    """해당 날짜의 KST 자정 — 구간 포함 하한."""
+    return datetime.combine(value, time.min, tzinfo=KST)
+
+
+def next_day_start(value: date) -> datetime:
+    """다음 날의 KST 자정 — 종료일 포함을 위한 반열린 상한(exclusive)."""
+    return datetime.combine(value + timedelta(days=1), time.min, tzinfo=KST)
+
+
 class DateRangeSerializer(serializers.Serializer):
     date_from = serializers.DateField()
     date_to = serializers.DateField()
 
     def validate_date_from(self, value: date) -> datetime:
-        return datetime.combine(value, time.min, tzinfo=KST)
+        return day_start(value)
 
     def validate_date_to(self, value: date) -> datetime:
-        return datetime.combine(value + timedelta(days=1), time.min, tzinfo=KST)
+        return next_day_start(value)
 
     def validate(self, attrs: dict) -> dict:
         # date_to 는 exclusive end 로 +1d 보정된 값 — 정상 구간이면 from < to.

app/event/migrations/0005_event_stats_end_date_event_stats_start_date_and_more.py

@@ -0,0 +1,27 @@
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [("event", "0004_remove_event_uq__evt__name_name_ko_and_more")]
+    operations = [
+        migrations.AddField(
+            model_name="event",
+            name="stats_end_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="event",
+            name="stats_start_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="historicalevent",
+            name="stats_end_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="historicalevent",
+            name="stats_start_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+    ]

app/event/models.py

@@ -14,6 +14,8 @@ class Event(BaseAbstractModel):
     event_end_at = models.DateTimeField(null=True, blank=True)
     banner_display_start_at = models.DateTimeField(null=True, blank=True)
     banner_display_end_at = models.DateTimeField(null=True, blank=True)
+    stats_start_date = models.DateField(null=True, blank=True)
+    stats_end_date = models.DateField(null=True, blank=True)
 
     class Meta:
         ordering = ["-event_start_at", "-event_end_at"]
@@ -34,3 +36,5 @@ def clean(self) -> None:
             and self.banner_display_start_at > self.banner_display_end_at
         ):
             raise ValidationError("banner 전시 종료 날짜는 시작 날짜보다 이전일 수 없습니다.")
+        if self.stats_start_date and self.stats_end_date and self.stats_start_date > self.stats_end_date:
+            raise ValidationError("통계 종료일은 시작일보다 이전일 수 없습니다.")