Skip to content

Ideas.md

Latest commit

 

History

History
225 lines (184 loc) · 18.7 KB

Ideas.md

File metadata and controls

225 lines (184 loc) · 18.7 KB
Raw

Ideas Backlog

This file captures out-of-scope or future ideas. Ideas are logged here instead of Backlog.md to keep the MVP focused. Each entry gets an I-### ID.

Format

  • I-###
    • source: who/what raised it (PO, Architect, Developer, Reviewer, Human Gatekeeper)
    • date: YYYY-MM-DD
    • priority: [1-9] (optional)
    • notes: 1–2 lines of context

Ideas

  • I-001 Spin and Clue System

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Core mechanic where players spin a world wheel to reveal a mystery country, then receive three progressive clues (animal, food, flag) before guessing.
    • status: Implemented in [0.1.0] - 2025-11-01

  • I-002 Discovery Card Rewards

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: After correct guesses, display educational cards featuring animal facts, local greetings, dinosaur/fossil info, historical notes, and space connections for each country.
    • status: Partially implemented in [0.1.0] - 2025-11-01 (core cards with facts; full fossil/space deferred)

  • I-003 Explorer Passport and Stamp Collection

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Progression system where each correct country earns a stamp. Completing all countries in a continent unlocks that continent's themed badge.

  • I-004 World Puzzle Map Visualization

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Interactive map that fills in piece-by-piece with each correct answer. Completed continents light up, and finishing the world unlocks an animated globe.

  • I-005 Continental Badges and Explorer Levels

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Six themed continental badges (Savanna Specialist, History Hero, Cultural Voyager, Nature Guardian, Ocean Explorer, Polar Scientist) and four explorer levels from Junior Adventurer to Cosmic Voyager.

  • I-006 Historical Civilizations Integration

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Educational content connecting modern countries to ancient civilizations and historical kingdoms (Ancient Greece, The Franks, Mesopotamia, Yugoslavia, etc.).

  • I-007 Anthropology and Fossil Discoveries

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Feature highlighting early human sites, fossils, and cultural artifacts found in each country to connect geography with human evolution and archaeology.

  • I-008 Astronomy and Space Connections

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Link geography to cosmos by showing how countries contributed to space exploration, telescopes, satellites, or have mythological constellations.

  • I-009 Sound Effects and Visual Theming

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Audio/visual polish including whooshes, celebration sounds, and cheerful color palette featuring teal. Playful sounds and bright colors for engagement. UI should be intuitive for younger children while not feeling babyish to older kids.
    • status: Partially implemented. Teal color theme in [0.1.0], roulette click sounds in [0.4.0]. Celebration sounds/whooshes deferred.

  • I-010 Mini Missions and Challenges

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Special challenge modes like "Find all countries with volcanoes" or "Unlock 5 countries that speak Spanish" to add variety to gameplay.

  • I-011 Offline Play Mode

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Printable world map puzzle where physical stickers or stamps can be placed as the player progresses through the digital game.

  • I-012 Multiplayer Expansion

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Future competitive mode similar to Jeopardy where multiple players guess countries simultaneously. POC is single-player only, but architecture should plan for multiplayer.

  • I-013 Responsive Web Platform

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Browser-based game that works seamlessly on laptops, phones, and tablets without requiring app downloads or installations.
    • status: Implemented in [0.1.0] - 2025-11-01

  • I-014 Country Selection

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Select 10-20 countries (1-2 per continent) with easily recognizable flags, well-known animals, and common foods. Focus on countries kids likely already know (USA, Japan, Australia, Egypt, etc.).
    • status: Implemented in [0.1.0] - 2025-11-01

  • I-015 Flag Image Sourcing

    • source: Product Owner
    • date: 2025-11-01
    • notes: Source flag images from public domain (Wikipedia Commons). Simple PNG/SVG files.

  • I-016 Animal Image Sourcing

    • source: Product Owner
    • date: 2025-11-01
    • notes: Find 1 iconic animal image per country. Use free stock photo sites or public domain sources. Choose visually striking animals kids will recognize (panda, kangaroo, elephant, etc.).

  • I-017 Clue Text

    • source: Product Owner
    • date: 2025-11-01
    • notes: Write simple clue text. Animal clues: species names + 1 sentence. Food clues: common dish names (sushi, tacos, pizza). Flag clues: distinctive features (colors, symbols). Use common knowledge.
    • status: Implemented in [0.1.0] - 2025-11-01

  • I-018 Discovery Card Facts

    • source: Product Owner
    • date: 2025-11-01
    • notes: 2-3 simple, well-known facts per country. Use Wikipedia or kids' geography sites. Facts should be surprising or fun, not encyclopedic.
    • status: Partially implemented in [0.1.0] - 2025-11-01 (basic facts; expansions deferred)

  • I-019 UI Transitions and Animations

    • source: Product Owner
    • date: 2025-11-01
    • notes: Smooth transitions between game states (spin → clue reveal → guess → discovery card). Satisfying animations for correct/incorrect answers, card flips, world spin. Snappy, playful animations make the game feel polished and fun.
    • status: Implemented in [0.1.0] with Framer Motion. Globe spin animation enhanced in [0.4.0].

  • I-020 Visual Feedback for Interactions

    • source: Product Owner
    • date: 2025-11-01
    • notes: Immediate visual feedback for all user interactions. Button hover states, click animations, correct/incorrect answer indicators, progress bar fills. Responsive UI elements make the game feel alive.
    • status: Implemented in [0.1.0]. Button hover/active states, feedback banners for correct/incorrect, Framer Motion tap animations.

  • I-021 Full Country Database Expansion

    • source: Product Owner
    • date: 2025-11-01
    • notes: Future expansion to comprehensive global coverage. Create complete content for all countries: clue data, discovery card facts (animal facts, greetings, fossils, historical notes, space connections), and continental groupings. Age-appropriate with 5th-6th grade reading level.

  • I-022 Capytan Game Host Character

    • source: Human Gatekeeper
    • date: 2025-11-01
    • notes: Friendly capybara character named Capytan acts as game host. Provides clues, encouragement, and fun facts in a whimsical way. Adds personality and guidance throughout the game.

  • I-023 Basic Internationalization Structure

    • source: Product Owner
    • date: 2025-11-01
    • notes: Simple JSON translation files (en.json, es.json, etc.) with translation keys used throughout the codebase. Basic language switcher UI component. Focus on making it easy for community contributors to add new languages later. Deferred: RTL support, complex validation workflows, automated cultural adaptation, pluralization rules.
    • status: Implemented in [0.2.0] - 2025-11-02

  • I-024 Community Translation Guide

    • source: Product Owner
    • date: 2025-11-01
    • priority: 7
    • notes: Simple CONTRIBUTING.md section explaining how community members can add a new language. Include JSON structure, naming conventions, and basic PR guidelines. Keep it lightweight and welcoming. Deferred: Automated validation tools, translation management platforms, complex review workflows.
    • status: Implemented in [0.2.0] via T-005. Comprehensive "Adding a New Language" section in README.md with 5 step-by-step subsections.

  • I-025 Internationalize ARIA Label Attributes for Accessibility

    • source: Code Reviewer (T-001 review via ask-codex)
    • date: 2025-11-01
    • priority: 4
    • notes: Externalize hardcoded ARIA label strings in App.jsx to translation files (en.json, es.json) to support screen readers in multiple languages. Current hardcoded strings include Capytan image label and flag card labels. Related to US-005 but marked out-of-scope for T-001 by Human Gatekeeper.
    • status: Implemented in [0.2.0] (T-004) and [0.4.0] (T-021). ARIA labels for Capytan, country flags, spinning globe, and sound toggle all internationalized.

  • I-026 Rename 'greeting' Field to 'expression' for Greater Variety

    • source: Human Gatekeeper
    • date: 2025-11-01
    • priority: 3
    • notes: Modify the country data model to rename the 'greeting' field to 'expression' to support more varied cultural expressions. Current implementation would result in "Hola!" appearing for all 36 Spanish-speaking countries. The 'expression' field would allow for country-specific phrases, idioms, or local variations that better represent each nation's unique culture while still maintaining the educational goal of teaching greetings and common expressions.

  • I-027 Add Open Source Footer with Contribution Link

    • source: Human Gatekeeper
    • date: 2025-11-01
    • priority: 5
    • notes: Add a footer component to the application stating this is an open source project and welcoming community contributions. Include link to GitHub repository (https://github.com/zosorock/worldspinner), current version (from the release tag), and last update timestamp. This promotes community engagement and transparency about the project's open source nature. Footer should be subtle and non-intrusive while clearly communicating the collaborative spirit of the project.

  • I-028 Refactor Country Card Data Storage for Scalability

    • source: Human Gatekeeper
    • date: 2025-11-01
    • priority: 2
    • notes: As the country database expands, the countryCards.js file will become large and difficult to maintain. Need a scalable solution for storing and translating country card data. Consider options like: splitting into individual JSON files per country, using a database, implementing lazy loading/code splitting, or organizing data by continent. The solution should support efficient loading, easy translation workflows, and maintainable file sizes while preserving the existing data structure and internationalization requirements.

  • I-029 Smart Card Removal from Shuffle Deck

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 4
    • notes: Remove cards from the shuffle deck after they are guessed correctly to improve user experience. Current implementation allows the same country to appear multiple times during a game session, making it increasingly difficult to encounter unguessed countries as the player progresses. This enhancement would track correctly guessed countries and filter them from the random selection pool, ensuring each country only appears once per session. This creates a better game flow and prevents frustration from repeatedly seeing already-completed countries. Implementation should consider session persistence (what happens on page refresh), visual feedback showing progress through the deck, and the option to reset/reshuffle once all cards are completed.
    • status: Implemented in [0.3.0]

  • I-030 Clock-Hand Style Globe Spinning Animation

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 6
    • notes: Interactive spinning globe animation triggered by the "Spin the Globe" button. Instead of the traditional globe rotation (spinning on its axis), implement a clock-hand style spin animation where the globe rotates around a central pivot point like a roulette wheel or prize wheel. This creates a more dramatic and anticipation-building effect before revealing the mystery country. The animation should be smooth, visually engaging, and appropriate for the target age group (6-12 years old). Consider adding sound effects during the spin and a satisfying "stop" animation when the country is revealed.
    • status: Implemented in [0.4.0] via US-008. Globe spins 360°+ with easeOut deceleration, roulette-style click sounds with audio pooling, mute control with localStorage persistence. Complex sound effects/music remain deferred to future enhancements.

  • I-031 Auto-Dismiss Feedback Banners

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 4
    • notes: Implement auto-dismiss feedback banners for guess results. When a player makes a correct or incorrect guess, the green (success) or red (error) banner should automatically fade away after approximately 7 seconds. This provides clear immediate feedback while preventing screen clutter and allowing the game to naturally flow to the next interaction. The dismissal should be smooth and non-jarring, using a fade-out animation. Players should still be able to manually dismiss the banner if they want to proceed faster than the auto-dismiss timer.

  • I-032 Rotating Capytan Images Next to Clue Board

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 4
    • notes: Display rotating pictures of Capytan (the friendly capybara game host) in a dedicated area positioned next to the Clue Board as two square sections side by side. The Capytan image area would cycle through different character poses, expressions, or themed variations to add visual interest and personality to the game interface. This enhancement creates a more engaging UI by giving Capytan a consistent presence alongside the main game content, reinforcing the character's role as game host while making the interface more dynamic and playful. Implementation should consider image rotation timing, smooth transitions between images, responsive layout to maintain the side-by-side square arrangement across different screen sizes, and a curated set of Capytan images that convey different moods or match game states (encouraging, celebrating, curious, etc.).

  • I-033 Persistent Game Progress Storage

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 6
    • notes: Implement persistent game progress tracking that survives page refreshes and browser sessions. When a player correctly guesses countries, their progress (completed countries, earned stamps, unlocked badges, puzzle map state) should be saved to browser local storage or session cookies. This allows players to return later and continue where they left off without losing their achievements. The solution should handle session persistence gracefully, maintain data integrity across browser restarts, and provide a clear way to reset/restart the game if desired. This enhancement significantly improves user experience by making the game progress feel meaningful and permanent rather than ephemeral.

  • I-034 CAPTCHA-Protected Feedback Button

    • source: Human Gatekeeper
    • date: 2025-11-02
    • priority: 7
    • notes: Add a user feedback mechanism with CAPTCHA protection that allows players to report issues or incorrect information during gameplay. The feedback button should be accessible throughout the game experience and open a form where users can submit bug reports or corrections to game content (such as incorrect clues, missing translations, or technical issues). The form itself should include explanatory text encouraging users to share what's not working correctly or if they've found an incorrect answer or educational fact. This feedback system will help improve game quality through community input while preventing spam submissions via CAPTCHA validation. The feature should be unobtrusive but discoverable, integrate with the existing UI design language, and provide clear confirmation when feedback is submitted successfully.

  • I-035 Progressive Scoring System Based on Guess Attempt

    • source: Human Gatekeeper
    • date: 2025-11-03
    • priority: 7
    • notes: Implement a scoring system that awards different point values based on when the player guesses correctly during the three-clue progression. Players who identify the country after the first clue (animal) earn the highest points, demonstrating strong geographical knowledge. Guessing correctly after the second clue (food) awards medium points, while waiting until the third clue (flag) provides the lowest point value. This tiered scoring mechanism encourages players to think critically about each clue and rewards earlier correct guesses, adding a strategic element to the game. The scoring system should integrate with existing game mechanics and provide clear feedback showing points earned for each correct guess. Consider how this scoring interacts with the Explorer Passport progression system (I-003) and whether accumulated points could unlock additional badges or achievements beyond the current stamp collection mechanic.

  • I-036 Spelling Suggestion for Close Matches

    • source: Human Gatekeeper
    • date: 2025-11-08
    • priority: 3
    • notes: Implement fuzzy matching on guess submissions to detect near-miss spellings and provide "Did you mean...?" suggestions to help players learn correct country name spellings while building confidence. When a player submits a guess that doesn't exactly match the target country name or its aliases, the system should calculate string similarity (using algorithms like Levenshtein distance) to determine if the guess is close to the correct answer. If a close match is detected (e.g., "aergentina" → "Argentina", "Japon" → "Japan", "Chinna" → "China"), display a helpful suggestion message like "Did you mean Argentina?" with an option to accept the suggestion or try again. This feature serves multiple educational purposes: it teaches proper spelling through gentle correction, prevents frustration from minor typos, encourages experimentation without penalty, and builds geographic vocabulary confidence especially for younger players (ages 7-12) who may know the country but struggle with spelling complex names. Implementation should consider: setting appropriate similarity thresholds to avoid false positives, handling multiple close matches, internationalization of suggestion messages, and maintaining game flow without feeling punitive. The feedback should feel supportive and educational rather than corrective, aligning with the game's philosophy of intellectually stimulating language without oversimplification.