DYI System Requirements Document

1. Introduction

The DYI project aims to create a premium digital platform for a small DIY craft business. The focus is on delivering a visually compelling and artistically rich experience that highlights the handcrafted nature of the products. The platform will include both a customer-facing website and an admin dashboard, each tailored to the unique needs of the business and its clientele.

2. System Overview

The DYI platform will serve as a digital storefront and management tool for a small DIY craft business. It will enable customers to explore, understand, and purchase handmade products while providing the business owner with tools to manage inventory, orders, and customer interactions. The design will emphasize visual storytelling and creativity, ensuring that the platform feels both modern and artisanal.

3. Functional Requirements as Story Points

• As a Customer, I should be able to discover the brand and understand what the business creates.
• As a Customer, I should be able to explore all available DIY products.
• As a Customer, I should be able to view individual product details and understand what is included in each product.
• As a Customer, I should be able to see product images and different product information.
• As a Customer, I should be able to add products to my cart.
• As a Customer, I should be able to add products to my wishlist.
• As a Customer, I should be able to purchase products through checkout.
• As a Customer, I should be able to complete online payment.
• As a Customer, I should be able to view my orders and track delivery progress.
• As a Customer, I should be able to view previous orders and manage my profile.
• As an Admin, I should be able to view an overview/business dashboard.
• As an Admin, I should be able to manage products, product details, and pricing.
• As an Admin, I should be able to manage inventory/stock.
• As an Admin, I should be able to manage orders, order status, and delivery progress.
• As an Admin, I should be able to manage customers and view wishlist/activity insights.
• As an Admin, I should be able to view sales, revenue, best-selling products, and low-stock products.
• As an Admin, I should be able to access basic business analytics.

4. User Personas

• Customer: Individuals interested in purchasing DIY craft products. They value creativity, storytelling, and the handcrafted nature of products.
• Admin: The business owner or manager responsible for overseeing product listings, inventory, orders, and customer interactions.

5. Core User Flows

• Customer Flow: Discover brand → Explore products → View product details → Add to wishlist/cart → Checkout → Payment → Order tracking.
• Admin Flow: Access dashboard → Manage products/stock → Manage orders → View sales insights.

6. Visuals Colors and Theme

• primary: #8B4513 (Saddle Brown)
• primary_light: #D2B48C (Tan)
• secondary: #F5DEB3 (Wheat)
• accent: #CD853F (Peru)
• highlight: #FFD700 (Gold)
• bg: #FFF8DC (Cornsilk)
• surface: #FAEBD7 (Antique White)
• text: #2F4F4F (Dark Slate Gray)
• text_muted: #A9A9A9 (Dark Gray)
• border: #D3D3D3 (Light Gray)

7. Signature Design Concept

Interactive Craft Workshop

The homepage will feature an interactive craft workshop scene where users can explore different DIY projects. Each project will be represented by a miniature model that users can click to expand and view details. The models will be crafted from paper, wood, and other materials, reflecting the brand's handmade ethos. As users hover over each model, subtle animations will bring the scene to life, such as paper folding or wood carving.

Landing Hero Motion Brief

The landing hero will depict a transformation of raw materials into a finished DIY product. Users will see paper, wood, and other materials gather around a central workspace. Through a series of animations, these materials will transform into a completed product, showcasing the craftsmanship involved. The animation will loop every 10 seconds, with interactive elements allowing users to pause or explore specific stages of the process.

8. Interaction Model & Motion Direction

• Intended Interaction Model: Parallax
  • Layered depth via scroll with decorative layers translating at different speeds.
  • Real content stays in normal flow and scrolls naturally.
  • Suitable for storytelling and visually rich first impressions.

9. Non-Functional Requirements

• The platform must be responsive and accessible across all devices.
• Ensure fast loading times and optimized performance.
• Maintain high security standards for customer data and transactions.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, use alembic for migrations
• Local Orchestration: Docker, docker-compose

11. Assumptions and Constraints

• The platform will cater to a small product catalog with a maximum of 6 products.
• The design will prioritize storytelling and craftsmanship over traditional ecommerce layouts.
• The admin dashboard will be simplified to avoid unnecessary complexity.

12. Glossary

• DIY: Do It Yourself, referring to handmade or self-assembled products.
• Parallax: A design technique where background images move slower than foreground images, creating an illusion of depth.
• Wishlist: A feature allowing customers to save products for future consideration.