Ouvrir le compte et les préférences au paramétrage

Quatre écrans manquaient faute de spécification. Les captures du produit audité
les fournissent : identité de l'entreprise, comportement des plannings, droits
ouverts aux salariés, décompte de paie.

Les préférences sont trois blocs typés, pas un sac de clés-valeurs. Ce n'est pas
de la rigueur gratuite : `smoothOvertimeMonthly` change le calcul des heures
supplémentaires, et un JSON libre rendrait indétectable une clé mal
orthographiée — le réglage paraîtrait actif sans l'être.

Chaque formulaire déclare les clés qu'il gouverne. Une case décochée n'arrive
pas dans le FormData ; sans cette déclaration, enregistrer « Plannings »
remettrait à faux tout « Droits », un formulaire partiel effaçant ce qu'il
n'affiche pas.

Trois réglages portent un avertissement en évidence parce qu'ils déplacent des
heures et non des pixels. Le lissage mensuel des heures supplémentaires suppose
un accord d'aménagement du temps de travail : le décompte hebdomadaire est le
principe, et sans accord l'aménagement est inopposable. Les pauses rémunérées et
l'inclusion des repos dans les heures normales changent la répartition entre
heures normales et majorées. Un interrupteur qui coûte de l'argent ne doit pas
se présenter comme un réglage d'affichage.

La ligne de préférences est créée à la demande : son absence vaut « tous les
défauts ». Semer une ligne à l'installation obligerait à migrer chaque compte au
premier réglage ajouté.

L'adresse va sur le compte et non sur l'établissement : le siège porte
l'identité juridique et figure au registre du personnel, là où l'établissement
porte le SIRET, le fuseau effectif et les plannings.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
MichaelandClaude Opus 5 committed 2026-08-11 12:59:53 +02:00
1 parent f0ef6f12a1
commit d8060eb4a9
11 files changed
+945

No files matched your search

