System Requirements Document (SRD)

Project Name: Purple-Candies

1. Introduction

Welcome to the Purple-Candies System Requirements Document. This document outlines the functional and non-functional requirements, design concepts, and technical specifications for the Purple-Candies project. Inspired by the vibrant and engaging match-3 puzzle game genre, Purple-Candies aims to deliver a unique, visually stunning, and addictive gaming experience for casual players worldwide.

2. System Overview

Purple-Candies is a match-3 puzzle game designed to captivate players with its colorful graphics, dynamic gameplay, and innovative mechanics. The game will feature multiple puzzle modes, competitive and cooperative play options, and monthly updates to keep the experience fresh. Players will enjoy the freedom to play offline or online, with opportunities to unlock rewards, boosters, and special features.

3. Functional Requirements

Story Points:

• As a Player, I should be able to match 3 or more candies to score points and progress through levels.
• As a Player, I should be able to unlock boosters and power-ups to enhance gameplay.
• As a Player, I should be able to compete in online leaderboards and track my ranking.
• As a Player, I should be able to team up with friends in cooperative modes to earn rewards.
• As a Player, I should be able to experience unique puzzle modes such as Soda, Frosting, and Jam.
• As a Player, I should be able to play offline without requiring an internet connection.
• As a Player, I should be able to purchase optional in-game items like extra moves or lives.
• As an Admin, I should be able to manage monthly updates, including new levels, rewards, and challenges.

4. User Personas

Player:

• Casual gamers who enjoy quick, engaging puzzle games.
• Individuals seeking offline entertainment during commutes or breaks.
• Competitive players aiming to climb leaderboards and showcase their skills.

Admin:

• Game developers and content managers responsible for maintaining and updating the game.
• Moderators ensuring fair play and managing online competitions.

5. Visuals Colors and Theme

Color Palette:

Inspired by the reference image, the Purple-Candies game will feature a warm and inviting color scheme:

• Background: #F5E8D0 (Creamy Beige)
• Surface: #FFD1A9 (Soft Peach)
• Text: #5A3E2B (Rich Brown)
• Accent: #FF6F61 (Vibrant Coral)
• Muted Tones: #B8A08C (Subtle Taupe)

6. Signature Design Concept

Concept: Interactive Candy Kitchen

The homepage will resemble a lively, interactive candy kitchen. Players will be greeted by animated candy characters (similar to the naan bread character in the reference image) bustling around a countertop filled with colorful candies, soda bottles, and jelly jars.

Features:

• Dynamic Animations: Candies will bounce, fizz, and swirl as players hover over them. Soda bottles will pop open with fizzy effects when clicked.
• Interactive Elements: Players can drag candies to match them directly on the homepage, offering a mini-game experience before entering the main game.
• Transitions: Smooth transitions between sections, with candy trails leading the way.
• Micro-Interactions: Buttons will jiggle slightly when hovered over, and jelly jars will wobble when clicked.

This design will create an unforgettable first impression, immersing players in the candy-filled world of Purple-Candies.

7. Non-Functional Requirements

• The game must load within 3 seconds on standard devices.
• The game must support offline play without compromising core features.
• Monthly updates should be seamless and require minimal downtime.
• The game must be compatible with Android, iOS, and web platforms.

8. Tech Stack

Frontend:

• React (Web)
• React Native (Mobile App)

Backend:

• Python
• FastAPI

Database:

• MySQL (Primary RDBMS)
• MongoDB (NoSQL for game state storage)

AI Models:

• GPT 5.4 for user-friendly responses.
• Claude 4.6 Opas for coding and academic support.
• Google Nano Banana for image generation.

AI Tools:

• Litellm for LLM Routing.
• Langchain for advanced AI workflows.

Orchestration:

• Docker and docker-compose for local development.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

• Players will have access to devices with at least 2GB of RAM.
• Internet connectivity is required for online competitions and updates.
• In-app purchases will be optional and disabled by default.

10. Glossary

• Match-3 Puzzle: A game mechanic where players align three or more identical items to score points.
• Boosters: Special items that enhance gameplay, such as extra moves or powerful combos.
• Leaderboards: Online rankings that display player scores and achievements.
• Season Pass: A monthly subscription offering exclusive rewards and challenges.