🏭 Makswel Pharmaceuticals SaaS Platform

Ayurvedic Manufacturing + Digital Ecosystem Blueprint

A production-grade, multi-role business operating system for Ayurvedic pharmaceutical manufacturing, distribution, compliance, and social impact.

Live Demo • API Docs • Architecture • Deploy Guide

🎯 Why Makswel?

Makswel Pharmaceuticals needed a unified digital operating system that spans the entire lifecycle of an Ayurvedic manufacturing business — from raw herb sourcing and batch production to B2B distribution, regulatory compliance, and community impact.

This isn't just an ecommerce site. It's a modular monolith covering:

Domain	What It Handles
🏭 Manufacturing	Formula master, batch production, QC/QA, raw material sourcing
📦 Inventory	Multi-warehouse stock, lot tracking, expiry management, movements
💰 Commerce	B2B wholesale, D2C ordering, dealer portals, price lists
📋 Compliance	AYUSH licensing, audit trails, document workflows, renewals
🧪 Research	Publications, peer review, literature repository
💜 Social Impact	Events, scholarships, fundraisers, impact reporting
🤝 CRM	Lead management, support tickets, customer engagement
👥 HR & Training	Employee management, training courses, enrollment tracking
📊 Analytics	Revenue analytics, product performance, margin analysis
💼 Accounts	Payments, ledger, journal entries, reconciliation

✨ Features

🔐 Authentication & Security

Passport.js local authentication with bcrypt password hashing
Google OAuth 2.0 integration for seamless sign-in
Redis-backed sessions for production-grade session management
Role-Based Access Control (RBAC) with 8 distinct roles
Route protection — each dashboard is role-gated at both UI and API level

🏭 Manufacturing Module

Batch creation and lifecycle management (planned → in-progress → QC → completed)
Raw material sourcing with vendor GSTIN tracking
Quality control checks per batch (heavy metals, microbial load, moisture)
Material consumption logging with wastage tracking
Batch document attachments

📦 Inventory Management

Multi-warehouse support with location tracking
Stock items by type (raw materials, packaging, finished goods)
Stock movement history (in, out, transfer, adjustment)
Reorder level alerts
Lot-level expiry tracking

💰 Commerce & Pricing

20 Ayurvedic/Herbal products with therapeutic classifications
Wholesale/MRP dual pricing with margin analysis
CSV export for price lists
Order lifecycle: pending → confirmed → shipped → delivered
Dealer and customer portals

📋 Compliance & Audit

Manufacturing license management with expiry tracking
Compliance task scheduling and assignment
Full audit log capturing all state-changing operations
AYUSH batch record traceability

📊 Analytics & Reporting

Therapeutic area distribution charts
Category breakdown analysis
Revenue and margin analytics
Product performance dashboards

🤝 CRM & Support

Lead management with status pipeline
Support ticket system with priority and category
Customer engagement tracking

👥 HR & Training

Training course management
Employee enrollment and progress tracking
Course status management

🧪 Research & Publications

Research project tracking
Publication management with journal metadata
Peer review workflow

💜 NGO & Social Impact

Event management and scheduling
Scholarship program administration
Fundraiser tracking with goal progress
Beneficiary management

🛠 Tech Stack

┌─────────────────────────────────────────────────────────┐
│                     FRONTEND                            │
│  React 19 · TypeScript · Vite 6 · Tailwind CSS 4       │
│  React Router · Recharts · Lucide Icons                 │
│  React Hook Form · Zod · TanStack Query patterns        │
├─────────────────────────────────────────────────────────┤
│                     BACKEND                             │
│  Express 5 · TypeScript · tsx runtime                   │
│  Passport.js (Local + Google OAuth) · express-session   │
│  bcryptjs · cookie-parser · CORS                        │
├─────────────────────────────────────────────────────────┤
│                     DATABASE                            │
│  PostgreSQL 17 (primary) · Redis 7.2 (sessions/cache)   │
│  30+ database tables · UUID primary keys                │
├─────────────────────────────────────────────────────────┤
│                     INFRASTRUCTURE                      │
│  Docker · Nginx reverse proxy · systemd services        │
│  VPS deployment · SSL/TLS ready                         │
└─────────────────────────────────────────────────────────┘

