wise-mithai

Introduction

The "wise-mithai" project aims to develop a comprehensive mobile application for a mithai (sweet shop) named "Mishti Bhog". This application will provide customers with a seamless experience for exploring, ordering, and purchasing a variety of sweets. The app will also include features for managing advertisements, enhancing business revenue, and providing a user-friendly interface for both customers and administrators.

System Overview

The "wise-mithai" application is designed to cater to the needs of a mithai shop, offering functionalities similar to popular mithai shop apps like Bikanervala. The app will support online ordering, payment processing, and packaging confirmation. Additionally, it will include an advertisement feature to help generate additional revenue. The system will be accessible to different user personas, including customers and administrators, each with specific roles and functionalities.

Functional Requirements

• As a Customer, I should be able to explore various mithai options available in the shop.
• As a Customer, I should be able to place an order and make payments online.
• As a Customer, I should receive a confirmation once my mithai is packed.
• As an Admin, I should be able to manage orders and track their status.
• As an Admin, I should be able to configure and run advertisements within the app.

User Personas

• Customer: Individuals who browse, order, and purchase mithai from the app.
• Admin: Shop owners or managers who manage orders, payments, and advertisements.

Visuals Colors and Theme

• primary: #D2691E (Chocolate Brown)
• primary_light: #F4A460 (Sandy Brown)
• secondary: #FFD700 (Gold)
• accent: #FF4500 (Orange Red)
• highlight: #FFA500 (Orange)
• bg: #FFF8DC (Cornsilk)
• surface: rgba(255, 248, 220, 0.8)
• text: #8B4513 (Saddle Brown)
• text_muted: #A0522D (Sienna)
• border: rgba(139, 69, 19, 0.2)

Signature Design Concept

The "wise-mithai" app will feature an interactive, vibrant landing page that immerses users in a virtual mithai shop experience. The homepage will be designed as a 3D virtual tour of the shop using @react-three/fiber and @react-three/drei. Users can navigate through different sections of the shop, each showcasing a variety of mithai displayed on elegant, rotating platters. As users hover over each mithai, detailed descriptions and prices will appear, and clicking on them will add items to the cart. The background will feature subtle animations of floating sweets, creating a delightful and engaging experience. This interactive design will make the app not only functional but also visually captivating.

Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, providing a layered depth experience as users scroll through the app. Decorative elements like floating sweets and atmospheric particles will move at different speeds, creating a dynamic and immersive storytelling environment. Internal pages such as the dashboard and order management will use a "static" interaction model to ensure clarity and ease of use.

Non-Functional Requirements

• The application should be responsive and work seamlessly across various devices and screen sizes.
• The system should handle concurrent users efficiently without performance degradation.
• Data security and user privacy must be ensured, especially for payment transactions.

Tech Stack

• Frontend: React for Web, React Native for mobile app
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The app will primarily target users in India, considering local preferences and payment methods.
• The system will support English and Hindi languages for broader accessibility.
• The app will comply with local regulations regarding online transactions and data privacy.

Glossary

• Mithai: Traditional Indian sweets.
• Admin: A user role responsible for managing the app's backend operations.
• Customer: A user role for individuals purchasing mithai through the app.
• Parallax: A design technique that creates an illusion of depth by moving background images slower than foreground images.
• Static: A design approach focusing on minimal motion for clarity and ease of use.