AmpliX

# 🚛# 🚛 AmpliX - Intelligent Working Hours Tracking

**AmpliX** is a Progressive Web Application (PWA) that works 100% offline, designed as a preventative support and planning tool for professional heavy goods vehicle drivers in Europe.

> ⚠️ **Important Legal Notice:** AmpliX is a tool geared towards self-management and prevention. **It does NOT replace the digital tachograph** or official legal records. It does not guarantee legal compliance, but rather acts as an early warning system based on the length of the working day.

---

## 🎯 Fundamental Objective

The main purpose of AmpliX is to help drivers monitor their **"Working Hours"** (the continuous time elapsed from the start to the end of their shift) in real time to avoid potential violations, fines for exceeding working hours, or lack of minimum rest periods, quickly and without relying on an internet connection.

---

## 🚀 Features and Functionalities

### ⏱️ Workday Length Management

- **Start and End Control:** The workday is calculated based on the entered start and end dates and times.

- **Intelligent Safety Lock:** Prevents the start of a new workday if there is no 9-hour break.

- **Daily Limit Alerts:**

- **13 hours:** Preventive warning. Any subsequent break will automatically be considered reduced.

- **15 hours:** Alert for exceeding the absolute maximum limit (indicator of almost certain violation).

### 🛏️ Intelligent Break Control

- **Daily Break Classification:**

- Length <= 13 hours = Requires an 11-hour break.

- Length > 13 hours = Requires a 9-hour break (Reduced Break).

- *Regulatory Limit:* A fixed maximum of 3 reduced daily rest periods per week.

- **Calculated Weekly Rest:** Divided into Normal (45h) or Reduced (24h).

- *Critical Rule:* Alert regarding the prohibition of consecutive reduced weekly rest periods.

- *Hour Debt:* Strict accounting of hours to be compensated for using reduced rest periods.

### 🛣️ Work Cycle and Exceptions

- **144h Cycle Monitoring:** Tracking of the weekly cycle. Preventive alerts at 120 hours of work and a critical alert at 144 hours without a weekly rest period.

- **10h Exception:** Allows monitoring of the use of the legal exception to extend driving time to 10 hours (limited to a maximum of 2 times per week).

- **6-Hour Break Rule:** Requires an uninterrupted 30-minute break before exceeding 6 hours of work.

### 💰 Informative Financial Logic

- Compensation calculation based on: price per kilometer, per diems, and efficiency bonuses.

### 📊 Reports and Export

- **Automatic Grouping:** Records are grouped in an orderly fashion, allowing for quick filtering.

- **Formats:** Download records in **PDF** and **CSV** for personal or administrative use.

### 🔒 Extreme Privacy and Offline-First Architecture

- **Offline-First:** Stores data locally in your web browser, ensuring continuous operation.

- **Backups:** Allows you to generate and import a JSON file containing all data to prevent data loss.

---

## 🛑 What AmpliX DOES NOT do

- It does NOT monitor fragmented 4.5-hour driving breaks.

- It does NOT monitor cumulative limits of 56 or 90 hours.

- It does NOT distinguish between driving periods and availability.

- It does NOT guarantee legal compliance; the responsibility lies with the driver's actions.

- Breaks are not detected by GPS and must be confirmed manually.

--

## 🛠️ Technologies and PWA

- **Frontend:** React, TypeScript, Vite, and Tailwind CSS.

- **PWA:** Installable on iOS and Android.

- **In-App Alerts:** Update system connected to GitHub.

If you encounter any problems or have suggestions, please contact us through the app store comments. Thank you for trusting AmpliX! 🚛