🏗 Architecture

                    ┌──────────────────────┐
                    │   Client (Browser)    │
                    │   React SPA + Vite    │
                    └──────────┬───────────┘
                               │
                    ┌──────────▼───────────┐
                    │     Nginx (443/80)    │
                    │   SSL Termination     │
                    └──────────┬───────────┘
                               │
                    ┌──────────▼───────────┐
                    │  Express.js (3001)    │
                    │  API + SSR Fallback   │
                    │  Passport.js Auth     │
                    └──┬──────┬──────┬─────┘
                       │      │      │
            ┌──────────▼┐  ┌──▼───┐  ┌▼──────────┐
            │PostgreSQL  │  │Redis │  │  Static    │
            │  (5432)    │  │(6379)│  │  Files     │
            │ 30+ tables │  │Sessions│ │  (dist/)   │
            └───────────┘  └──────┘  └───────────┘

Module Flow

  ┌──────────┐    ┌───────────┐    ┌──────────┐    ┌──────────┐
  │ Sourcing │───▶│ Manufac-  │───▶│   QC /   │───▶│Inventory │
  │  (Raw)   │    │  turing   │    │   QA     │    │  Stock   │
  └──────────┘    └───────────┘    └──────────┘    └────┬─────┘
                                                        │
                   ┌──────────┐    ┌──────────┐    ┌────▼─────┐
                   │ Accounts │◀───│ Invoicing│◀───│  Orders  │
                   │ & Ledger │    │          │    │          │
                   └──────────┘    └──────────┘    └──────────┘

📸 Dashboard Screenshots

🔐 Authentication

Login	Register

🛡️ Admin Dashboard

Overview	User Management	Audit Log

Products	Orders	Manufacturing

Inventory	Compliance	CRM

Support	Accounts	Training

Research	Events	Scholarships	Roles

🏭 Manufacturer Dashboard

Manufacturing Overview

🏪 Dealer Dashboard

Dealer Overview	Products	Orders

🛒 Customer Dashboard

Customer Overview	Products

🧪 QC Inspector Dashboard

QC Overview

💼 Accountant Dashboard

Accounts Overview

🎧 Support Dashboard

Support Overview

👥 HR Dashboard

HR Overview

🔐 Role-Based Access Control

Makswel implements 8 distinct roles with fine-grained route and API protection:

Role	Description	Accessible Modules
admin	Full system access	All modules
manufacturer	Manufacturing operations	Manufacturing, Compliance, Products
dealer	Wholesale partner portal	Dealer Portal, Products, Prices, Orders
customer	Retail buyer portal	Customer Portal, Products, Prices, Orders
qc_inspector	Quality control staff	Compliance, QC checks, Batch verification
accountant	Financial operations	Accounts, Payments, Ledger, Journal
support	Customer support team	CRM, Support Tickets, Lead Management
hr_manager	Human resources	HR Dashboard, Training, Enrollments

How RBAC Works

1. User logs in → Passport.js validates credentials
2. Session created → Stored in Redis with user ID + role
3. Frontend checks role → ProtectedRoute component gates UI
4. API checks role → Middleware verifies session role on each request
5. Sidebar adapts → Only visible nav items for current role

Route Protection Example:

<ProtectedRoute roles={['admin', 'manufacturer']}>
  <ManufacturerDashboard />
</ProtectedRoute>

API Protection Pattern:

router.get('/api/manufacturing/batches', async (req: any, res) => {
  if (!req.session?.userId) return res.status(401).json({ error: 'Unauthorized' })
  // Role-specific logic...
})

🌐 API Endpoints

Authentication

Method	Endpoint	Description
POST	`/api/auth/register`	Register new dealer/customer
POST	`/api/auth/login`	Email + password login
POST	`/api/auth/logout`	Destroy session
GET	`/api/auth/me`	Get current user
GET	`/api/auth/google`	Google OAuth redirect
GET	`/api/auth/google/callback`	Google OAuth callback

Products & Commerce

Method	Endpoint	Description
GET	`/api/products`	List all products with variants
GET	`/api/orders`	List orders (filtered by role)
POST	`/api/orders`	Create new order
GET	`/api/stats`	Dashboard statistics

Admin

Method	Endpoint	Description
GET	`/api/admin/users`	List all users
PATCH	`/api/admin/users/:id`	Update user (role, status)
DELETE	`/api/admin/users/:id`	Delete user
GET	`/api/admin/audit-log`	Full audit trail
GET	`/api/roles`	List all roles

