@@ -14,8 +14,12 @@
     1. Import the include() function: from django.urls import include, path
     2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
 """
+from django.conf import settings
 from django.contrib import admin
 from django.http import JsonResponse
+from django.urls import path, include, re_path
+from django.views.static import serve as static_serve
+
 from django.urls import path, include
 from django.views.generic import TemplateView #임시
 
@@ -41,4 +45,14 @@ def login_placeholder(request):
     path('allnight_mode/', TemplateView.as_view(template_name='allnight_mode.html'), name='allnight_mode'),
     path('allnight_setup/', TemplateView.as_view(template_name='allnight_setup.html'), name='allnight_setup'),
     path('', include('diary.urls')),
-]
+]
+
+if settings.DEBUG:
+    # 개발용 테스트 프론트(testpages/)를 같은 origin에서 서빙 - 세션/CSRF 쿠키 공유 목적
+    urlpatterns += [
+        re_path(
+            r"^testpages/(?P<path>.*)$",
+            static_serve,
+            {"document_root": settings.BASE_DIR / "testpages"},
+        ),
+    ]
@@ -0,0 +1,28 @@
+# Generated by Django 6.0.8 on 2026-08-13 07:44
+
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('diary', '0004_alter_drink_brand'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.RemoveConstraint(
+            model_name='drink',
+            name='uniq_active_drink_per_user',
+        ),
+        migrations.AddField(
+            model_name='drink',
+            name='custom_brand_name',
+            field=models.CharField(blank=True, max_length=100),
+        ),
+        migrations.AddConstraint(
+            model_name='drink',
+            constraint=models.UniqueConstraint(condition=models.Q(('is_active', True)), fields=('user', 'brand', 'custom_brand_name', 'name', 'size'), name='uniq_active_drink_per_user'),
+        ),
+    ]
@@ -0,0 +1,18 @@
+# Generated by Django 6.0.8 on 2026-08-14 03:21
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('diary', '0005_remove_drink_uniq_active_drink_per_user_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='caffeinelog',
+            name='name',
+            field=models.CharField(blank=True, max_length=100),
+        ),
+    ]
@@ -18,6 +18,7 @@ class Drink(models.Model):
     brand = models.CharField(
         max_length=20, choices=Brand.choices, default=Brand.CUSTOM
     )
+    custom_brand_name = models.CharField(max_length=100, blank=True)  # brand=custom일 때만 사용하는 자유 입력 브랜드명
     name = models.CharField(max_length=100)
     size = models.CharField(max_length=50, blank=True)  # 브랜드별 라벨, 검증은 serializer
 
@@ -29,7 +30,7 @@ class Drink(models.Model):
     class Meta:
         constraints = [
             models.UniqueConstraint(
-                fields=["user", "brand", "name", "size"],
+                fields=["user", "brand", "custom_brand_name", "name", "size"],
                 condition=models.Q(is_active=True),
                 name="uniq_active_drink_per_user",
             )
@@ -47,6 +48,7 @@ class CaffeineLog(models.Model):
         null=True, blank=True,
         related_name="logs",
     )
+    name = models.CharField(max_length=100, blank=True)  # 스냅샷: 기록 시점 음료명(커스텀/Drink 삭제 대비)
     caffeine_mg = models.FloatField()        # 스냅샷: 기록 시점 카페인량
 
     created_at = models.DateTimeField(auto_now_add=True)
 
@@ -15,7 +15,7 @@
 from rest_framework import serializers
 
 from .constants import Brand, DrinkType
-from .models import Drink
+from .models import CaffeineLog, Drink
 from .presets import find_preset, size_labels
 
 
@@ -30,7 +30,7 @@ class DrinkSerializer(serializers.ModelSerializer):
     """
 
     type_display = serializers.CharField(source="get_type_display", read_only=True)
-    brand_display = serializers.CharField(source="get_brand_display", read_only=True)
+    brand_display = serializers.SerializerMethodField()
 
     class Meta:
         model = Drink
@@ -39,6 +39,7 @@ class Meta:
             "type",
             "type_display",
             "brand",
+            "custom_brand_name",
             "brand_display",
             "name",
             "size",
