> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fentufsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Comprehensive service agreement and request management in Fentu FSM

## Overview

The Service Management module provides end-to-end tools for managing service agreements, contracts, maintenance schedules, customer requests, and complaints. This module bridges the gap between one-time service calls and ongoing customer relationships through structured service contracts and automated maintenance scheduling.

<Note>
  Service Management transforms reactive service calls into proactive customer relationships. By establishing service contracts with scheduled maintenance, you can predict revenue, prevent equipment failures, and improve customer satisfaction.
</Note>

## Module Structure

The Service Management module is organized into five main sections:

<CardGroup cols={2}>
  <Card title="Service Contracts" icon="file-contract" href="/service-management/service-contracts">
    Create and manage service agreements with customers, defining scope, pricing, and maintenance schedules.
  </Card>

  <Card title="Scheduled Maintenances" icon="calendar-check" href="/service-management/scheduled-maintenances">
    View and manage all scheduled preventive maintenance tasks generated from service contracts.
  </Card>

  <Card title="Service Requests" icon="bell" href="/service-management/service-requests">
    Track incoming customer service requests from initial contact through work order creation.
  </Card>

  <Card title="Complaints" icon="triangle-exclamation" href="/service-management/complaints">
    Document and resolve customer complaints, tracking root causes and corrective actions.
  </Card>

  <Card title="Time Tracking" icon="clock" href="/service-management/time">
    Monitor technician time entries, labor hours, and billing for service activities.
  </Card>
</CardGroup>

***

## Key Concepts

### Service Contract Lifecycle

Service contracts follow a structured lifecycle from creation through renewal or termination:

```
Contract Creation
  └─> Scheduled Maintenances Generated
      └─> Work Orders Created Automatically
          └─> Technicians Complete Work
              └─> Contract Renewed or Terminated
```

**Key Stages:**

1. **Contract Setup** - Define customer, assets, service frequency, pricing
2. **Schedule Generation** - System creates scheduled maintenance tasks based on contract terms
3. **Work Order Creation** - Scheduled maintenances automatically generate work orders
4. **Service Delivery** - Technicians complete scheduled maintenance visits
5. **Contract Management** - Track contract performance, renewals, and modifications

### How Components Work Together

<AccordionGroup>
  <Accordion title="Service Contracts → Scheduled Maintenances" icon="arrow-right">
    When you create a service contract with a maintenance schedule (monthly, quarterly, annual), Fentu automatically generates **Scheduled Maintenance** records. These define:

    * Which assets need service
    * How often service occurs
    * What tasks need to be performed
    * Which technicians are assigned

    Scheduled maintenances are the "blueprint" that drives recurring work order creation.
  </Accordion>

  <Accordion title="Scheduled Maintenances → Work Orders" icon="arrow-right">
    Scheduled maintenances automatically generate **Work Orders** when their due date approaches. This automation ensures:

    * No missed maintenance visits
    * Consistent service delivery
    * Predictable technician scheduling
    * Automated customer notifications

    Work orders link back to both the scheduled maintenance and the parent service contract for complete traceability.
  </Accordion>

  <Accordion title="Service Requests → Work Orders" icon="arrow-right">
    When customers report issues via **Service Requests**, dispatchers evaluate the request and either:

    * Create a work order if the request is covered by a service contract
    * Generate a quote if the work is not covered
    * Escalate if the issue is a complaint

    Service requests provide a formal intake process that prevents requests from being lost or forgotten.
  </Accordion>

  <Accordion title="Contracts → Assets → Tools" icon="link">
    Service contracts link to specific **Assets** (equipment) at customer locations. You can also attach:

    * **Tools** - Special equipment required for contract work
    * **Parts Inventory** - Standard parts used during maintenance
    * **Checklists** - Standardized inspection procedures
    * **Document Templates** - Reports and certificates generated after service

    These linked items ensure technicians have everything they need before arriving on site.
  </Accordion>
</AccordionGroup>

***

## Common Workflows

### Setting Up a New Service Contract

<Steps>
  <Step title="Create Contract">
    Define the service agreement including customer, contract period, pricing, and terms.
  </Step>

  <Step title="Add Assets">
    Select which assets (equipment) are covered by the contract.
  </Step>

  <Step title="Define Schedule">
    Set maintenance frequency (monthly, quarterly, annual) and preferred service windows.
  </Step>

  <Step title="Generate Scheduled Maintenances">
    System automatically creates scheduled maintenance records based on contract terms.
  </Step>

  <Step title="Assign Technicians">
    Designate which technicians or teams will handle contract work.
  </Step>
</Steps>

### Processing a Service Request

<Steps>
  <Step title="Customer Submits Request">
    Request comes in via phone, email, customer portal, or walk-in.
  </Step>

  <Step title="Create Service Request Record">
    Dispatcher documents the request with customer, asset, and issue details.
  </Step>

  <Step title="Evaluate Coverage">
    Check if customer has a service contract covering this issue.
  </Step>

  <Step title="Create Work Order or Quote">
    If covered: create work order. If not covered: generate quote for approval.
  </Step>

  <Step title="Schedule and Complete">
    Assign technician, schedule visit, complete work, and close service request.
  </Step>
</Steps>

### Handling a Complaint

<Steps>
  <Step title="Document Complaint">
    Record customer complaint with all relevant details and context.
  </Step>

  <Step title="Investigate">
    Assign ownership, review related work orders, identify root cause.
  </Step>

  <Step title="Implement Corrective Action">
    Take steps to resolve the issue and prevent recurrence.
  </Step>

  <Step title="Follow Up">
    Contact customer to ensure satisfaction and document resolution.
  </Step>

  <Step title="Close and Learn">
    Close complaint and use insights to improve processes.
  </Step>
