M
Musculine HRMS
/ Official User Guide & Manual
Enterprise Documentation v2.4

Musculine HRMS SaaS Operational Guide

Comprehensive walkthrough for testing, configuring, and operating the multi-tenant HRMS platform. Covers instant sandbox onboarding, corporate net banking payroll exports, AI Copilot reasoning, and SaaS host administration.

1. Architecture & Multi-Tenancy Isolation

The platform operates on a high-performance Row-Level Multi-Tenant Architecture. Every company operates within its own cryptographic and organizational boundaries. Under no circumstance can Company A view or access employees, payroll figures, chat channels, or audit logs of Company B.

👑 SaaS Platform Owner (You)

Access to /platform. Can onboard new client companies, monitor global MRR, adjust employee quotas, suspend delinquent tenants, and use one-click "Login-as" impersonation for technical support.

🏢 Tenant Company Admin (Your Customer)

Access to /dashboard. The buyer or HR head who manages their employees, processes statutory payroll, exports corporate net banking payout files, and configures internal chat channels.

2. How to Test Dummy Payment Gateway & Instant Onboarding

We have embedded an Authentic Sandbox Payment Gateway Simulation directly onto the public landing page. This allows any evaluator, investor, or client to experience instant automated workspace provisioning without charging real cards.

✓ Step-by-Step Onboarding Test Workflow:
  1. Visit the homepage at https://hrms.musculine.in/.
  2. Click either "Start 14-Day Free Trial" in the header or choose a plan from the pricing table.
  3. Step 1 Modal (Company Profile):
    • Company Name: e.g. Apex Healthcare Pvt Ltd
    • Admin Name: e.g. Dr. Vikram Mehra
    • Work Email: e.g. vikram@apexhealth.in (must be a new email)
    • Password: e.g. Admin@1234
    • Click "Proceed to Payment & Provisioning →".
  4. Step 2 Modal (Test Gateway Simulation):
    • Choose between "14-Day Free Trial" or "Test Sandbox Payment".
    • Notice the pre-filled dummy card details: 4111 •••• •••• 1111, CVV 123, Exp 12/28.
    • Click "Authorize & Provision Workspace".
  5. Instant Backend Provisioning:

    Watch the animated progress spinner. In 1.5 seconds, the system generates a unique transaction reference (e.g. TXN_SANDBOX_XXXXXX), creates the Company, seeds the Head Office Branch, generates standard HR, Tech, Sales, and Finance departments, sets up the General Shift (09:30 - 18:30), initializes Casual/Sick/Earned leaves, creates the #general and #announcements chat rooms, and logs the new admin directly into their isolated dashboard!

3. SaaS Master Platform Owner Portal (/platform)

As the SaaS platform owner, you have a master administrative dashboard completely isolated from ordinary client HRMS views.

Key Host Features:
  • Global Real-Time KPI Cards: Live count of tenant companies, total managed employees, active subscriptions, and Monthly Recurring Revenue (MRR).
  • Manual Company Provisioning: Click "Add New Client Company" to manually onboard enterprise clients who pay via direct bank wire. Enter company details, select their plan, and credentials are auto-generated.
  • 1-Click Login-As Impersonation: In the companies table, click "Login-As" next to any tenant. You are instantly authenticated into their private workspace for customer support. A prominent yellow banner appears at the top allowing you to click "Return to SaaS Host Portal" at any time.
  • Instant Suspension / Reactivation: Click "Suspend" next to any tenant to immediately disable their workspace access in case of non-payment.

4. Tenant Company Admin Operations Guide

When a client logs in as Administrator, they have full access to their company's HRMS suite:

👥 Employee Directory

Add employees, upload statutory documents, enter bank account numbers with IFSC codes, assign reporting managers, and define custom CTC breakdown structures.

⏰ Shifts & Attendance

Configure morning, general, or night shifts with grace periods. Monitor daily attendance status, late entries, and approve employee regularization punch adjustments in 1 click.

🌴 Leave Approvals

Review pending leave applications (Casual, Sick, Earned). Automatic quota tracking prevents employees from requesting more days than allotted.

⚙️ Company SMTP & AI

At /settings/smtp, admins can configure their own corporate email server (Mailgun, SendGrid, Amazon SES) and input a Google Gemini API Key for private AI assistant reasoning.

5. Corporate Bank Salary Disbursement Files

The payroll module provides an Indian Corporate Net Banking batch disbursement engine. Once a monthly payroll period is closed, the system verifies all employees' bank accounts and generates direct corporate payment files.

Supported Corporate Bank File Formats:
1. Universal NEFT/RTGS Batch CSV

Standard 10-column interbank transfer format compatible with Axis Bank, Kotak, Yes Bank, and IndusInd Bank corporate portals.

2. HDFC Corporate CMS CSV

Exact HDFC Cash Management System layout formatted with Transaction Type (I/N/R), Client Code, and Date stamps.

3. ICICI Corporate CIB CSV

Standard ICICI Corporate Internet Banking batch payment format with debit account and narration tags.

4. SBI Corporate CMP CSV

State Bank of India Corporate Multicity Payment layout for direct bulk upload to SBI Corporate portal.

6. Autonomous AI HR Copilot & Teams Chat

🤖 Enterprise AI HR Copilot

Accessible via the floating bottom-right copilot widget on all screens or full-screen at /ai-assistant.

Try asking:
"How many leaves do I have left?"
"What was my take-home pay and EPF last month?"
"Draft an official notice for Monday standup."

💬 Teams-Style Office Chat

Accessible at /chat. Features corporate channels (#general, #announcements), private direct messages between team members, read status timestamps, and attachment sharing.

7. Employee Self-Service (ESS) Guide

When regular staff log in (e.g. using employee.test@example.com), their interface is strictly scoped to self-service operations:

  • Attendance Punch: Web punch-in and punch-out with live timestamp logging.
  • Regularization Request: If an employee forgot to punch out, they submit an attendance regularization request with reason.
  • Apply for Leaves: Select date range, leave type (Casual, Sick, Earned), and submit for manager approval.
  • Payslip Download: Access PDF/HTML payslips showing gross CTC, basic salary, HRA, EPF, and take-home net pay.

8. Test Dummies & Sandbox Reference Table

Keep this reference handy while demonstrating or reviewing the platform locally or on live server:

Role / Purpose Login Email / Identifier Password / Value Available Capabilities
Tenant Super Admin admin@example.com password123 Full access to company HRMS, payroll, bank exports, SMTP
Employee Self-Service employee.test@example.com password123 Punch attendance, request leaves, chat, ask AI Copilot
Dummy Sandbox Card 4111 1111 1111 1111 Exp: 12/28 • CVV: 123 Simulates instant online payment for new company registration
Dummy Test UPI companyadmin@oksbi N/A (Instant) Simulates instant UPI approval in onboarding modal