new migrations in apps.epic & apps.lyric apps; new Token fields of latter articulate upon Room model helper fns of former; new FTs, ITs & UTs capture new behavior accordingly; new template partial content in templates/apps/gameboard

src/apps/epic/migrations/0002_alter_room_renewal_period.py

@@ -0,0 +1,19 @@
+# Generated by Django 6.0 on 2026-03-13 20:32
+
+import datetime
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('epic', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='room',
+            name='renewal_period',
+            field=models.DurationField(blank=True, default=datetime.timedelta(days=7), null=True),
+        ),
+    ]

src/apps/epic/models.py

@@ -1,9 +1,13 @@
 import uuid
 
+from datetime import timedelta
 from django.db import models
 from django.db.models.signals import post_save
 from django.dispatch import receiver
 from django.conf import settings
+from django.utils import timezone
+
+from apps.lyric.models import Token
 
 
 class Room(models.Model):
@@ -32,7 +36,7 @@ class Room(models.Model):
     )
     visibility = models.CharField(max_length=20, choices=VISIBILITY_CHOICES, default=PRIVATE)
     gate_status = models.CharField(max_length=20, choices=GATE_STATUS_CHOICES, default=GATHERING)
-    renewal_period = models.DurationField(null=True, blank=True)
+    renewal_period = models.DurationField(null=True, blank=True, default=timedelta(days=7))
     created_at = models.DateTimeField(auto_now_add=True)
     board_state = models.JSONField(default=dict)
     seed_count = models.IntegerField(default=12)
@@ -67,3 +71,16 @@ def create_gate_slots(sender, instance, created, **kwargs):
     if created:
         for i in range(1, 7):
             GateSlot.objects.create(room=instance, slot_number=i)
+
+
+def debit_token(user, slot, token):
+    if token.token_type == Token.COIN:
+        token.current_room = slot.room
+        token.next_ready_at = timezone.now() + slot.room.renewal_period
+        token.save()
+    else:
+        token.delete()
+    slot.gamer = user
+    slot.status = GateSlot.FILLED
+    slot.filled_at = timezone.now()
+    slot.save()

src/apps/epic/tests/integrated/test_models.py

@@ -1,7 +1,9 @@
+from datetime import timedelta
 from django.test import TestCase
+from django.urls import reverse
 
-from apps.lyric.models import User
-from apps.epic.models import Room, GateSlot
+from apps.lyric.models import Token, User
+from apps.epic.models import Room, GateSlot, debit_token
 
 
 class RoomCreationTest(TestCase):
@@ -9,3 +11,54 @@ class RoomCreationTest(TestCase):
         owner = User.objects.create(email="founder@example.com")
         room = Room.objects.create(name="Test Room", owner=owner)
         self.assertEqual(GateSlot.objects.filter(room=room).count(), 6)
+
+
+class DebitTokenTest(TestCase):
+    def setUp(self):
+        self.owner = User.objects.create(email="founder@example.com")
+        self.room = Room.objects.create(
+            name="Test Room",
+            owner=self.owner,
+            renewal_period=timedelta(days=7)
+        )
+        self.slot = self.room.gate_slots.get(slot_number=1)
+
+    def test_debit_free_token_consumes_token_and_fills_slot(self):
+        free_token = Token.objects.get(user=self.owner, token_type=Token.FREE)
+        debit_token(self.owner, self.slot, free_token)
+        self.assertFalse(Token.objects.filter(pk=free_token.pk).exists())
+        self.slot.refresh_from_db()
+        self.assertEqual(self.slot.status, GateSlot.FILLED)
+        self.assertEqual(self.slot.gamer, self.owner)
+
+    def test_debit_coin_does_not_consume_token(self):
+        coin_token = Token.objects.get(user=self.owner, token_type=Token.COIN)
+        debit_token(self.owner, self.slot, coin_token)
+        self.assertTrue(Token.objects.filter(pk=coin_token.pk).exists())
+        self.slot.refresh_from_db()
+        self.assertEqual(self.slot.status, GateSlot.FILLED)
+        self.assertEqual(self.slot.gamer, self.owner)
+
+
+class CoinTokenInUseTest(TestCase):
+    def setUp(self):
+        self.owner = User.objects.create(email="founder@example.com")
+        self.room = Room.objects.create(
+            name="Dragon's Den",
+            owner=self.owner,
+            renewal_period=timedelta(days=7),
+        )
+        self.slot = self.room.gate_slots.get(slot_number=1)
+        self.coin = Token.objects.get(user=self.owner, token_type=Token.COIN)
+        debit_token(self.owner, self.slot, self.coin)
+        self.coin.refresh_from_db()
+
+    def test_coin_tooltip_expiry_shows_next_ready_date(self):
+        expected_date = self.coin.next_ready_at.strftime("%Y-%m-%d")
+        self.assertIn(expected_date, self.coin.tooltip_expiry())
+
+    def test_coin_tooltip_room_html_contains_anchor(self):
+        room_url = reverse("epic:gatekeeper", kwargs={"room_id": self.room.id})
+        html = self.coin.tooltip_room_html()
+        self.assertIn(f'href="{room_url}"', html)
+        self.assertIn(self.room.name, html)

src/apps/epic/tests/integrated/test_views.py

@@ -29,3 +29,24 @@ class RoomCreationViewTest(TestCase):
             reverse("epic:create_room"),
             data={"name": "Test Room"},
         )
