FT helper: sig_page.py — _seed_earthman_sig_pile + _assign_sig — Sprint 4c of My Sea roadmap — TDD

Pure test-infra refactor. Sprint 5+ (sea-select / DRAW SEA / latest-draw rendering) all need a "user has sig" precondition without walking the picker — extracting it once now prevents Sprint 5's setUps from copy-pasting the inline assignment dance again.

Two helpers in new `src/functional_tests/sig_page.py` (mirrors the `room_page.py` / `post_page.py` / `my_posts_page.py` convention — underscored to signal "test infrastructure, not API surface", public within `functional_tests/`):

- `_seed_earthman_sig_pile()` — re-seeds Earthman DeckVariant + the 16 MIDDLE court cards (Maid/Jack/Queen/King × BRANDS/CROWNS/BLADES/GRAILS) that `personal_sig_cards(user)` returns. Hoisted verbatim from the duplicate definitions in `test_bill_my_sign.py` + `test_game_my_sea.py` introduced in [[sprint_serialized_rollback_ft_fix_may19]]. Major 0/1 are deliberately NOT seeded — `_filter_major_unlocks` in `personal_sig_cards()` strips them for users w.o the matching Note unlocks, which is the default state in solo FTs.
- `_assign_sig(user, card=None, reversed_flag=False)` — sets `user.significator` + `significator_reversed` directly, bypassing the picker UI. Returns the assigned card so downstream assertions can use it. `card=None` defaults to `personal_sig_cards(user)[0]` (the same target the picker happy-path FT uses).

Call sites updated:
- `test_bill_my_sign.py` — drops the local `_seed_earthman_sig_pile` definition (32 lines); imports from `sig_page`. `MySignClearTest.setUp` now uses `_assign_sig(self.gamer)` instead of the 4-line manual sig-assignment block.
- `test_game_my_sea.py` — drops the local `_seed_earthman_sig_pile` definition (22 lines); imports from `sig_page`. `MySeaSignGateTest`'s two "user w. sig" tests (#4 + #6) swap their 2-line `self.gamer.significator = ... ; .save(...)` blocks for `_assign_sig(self.gamer, self.target_card)`.

Diff stat: +69 lines (new helper module), -59 lines (duplicate code removed). Net +10 LOC but the duplication trap is closed — single source of truth for sig-state FT setup.

20/20 FT green across both files in 174s post-refactor.

Code architected by Disco DeDisco <discodedisco@outlook.com>
Git commit message Co-Authored-By:
Claude Sonnet 4.6 <noreply@anthropic.com>

src/functional_tests/test_game_my_sea.py

@@ -9,8 +9,9 @@ mirrors the gate hint in its empty-state slot.
 from selenium.webdriver.common.by import By
 
 from .base import FunctionalTest
+from .sig_page import _assign_sig, _seed_earthman_sig_pile
 from apps.applets.models import Applet
-from apps.epic.models import DeckVariant, TarotCard, personal_sig_cards
+from apps.epic.models import personal_sig_cards
 from apps.lyric.models import User
 
 
@@ -32,29 +33,6 @@ def _seed_gameboard_applets():
         )
 
 
-def _seed_earthman_sig_pile():
-    """Re-seed Earthman DeckVariant + the 16 MIDDLE court cards that
-    personal_sig_cards() returns. TransactionTestCase flushes wipe the
-    migration seed between tests, so each setUp must restore them.
-    See [[feedback_transactiontestcase_flush]]."""
-    earthman, _ = DeckVariant.objects.get_or_create(
-        slug="earthman",
-        defaults={"name": "Earthman", "card_count": 106, "is_default": True},
-    )
-    _NAME = {11: "Maid", 12: "Jack", 13: "Queen", 14: "King"}
-    for suit in ("BRANDS", "CROWNS", "BLADES", "GRAILS"):
-        for number in (11, 12, 13, 14):
-            TarotCard.objects.get_or_create(
-                deck_variant=earthman,
-                slug=f"{_NAME[number].lower()}-of-{suit.lower()}-em",
-                defaults={"arcana": "MIDDLE", "suit": suit, "number": number,
-                          "name": f"{_NAME[number]} of {suit.capitalize()}",
-                          "levity_qualifier": "Elevated",
-                          "gravity_qualifier": "Graven"},
-            )
-    return earthman
-
-
 class MySeaSignGateTest(FunctionalTest):
     """Sign-gate UX on the standalone /gameboard/my-sea/ page + the
     /gameboard/ My Sea applet. User without a saved sig sees a Look!-
@@ -134,8 +112,7 @@ class MySeaSignGateTest(FunctionalTest):
     def test_with_sig_skips_gate_and_renders_draw_shell(self):
         """User w. saved significator → no .my-sea-sign-gate on the page;
         draw shell renders normally (Sprint 3 placeholder)."""
-        self.gamer.significator = self.target_card
-        self.gamer.save(update_fields=["significator"])
+        _assign_sig(self.gamer, self.target_card)
         self.create_pre_authenticated_session(self.email)
         self.browser.get(self.live_server_url + "/gameboard/my-sea/")
         self.wait_for(
@@ -170,8 +147,7 @@ class MySeaSignGateTest(FunctionalTest):
     def test_with_sig_applet_renders_default_empty_state(self):
         """Applet w. saved sig → no gate, empty-state placeholder (until
         Sprint 7 wires up the latest-draw rendering)."""
-        self.gamer.significator = self.target_card
-        self.gamer.save(update_fields=["significator"])
+        _assign_sig(self.gamer, self.target_card)
         self.create_pre_authenticated_session(self.email)
         self.browser.get(self.live_server_url + "/gameboard/")
         self.wait_for(