MediVerify Pro is a professional Full-Stack solution (MERN Architecture) designed to combat counterfeit medicine. It empowers medical administrators to manage pharmaceutical inventory and generate unique, secure serial numbers, while providing a public portal for consumers to instantly verify product authenticity and safety status — backed by a real-time AI Health Advisor powered by Groq LLaMA.

Dark Mode Interface	Light Mode Interface
Premium Particle Canvas Design	Clean & Professional UI

Dark Mode Interface	Light Mode Interface

• Secure Access: Robust login/registration system using JWT (JSON Web Tokens) and Bcryptjs for password hashing.
• Inventory Control (CRUD): Full management of medicine records (Create, Read, Update, Delete).
• Smart Serial Generation: Utilizes Crypto to generate high-entropy, unique identifiers in the format MV-XXXX-XXXX.
• Live Search: Instant client-side filtering to navigate through large medicine databases efficiently.
• Dashboard Stats: Real-time counters for Total, Active, Expired, and Today's medicines.

• Instant Check: Consumers can verify product serial numbers without an account.
• Double-Safety Logic: The system checks if the serial exists AND validates the Expiry Date to warn against outdated products.
• Dynamic Results: Inline result cards (Authentic ✅, Expired ⚠️, Counterfeit ❌) rendered directly on the page without popups.
• QR Code Scanner: Camera-based scanning using jsQR — consumers can scan packaging directly from their phone browser with no app required.

• Symptom Analysis Chat: A full conversational AI chat interface where users describe symptoms and receive structured pharmaceutical guidance.
• Web Search Integration: The AI uses Brave Search API + Groq tool-calling to fetch real-time, accurate medicine information before responding — not hallucinated data.
• Strict Medical Rules: The AI never diagnoses, never invents drug interactions, never guesses symptoms from a medicine name, and always recommends consulting a physician.
• Structured Response Format: Responses follow a fixed clinical format covering Active Ingredients, Dosage, Warnings, Drug Interactions, and When to Seek Medical Advice.
• Conversation History: Multi-turn chat with session memory (last 20 messages) for contextual follow-up questions.
• Bulk Medicine Generator: One-click generation of 10 verified medicines simultaneously with live progress bar and auto database entry.
• Quick Symptom Chips: Pre-built shortcut buttons for common conditions (Fever, Cold, Allergy, Pain Relief, etc.).
• Secure Architecture: Groq and Brave Search API keys are stored server-side in .env and never exposed to the frontend.

• Animated Particle Canvas: Dynamic WebGL-style particle network rendered on an HTML5 canvas for a premium background effect.
• Boot Loader: Professional animated loader screen with triple-ring spinner on startup.
• Theme Persistence: Dark/Light mode toggle with smooth transitions, saved in localStorage.
• Toast Notifications: Lightweight, non-blocking toast system replacing popup alerts.
• Fully Responsive: Mobile-first layout that works on all screen sizes.

mediverify/
├── app.js                   # Server entry point, middleware, rate limiting
├── middleware/
│   └── auth.js              # JWT verification & route protection
├── models/
│   ├── Medicine.js          # Mongoose schema for medicine records
│   └── User.js              # Mongoose schema for admin users
├── public/
│   ├── index.html           # Main SPA entry point
│   ├── script.js            # Frontend logic, QR scanner, AI chat, canvas
│   └── style.css            # Custom CSS, dark/light theme, animations
├── routes/
│   ├── authRoutes.js        # Authentication API endpoints
│   ├── medicineRoutes.js    # Medicine CRUD & verification endpoints
│   └── aiRoutes.js          # AI chat (with web search) + bulk generate
├── .env.example             # Environment variable template
├── package.json             # Project dependencies & scripts
└── README.md                # Project documentation

git clone https://github.com/MomenElsayedDev/MediVerify-Pro.git
cd MediVerify-Pro

npm install

Create a .env file in the root directory:

PORT=3000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_super_secret_key_min_32_chars
GROQ_API_KEY=your_groq_api_key
BRAVE_SEARCH_API_KEY=your_brave_search_api_key

Getting API Keys:

• Groq: Free at console.groq.com
• Brave Search: Free tier (2,000 req/month) at api.search.brave.com

# Development mode (with Nodemon)
npm run dev

# Production mode
npm start

🟢 Rate Limiting: Global 200 req/15min + AI-specific 20 req/min to prevent abuse and protect API quotas.

🟢 JWT Route Protection: All write operations (add, update, delete) require a valid admin token.

🟠 CORS Enabled: Cross-Origin Resource Sharing configured for secure frontend-backend communication.

🟢 Real-Time AI Data: Web search tool-calling ensures medicine information is fetched from live sources, not AI memory.

🟠 Graceful Fallback: If Brave Search is unavailable, the AI falls back to its internal knowledge without crashing.

🟢 Collision-Resistant Serials: Crypto-based serial generation with uniqueness retry loop — format MV-XXXX-XXXX.

🟢 Secure API Keys: All API keys stored server-side in .env and never exposed to the frontend.

Momen Elsayed

• GitHub: @MomenElsayedDev
• LinkedIn: momen-elsayed-dev