Manufacturing

Method	Endpoint	Description
GET	`/api/manufacturing/batches`	List manufacturing batches
POST	`/api/manufacturing/batches`	Create batch
PATCH	`/api/manufacturing/batches/:id/status`	Update batch status
GET	`/api/manufacturing/qc/:batchId`	QC checks for batch
POST	`/api/manufacturing/qc`	Submit QC result
GET	`/api/manufacturing/raw-materials`	List raw materials
POST	`/api/manufacturing/raw-materials`	Add raw material

Inventory

Method	Endpoint	Description
GET	`/api/inventory/warehouses`	List warehouses
POST	`/api/inventory/warehouses`	Create warehouse
GET	`/api/inventory/stock`	List stock items
POST	`/api/inventory/stock`	Add stock item
GET	`/api/inventory/stock/:warehouseId`	Stock by warehouse
GET	`/api/inventory/movements`	Stock movement history
POST	`/api/inventory/movements`	Record stock movement

CRM & Support

Method	Endpoint	Description
GET	`/api/crm/leads`	List CRM leads
POST	`/api/crm/leads`	Create lead
PATCH	`/api/crm/leads/:id`	Update lead
PATCH	`/api/crm/leads/:id/status`	Change lead status
GET	`/api/support/tickets`	List support tickets
POST	`/api/support/tickets`	Create ticket
PATCH	`/api/support/tickets/:id`	Update ticket

Compliance

Method	Endpoint	Description
GET	`/api/compliance/licenses`	List licenses
POST	`/api/compliance/licenses`	Add license
GET	`/api/compliance/tasks`	List compliance tasks
POST	`/api/compliance/tasks`	Create task

Accounts

Method	Endpoint	Description
GET	`/api/accounts/payments`	Payment history
GET	`/api/accounts/ledger`	Account ledger
GET	`/api/accounts/journal`	Journal entries

Training & HR

Method	Endpoint	Description
GET	`/api/training/courses`	List courses
POST	`/api/training/courses`	Create course
PATCH	`/api/training/courses/:id`	Update course
GET	`/api/training/enrollments`	List enrollments

Research

Method	Endpoint	Description
GET	`/api/research/projects`	List research projects
POST	`/api/research/projects`	Create project
GET	`/api/research/publications`	List publications

Social Impact

Method	Endpoint	Description
GET	`/api/events`	List events
POST	`/api/events`	Create event
GET	`/api/scholarships`	List scholarships
POST	`/api/scholarships`	Create scholarship

🗄 Database Schema

Core Tables (30+)

IDENTITY & ACCESS
├── users              (id, email, password_hash, name, role, company, gstin, ...)
├── roles              (id, name, permissions)

PRODUCTS & COMMERCE
├── products           (id, sku, name, category, formulation, ingredients, ...)
├── product_variants   (id, product_id, pack_size, wholesale_price, mrp_price, ...)
├── orders             (id, user_id, status, total_amount, ...)
└── order_items        (id, order_id, product_id, quantity, unit_price, ...)

MANUFACTURING
├── batches            (id, product_id, batch_no, status, planned_qty, ...)
├── batch_material_consumption (id, batch_id, ingredient_id, qty_used, ...)
├── batch_quality_checks (id, batch_id, test_type, result, passed, ...)
└── raw_materials      (id, name, botanical_name, vendor_gstin, ...)

INVENTORY
├── warehouses         (id, name, location, ...)
├── stock_items        (id, warehouse_id, item_type, qty_on_hand, ...)
├── stock_movements    (id, stock_item_id, movement_type, qty, ...)
└── inventory_lots     (id, stock_item_id, lot_no, expiry_date, ...)

CRM & SUPPORT
├── crm_leads          (id, name, source, status, assigned_to, ...)
└── support_tickets    (id, created_by, subject, priority, status, ...)

COMPLIANCE
├── compliance_licenses (id, license_type, license_no, expiry_date, ...)
├── compliance_tasks   (id, task_type, due_date, status, ...)
└── audit_logs         (id, actor_user_id, action, entity_type, ...)

