System Requirements Document (SRD)

Project Name: crystal-pharmacy

1. Introduction

The crystal-pharmacy project is an AI-powered Pharmacy Stock, Billing, and Lab Management System designed for retail pharmacies, clinics, and diagnostic labs in India. This system adheres to Indian Pharmacopoeia standards and PCI guidelines, ensuring compliance with local healthcare regulations.

The platform integrates advanced AI automation, a comprehensive backend, a vast medical database, and enterprise-level security to streamline pharmacy and lab operations. It is tailored to meet the unique needs of the Indian healthcare sector, including multi-language support, GST compliance, and robust role-based access control.

2. System Overview

The crystal-pharmacy system is a full-stack application that provides:

• Web and Mobile Compatibility: Accessible via web browsers and mobile apps for Android and iOS.
• AI-Powered Features: Automates stock entry, billing, and lab test management using AI-driven tools.
• Comprehensive Medical Database: Includes 20,000+ medicines, 3,000+ salts, and 2,000+ manufacturers.
• Lab Management Module: Supports diagnostic labs with preloaded tests, patient management, and AI-enhanced data entry.
• Secure Backend: Ensures data integrity, role-based access, and compliance with Indian healthcare standards.
• Real-Time Analytics: Provides actionable insights through an interactive dashboard.

This system is designed to enhance operational efficiency, reduce manual errors, and provide a seamless user experience for pharmacy owners, staff, and customers.

3. Functional Requirements

As User:

• I should be able to log in or sign up using email or Google.
• I should be able to view my profile in the dashboard.
• I should be able to toggle between light and dark modes.
• I should be able to search for medicines quickly.
• I should be able to view medicine details, including brand name, generic alternatives, and manufacturer info.
• I should be able to generate and download invoices in PDF format.

As Admin:

• I should be able to manage stock using AI tools like barcode scanning, QR code scanning, and manual entry.
• I should be able to track expiry dates and receive alerts for near-expiry and expired medicines.
• I should be able to add, edit, or delete lab tests and their parameters.
• I should be able to generate reports for stock, billing, and lab tests.
• I should be able to manage user roles and permissions.

As Pharmacist:

• I should be able to scan distributor bills and auto-update stock.
• I should be able to filter stock by expiry date, manufacturer, and low stock.
• I should be able to process billing with GST calculations and discounts.

4. User Personas

1. Owner

• Role: Pharmacy or clinic owner.
• Needs: Comprehensive analytics, stock management, and role-based access control.

2. Pharmacist

• Role: Handles daily operations like stock entry and billing.
• Needs: Fast and accurate tools for stock updates and billing.

3. Staff

• Role: Assists in lab management and customer service.
• Needs: Easy-to-use interfaces for lab test entry and patient management.

5. Visuals Colors and Theme

Color Palette:

• Background: #F4F9F9 (Soft Mint White)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Navy Blue)
• Accent: #1ABC9C (Emerald Green)
• Muted: #BDC3C7 (Light Gray)

This palette reflects a clean, professional, and calming aesthetic suitable for healthcare applications.

6. Signature Design Concept

Dynamic Medicine Shelf Homepage

The homepage will feature an interactive 3D medicine shelf. Users can "browse" the shelf by swiping or scrolling, with each medicine appearing as a clickable card. When a card is clicked, it flips to reveal detailed information about the medicine, including brand name, generic alternatives, and manufacturer details.

Key Features:

• 3D Animation: Smooth transitions as users scroll through the shelf.
• Micro-Interactions: Cards will slightly "tilt" when hovered over, providing a tactile feel.
• Color Transitions: The background will subtly shift between shades of emerald green and soft mint white as users interact with the shelf.
• AI Integration: A search bar at the top allows users to type symptoms or scan barcodes, instantly highlighting relevant medicines on the shelf.

This design will make the homepage visually engaging and intuitive, leaving a lasting impression on users.

7. Non-Functional Requirements

• Performance: The system must handle up to 10,000 concurrent users with minimal latency.
• Scalability: Must support future expansion, including additional AI modules or database entries.
• Security: Implement JWT authentication, encrypted databases, and secure APIs.
• Compliance: Adhere to Indian healthcare standards, including PCI and GST regulations.

8. Tech Stack

Frontend:

• React for Web
• React Native for Mobile

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for coding-related tasks
• Google Nano Banana for image generation

AI Tools:

• Litellm for LLM Routing
• Langchain

Orchestration:

• Docker
• Kubernetes

9. Assumptions and Constraints

• The system will primarily serve users in India, so it must support INR currency and Indian time zones.
• Internet connectivity is required for real-time database synchronization and AI processing.
• The system will not include an AI prescription reader module.

10. Glossary

• AI OCR: Optical Character Recognition powered by Artificial Intelligence.
• PCI: Pharmacy Council of India.
• GST: Goods and Services Tax, applicable in India.
• JWT: JSON Web Token, used for secure authentication.
• MFG Date: Manufacturing Date.
• EXP Date: Expiry Date.