Crew Counter Command

Starting Point CrewCounterCommand.php

Descrizione del workflow completo del sistema di conteggio dei tempi di servizio dell'equipaggio:

1. Punto di Partenza - CrewCounterCommand:

protected static $defaultName = 'app:crew:counters';

Il comando accetta tre parametri:

  • Mese di riferimento: month

  • ID del membro dell'equipaggio: crew

  • Anno di

2. Flusso di Esecuzione:

Inizializzazione:

  • Recupero del membro dell'equipaggio dal database

  • Definizione del periodo di analisi (inizio e fine mese)

  • Creazione delle sezioni di output per il monitoraggio

2. Generazione Schedule:

Genera la pianificazione dei turni per il periodo specificato

$turns = $this->crewEventService->generateDutySchedule($crew, $start, $end);

3. Salvataggio Turni:

Salva i turni generati nel database

$this->crewEventService->save($crew, $start, $end, $turns);

4. Calcolo Contatori:

Calcola i contatori giornalieri di servizio

$this->ftlService->calculateDutyDailyCounters($crew, $start, $end);

Verifica le limitazioni e genera warning se necessario

$this->ftlService->calculateWarningLimitation($crew, $start, $end);

3. Servizio CrewCounterService:

a. Calcolo Annuale (dutyYearCalculator):

  • Gestisce la persistenza dei dati

  • Aggiorna o crea nuovi contatori per ogni giorno

  • Analizza giorno per giorno l

b. Calcolo Mensile (dutyMonthCalculator):

  • Mantiene la cronologia dei calcoli

  • Gestisce i contatori verificati e non verificati

  • Analizza

c. Calcolo Giornaliero (dutyDayCalculator):

  • Warning e limitazioni

  • Block Time

  • Cumulative Duty (7, 14, 28 giorni)

  • Flight Time (FT)

  • Duty Period (DP)

  • Calcola:

    • Verifica contratti attivi

    • Inizializza

4. Entità Coinvolte:

  • CrewExtraType: Tipi di attività extra

  • CrewContract: Contratti equipaggio

  • Fdstatus: Stati degli eventi

  • Fdevent: Eventi di servizio

  • CrewFlightLimitation: Limitazioni di volo

  • CrewCounter: Contatori di servizio

5. Logica di Business:

  • Tracciamento delle verifiche e validazioni

  • Gestione dei turni e degli eventi speciali

  • Verifica delle limitazioni normative

  • Calcolo dei tempi di volo cumulativi

  • Gestione dei periodi di servizio (Duty Period)

6. Sistema di Warning:

· Monitoraggio dei limiti di servizio

· Generazione di avvisi per superamento limiti

· Tracking delle ragioni dei warning

7. Persistenza Dati:

· Salvataggio incrementale dei contatori

· Gestione della verifica dei dati

· Storicizzazione delle informazioni

8. Output e Reporting:

· Generazione di report dettagliati

· Visualizzazione dei turni e dei contatori

· Tracking delle attività e degli stati

Questo workflow è fondamentale per:

1. Garantire la conformità alle normative di volo

2. Monitorare i tempi di servizio dell'equipaggio

3. Prevenire il superamento dei limiti di servizio

4. Mantenere una documentazione accurata delle attività

5. Supportare la pianificazione operativa

Last updated