@@ -49,6 +50,19 @@ class Meta:
         ]
         read_only_fields = ["id", "is_recent", "created_at"]
 
+    def get_brand_display(self, obj):
+        """brand=custom이고 custom_brand_name이 있으면 그 값을, 아니면 choices 라벨을 보여준다.
+
+        Args:
+            obj (Drink): 직렬화 대상 인스턴스
+
+        Returns:
+            str: 화면에 보여줄 브랜드명
+        """
+        if obj.brand == Brand.CUSTOM and obj.custom_brand_name:
+            return obj.custom_brand_name
+        return obj.get_brand_display()
+
     def validate_name(self, value):
         """음료명 공백을 정리하고 빈 문자열을 거부한다.
 
@@ -105,6 +119,10 @@ def validate(self, attrs):
         brand = attrs.get("brand") or getattr(self.instance, "brand", Brand.CUSTOM)
         size = attrs.get("size", getattr(self.instance, "size", ""))
 
+        # custom이 아닌 브랜드에는 자유 입력 브랜드명이 의미가 없으므로 비워둔다.
+        if brand != Brand.CUSTOM:
+            attrs["custom_brand_name"] = ""
+
         labels = size_labels(brand)
         if not labels:
             return attrs
@@ -136,6 +154,7 @@ def create(self, validated_data):
         return _create_or_revive(
             user=user,
             brand=validated_data.get("brand", Brand.CUSTOM),
+            custom_brand_name=validated_data.get("custom_brand_name", ""),
             name=validated_data["name"],
             size=validated_data.get("size", ""),
             defaults={
@@ -226,6 +245,7 @@ def create(self, validated_data):
         return _create_or_revive(
             user=self.context["request"].user,
             brand=preset["brand"],
+            custom_brand_name="",
             name=preset["name"],
             size=preset["size"] or "",
             defaults={
@@ -250,8 +270,111 @@ def to_representation(self, instance):
         return DrinkSerializer(instance, context=self.context).data
 
 
+class CaffeineLogSerializer(serializers.ModelSerializer):
+    """카페인 섭취기록 조회/생성/수정.
+
+    두 가지 기록 방식을 하나의 스키마로 받는다.
+      - 한잔  : drink_id로 등록된 음료를 지목한다. caffeine_mg와 name은
+                서버가 해당 Drink에서 스냅샷으로 박제하며, 클라이언트가 보낸
+                값은 무시한다("스타벅스 라떼 = 5mg" 같은 위조를 막는다).
+      - 커스텀: drink_id 없이 caffeine_mg와 name을 직접 입력한다.
+
+    스냅샷 정책: 기록 이후 Drink가 수정/삭제되어도 이 로그의 값은 보존된다.
+    drink는 SET_NULL이라 연결이 끊길 수 있으므로 name도 함께 박제한다.
+
+    user는 fields에서 제외했다. 클라이언트가 보낸 값을 신뢰하면 다른 계정에
+    기록을 남길 수 있으므로, create에서 context의 request.user로만 주입한다.
+    """
+
+    drink_id = serializers.PrimaryKeyRelatedField(
+        source="drink",
+        queryset=Drink.objects.none(),  # __init__에서 요청 사용자 소유로 좁힌다
+        required=False,
+        allow_null=True,
+    )
+    caffeine_mg = serializers.FloatField(required=False)
+
+    class Meta:
+        model = CaffeineLog
+        fields = ["id", "drink_id", "name", "caffeine_mg", "created_at"]
+        read_only_fields = ["id", "created_at"]
+
+    def __init__(self, *args, **kwargs):
+        """drink_id 후보를 요청 사용자의 활성 음료로 제한한다.
+
+        queryset을 좁히면 타인 소유 drink_id는 존재하지 않는 값으로 취급되어
+        검증 단계에서 걸러진다(다른 사람 음료로 기록을 남길 수 없다).
+        """
+        super().__init__(*args, **kwargs)
+        request = self.context.get("request")
+        if request is not None and getattr(request.user, "is_authenticated", False):
+            self.fields["drink_id"].queryset = Drink.objects.filter(
+                user=request.user, is_active=True
+            )
+
+    def validate(self, attrs):
+        """한잔/커스텀을 구분해 스냅샷을 채우거나 입력값을 검증한다.
+
+        이번 요청에 drink가 지정되면 '한잔'으로 보고 서버가 caffeine_mg/name을
+        박제한다. drink가 없으면 '커스텀'이며, 생성 시에는 두 값이 필수다.
+        drink를 보내지 않는 PATCH에서는 기존 스냅샷을 임의로 다시 덮어쓰지
+        않는다(과거 기록의 caffeine_mg 불변성을 지키기 위해서다).
+
+        Args:
+            attrs (dict): 필드 단위 검증을 통과한 값들
+
+        Returns:
+            dict: 스냅샷이 채워졌거나 정리된 attrs
+
+        Raises:
+            serializers.ValidationError: 커스텀 생성에 필수값이 없거나,
+                카페인량이 범위를 벗어나거나, 이름이 공백인 경우
+        """
+        if attrs.get("drink") is not None:
+            drink = attrs["drink"]
+            attrs["caffeine_mg"] = drink.caffeine_mg
+            attrs["name"] = drink.name
+            return attrs
+
+        if self.instance is None:  # 커스텀 생성
+            if attrs.get("caffeine_mg") is None:
+                raise serializers.ValidationError(
+                    {"caffeine_mg": "카페인량을 입력해주세요."}
+                )
+            if not (attrs.get("name") or "").strip():
+                raise serializers.ValidationError({"name": "음료 이름을 입력해주세요."})
+
+        # 넘어온 값만 범위/공백 검증한다(생성·수정 공통).
+        if attrs.get("caffeine_mg") is not None and not 0 < attrs["caffeine_mg"] <= 1000:
+            raise serializers.ValidationError(
+                {"caffeine_mg": "카페인량은 1~1000mg 사이여야 합니다."}
+            )
+        if "name" in attrs:
+            name = attrs["name"].strip()
+            if not name:
+                raise serializers.ValidationError({"name": "음료 이름을 입력해주세요."})
+            attrs["name"] = name
+        return attrs
+
+    def create(self, validated_data):
+        """요청 사용자 소유로 기록을 생성하고 참조 음료를 '최근'으로 표시한다.
+
+        Args:
+            validated_data (dict): 스냅샷이 채워진 검증 결과
+
+        Returns:
+            CaffeineLog: 생성된 인스턴스
+        """
+        validated_data["user"] = self.context["request"].user
+        log = super().create(validated_data)
+        if log.drink_id and not log.drink.is_recent:
+            log.drink.is_recent = True
+            log.drink.save(update_fields=["is_recent"])
+        return log
+
+
 @transaction.atomic
-def _create_or_revive(user, brand, name, size, defaults):
+def _create_or_revive(user, brand, custom_brand_name, name, size, defaults):
     """중복 음료를 새로 만들지 않고 되살리거나 갱신한다.
 
     Drink에 걸린 UniqueConstraint는 is_active=True 조건부라서 DRF의
@@ -266,6 +389,7 @@ def _create_or_revive(user, brand, name, size, defaults):
     Args:
         user (User): 소유자
         brand (str): 브랜드 코드
+        custom_brand_name (str): brand=custom일 때의 자유 입력 브랜드명. 그 외엔 빈 문자열
         name (str): 음료명
         size (str): 사이즈 라벨. 사이즈가 없으면 빈 문자열
         defaults (dict): type, caffeine_mg, is_favorite
@@ -275,14 +399,14 @@ def _create_or_revive(user, brand, name, size, defaults):
     """
     existing = (
         Drink.objects.select_for_update()
-        .filter(user=user, brand=brand, name=name, size=size)
+        .filter(user=user, brand=brand, custom_brand_name=custom_brand_name, name=name, size=size)
         .order_by("-is_active", "-created_at")
         .first()
     )
 
     if existing is None:
         return Drink.objects.create(
-            user=user, brand=brand, name=name, size=size, **defaults
+            user=user, brand=brand, custom_brand_name=custom_brand_name, name=name, size=size, **defaults
         )
 
     if not existing.is_active: