System Requirements Document (SRD)

Project Name: mint-countries

1. Introduction

The mint-countries project, also known as Battle of the Countries, is a fandom wiki designed to bring a creative fictional universe to life. In this universe, countries, celestial bodies, and cosmic forces are reimagined as students and staff in a chaotic and satirical school setting. This wiki will serve as a comprehensive resource for fans, offering detailed character biographies, hidden lore, and interactive features that encourage community engagement.

The project is tailored to Natasha Riley's vision, blending humor, absurdity, and deep lore-building to create a unique and immersive experience. The wiki will include all 197 countries, celestial staff, and creatures, ensuring a full-scale representation of this imaginative world.

2. System Overview

The mint-countries fandom wiki will provide:

• A searchable and filterable character directory featuring 200+ characters, including country-students, celestial staff, and creatures.
• Individual character pages with detailed biographies, trivia, relationships, and hidden lore.
• A mystery/unlockables section tied to hidden messages and lore, such as Guinea-Bissau’s poem and Code String 042.
• Community contribution features, allowing fans to submit their own poems, stories, and theories inspired by the universe.
• Season highlights summarizing key chaotic and iconic moments.
• Interactive features like voting for the most chaotic student and suggesting new character quirks.
• A responsive, wiki-style layout optimized for both desktop and mobile devices.

The system will balance humor and absurdity with serious lore-building, creating a fandom experience that is both entertaining and thought-provoking.

3. Functional Requirements

• As a User, I should be able to browse a searchable character directory with 200+ entries.
• As a User, I should be able to filter characters by role type (e.g., Students, Leadership, Staff, Teachers, Creatures).
• As a User, I should be able to view individual character pages with detailed biographies, trivia, relationships, and fun facts.
• As a User, I should be able to uncover hidden lore, such as Guinea-Bissau’s poem and Code String 042, through interactive elements.
• As a User, I should be able to contribute my own poems, stories, and theories in a dedicated community section.
• As a User, I should be able to vote for the most chaotic student of the season.
• As a User, I should be able to suggest new character quirks or storylines.
• As an Admin, I should be able to manage and update character profiles, lore, and community contributions.
• As an Admin, I should be able to moderate fan-submitted content and approve or reject suggestions.
• As a Guest, I should be able to explore the wiki but not contribute content.

4. User Personas

1. Admin:

   • Role: Oversees the wiki, manages content, and moderates community contributions.
   • Goals: Ensure the accuracy and quality of the wiki’s content while fostering a positive fan community.

2. User (Fan):

   • Role: Engages with the wiki by exploring character profiles, uncovering hidden lore, voting on chaotic moments, and contributing creative content.
   • Goals: Immerse themselves in the universe, connect with other fans, and expand the lore through their contributions.

3. Guest:

   • Role: Casual visitor who explores the wiki without contributing content.
   • Goals: Learn about the universe and decide whether to join the community.

5. Visuals Colors and Theme

Color Palette:

The color palette for mint-countries reflects the cosmic, chaotic, and whimsical nature of the universe:

• Background: #0D1B2A (Deep Midnight Blue)
• Surface: #1B263B (Dark Cosmic Gray)
• Text: #E0E1DD (Moonlight White)
• Accent: #F77F00 (Solar Flare Orange)
• Muted Tones: #415A77 (Muted Galactic Blue)

This palette creates a balance between the mysterious and the vibrant, aligning with the project’s tone.

6. Signature Design Concept

The Cosmic Classroom Homepage

The homepage of the wiki will be an interactive, animated classroom set in space. Here’s how it will look and feel:

• Visuals:

  • The classroom is suspended in a galaxy, with desks floating in zero gravity. Each desk represents a character or group (e.g., continents, celestial staff, creatures).
  • The blackboard at the front displays the title Battle of the Countries in glowing, animated chalk.

• Interactions:

  • Hovering over desks reveals character names and roles (e.g., “Guinea-Bissau: The Ghost”). Clicking a desk takes users to the character’s profile.
  • The blackboard updates dynamically with trivia, episode highlights, or community announcements.

• Animations:

  • Planets orbit around the classroom, and stars twinkle in the background.
  • When users scroll, the classroom rotates slightly, giving a 3D effect.

• Hidden Lore:

  • Clicking on specific objects (e.g., a dusty Geography book) reveals hidden messages or unlocks parts of Guinea-Bissau’s poem.

This design will make the homepage unforgettable, immersing users in the universe from the moment they arrive.

7. Non-Functional Requirements

• The system must support at least 200 character profiles with detailed content.
• The wiki must be responsive and optimized for both desktop and mobile devices.
• The search and filtering features must return results within 2 seconds.
• The system must allow for secure user authentication and content moderation.
• The system must support interactive features like voting and lore discovery without performance degradation.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• GPT 5.4 for user-friendly responses
• Litellm for LLM Routing

Local Orchestration:

• Docker
• docker-compose

9. Assumptions and Constraints

• The wiki will initially focus on English content, with potential for multilingual support in the future.
• All 197 countries and characters will have detailed profiles, requiring significant content creation and management.
• The system will rely on community contributions to expand the lore and maintain engagement.
• The exaggerated traits and chaotic moments will be presented with a balance of humor and respect to avoid unintended offense.

10. Glossary

• Character Directory: A searchable list of all characters in the universe.
• Hidden Lore: Secret content that users can uncover through interactions with the wiki.
• Code String 042: A hidden message tied to Guinea-Bissau’s story.
• The Ghost’s Lament: Guinea-Bissau’s poem, central to the lore of the universe.
• Community Contributions: User-submitted content, such as poems and stories, inspired by the universe.
• Chaos Suggestion Box: A feature allowing fans to propose new quirks or storylines for characters.
• Most Chaotic Student: A fan-voted title awarded to the character with the wildest behavior each season.

This SRD captures the full scope of your vision, Natasha, and sets the stage for an unforgettable fandom experience. Let me know if there’s anything else you’d like to refine or expand!