System Requirements Document (SRD)

Project Name: heroic-demo

1. Introduction

The heroic-demo project is a website designed for a medical shop based in India. The goal is to serve both local customers visiting the physical store and online customers seeking convenience through digital ordering and delivery services. This document outlines the system requirements for the project, ensuring it meets the needs of its target audience while adhering to locale-specific considerations such as currency (INR), timezone (IST), and user expectations.

2. System Overview

The heroic-demo website will provide a seamless experience for customers looking to purchase medicines and health-related products. It will cater to two primary user groups:

1. Local customers who prefer visiting the physical store.
2. Online customers who wish to browse, order, and track deliveries from the comfort of their homes.

The system will include features such as:

• A searchable catalog of medicines and health products.
• Online ordering and secure payment options.
• Prescription upload functionality for regulated medicines.
• Delivery tracking for online orders.
• Store location details for walk-in customers.
• Health advice and educational sections to promote wellness.

3. Functional Requirements

Story Points:

• As a User, I should be able to search for medicines and health products by name or category.
• As a User, I should be able to upload prescriptions for regulated medicines.
• As a User, I should be able to place orders online and make secure payments.
• As a User, I should be able to track the delivery status of my orders.
• As a User, I should be able to view store location details and operating hours.
• As a User, I should be able to access health advice and educational content.
• As an Admin, I should be able to manage the product catalog (add, update, delete items).
• As an Admin, I should be able to verify uploaded prescriptions.
• As an Admin, I should be able to manage orders and delivery statuses.
• As an Admin, I should be able to view and analyze sales reports.

4. User Personas

1. Local Customer

• Visits the physical store for purchases.
• Uses the website to check store location, operating hours, and product availability.

2. Online Customer

• Prefers ordering medicines and health products online.
• Uploads prescriptions for regulated medicines.
• Tracks delivery status and accesses health advice.

3. Admin

• Manages the product catalog, verifies prescriptions, and oversees orders.
• Analyzes sales data to improve business operations.

5. Visuals Colors and Theme

Unique Color Palette:

The heroic-demo website will use a fresh, vibrant color palette inspired by health and wellness:

• Background: #F5F9FF (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2B2D42 (Deep Charcoal)
• Accent: #4CAF50 (Healthy Green)
• Muted Tones: #A0AEC0 (Calm Gray)

This palette reflects trust, cleanliness, and vitality, aligning with the medical shop's identity.

6. Signature Design Concept

Concept: Interactive Medicine Shelf

The homepage will feature an Interactive Medicine Shelf design. Imagine a virtual shelf where medicines and health products are displayed as clickable cards. Each card will "slide out" with a smooth animation when hovered over, revealing detailed product information, pricing, and an "Add to Cart" button.

Additional features:

• Dynamic Search Bar: Positioned at the top, it will allow users to type in medicine names and see instant suggestions.
• Prescription Upload Animation: A drag-and-drop area with a glowing border that reacts when a file is uploaded.
• Delivery Tracker: A live map widget showing the delivery vehicle's location.
• Health Advice Section: Animated icons representing different health topics that expand into articles when clicked.

This design will captivate users, making the website feel modern, interactive, and user-friendly.

7. Non-Functional Requirements

• The website must load within 3 seconds for optimal user experience.
• It must support high availability with 99.9% uptime.
• The system should be scalable to handle increased traffic during peak times.
• Data security measures must comply with Indian regulations, including encryption for sensitive data.
• The website must be mobile-responsive and accessible across devices.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database RDBMS:

• MySQL (with Alembic for migrations)

Database NoSQL:

• MongoDB

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work

AI Tools:

• Litellm for LLM Routing
• Langchain

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

Assumptions:

• Users will have access to stable internet connections for online ordering.
• Prescription uploads will be in standard image or PDF formats.
• Delivery services will be available within a defined geographic area.

Constraints:

• Compliance with Indian medical regulations for prescription medicines.
• Integration with payment gateways supporting INR transactions.
• Limited delivery radius for online orders based on logistics capabilities.

10. Glossary

• Interactive Medicine Shelf: A virtual representation of a store shelf where products are displayed as clickable cards.
• Prescription Upload: A feature allowing users to upload prescriptions for regulated medicines.
• Delivery Tracker: A live map widget showing the real-time location of delivery vehicles.
• Health Advice Section: An area of the website providing educational content on health and wellness topics.
• LLM Routing: A tool for managing and directing queries to the appropriate AI model.

This document ensures the heroic-demo project is well-defined and ready for development. Harsh, let me know if there are any additional features or adjustments you'd like to make!