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.

## What’s new (v1.0.1)
- Clearer, more complete PDFs: improved presentation with your details and the customer’s details.
- More precise intervention location: full address, useful contact details (if provided), and optional notes.
- You can link an intervention to a project and/or a ticket for easier follow‑up.
- Intervention start/end date and time shown on PDFs: easier tracking, approval and archiving.
- Signature areas on the customer PDF: convenient for on‑site signing.
- Amount display can be adapted: you can hide amounts on the document given to the customer.
 

## 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.

## Support & Feedback
Please open issues or contact your administrator.