TRAINING & HR
├── training_courses   (id, title, category, status, ...)
├── training_enrollments (id, course_id, user_id, progress, ...)
└── employees          (id, user_id, designation, department, ...)

RESEARCH
├── research_projects  (id, title, synopsis, status, ...)
└── research_publications (id, title, journal_name, doi, ...)

SOCIAL IMPACT
├── events             (id, name, event_type, start_date, ...)
└── scholarships       (id, name, eligibility, total_amount, ...)

ACCOUNTS
├── accounts_payments  (id, invoice_id, amount, method, status, ...)
├── accounts_ledger    (id, account_id, debit, credit, ...)
└── accounts_journal   (id, entry_date, narration, ...)

🚀 Getting Started

Prerequisites

Node.js 20+
PostgreSQL 17
Redis 7+

Quick Start

# Clone the repository
git clone https://github.com/yashas-13/maxwell.git
cd maxwell

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Edit .env with your credentials

# Set up database
psql -U postgres -c "CREATE USER makswell WITH PASSWORD 'yourpassword';"
psql -U postgres -c "CREATE DATABASE makswell OWNER makswell;"

# Start development
npm run dev

Default Admin Credentials

Email:    cyberjeet13@gmail.com
Password: admin123

Available Scripts

Command	Description
`npm run dev`	Start frontend (Vite) + backend (Express) concurrently
`npm run dev:client`	Frontend only on `:5173`
`npm run dev:server`	Backend only on `:3001`
`npm run build`	Build production bundle
`npm start`	Start production server

🌐 Deployment

Production Setup (Ubuntu VPS)

# 1. Install Node.js, PostgreSQL, Redis
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs postgresql redis-server nginx

# 2. Clone and build
git clone https://github.com/yashas-13/maxwell.git /var/www/makswell
cd /var/www/makswell
npm install
npm run build

# 3. Configure systemd service
sudo tee /etc/systemd/system/makswell.service <<EOF
[Unit]
Description=Makswell Pharmaceuticals SaaS
After=network.target postgresql.service redis.service

[Service]
Type=simple
User=www-data
WorkingDirectory=/var/www/makswell
ExecStart=/usr/bin/node --import tsx server/index.ts
Restart=always
Environment=NODE_ENV=production
Environment=PORT=3001

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable makswell
sudo systemctl start makswell

# 4. Configure Nginx
sudo tee /etc/nginx/sites-available/makswell <<EOF
server {
    listen 80;
    server_name makswell.tech;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host \$host;
        proxy_set_header X-Real-IP \$remote_addr;
        proxy_cache_bypass \$http_upgrade;
    }
}
EOF

sudo ln -s /etc/nginx/sites-available/makswell /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# 5. Enable SSL
sudo certbot --nginx -d makswell.tech

⚙️ Environment Variables

Variable	Description	Required
`DATABASE_URL`	PostgreSQL connection string	✅
`REDIS_URL`	Redis connection string	✅
`SESSION_SECRET`	Express session signing key	✅
`GOOGLE_CLIENT_ID`	Google OAuth client ID	Optional
`GOOGLE_CLIENT_SECRET`	Google OAuth client secret	Optional
`GOOGLE_CALLBACK_URL`	OAuth callback URL	Optional
`PORT`	Server port (default: 3001)	Optional
`NODE_ENV`	`development` or `production`	Optional

📁 Project Structure

makswel-saas/
├── server/                    # Backend (Express.js + TypeScript)
│   ├── index.ts               # Server entry, middleware, auth config
│   ├── db.ts                  # PostgreSQL connection pool
│   └── routes/
│       └── manufacturing.ts   # All 60+ API route handlers
├── src/                       # Frontend (React + TypeScript)
│   ├── App.tsx                # Router config + role-based routes
│   ├── main.tsx               # App entry point
│   ├── context/
│   │   └── AuthContext.tsx     # Auth state, login, register, RBAC types
│   ├── components/
│   │   ├── Sidebar.tsx         # Role-adaptive navigation sidebar
│   │   └── ProtectedRoute.tsx  # Route guard component
│   ├── pages/
│   │   ├── Login.tsx           # Email/password + Google OAuth login
│   │   ├── Register.tsx        # Dealer/Customer registration
│   │   ├── Dashboard.tsx       # Main dashboard with stats
│   │   ├── ProductCatalog.tsx  # 20 Ayurvedic products with search
│   │   ├── PriceList.tsx       # Wholesale/MRP pricing + CSV export
│   │   ├── Orders.tsx          # Order management by role
│   │   ├── Dealers.tsx         # Dealer directory (admin)
│   │   ├── Analytics.tsx       # Revenue & product analytics
│   │   ├── admin/
│   │   │   ├── AdminDashboard.tsx
│   │   │   ├── AdminUsers.tsx
│   │   │   └── AdminAudit.tsx
│   │   ├── manufacturer/
│   │   │   └── ManufacturerDashboard.tsx
│   │   ├── dealer/
│   │   │   └── DealerDashboard.tsx
│   │   ├── customer/
│   │   │   └── CustomerDashboard.tsx
│   │   ├── compliance/
│   │   │   └── ComplianceDashboard.tsx
│   │   ├── crm/
│   │   │   └── CRMDashboard.tsx
│   │   ├── accounts/
│   │   │   └── AccountsDashboard.tsx
│   │   ├── hr/
│   │   │   └── HRDashboard.tsx
│   │   ├── research/
│   │   │   └── ResearchDashboard.tsx
│   │   └── ngo/
│   │       └── NGODashboard.tsx
│   └── lib/
│       └── utils.ts
├── screenshots/               # 72 dashboard screenshots
├── dist/                      # Production build output
├── .env                       # Environment secrets (gitignored)
├── .env.example               # Template for environment variables
├── package.json
├── tsconfig.json
├── vite.config.ts
├── tailwind.config.ts
└── README.md

📊 Product Catalog

Makswel's catalog includes 20 proprietary Ayurvedic medicines across therapeutic categories:

Product	Category	Form	Therapeutic Area
Livozone	Liver Care	Capsule	Yakrut Vikaara
Asmane	Respiratory	Tablet	Shwasa Roga
Garmax	Musculoskeletal	Capsule	Sandhigata Vata
Ashwagandha Plus	Adaptogen	Capsule	Rasayana
Triphala Churna	Digestive	Powder	Vata Balancing
Punarnava Mandur	Blood Purifier	Tablet	Raktashodhaka
Chandraprabha Vati	Urinary	Tablet	Mutravaha Srotas
Sutshekhar Ras	Digestive	Tablet	Amlapitta
Arogyavardhini Vati	Hepatic	Tablet	Yakrut Roga
Mahamanjisthadi Kvath	Blood	Liquid	Raktapitta
Dashamula Kashayam	Anti-inflammatory	Liquid	Vata disorders
Bhumyamalaki Syrup	Hepatoprotective	Syrup	Udara Roga
Kaishore Guggulu	Anti-inflammatory	Tablet	Amavata
Triphala Guggulu	Digestive	Tablet	Obesity
Gokshuradi Guggulu	Urinary	Tablet	Mutra Roga
Yogaraj Guggulu	Musculoskeletal	Tablet	Sandhivata
PanchTikta Ghruta	Skin	Liquid	Kushtha
Mahatikta Ghruta	Skin/Pitta	Liquid	Yonivyapad
Khadiradi Vati	Throat/Dental	Lozenge	Mukha Roga
Laxmivilas Ras	Respiratory	Tablet	Kasa Shwasa

🤝 Contributing

This is a proprietary platform for Makswel Pharmaceuticals. For internal development:

Create a feature branch
Make changes with TypeScript strict mode
Ensure all role-based routes are properly protected
Test with all 8 user roles
Submit PR with description

📄 License

Built with 💊 for Ayurvedic Manufacturing Excellence

From raw herb sourcing to patient impact — one platform, every workflow.

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
docs		docs
public		public
screenshots		screenshots
server		server
src		src
.gitignore		.gitignore
.oxlintrc.json		.oxlintrc.json
README.md		README.md
capture-all.mjs		capture-all.mjs
debug-render.mjs		debug-render.mjs
index.html		index.html
mock-server.mjs		mock-server.mjs
package-lock.json		package-lock.json
package.json		package.json
screenshot-dashboards.mjs		screenshot-dashboards.mjs
take-all-screenshots.mjs		take-all-screenshots.mjs
take-screenshots.mjs		take-screenshots.mjs
test-screenshot.mjs		test-screenshot.mjs
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Folders and files

Latest commit

History

Repository files navigation