+
+
+class MyGamesContextTest(TestCase):
+    def setUp(self):
+        self.user = User.objects.create(email="gamer@example.com")
+        self.client.force_login(self.user)
+
+    def test_gameboard_context_includes_owned_rooms(self):
+        room = Room.objects.create(name="Durango", owner=self.user)
+        response = self.client.get("/gameboard/")
+        self.assertIn(room, response.context["my_games"])
+
+    def test_gameboard_context_includes_rooms_with_filled_slot(self):
+        other = User.objects.create(email="friend@example.com")
+        room = Room.objects.create(name="Their Room", owner=other)
+        slot = room.gate_slots.get(slot_number=2)
+        slot.gamer = self.user
+        slot.status = "FILLED"
+        slot.save()
+        response = self.client.get("/gameboard/")
+        self.assertIn(room, response.context["my_games"])

src/apps/epic/urls.py

@@ -7,5 +7,6 @@ app_name = 'epic'
 urlpatterns = [
     path('rooms/create_room', views.create_room, name='create_room'),
     path('room/<uuid:room_id>/gate/', views.gatekeeper, name='gatekeeper'),
+    path('room/<uuid:room_id>/gate/<int:slot_number>/drop_token', views.drop_token, name='drop_token'),
 ]
 

src/apps/epic/views.py

@@ -1,7 +1,8 @@
 from django.contrib.auth.decorators import login_required
 from django.shortcuts import redirect, render
 
-from apps.epic.models import Room
+from apps.epic.models import Room, debit_token
+from apps.lyric.models import Token
 
 
 @login_required
@@ -20,3 +21,17 @@ def gatekeeper(request, room_id):
         'room': room,
         'slots': slots,
     })
+
+@login_required
+def drop_token(request, room_id, slot_number):
+    if request.method == "POST":
+        room = Room.objects.get(id=room_id)
+        slot = room.gate_slots.get(slot_number=slot_number)
+        token = (
+            request.user.tokens.filter(token_type=Token.COIN).first()
+            or request.user.tokens.filter(token_type=Token.FREE).first()
+            or request.user.tokens.filter(token_type=Token.TITHE).first()
+        )
+        if token:
+            debit_token(request.user, slot, token)
+    return redirect("epic:gatekeeper", room_id=room_id)

src/apps/gameboard/views.py

@@ -1,8 +1,10 @@
 from django.contrib.auth.decorators import login_required
+from django.db.models import Q
 from django.shortcuts import redirect, render
 
 from apps.applets.utils import applet_context
 from apps.applets.models import Applet, UserApplet
+from apps.epic.models import Room
 from apps.lyric.models import Token
 
 
@@ -23,6 +25,9 @@ def gameboard(request):
             "free_tokens": free_tokens,
             "applets": applet_context(request.user, "gameboard"),
             "page_class": "page-gameboard",
+            "my_games": Room.objects.filter(
+                Q(owner=request.user) | Q(gate_slots__gamer=request.user)
+            ).distinct(),
         }
     )
 
@@ -40,5 +45,8 @@ def toggle_game_applets(request):
             "applets": applet_context(request.user, "gameboard"),
             "coin": request.user.tokens.filter(token_type=Token.COIN).first(),
             "free_tokens": list(request.user.tokens.filter(token_type=Token.FREE)),
+            "my_games": Room.objects.filter(
+                Q(owner=request.user) | Q(gate_slots__gamer=request.user)
+            ).distinct(),
         })
     return redirect("gameboard")

src/apps/lyric/migrations/0008_token_current_room_token_next_ready_at.py

@@ -0,0 +1,25 @@
+# Generated by Django 6.0 on 2026-03-13 20:17
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('epic', '0001_initial'),
+        ('lyric', '0007_user_stripe_customer_id_paymentmethod'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='token',
+            name='current_room',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='coin_tokens', to='epic.room'),
+        ),
+        migrations.AddField(
+            model_name='token',
+            name='next_ready_at',
+            field=models.DateTimeField(blank=True, null=True),
+        ),
+    ]

src/apps/lyric/models.py

@@ -5,6 +5,7 @@ from django.contrib.auth.base_user import AbstractBaseUser, BaseUserManager
 from django.db import models
 from django.db.models.signals import post_save
 from django.dispatch import receiver
+from django.urls import reverse
 from django.utils import timezone
 
 
@@ -79,6 +80,11 @@ class Token(models.Model):
     user = models.ForeignKey(User, on_delete=models.CASCADE, related_name="tokens")
     token_type = models.CharField(max_length=8, choices=TOKEN_TYPE_CHOICES)
     expires_at = models.DateTimeField(null=True, blank=True)
+    current_room = models.ForeignKey(
+        "epic.Room", null=True, blank=True,
+        on_delete=models.SET_NULL, related_name="coin_tokens"
+    )
+    next_ready_at = models.DateTimeField(null=True, blank=True)
 
     def tooltip_name(self):
         return self.get_token_type_display()
@@ -92,10 +98,18 @@ class Token(models.Model):
 
     def tooltip_expiry(self):
         if self.token_type == self.COIN:
+            if self.next_ready_at:
+                return f"Ready {self.next_ready_at.strftime('%Y-%m-%d')}"
             return "no expiry"
         if self.expires_at:
             return f"Expires {self.expires_at.strftime('%Y-%m-%d')}"
         return ""
+    
+    def tooltip_room_html(self):
+        if not self.current_room_id:
+            return ""
+        url = reverse("epic:gatekeeper", kwargs={"room_id": self.current_room_id})
+        return f'<a href="{url}">{self.current_room.name}</a>'
 
     def tooltip_shoptalk(self):
         if self.token_type == self.COIN: