d66288d061
Auto Tag Develop / tag (push) Successful in 13s
## Contexte (incident prod) Le correctif #31 (dirty-tracking front) ne protège que les sessions chargeant le nouveau bundle. Un **vieil onglet** ouvert avant déploiement tourne encore sur l'ancien JS et envoie toute la grille périmée. Hier soir, un onglet ouvert le matin a **supprimé ~10 lignes d'heures** saisies dans la journée par d'autres utilisateurs (journal BDD à l'appui : 1 save = 2 updates + 8 deletes de lignes intactes). Cause : le backend traitait toute **entrée vide comme une suppression**, sans aucune garde indépendante du client. ## Correctif — suppression sur intention explicite (`delete: true`) `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 (vieil onglet inclus), 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`, appliqué 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 (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), via le pre-commit hook. - Front : revue de code (pas de harnais de tests front). ## Doc - `doc/hours-save-dirty-tracking.md`, `CLAUDE.md`, doc in-app (`documentation-content.ts`). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: #36 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
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
|
|
}
|