System Requirements Document (SRD)

Project Name: amber-cake

1. Introduction

The amber-cake project is a full-stack cake shop website designed to provide a premium e-commerce experience for customers in India. The platform will feature a modern, responsive user interface and a Python-based backend to ensure seamless functionality and scalability. The goal is to create a professional-grade website that combines aesthetic appeal with robust functionality, catering to both end customers and administrators managing the shop's operations.

This document outlines the system requirements for the amber-cake project, including functional and non-functional specifications, design concepts, and technical details.

2. System Overview

The amber-cake platform will serve as an online storefront for a cake shop, allowing customers to browse, filter, and purchase cakes. It will include features such as user authentication, a shopping cart system, order placement, and payment integration. Administrators will have access to an admin panel for managing products, orders, and user data.

Key objectives:

• Provide a visually appealing and user-friendly interface.
• Ensure mobile responsiveness for accessibility across devices.
• Implement a secure and scalable backend using Python.
• Offer robust e-commerce features, including filtering, cart functionality, and payment integration.

Locale-specific considerations:

• Currency: INR (₹)
• Timezone: IST (Indian Standard Time)

3. Functional Requirements

Frontend Requirements:

• As a User, I should be able to view a modern, responsive website with smooth animations and transitions.
• As a User, I should be able to browse featured cakes, offers, and hero banners on the Home page.
• As a User, I should be able to filter cakes by price, category, and flavor on the Shop page.
• As a User, I should be able to view detailed product information, including images, descriptions, prices, and reviews, on the Product Details page.
• As a User, I should be able to add cakes to my cart and view them on the Cart page.
• As a User, I should be able to complete my purchase on the Checkout page.
• As a User, I should be able to contact the shop via the Contact page.
• As an Admin, I should be able to add, edit, and delete cakes via the admin panel.
• As an Admin, I should be able to view and manage orders.
• As a User, I should be able to log in or sign up to access personalized features like order history.
• As a User, I should be able to view my order history.
• As a User, I should be able to make payments using Stripe or a dummy payment gateway.

4. User Personas

1. Customer

• Primary user of the platform.
• Browses cakes, adds items to the cart, and completes purchases.
• Can log in or sign up to access personalized features like order history.

2. Administrator

• Manages the shop's operations via the admin panel.
• Adds, edits, and deletes cakes.
• Views and manages orders.

5. Visuals Colors and Theme

Color Palette:

The amber-cake project will feature a warm, inviting color palette inspired by premium bakery aesthetics.

• Background: #FFF8E7 (Soft Cream)
• Surface: #FFDAB9 (Peach Puff)
• Text: #4B2E2E (Rich Chocolate)
• Accent: #FF6347 (Tomato Red)
• Muted Tones: #E6E6FA (Lavender Mist)

This palette evokes warmth, comfort, and indulgence, aligning with the theme of a premium cake shop.

6. Signature Design Concept

Floating Cake Carousel Homepage

The homepage will feature a 3D floating cake carousel as its centerpiece. Users will see cakes rotating in a circular motion, with each cake displayed as a high-resolution image on a transparent pedestal.

• Interaction: Users can hover over a cake to reveal its name, price, and a "View Details" button. Clicking on the button will navigate to the Product Details page.
• Animations: Smooth rotation of cakes, hover effects with subtle zoom-in animations, and glowing accents around the selected cake.
• Transitions: The carousel will dynamically adjust based on the screen size, ensuring responsiveness across devices.
• Background: A gradient blend of the color palette (Soft Cream transitioning to Peach Puff) with subtle sparkles resembling sugar crystals.

This unique design will captivate users and create a memorable first impression, making the website stand out among competitors.

7. Non-Functional Requirements

• The website must load within 3 seconds on standard broadband connections.
• Ensure cross-browser compatibility (Chrome, Firefox, Safari, Edge).
• Implement secure authentication mechanisms for user login/signup.
• Ensure scalability to handle up to 10,000 concurrent users.
• Provide detailed deployment instructions for hosting the website.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools (Optional):

• GPT 5.4 for user-friendly responses

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

Assumptions:

• Users will primarily access the website via mobile and desktop browsers.
• Payment integration will initially use Stripe or a dummy gateway.
• The admin panel will be accessible only to authorized administrators.

Constraints:

• The website must comply with Indian e-commerce regulations.
• Deployment will be limited to cloud platforms supporting Docker and Kubernetes.

10. Glossary

• Frontend: The user-facing part of the website.
• Backend: The server-side logic and database management.
• Responsive Design: A design approach ensuring the website adapts to different screen sizes.
• REST API: A set of web services for communication between the frontend and backend.
• Admin Panel: A dashboard for administrators to manage the shop's operations.
• Payment Gateway: A service for processing online payments.