+162
View File
@@ -0,0 +1,162 @@
/**
* Préférences du compte — PLAN.md §9.
*
* Le catalogue vit dans le domaine plutôt que dans l'écran : chaque préférence
* y porte son libellé, sa conséquence et, le cas échéant, son avertissement.
* Un interrupteur qui change un calcul de paie ne doit pas se présenter comme
* un réglage d'affichage, et la nuance ne tiendra pas si elle n'existe que dans
* le JSX.
*/
export type PreferenceGroup = 'planning' | 'rights' | 'payroll';
export interface PreferenceToggle {
key: string;
group: PreferenceGroup;
label: string;
/** Ce que l'interrupteur change réellement. */
hint: string;
/** Avertissement affiché en évidence — risque juridique ou de calcul. */
warning?: string;
/** Décalé sous la préférence dont il dépend. */
parent?: string;
}
export const PREFERENCE_TOGGLES: PreferenceToggle[] = [
// --- Plannings ---------------------------------------------------------
{
key: 'defaultMealPerShift',
group: 'planning',
label: 'Compter un repas par créneau',
hint: 'Chaque créneau ouvre un repas sans saisie. À décocher si le repas dépend de l’amplitude.',
},
{
key: 'paidBreaks',
group: 'planning',
label: 'Les pauses sont rémunérées',
hint: 'Les pauses cessent d’être déduites du temps de travail effectif — et entrent donc dans les seuils de convention.',
warning:
'Modifie le décompte des heures : les semaines déjà exportées ne sont pas recalculées.',
},
{
key: 'lockEmployeeMeals',
group: 'planning',
label: 'Les salariés ne peuvent pas modifier leur repas',
hint: 'Le repas devient une donnée de gestion, saisie par l’encadrement.',
},
{
key: 'employeesSeeOwnTotals',
group: 'planning',
label: 'Le salarié voit son total d’heures',
hint: 'Heures planifiées et réelles de sa semaine, sur son propre planning.',
},
{
key: 'employeesSeeTeamPlanning',
group: 'planning',
label: 'Le salarié voit le planning de son équipe',
hint: 'Les créneaux des autres membres de ses équipes, sans leurs compteurs.',
},
{
key: 'hideForfaitCounters',
group: 'planning',
label: 'Masquer les compteurs au forfait jours',
hint: 'Les alertes horaires de ces lignes sont masquées avec eux. Un forfait jours ne se compte pas en heures : un écart hebdomadaire y est un faux positif.',
},
// --- Droits ------------------------------------------------------------
{
key: 'employeesEditOwnProfile',
group: 'rights',
label: 'Le salarié modifie ses informations personnelles',
hint: 'Coordonnées et état civil. Le contrat et la rémunération restent hors de portée.',
},
{
key: 'employeesSeeOwnTimesheets',
group: 'rights',
label: 'Le salarié consulte ses feuilles de présence',
hint: 'Depuis son profil, en lecture seule.',
},
{
key: 'employeesSeeTeamContacts',
group: 'rights',
label: 'Le salarié voit les coordonnées de l’équipe',
hint: 'Téléphone et adresse e-mail de tous les membres.',
warning:
'Ouvre des données personnelles à l’ensemble de l’équipe : à n’activer que si la finalité le justifie.',
},
{
key: 'managerCreatedArePlannable',
group: 'rights',
label: 'Un salarié créé par un manager est planifiable aussitôt',
hint: 'Décoché, un administrateur ou un directeur doit le rendre planifiable depuis son profil.',
},
{
key: 'directorsSharePeople',
group: 'rights',
label: 'Les directeurs partagent leurs salariés',
hint: 'Un salarié devient disponible sur les plannings d’un autre établissement.',
},
{
key: 'directorsAccessHrDashboard',
group: 'rights',
label: 'Les directeurs accèdent au tableau de bord RH',
hint: 'Les agrégats restent bornés à leur périmètre d’établissement.',
},
{
key: 'directorsSeePaidLeave',
group: 'rights',
label: 'Compteurs de congés payés visibles des directeurs',
hint: 'Lecture seule. L’ajustement manuel reste une capacité distincte.',
},
{
key: 'managersSeePaidLeave',
group: 'rights',
label: 'Compteurs de congés payés visibles des managers',
hint: 'Lecture seule, même règle que pour les directeurs.',
},
// --- Paie --------------------------------------------------------------
{
key: 'smoothOvertimeMonthly',
group: 'payroll',
label: 'Lisser les heures supplémentaires au mois',
hint: 'Le décompte se fait sur le mois au lieu de la semaine.',
warning:
'Le décompte hebdomadaire est le principe (art. L3121-28). Lisser au mois suppose un accord d’aménagement du temps de travail ; sans accord, l’aménagement est inopposable et les heures restent dues à la semaine.',
},
{
key: 'includeRestInNormalHours',
group: 'payroll',
label: 'Inclure repos et absences dans les heures normales',
hint: 'Les heures travaillées au-delà du contractuel du fait d’une absence sont payées au taux normal plutôt qu’en heures supplémentaires.',
warning:
'Modifie la répartition entre heures normales et heures majorées : à confirmer avec le gestionnaire de paie avant tout export.',
},
{
key: 'autoEmployeeNumber',
group: 'payroll',
label: 'Générer le matricule automatiquement',
hint: 'Décoché, le matricule est saisi à l’embauche — utile quand il doit correspondre à celui du logiciel de paie.',
},
];
export const PREFERENCE_KEYS: string[] = PREFERENCE_TOGGLES.map(
(toggle) => toggle.key,
);
export function togglesOf(group: PreferenceGroup): PreferenceToggle[] {
return PREFERENCE_TOGGLES.filter((toggle) => toggle.group === group);
}
/** « 20:00 » ↔ minutes depuis minuit, pour l'heure de bascule du soir. */
export function minutesToTime(minutes: number): string {
const hours = Math.floor(minutes / 60) % 24;
const rest = minutes % 60;
return `${String(hours).padStart(2, '0')}:${String(rest).padStart(2, '0')}`;
}
export function timeToMinutes(value: string): number | null {
const match = /^([01]\d|2[0-3]):([0-5]\d)$/.exec(value.trim());
if (!match) return null;
return Number(match[1]) * 60 + Number(match[2]);
}