Avis de sanction & retenue

L'application génère des PDFs officiels d'avis de sanction et d'avis de retenue à partir des templates AcroForm fournis (data/templates/GF_FO_Avis_de_sanction.pdf et GF_FO_Avis_de_retenue.pdf). Les champs du formulaire restent éditables après téléchargement.

Où créer un avis

Bouton « Créer un avis de retenue » (orange) ou « Créer un avis de sanction » (rouge) :

Sur /fiche (Apprentis) — dans le bandeau d'actions sous les KPIs
Sur /classe (Classes) — sur chaque carte apprenti, même bandeau

Cliquer ouvre une modale dédiée pré-remplie avec l'apprenti sélectionné.

Modale Avis de sanction

Champs :

Apprenti (verrouillé, pré-rempli)
Texte de description : pré-rempli depuis settings.texte_sanction (configurable en /params)
Chef de section : pré-rempli depuis settings.chef_section
Préfixe utilisateur : (<username>) est ajouté en début de la remarque enregistrée en notice (traçabilité)

3 actions :

Télécharger uniquement — génère le PDF + crée la notice Escada en pending
Envoyer par email — choix destinataire (apprenti / formateur / autre adresse libre)
Détecte les notices doublons : si une notice du même type a déjà été créée aujourd'hui, l'app le signale avec un toast et propose « Créer quand même »

Filtre : uniquement les classes EM côté UI (les classes DUAL ne peuvent pas générer d'avis de sanction).

Modale Avis de retenue

Champs :

Apprenti
Profession (auto-calculée depuis le préfixe de classe via prof_mapping configuré en /params)
Date de retenue (date d'envoi)
Date du problème (date à laquelle l'incident s'est produit)
Case cochée : Devoir non rendu / Comportement / Retard
Branche (uniquement si « Devoir non rendu »)
Remarque libre (préfixée par (<username>) )
Vos initiales (champ Profs du template)

Le template a un champ Date partagé entre 3 lignes ; le code src/retenue_pdf.py:_split_date_field sépare les widgets pour ne remplir que la date correspondant à la case cochée.

Destinataire de l'avis (adresse imprimée sur le PDF)

Depuis mai 2026, l'adresse de l'entreprise n'est plus utilisée. Logique unifiée (_destinataire(apprenti, fiche) dans les deux modules PDF) :

Statut apprenti	Destinataire (NomParents / NomEntreprise + Adresse + NPA-Ville)
Mineur (`majeur=False`)	Représentant légal (`resp_legal_*`)
Majeur (`majeur=True`)	Apprenti lui-même (`fiche.adresse/code_postal/localite`)
Inconnu / pas de fiche	Apprenti lui-même

Pré-requis : la sync Escada avec option « Données apprentis » doit avoir été lancée pour que ApprentiFiche.majeur + resp_legal_* soient remplis.

Notice Escada associée

Chaque avis téléchargé crée une Notice (table locale) avec :

source = "sanction" ou "retenue"
status = "pending"
titre = « Avis de sanction » / « Est arrivé en retard aux cours » / etc.
remarque = (<username>) <texte saisi> — le préfixe sert d'identification de l'auteur en attendant un compte Escada par utilisateur
date_event = aujourd'hui

Ces notices sont poussées vers Escada par scripts/push_notices.py (cf. Push vers Escada).

Configuration des défauts

/params → Avis de sanction :

Texte de description par défaut
Chef de section (CS) par défaut

/params → Correspondances classe → profession :

Mapping préfixe de classe → profession utilisé sur les avis de retenue. Ex : AUTOMAT → Automaticien CFC.
Liste des classes « orphelines » (sans mapping) en chips jaunes — clic pour pré-remplir le formulaire.
Bouton « Appliquer aux fiches existantes » : recalcule ApprentiFiche.profession pour tous les apprentis selon le mapping actuel.

Audit

[notice] prof.demo : création (sanction) pour Dupont Marc (1EM1)
[notice] prof.demo : notice doublon évitée pour Dupont Marc (existante : Avis de sanction — créée le 12.05.2026 10:23)
[notice] prof.demo : création (retenue) pour Martin Léa (2EM2) — case=retard

4.3 KiB Raw Blame History