elysium/verify.md

Manual Verification Checklist

Things our unit tests cannot verify — these need manual testing in a real browser with a live server.

---

Auth & Login

• Discord OAuth login flow works end-to-end (redirect → callback → JWT → game loads)
• Logging out and back in restores the correct game state
• A brand-new player (no existing save) gets a fresh game state with no errors
• A player with an outdated save (no schemaVersion) sees the OutdatedSchemaModal on login
  • "Reset Progress" button nukes the save and starts fresh
  • "Proceed with Bugs" dismisses the modal for the session but reappears on next login
  • Cloud save attempts while on an outdated save are rejected (save button should fail gracefully)
• A player whose save was nuked server-side (v1 release reset) gets a fresh state, not a 404

---

Cloud Save

• Auto-save triggers every 60 seconds while the game is open
• Manual save (if applicable) works correctly
• Saving and reloading in a new tab preserves all progress
• Save is rejected with a helpful error if the schema version is outdated (HTTP 409)

---

Offline Progress

• Closing the tab and reopening after 30+ minutes shows the offline earnings modal
• Offline gold is calculated correctly (passive income × elapsed time, capped appropriately)
• Offline essence is calculated correctly
• Resetting progress clears offline earnings — after a reset, no offline modal should appear

---

Daily Login Bonus

• First login of a new day shows the login bonus modal with correct reward
• Consecutive days increment the streak counter
• Missing a day resets the streak to 1
• Day 7 reward (crystals) is awarded correctly
• Week multiplier applies for streaks beyond 7 days
• Streak is displayed correctly on the Character Sheet

---

Discord Integration

• Webhook on prestige: posting to the Discord webhook channel with correct message and player mention
• Webhook on transcendence: same as above
• Webhook on apotheosis: webhook fires AND Discord role is granted to the player
• Discord role grant requires the bot to have Manage Roles permission and the bot role to be above the target role
• If Discord env vars are missing (dev environment), these silently no-op without crashing

---

Prestige / Transcendence / Apotheosis

• Prestige resets gold and adventurers but preserves story/titles/companions/achievements
• Prestige increments the prestige count correctly
• Transcendence resets prestige progress but preserves correct fields
• Apotheosis resets transcendence progress but preserves correct fields
• Story chapters unlock at correct milestone points (1st prestige, 5th prestige, 1st transcendence, 1st apotheosis)

---

Boss Fights

• Boss fight UI opens correctly and shows HP bar
• Win/loss outcomes are applied correctly
• Boss rewards (gold, equipment) are granted on win
• Zone unlock happens after final zone boss is defeated and final zone quest is completed
• bossesDefeated daily challenge counter increments in the UI after a win
• Auto-boss toggle fires when a boss is available and the player is actively on the page

---

Quests

• Quest starts and the timer counts down in real time
• Quest completes and rewards are granted
• Quest failure (chance-based) resets the quest to available with ⚠️ indicator
• questsCompleted daily challenge counter increments in the UI
• Auto-quest toggle fires when a quest becomes available
• Active companion quest-time reduction (Wren, Zuri) visibly shortens the timer

---

Exploration

• Starting an exploration works and shows in-progress state
• Cannot start a second exploration while one is in progress (all Explore buttons disabled)
• Exploration completes and rewards/codex entries are granted
• "Found nothing" outcome is handled gracefully (no crash, no reward)
• adventurer_loss event properly removes adventurers

---

Companions

• Companions unlock when the correct threshold is met (bosses defeated, quests completed, prestige, etc.)
• Setting an active companion applies the bonus correctly:
  • Passive gold bonus (Lyra, Mira, Pria) — check gold income rate
  • Click gold bonus (Finn) — check click power
  • Boss damage bonus (Aldric, Kael) — check boss fight outcomes
  • Quest time reduction (Wren, Zuri) — check quest timer
  • Essence income bonus (Sera, Vex) — check essence accumulation
• Changing active companion takes effect immediately

---

Story System

• First zone boss defeat unlocks Chapter 1 and shows a toast notification
• Story tab shows unread dot badge when new chapters are available
• Reading a chapter and making a choice saves the selection
• Choice outcome is displayed after selection
• Completed choices are visible on the Character Sheet
• Story progress is preserved through prestige, transcendence, and apotheosis
• {characterName} is substituted correctly with the player's character name

---

Titles

• Titles unlock when the correct milestones are reached
• Active title is selectable in the Character Sheet edit mode
• Active title displays on the public /character/:id page
• Titles are preserved through prestige, transcendence, and apotheosis

---

Leaderboards

• Leaderboard page loads and displays real player data
• All 7 categories (gold, bosses, quests, achievements, prestige, transcendence, apotheosis) work
• Top 3 rows have medal highlighting
• Clicking a player's row navigates to their /character/:id page
• showOnLeaderboards: false hides the player from all categories
• Default is opted-in (new players appear on leaderboards)

---

Character Sheet & Public Profile

• Character Sheet tab loads and displays correctly
• Edit mode saves all fields (name, pronouns, race, class, bio, guild name, guild description, active title)
• Share button copies the correct /character/:id URL and shows ✓ Copied!
• Public /character/:id page renders for another player's ID
• Equipped items (weapon, armour, trinket) display correctly with rarity colours
• Profile settings (showOnLeaderboards, etc.) persist correctly

---

Batch Hire

• Batch selector (×1, ×5, ×10, ×25, ×100, ×Max) updates all hire buttons
• Cost display updates to reflect batch price
• ×Max hires as many as the player can afford, down to 1
• ×Max is disabled (or shows ×0) if the player cannot afford even 1

---

Responsive Layout

• Game is usable on a 375px wide mobile screen
• Sidebar collapses to a horizontal strip on mobile
• Tabs scroll horizontally when there are too many to fit
• Resource bar wraps cleanly on small screens

---

Notifications / Toasts

• Achievement toast appears when an achievement is unlocked
• Codex toast appears when a new codex entry is discovered
• Story toast appears when a new chapter unlocks
• Login bonus modal appears on first daily login
• Offline progress modal appears when returning after time away
• Outdated schema modal appears for players with old saves
• All toasts auto-dismiss after a few seconds

---

Crafting

• Crafting a recipe deducts the correct materials
• Crafted item appears in inventory / updates stats
• Cannot craft without required materials (error shown)

---

1Password Secrets (Production Only)

• DISCORD_MILESTONE_WEBHOOK is set and webhook posts succeed
• DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, DISCORD_APOTHEOSIS_ROLE_ID are set and role grant succeeds
• JWT secret is correctly injected
• MongoDB connection string is correctly injected