Savmanager

# Savmanager User Guide

Savmanager is a Dolibarr module to manage after-sales service (SAV) interventions.

## Overview

- Track interventions with status, priority, technicians, and locations.

- Calendar views: Month and Week, with outside-working-hours alerts.

- Configurable colors and display limits per calendar cell.

- Multi-language: FR, EN, DE, IT.

- Additional fields (Extrafields): supported using Dolibarr’s native functions.

## Installation

1. Copy the `savmanager/` folder into `htdocs/custom/`.

2. Enable the module in Dolibarr: Home → Setup → Modules → Savmanager.

3. Go to Savmanager setup page to configure options.

## Setup

Open Savmanager → Admin → Setup.

- Default status: initial status applied to new SAV (configurable).

- Auto customer notification: send an email to the customer when status changes.

- Repair deadline (days): number of days before a warning triggers.

- Calendar display limits:

- Week view: max visible items per slot.

- Month view: max visible items per day (a “More” link reveals the rest).

- "More/Less" button style: appearance of the toggle (link, button, badge, icon). Optional custom CSS class.

- Status colors: choose a color per status (Draft, Validated, In progress, etc.).

- Priority colors: choose a background color for Normal, Urgent, Critical.

- Week view hours: first and last hour shown in the weekly grid.

- Intervention working hours (alerts): time range considered “working hours” for the outside-hours banner.

## Creating a SAV

- Third party required. If missing, the module prevents creation.

- Fill key fields: product (optional), serial number, problem type, priority, dates, technicians, location.

- Save. By default, an initial status is applied (configurable).

## Editing rules

- You can modify a SAV for all statuses except Closed.

- Server-side checks block updates if status = Closed.

## Calendar

- Month view: shows events with status badge, technicians initials, and town aligned right.

- If the number of events exceeds the per-day limit, a `+N` badge appears near the day number and a "More" link toggles hidden items.

- Week view: configurable working hours grid.

- Outside-hours events appear in the "All day" row.

- A banner lists SAV outside intervention hours for the current week.

## Outside-hours banner

- Configured by the intervention working hours in Setup.

- Displays a warning with the count and the list of affected SAVs.

## Translations

- Language files in `savmanager/langs/` for FR, EN, DE, IT.

## Known tips

- If icons are too large, ensure `savmanager/css/savmanager.css` is loaded.

- Use the module picto alias `object_savmanager@savmanager` for headers.

## Support & Feedback

Please open issues or contact your administrator.