1. System Overview & Access

The MT-LMS uses separated portals to ensure security and specific functionality for each user type.

2. Employee Portal Guide (Livewire)

Dashboard View

The dashboard provides a real-time summary of your current leave entitlements, calculated based on accrual rules and pending requests.

• Detailed Balance Cards: Show specific entitlement details (Total Allowed, Earned, Spent, Balance) for Annual, Casual, and Sick Leave.

• Actionable History: Lists all requests with current status. Only **Pending** requests can be edited.

• Upcoming Leaves: Displays all requests that have been **Approved** and have a future start date.

Applying for Leave (Form Logic)

The application form utilizes intelligent validation to guide you before submission.

• Eligibility Filter: Only shows leave types for which you meet the min_service_years and gender criteria.

• Date Constraints: Prevents requests that start or end more than 15 days from the current date.

• Action Plan Feedback: A notification toast appears dynamically, informing you of the system's plan:

  • Green/Success: Balance is sufficient.
  • Yellow/Warning: Adjustment is required (e.g., Casual deficit covered by Annual balance).
  • Red/Danger: LWP is required (All entitlements exhausted).

3. Manager Action Panel (Filament)

Managers use the central 'Take Action' modal to approve or reject requests only after verifying the financial impact.

Action Flow and Data Context

• Full Context: The modal displays the Request Details side-by-side with the employee's Current Available Balances (Earned/Spent/Remaining).

• Adjustment Audit: The manager can clearly see the System's Action Plan (e.g., "Adjust 2 days from Annual, 0 days LWP").

• Approval Execution: Clicking 'Approve Request' triggers a single atomic transaction:

  • Updates supervisor_status to Approved.
  • Recalculates and overwrites the LeaveBalances table (Source of Truth principle).
  • Calculates the final salary_deduction_amount and saves it to the request log.

• Rejection: Requires entering a Rejection Reason before submission, which is saved to supervisor_notes.

4. Employer Admin Panel (Filament)

This panel is strictly multi-tenant. Admins only manage data for the company they are linked to.

Policy Management

• Automated Setup: Mandatory leave types (Annual, Sick, Casual, Maternity) are automatically seeded upon company creation.

• Customization: Admins customize parameters like max_days and min_service_years (e.g., set Annual to require 1 year).

• Protection: Critical, seeded types are protected from deletion (is_deletable = false).

5. Core Logic & Rules Summary