photos
diapason.succes.photos
¶
Les piles de photos d'un projet Succès.
Une pile est une catégorie (« Python », « Ottawa ») ; une photo appartient à une pile, porte une légende et peut pointer vers une tâche du projet. Les octets vivent sur disque, jamais dans SQLite : une base de quelques Mo par photo aurait fini par ralentir chaque relève du téléphone, qui lit le même fichier.
Les photos ne passent PAS par le journal d'opérations. Le client Dart
réimplémente l'enveloppe signée avec une liste de champs figée ; y glisser
des images serait exactement le genre d'ajout que docs/succes-client-mobile.md
interdit. Une photo est locale à ce Mac, comme le fichier qu'elle est.
Le serveur ne décode aucune image : il n'y a pas Pillow dans ce venv, et un décodeur d'images est une surface d'attaque qu'on n'ouvre pas pour une galerie personnelle. C'est le navigateur qui produit l'aperçu, la taille et la teinte ; le serveur vérifie la signature du fichier et le range.
SuccesPhotosStore
¶
Bases: SuccesFinancesStore
Piles et photos, rangées sous <données>/succes-photos/<projet>/.
delete_photo_pile(pile_id)
¶
Supprimer la pile ET ses photos, fichiers compris. Rend le nombre.
reorder_photos(pile_id, photo_ids)
¶
Ranger les photos de la pile dans l'ordre donné, complet ou non.
Les identifiants absents de la liste gardent leur ordre relatif et passent après. Un identifiant d'une autre pile est une erreur : on ne déplace pas une photo en la « rangeant ».
search_photos(project_id, query)
¶
Les photos dont la légende, le nom ou le texte lu contient query.
write_export(chemin, data_base64)
staticmethod
¶
Écrire un export (PDF) là où l'utilisateur l'a demandé.
Le chemin vient du dialogue « Enregistrer sous » de l'app ; on refuse
tout de même ce qui sort du dossier personnel, et tout ce qui n'est
pas un .pdf : une route qui écrit n'importe où est une route qui
écrira un jour dans ~/Library.
decoder_base64(value, *, champ, maximum)
¶
Décoder strictement : un caractère hors alphabet est une erreur.
mime_depuis_signature(data)
¶
Le type réel du fichier, lu dans ses premiers octets.
Le type annoncé par le client est une opinion ; la signature est un fait.
Un .jpg qui commence par <html n'est pas une image et ne sera pas
servi comme telle.
valider_annotations(value)
¶
Le calque d'annotations : une liste de formes aux coordonnées en fractions.
valider_cadre(value)
¶
Le cadre de recadrage, en fractions de l'image : {x, y, w, h}.
Vide (None) = pas de recadrage. Un cadre plus petit que 2 % de
l'image est une erreur de manipulation, pas une intention.