System Requirements Document (SRD) for starry-admin

1. Introduction

The starry-admin project is a web-based platform designed to streamline the process of managing medicine orders in India. This system empowers Adarsh Shukla, the admin, to manage products and receive real-time notifications when customers place orders. Customers, primarily medical store owners, can independently register, browse products, and place orders with ease. The platform is designed to be professional, user-friendly, and fully automated, ensuring a seamless experience for both admin and customers.

The system is tailored for the Indian market, with locale-specific considerations such as INR currency, IST timezone, and mobile responsiveness for widespread accessibility.

2. System Overview

The starry-admin system is a centralized platform where:

• Admin (Adarsh Shukla) has full control over product management, including adding, editing, and deleting products, as well as monitoring orders in real-time.
• Customers (Medical Store Owners) can register, browse products, and place orders independently, providing details such as medical store name, owner name, phone number, and delivery address.

The system ensures real-time notifications for the admin when an order is placed, enabling prompt action. It is built with a focus on security, scalability, and professional design, ensuring a robust and reliable solution.

3. Functional Requirements

Admin Features

• As Admin, I should be able to log in securely to the system.
• As Admin, I should be able to add new products with details like name, price, stock, category, and image.
• As Admin, I should be able to edit or delete existing products.
• As Admin, I should be notified instantly when a customer places an order.
• As Admin, I should be able to view all orders and filter them by date or status.
• As Admin, I should be able to update the status of orders (Pending, Confirmed, Dispatched, Delivered).
• As Admin, I should be able to view customer details for each order.

Customer Features

• As a Customer, I should be able to register and log in using my email.
• As a Customer, I should be able to browse all available products.
• As a Customer, I should be able to search and filter products by category.
• As a Customer, I should be able to add products to my cart.
• As a Customer, I should be able to place an order by providing my medical store name, owner name, phone number, and delivery address.

4. User Personas

Admin

• Role: Medicine Dealer (Adarsh Shukla)
• Responsibilities: Manage products, monitor orders, and handle notifications.
• Technical Expertise: Minimal; the system is designed to be fully automated and user-friendly.

Customer

• Role: Medical Store Owner
• Responsibilities: Register, browse products, and place orders.
• Technical Expertise: Basic; the system is intuitive and easy to use.

5. Visuals Colors and Theme

Color Palette for starry-admin

• Background: #F5F7FA (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Navy Blue)
• Accent: #3498DB (Bright Azure Blue)
• Muted Tones: #BDC3C7 (Light Gray)

This palette reflects professionalism and trust, aligning with the healthcare industry while maintaining a clean and modern aesthetic.

6. Signature Design Concept

Interactive Starry Night Homepage

The homepage of starry-admin will feature an interactive starry night theme, symbolizing the project's name and its focus on clarity and guidance. Key elements include:

• Animated Starry Background: A subtle, moving starry sky that creates a calming and professional ambiance.
• Floating Product Cards: Each product card will appear as a "constellation," with smooth hover animations that highlight product details.
• Interactive Navigation: A glowing "star" cursor that leaves a faint trail as users navigate the page.
• Real-Time Notifications: A shooting star animation accompanied by a sound alert whenever a new order is placed.

This design ensures the platform is visually captivating while maintaining usability and professionalism.

7. Non-Functional Requirements

• Performance: The system should load within 2 seconds on a standard 4G connection.
• Scalability: The backend should handle up to 10,000 concurrent users.
• Security: All sensitive data must be encrypted, and APIs should be protected against unauthorized access.
• Availability: The system should maintain 99.9% uptime.
• Responsiveness: The UI must be fully responsive across devices, including desktops, tablets, and smartphones.

8. Tech Stack

Frontend

• React.js
• Tailwind CSS

Backend

• Node.js
• Express.js

Database

• MongoDB Atlas (cloud-based)

Real-Time Notifications

• Socket.io

Deployment

• Frontend: Vercel
• Backend: Render
• Database: MongoDB Atlas

9. Assumptions and Constraints

• Customers will have basic internet access and devices capable of running modern web browsers.
• The admin will be the sole user of the admin panel.
• All customer data will be stored securely in compliance with Indian data protection laws.
• The system will operate in the IST timezone and use INR as the default currency.

10. Glossary

• Admin: The primary user (Adarsh Shukla) responsible for managing the system.
• Customer: Medical store owners who register and place orders.
• JWT: JSON Web Token, used for secure authentication.
• Socket.io: A library for real-time, bidirectional communication between web clients and servers.
• MongoDB Atlas: A cloud-based NoSQL database service.
• Vercel: A platform for deploying frontend applications.
• Render: A platform for deploying backend applications.