System Requirements Document for dozie-scent

1. Introduction

The dozie-scent project is an online marketplace dedicated to perfumes, inspired by the e-commerce platform Jumia. The platform is designed to provide a vibrant and engaging shopping experience, focusing solely on perfumes. The primary audience includes individual consumers looking for a distinctive and memorable online shopping experience for perfumes. The platform will feature an admin interface for managing product listings and stock levels, integrated online payment methods, and AI-driven customer care with WhatsApp support.

2. System Overview

dozie-scent is a perfume-focused e-commerce platform that allows users to browse and purchase perfumes online. The system includes an admin interface for managing product inventory and receiving order notifications. The platform supports online payments and features AI-driven customer care with WhatsApp integration. The system is designed to provide a playful and maximalist user experience, aligning with the creative direction inspired by Jessica Walsh.

2a. Product Interpretation and Delivery Boundary

The platform will be delivered as a web application with a focus on vibrant and engaging user interactions. The admin will have the ability to manage product listings, monitor stock levels, and receive order notifications via email. Users will be able to browse products, make purchases using integrated online payment methods, and receive customer support through AI and WhatsApp. The system will not include features outside of perfume sales and related customer interactions.

2b. Source Content Inventory

Not applicable as no explicit content_source directive was provided.

2c. Page Content and Component Coverage

Home Page

• Hero Section: Full-bleed hero image featuring a vibrant, oversized perfume bottle with surreal colors and playful props.
• Featured Products: Display of highlighted perfumes with images, names, and prices.
• Navigation: Links to product categories, cart, and customer support.
• Search Bar: Allows users to search for specific perfumes.

Product Page

• Product Details: Images, descriptions, prices, and stock availability.
• Add to Cart: Button to add selected perfumes to the shopping cart.
• Customer Reviews: Section for user-generated reviews and ratings.

Admin Dashboard

• Product Management: Interface for adding, editing, and deleting product listings, including images and prices.
• Stock Monitoring: Notifications for low stock levels.
• Order Notifications: Email alerts sent to the admin's Gmail for completed orders.

Checkout Page

• Order Summary: Display of selected items, quantities, and total price.
• Payment Options: Integration with online payment methods.
• Confirmation: Order confirmation message and email receipt.

Customer Support

• AI Chatbot: Automated customer care with AI-driven responses.
• WhatsApp Integration: Direct link for customer support via WhatsApp.

3. Functional Requirements

• As an admin, I should be able to add, edit, and delete perfume listings, including images and prices, to manage the product catalog. (explicit)
• As an admin, I should receive notifications via email when a product is out of stock to manage inventory effectively. (explicit)
• As a customer, I should be able to browse and search for perfumes to find products of interest. (basic_default)
• As a customer, I should be able to purchase perfumes using integrated online payment methods to complete transactions. (explicit)
• As a customer, I should receive customer support through an AI chatbot and WhatsApp for assistance with inquiries. (explicit)

4. User Personas

• Admin: Responsible for managing product listings, monitoring stock levels, and receiving order notifications.
• Customer: Browses the platform, searches for perfumes, makes purchases, and interacts with customer support.

5. Core User Flows

Admin Product Management

1. Admin logs into the dashboard.
2. Admin navigates to the product management section.
3. Admin adds a new perfume listing with images and prices.
4. Admin edits existing product details as needed.
5. Admin deletes outdated or unavailable products.
6. Admin receives email notifications for low stock levels.

Customer Shopping Experience

1. Customer visits the home page and browses featured products.
2. Customer uses the search bar to find specific perfumes.
3. Customer selects a product to view detailed information.
4. Customer adds desired products to the cart.
5. Customer proceeds to checkout and selects a payment method.
6. Customer completes the purchase and receives an order confirmation.

Customer Support Interaction

1. Customer accesses the customer support section.
2. Customer interacts with the AI chatbot for assistance.
3. Customer clicks the WhatsApp link for direct support.

6. Visuals Colors and Theme

• Muse: Jessica Walsh
• Palette:
  • Background: #FFFFFF
  • Surface: #FFD700
  • Text: #333333
  • Primary: #FF69B4
  • Accent: #FF4500
  • Muted: #E6E6E6
• Typography:
  • Headings: Archivo Black
  • Body: Syne
  • Scale: 1.5 modular
• Shape Language: Bold color fields, overlapping shapes, sticker-like elements.
• Layout: Asymmetric, vibrant compositions.
• Motion: Bouncy scale-ins, marquee text, color flips on hover.

7. Signature Design Concept

The home page will feature a full-bleed hero section with an oversized, surreal perfume bottle in hot pink and tangerine colors. The design will include playful hover interactions with color flips and marquee text, alongside bold, colorful fields overlapping with product images.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
• Motion Tempo: Expressive
• Hero Dimensionality: Layered_2d
• Landing Hero Motion Brief: The hero section will feature a vibrant perfume bottle with bouncy scale-ins and color flips on hover. The initial frame will showcase the bottle surrounded by playful props, with a reduced-motion state offering a static image.

9. Non-Functional Requirements

• The system must support secure online payment methods to ensure customer data protection. (explicit)
• The platform should maintain high availability and performance to handle peak shopping times. (required_inference)

10. Tech Stack

• Frontend: React
• Backend: Python/FastAPI
• Database: PostgreSQL
• Payment Integration: Stripe or PayPal
• AI Customer Care: Dialogflow
• Deployment: Docker, Kubernetes (if required)

11. Assumptions and Constraints

• The admin will have exclusive access to the dashboard for product management.
• The platform will focus solely on perfume sales and related customer interactions.
• Customer support will be available through AI and WhatsApp only.

12. Glossary

• Admin: The user responsible for managing the product catalog and receiving order notifications.
• Customer: The end-user browsing and purchasing perfumes on the platform.
• AI Chatbot: An automated system providing customer support through predefined responses.
• WhatsApp Integration: A feature allowing direct customer support communication via WhatsApp.