Skip to content

Commit c95adb7

Browse files
committed
feat: admin_api에 통계 관련 API 구현
1 parent 99bb695 commit c95adb7

16 files changed

Lines changed: 975 additions & 1 deletion

File tree

‎app/admin_api/dashboard/__init__.py‎

Whitespace-only changes.
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# 임포트 시 차트 핸들러가 CHART_REGISTRY 에 등록됨 (순서 = 대시보드 표시 순서).
2+
from admin_api.dashboard.charts import counters, tickets, trends # noqa: F401
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
from admin_api.dashboard.params import CounterParamsSerializer, DashboardParams
2+
from admin_api.dashboard.registry import chart
3+
from django.db.models import Count, Q
4+
from shop.order.models import OrderProductRelation
5+
6+
7+
@chart(
8+
id="counter-ticket-paid-total",
9+
title="총 티켓 판매 완료 수",
10+
type="metric",
11+
params_serializer=CounterParamsSerializer,
12+
unit="건",
13+
)
14+
def _paid_total(p: DashboardParams) -> dict:
15+
return {"value": p.ticket_opr_qs().filter(status__in=OrderProductRelation.PURCHASED_STOCK_STATUS).count()}
16+
17+
18+
@chart(
19+
id="counter-ticket-refund-total",
20+
title="총 티켓 환불 수",
21+
type="metric",
22+
params_serializer=CounterParamsSerializer,
23+
unit="건",
24+
)
25+
def _refund_total(p: DashboardParams) -> dict:
26+
return {"value": p.ticket_opr_qs().filter(status=OrderProductRelation.OrderProductStatus.refunded).count()}
27+
28+
29+
@chart(
30+
id="counter-checkin-current",
31+
title="현재 체크인 수",
32+
type="metric",
33+
params_serializer=CounterParamsSerializer,
34+
unit="명",
35+
)
36+
def _checkin_current(p: DashboardParams) -> dict:
37+
return {"value": p.ticket_opr_qs().filter(status=OrderProductRelation.OrderProductStatus.used).count()}
38+
39+
40+
@chart(
41+
id="counter-checkin-remaining",
42+
title="남은 체크인 수",
43+
type="metric",
44+
params_serializer=CounterParamsSerializer,
45+
unit="명",
46+
)
47+
def _checkin_remaining(p: DashboardParams) -> dict:
48+
return {"value": p.ticket_opr_qs().filter(status=OrderProductRelation.OrderProductStatus.paid).count()}
49+
50+
51+
@chart(
52+
id="counter-checkin-rate",
53+
title="체크인율",
54+
type="metric",
55+
params_serializer=CounterParamsSerializer,
56+
unit="%",
57+
)
58+
def _checkin_rate(p: DashboardParams) -> dict:
59+
agg = p.ticket_opr_qs().aggregate(
60+
used=Count("id", filter=Q(status=OrderProductRelation.OrderProductStatus.used)),
61+
total=Count("id", filter=Q(status__in=OrderProductRelation.PURCHASED_STOCK_STATUS)),
62+
)
63+
return {"value": round(agg["used"] / agg["total"] * 100, 1) if agg["total"] else 0.0}
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
from admin_api.dashboard.params import CounterParamsSerializer, DashboardParams
2+
from admin_api.dashboard.registry import chart
3+
from django.db.models import Count, F, Q, Sum
4+
from django.db.models.functions import Coalesce
5+
from shop.order.models import OrderProductRelation
6+
7+
# 매출 금액 = 상품가 + 후원금.
8+
AMOUNT = F("price") + F("donation_price")
9+
10+
11+
@chart(
12+
id="bar-ticket-paid-count",
13+
title="티켓별 판매 수",
14+
type="bar",
15+
params_serializer=CounterParamsSerializer,
16+
unit="건",
17+
)
18+
def _paid_count(p: DashboardParams) -> dict:
19+
rows = (
20+
p.ticket_opr_qs()
21+
.filter(status__in=OrderProductRelation.PURCHASED_STOCK_STATUS)
22+
.values("product_id", "product__name")
23+
.annotate(n=Count("id"))
24+
.order_by("product__name")
25+
)
26+
return {
27+
"series": [{"key": "count", "name": "판매 수"}],
28+
"data": [{"label": r["product__name"], "values": {"count": r["n"]}} for r in rows],
29+
}
30+
31+
32+
@chart(
33+
id="bar-ticket-revenue",
34+
title="티켓별 매출액",
35+
type="bar",
36+
params_serializer=CounterParamsSerializer,
37+
unit="원",
38+
options={"value_format": ",.0f"},
39+
)
40+
def _revenue(p: DashboardParams) -> dict:
41+
rows = (
42+
p.ticket_opr_qs()
43+
.filter(status__in=OrderProductRelation.PURCHASED_OR_REFUNDED_STATUS)
44+
.values("product_id", "product__name")
45+
.annotate(
46+
gross=Coalesce(Sum(AMOUNT), 0),
47+
refund=Coalesce(Sum(AMOUNT, filter=Q(status=OrderProductRelation.OrderProductStatus.refunded)), 0),
48+
)
49+
.annotate(net=F("gross") - F("refund")) # 순매출 = 총매출 − 환불액
50+
.order_by("product__name")
51+
)
52+
return {
53+
"series": [{"key": "gross", "name": "총매출"}, {"key": "net", "name": "순매출"}],
54+
"data": [{"label": r["product__name"], "values": {"gross": r["gross"], "net": r["net"]}} for r in rows],
55+
}
Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
from __future__ import annotations
2+
3+
from collections import defaultdict
4+
5+
from admin_api.dashboard.params import (
6+
REVENUE_NET,
7+
CheckinTrendParamsSerializer,
8+
DashboardParams,
9+
RevenueTrendParamsSerializer,
10+
SalesTrendParamsSerializer,
11+
)
12+
from admin_api.dashboard.registry import chart
13+
from core.util.dateutil import period_label, period_label_range
14+
from django.db.models import Min, OuterRef, Subquery
15+
from shop.order.models import OrderProductRelation
16+
from shop.payment_history.models import PaymentHistory
17+
18+
19+
def first_paid_at_subquery() -> Subquery:
20+
"""OPR 의 주문에 대한 첫 PaymentHistory.created_at (판매 시각). OPR 컨텍스트용(OuterRef order_id)."""
21+
return Subquery(
22+
PaymentHistory.objects.filter_active()
23+
.filter(order_id=OuterRef("order_id"))
24+
.order_by("created_at")
25+
.values("created_at")[:1]
26+
)
27+
28+
29+
def assemble_product_series(agg: dict[tuple[str, object], object], names: dict[object, str], p) -> dict:
30+
"""{(label, product_id): value} + {product_id: name} → series + 연속 data(빈 버킷 0)."""
31+
series = [{"key": str(pid), "name": name} for pid, name in names.items()]
32+
data = []
33+
for label in period_label_range(p.date_from, p.date_to, p.granularity):
34+
values = {str(pid): agg.get((label, pid), 0) for pid in names}
35+
data.append({"label": label, "values": values})
36+
return {"series": series, "data": data}
37+
38+
39+
def checkin_counts_by_label(p) -> dict[str, int]:
40+
"""현재 used 인 티켓 OPR 의 '최초 used 전이' 시각(history)을 주기별로 집계. {label: count}."""
41+
historical = OrderProductRelation.history.model
42+
target_ids = (
43+
p.ticket_opr_qs().filter(status=OrderProductRelation.OrderProductStatus.used).values_list("id", flat=True)
44+
)
45+
rows = (
46+
historical.objects.filter(id__in=target_ids, status=OrderProductRelation.OrderProductStatus.used)
47+
.values("id")
48+
.annotate(checked_at=Min("history_date"))
49+
.filter(checked_at__gte=p.date_from, checked_at__lt=p.date_to)
50+
)
51+
counts: dict[str, int] = defaultdict(int)
52+
for row in rows:
53+
counts[period_label(row["checked_at"], p.granularity)] += 1
54+
return counts
55+
56+
57+
@chart(
58+
id="line-sales-trend",
59+
title="판매 추이",
60+
type="line",
61+
params_serializer=SalesTrendParamsSerializer,
62+
unit="건",
63+
)
64+
def _sales_trend(p: DashboardParams) -> dict:
65+
rows = (
66+
p.ticket_opr_qs()
67+
.filter(status__in=OrderProductRelation.PURCHASED_STOCK_STATUS)
68+
.annotate(paid_at=first_paid_at_subquery())
69+
.filter(paid_at__gte=p.date_from, paid_at__lt=p.date_to)
70+
.values_list("product_id", "product__name", "paid_at")
71+
)
72+
agg: dict[tuple[str, object], int] = defaultdict(int)
73+
names: dict[object, str] = {}
74+
for pid, name, paid_at in rows:
75+
names.setdefault(pid, name)
76+
agg[(period_label(paid_at, p.granularity), pid)] += 1
77+
return assemble_product_series(agg, names, p)
78+
79+
80+
@chart(
81+
id="line-revenue-trend",
82+
title="매출 추이",
83+
type="line",
84+
params_serializer=RevenueTrendParamsSerializer,
85+
unit="원",
86+
options={"value_format": ",.0f"},
87+
)
88+
def _revenue_trend(p: DashboardParams) -> dict:
89+
# 순매출 = 환불 제외(paid+used). 총매출 = 환불 포함 결제총액. (판매 시각 기준 — 환불 시점은 미반영)
90+
statuses = (
91+
OrderProductRelation.PURCHASED_STOCK_STATUS
92+
if p.revenue_type == REVENUE_NET
93+
else OrderProductRelation.PURCHASED_OR_REFUNDED_STATUS
94+
)
95+
rows = (
96+
p.ticket_opr_qs()
97+
.filter(status__in=statuses)
98+
.annotate(paid_at=first_paid_at_subquery())
99+
.filter(paid_at__gte=p.date_from, paid_at__lt=p.date_to)
100+
.values_list("product_id", "product__name", "price", "donation_price", "paid_at")
101+
)
102+
agg: dict[tuple[str, object], int] = defaultdict(int)
103+
names: dict[object, str] = {}
104+
for pid, name, price, donation, paid_at in rows:
105+
names.setdefault(pid, name)
106+
agg[(period_label(paid_at, p.granularity), pid)] += price + donation
107+
return assemble_product_series(agg, names, p)
108+
109+
110+
@chart(
111+
id="line-checkin-trend", title="체크인 추이", type="line", params_serializer=CheckinTrendParamsSerializer, unit="명"
112+
)
113+
def _checkin_trend(p: DashboardParams) -> dict:
114+
counts = checkin_counts_by_label(p)
115+
data = [
116+
{"label": label, "values": {"checkin": counts.get(label, 0)}}
117+
for label in period_label_range(p.date_from, p.date_to, p.granularity)
118+
]
119+
return {"series": [{"key": "checkin", "name": "체크인 수"}], "data": data}
120+
121+
122+
@chart(
123+
id="line-checkin-rate-trend",
124+
title="체크인율 추이",
125+
type="line",
126+
params_serializer=CheckinTrendParamsSerializer,
127+
unit="%",
128+
)
129+
def _checkin_rate_trend(p: DashboardParams) -> dict:
130+
counts = checkin_counts_by_label(p)
131+
total = p.ticket_opr_qs().filter(status__in=OrderProductRelation.PURCHASED_STOCK_STATUS).count()
132+
data = []
133+
cumulative = 0
134+
for label in period_label_range(p.date_from, p.date_to, p.granularity):
135+
cumulative += counts.get(label, 0)
136+
pct = round(cumulative / total * 100, 1) if total else 0.0
137+
data.append({"label": label, "values": {"rate": pct}})
138+
return {"series": [{"key": "rate", "name": "체크인율"}], "data": data}