</Steps>

***

## Benefits of Service Contracts

<CardGroup cols={2}>
  <Card title="Predictable Revenue" icon="chart-line">
    Service contracts provide recurring revenue that's easier to forecast than one-time service calls. Build a stable base of contract income.
  </Card>

  <Card title="Preventive Maintenance" icon="shield-check">
    Regular scheduled maintenance prevents equipment failures and emergency calls, reducing costs for both you and your customers.
  </Card>

  <Card title="Customer Retention" icon="handshake">
    Contract customers are more loyal and provide higher lifetime value than one-time service customers.
  </Card>

  <Card title="Efficient Scheduling" icon="calendar">
    Scheduled maintenances allow better resource planning and route optimization compared to reactive service calls.
  </Card>

  <Card title="Improved Margins" icon="dollar-sign">
    Preventive maintenance is more profitable than emergency repairs. Contracts allow you to charge premium rates for guaranteed service.
  </Card>

  <Card title="Competitive Advantage" icon="trophy">
    Offer contracts as a premium service tier that differentiates you from competitors who only handle emergency calls.
  </Card>
</CardGroup>

***

## Service Contract Components

### Assets

Service contracts specify which assets (equipment) are covered. Understanding asset coverage is critical:

* **Fully Covered** - All service, parts, and labor included
* **Labor Only** - Service visits covered, customer pays for parts
* **Parts Only** - Parts covered, customer pays labor
* **Inspection Only** - Regular inspections covered, repairs quoted separately

Link assets to contracts so technicians know exactly what equipment is included in the agreement.

### Scheduled Maintenances

These are recurring maintenance tasks generated from contracts:

* **Frequency** - How often maintenance occurs (monthly, quarterly, annual)
* **Tasks** - What work needs to be done during each visit
* **Tools Required** - Special equipment needed for maintenance
* **Duration** - Expected time for each maintenance visit
* **Preferred Schedule** - Customer preferences for service timing (after hours, weekends, etc.)

Scheduled maintenances auto-generate work orders, ensuring consistent service delivery.

### Tools

Some contracts require specialized tools or equipment:

* Specific test equipment for certain assets
* Safety equipment for confined space or high-voltage work
* Diagnostic tools for specialized machinery
* Calibration equipment

Linking tools to contracts ensures technicians bring the right equipment and don't waste time with return trips.

***

## Best Practices

<AccordionGroup>
  <Accordion title="Start with Standard Contract Templates" icon="file">
    Create standard contract templates for common scenarios:

    * Basic Machine annual maintenance
    * Comprehensive facility management
    * Equipment-specific agreements (elevators, generators, etc.)

    Templates save time and ensure consistent pricing and terms across customers.
  </Accordion>

  <Accordion title="Build Contracts Around Asset Types" icon="barcode">
    Structure contracts based on asset categories rather than generic "facility maintenance":

    * Machine Contract - covers all heating and cooling equipment
    * Elevator Contract - covers all vertical transport equipment
    * Fire & Life Safety Contract - covers alarm and suppression systems

    Asset-based contracts are easier to price and deliver consistently.
  </Accordion>

  <Accordion title="Use Scheduled Maintenance Automation" icon="robot">
    Let the system generate work orders automatically from scheduled maintenances. This:

    * Eliminates manual work order creation
    * Prevents missed visits
    * Ensures consistent scheduling
    * Provides automatic customer notifications
  </Accordion>

  <Accordion title="Track Service Requests Formally" icon="clipboard-list">
    Don't rely on emails and phone logs. Log every service request in the system:

    * Creates accountability
    * Prevents lost requests
    * Provides metrics on response times
    * Documents customer interactions for quality and training
  </Accordion>

  <Accordion title="Document Complaints Thoroughly" icon="note-sticky">
    Complaints are learning opportunities. Document:

    * What went wrong and why
    * What corrective action was taken
    * How you'll prevent recurrence
    * Customer satisfaction after resolution

    This creates a knowledge base for improving service quality.
  </Accordion>

  <Accordion title="Review Contract Performance Regularly" icon="chart-mixed">
    Analyze contract profitability and performance:

    * Are you completing maintenance on schedule?
    * Are contracts profitable or losing money?
    * Which contracts have the most service requests or complaints?
    * Are renewal rates meeting targets?

    Use these insights to adjust pricing and service delivery.
  </Accordion>
</AccordionGroup>

***

## Metrics to Track

### Contract Health

* Total active contracts
* Contract value (MRR/ARR)
* Renewal rate
* Contract profitability by type

### Service Delivery

* Scheduled maintenance completion rate
* Average response time to service requests
* Work order completion rate for contract vs non-contract customers
* Customer satisfaction scores

### Complaint Management

* Number of complaints per month
* Average time to resolution
* Repeat complaints (same issue/customer)
* Root cause categories

### Time Tracking

* Labor hours per contract
* Actual vs budgeted time
* Billable vs non-billable hours
* Technician productivity

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Your First Service Contract" icon="file-contract" href="/service-management/service-contracts">
    Learn how to set up service agreements with customers.
  </Card>

  <Card title="Manage Scheduled Maintenances" icon="calendar-check" href="/service-management/scheduled-maintenances">
    View and manage automated maintenance schedules.
  </Card>

  <Card title="Process Service Requests" icon="bell" href="/service-management/service-requests">
    Handle incoming customer service requests efficiently.
  </Card>

  <Card title="Work Order Wizard" icon="wand-magic-sparkles" href="/service-apps/wizards/work-order-wizard">
    See how contracts connect to work order creation.
  </Card>
</CardGroup>
