a67e77dc50
## Problème Le correctif #31 (dirty-tracking front) ne protège que les sessions qui chargent le nouveau bundle. Un vieil onglet ouvert avant déploiement tourne encore sur l'ancien JS et envoie toute la grille périmée → reproduit en prod : un onglet ouvert le matin a supprimé ~10 lignes saisies dans la journée par d'autres utilisateurs (entrée vide = suppression côté backend, sans garde). ## Correctif (suppression sur intention explicite) `WorkHourBulkUpsertProcessor` ne supprime une ligne existante sur entrée vide QUE si l'entrée porte `delete: true`. Sinon → no-op (ligne préservée). Aucune grille périmée, quel que soit le client, ne peut plus détruire une saisie concurrente. La création de ligne technique de validation reste limitée à `null === $existing`. Le front (à jour) pose `delete: true` sur une ligne vidée volontairement (helper `isEntryEmpty`, après le filtre dirty-tracking) → suppression métier conservée. Flag optionnel ajouté au DTO front (`WorkHourEntryPayload`) et back (`WorkHourBulkUpsert`), défaut false. ## Testabilité Le processor dépend désormais des interfaces repo (`EmployeeScopedRepositoryInterface` / `WorkHourReadRepositoryInterface`, repos concrets `final` non mockables) → nouveau test unitaire `WorkHourBulkUpsertProcessorTest` (no-op sans flag / suppression avec flag / update normal). ## Limite résiduelle (par choix : suppression explicite, pas verrou optimiste) L'édition explicite d'une ligne sur données périmées peut encore écraser une saisie concurrente sur cette même ligne. Seule la suppression est blindée. ## Vérification - 267 tests PHPUnit OK (dont 3 nouveaux). Front : revue de code (pas de harnais). ## Doc - doc/hours-save-dirty-tracking.md, CLAUDE.md, doc in-app. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
147 lines
3.8 KiB
TypeScript
147 lines
3.8 KiB
TypeScript
import type { Employee } from './employee'
|
|
import type { ContractType, TrackingMode } from './contract'
|
|
|
|
export type WorkHour = {
|
|
id: number
|
|
employee: Employee
|
|
workDate: string
|
|
morningFrom?: string | null
|
|
morningTo?: string | null
|
|
afternoonFrom?: string | null
|
|
afternoonTo?: string | null
|
|
eveningFrom?: string | null
|
|
eveningTo?: string | null
|
|
isPresentMorning?: boolean
|
|
isPresentAfternoon?: boolean
|
|
dayHoursMinutes?: number | null
|
|
nightHoursMinutes?: number | null
|
|
workshopHoursMinutes?: number | null
|
|
hasBreakfast?: boolean
|
|
hasLunch?: boolean
|
|
hasDinner?: boolean
|
|
hasOvernight?: boolean
|
|
isSiteValid?: boolean
|
|
isValid?: boolean
|
|
updatedAt?: string | null
|
|
}
|
|
|
|
export type WorkHourEntryPayload = {
|
|
employeeId: number
|
|
morningFrom?: string | null
|
|
morningTo?: string | null
|
|
afternoonFrom?: string | null
|
|
afternoonTo?: string | null
|
|
eveningFrom?: string | null
|
|
eveningTo?: string | null
|
|
isPresentMorning?: boolean
|
|
isPresentAfternoon?: boolean
|
|
dayHoursMinutes?: number | null
|
|
nightHoursMinutes?: number | null
|
|
workshopHoursMinutes?: number | null
|
|
hasBreakfast?: boolean
|
|
hasLunch?: boolean
|
|
hasDinner?: boolean
|
|
hasOvernight?: boolean
|
|
// Autorise la suppression d'une ligne existante quand l'entrée est vide.
|
|
// Sans ce flag, le backend ignore une entrée vide sur une ligne existante
|
|
// (garde anti-perte de données contre les grilles périmées).
|
|
delete?: boolean
|
|
}
|
|
|
|
export type WeeklyWorkHourDailySummary = {
|
|
date: string
|
|
dayMinutes: number
|
|
nightMinutes: number
|
|
workshopMinutes?: number
|
|
totalMinutes: number
|
|
present?: number | null
|
|
hasAbsence?: boolean
|
|
absenceLabel?: string | null
|
|
absenceColor?: string | null
|
|
hasNightBasket?: boolean
|
|
hasBreakfast?: boolean
|
|
hasLunch?: boolean
|
|
hasDinner?: boolean
|
|
hasOvernight?: boolean
|
|
virtualHolidayMinutes?: number
|
|
holidayLabel?: string | null
|
|
}
|
|
|
|
export type WeeklyWorkHourRowSummary = {
|
|
employeeId: number
|
|
firstName: string
|
|
lastName: string
|
|
siteName?: string | null
|
|
contractName?: string | null
|
|
contractType?: ContractType | null
|
|
trackingMode?: TrackingMode | null
|
|
daily: WeeklyWorkHourDailySummary[]
|
|
weeklyDayMinutes: number
|
|
weeklyNightMinutes: number
|
|
weeklyWorkshopMinutes?: number
|
|
weeklyTotalMinutes: number
|
|
weeklyPresenceCount?: number
|
|
weeklyOvertimeTotalMinutes?: number
|
|
weeklyOvertime25Minutes?: number
|
|
weeklyOvertime50Minutes?: number
|
|
weeklyRecoveryMinutes?: number
|
|
weeklyNightBasketCount?: number
|
|
isDriver?: boolean
|
|
weeklyBreakfastCount?: number
|
|
weeklyLunchCount?: number
|
|
weeklyDinnerCount?: number
|
|
weeklyOvernightCount?: number
|
|
hasContractForWeek?: boolean
|
|
contractNature?: 'CDI' | 'CDD' | 'INTERIM' | null
|
|
comment?: string | null
|
|
commentId?: number | null
|
|
}
|
|
|
|
export type WeeklyWorkHourSummary = {
|
|
weekStart: string
|
|
weekEnd: string
|
|
days: string[]
|
|
rows: WeeklyWorkHourRowSummary[]
|
|
}
|
|
|
|
export type WorkHourDayContextRow = {
|
|
employeeId: number
|
|
hasContractAtDate: boolean
|
|
absenceLabel?: string | null
|
|
absenceColor?: string | null
|
|
absenceHalf?: 'AM' | 'PM' | null
|
|
absentMorning: boolean
|
|
absentAfternoon: boolean
|
|
creditedMinutes: number
|
|
creditedPresenceUnits: number
|
|
isDriverContract?: boolean
|
|
hasFormation?: boolean
|
|
formationLabel?: string | null
|
|
virtualHolidayMinutes?: number
|
|
contractNature?: 'CDI' | 'CDD' | 'INTERIM' | null
|
|
trackingMode?: TrackingMode | null
|
|
weeklyHours?: number | null
|
|
contractType?: ContractType | null
|
|
contractName?: string | null
|
|
workDaysHours?: Record<number, number> | null
|
|
}
|
|
|
|
export type WorkHourDayContext = {
|
|
workDate: string
|
|
rows: WorkHourDayContextRow[]
|
|
}
|
|
|
|
export type DriverHourRow = {
|
|
workHourId: number | null
|
|
dayHours: string
|
|
nightHours: string
|
|
workshopHours: string
|
|
hasBreakfast: boolean
|
|
hasLunch: boolean
|
|
hasDinner: boolean
|
|
hasOvernight: boolean
|
|
isSiteValid: boolean
|
|
isValid: boolean
|
|
updatedAt: string | null
|
|
}
|