‎app/admin_api/dashboard/params.py‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
from __future__ import annotations
2+
3+
from dataclasses import dataclass
4+
from datetime import datetime
5+
from uuid import UUID
6+
7+
from core.const.datetime import Granularity
8+
from core.serializer.date_range_serializer import DateRangeSerializer
9+
from django.db.models import QuerySet
10+
from rest_framework import serializers
11+
from shop.order.models import OrderProductRelation
12+
13+
REVENUE_GROSS, REVENUE_NET = "gross", "net"
14+
15+
16+
# --- 동적 옵션 마커 필드 (옵션은 정의 빌드 시 DB 에서 주입) ---
17+
class _TicketIdsField(serializers.ListField):
18+
dynamic_options = "tickets" # 정의 introspection 이 읽는 마커
19+
20+
def __init__(self, **kwargs: object) -> None:
21+
kwargs.setdefault("child", serializers.UUIDField()) # Product.id (UUID)
22+
kwargs.setdefault("required", False)
23+
kwargs.setdefault("label", "티켓")
24+
super().__init__(**kwargs)
25+
26+
27+
class _EventIdField(serializers.UUIDField):
28+
param_type = "select"
29+
dynamic_options = "events"
30+
31+
def __init__(self, **kwargs: object) -> None:
32+
kwargs.setdefault("required", False)
33+
kwargs.setdefault("allow_null", True)
34+
kwargs.setdefault("label", "이벤트")
35+
super().__init__(**kwargs)
36+
37+
38+
# --- shape 별 params serializer (검증 + 정의 역생성의 단일 소스) ---
39+
class CounterParamsSerializer(serializers.Serializer):
40+
event_id = _EventIdField()
41+
ticket_ids = _TicketIdsField()
42+
43+
44+
class _TimeSeriesParamsSerializer(CounterParamsSerializer):
45+
date_range = DateRangeSerializer(required=True, label="조회 기간")
46+
47+
48+
class SalesTrendParamsSerializer(_TimeSeriesParamsSerializer):
49+
granularity = serializers.ChoiceField(
50+
choices=[(g.value, g.label) for g in (Granularity.DAY, Granularity.WEEK, Granularity.MONTH)],
51+
default=Granularity.DAY.value,
52+
label="집계 단위",
53+
)
54+
55+
56+
class RevenueTrendParamsSerializer(SalesTrendParamsSerializer):
57+
revenue_type = serializers.ChoiceField(
58+
choices=[(REVENUE_GROSS, "총매출"), (REVENUE_NET, "순매출")],
59+
default=REVENUE_GROSS,
60+
label="매출 종류",
61+
)
62+
63+
64+
class CheckinTrendParamsSerializer(_TimeSeriesParamsSerializer):
65+
granularity = serializers.ChoiceField(
66+
choices=[(g.value, g.label) for g in (Granularity.HOUR, Granularity.DAY)],
67+
default=Granularity.HOUR.value,
68+
label="집계 단위",
69+
)
70+
71+
72+
@dataclass(frozen=True)
73+
class DashboardParams:
74+
date_from: datetime | None = None
75+
date_to: datetime | None = None
76+
granularity: str | None = None
77+
event_id: UUID | None = None
78+
ticket_ids: tuple[UUID, ...] = ()
79+
revenue_type: str = REVENUE_GROSS
80+
81+
@classmethod
82+
def from_validated(cls, data: dict) -> DashboardParams:
83+
date_range = data.get("date_range") or {}
84+
return cls(
85+
date_from=date_range.get("date_from"),
86+
date_to=date_range.get("date_to"),
87+
granularity=data.get("granularity"),
88+
event_id=data.get("event_id") or None,
89+
ticket_ids=tuple(data.get("ticket_ids") or ()),
90+
revenue_type=data.get("revenue_type") or REVENUE_GROSS,
91+
)
92+
93+
def ticket_opr_qs(self) -> QuerySet[OrderProductRelation]:
94+
qs = OrderProductRelation.objects.filter_active().filter(product__category__is_ticket=True)
95+
if self.event_id:
96+
qs = qs.filter(product__category__event_id=self.event_id)
97+
if self.ticket_ids:
98+
qs = qs.filter(product_id__in=self.ticket_ids)
99+
return qs

0 commit comments

Comments
 (0)