---
title: "Avatars des annuaires (initiales et couleur automatique)"
module: platform
type: functional
status: active
updated: 2026-08-18
---

# Avatars des annuaires

> Doc fonctionnelle : décrit le **quoi** et le **pourquoi**. Cible utilisateur final, chef de projet.
> Doc technique associée : [`.claude/technical-docs/platform/onyx-avatar.md`](../../.claude/technical-docs/platform/onyx-avatar.md).

## À quoi ça sert

Dans les annuaires (entités, adresses, personnes), toutes les fiches sans photo affichaient la
même image générique. Les listes étaient visuellement indistinctes et donnaient l'impression d'un
contenu manquant.

Chaque fiche sans photo affiche désormais un **avatar qui lui est propre** : ses initiales sur une
couleur qui ne change jamais. La même fiche garde le même avatar partout où elle apparaît — dans
la liste, dans les cartes, sur sa page de détail. C'est ce qui permet de retrouver une ligne d'un
coup d'œil et de reconnaître une fiche en passant de la liste au détail.

## Ce que vous voyez

| Type de fiche | Forme | Contenu |
|---------------|-------|---------|
| Entité | carré arrondi | initiales du nom (« Clinique Saint-Jean » → **CS**) |
| Adresse | carré arrondi | icône de localisation |
| Personne | rond | initiales « Prénom Nom » (« Camille Dupont » → **CD**) |

La forme distingue les **organisations** (carré arrondi) des **personnes** (rond), y compris dans
une liste qui mélange les deux.

Les adresses affichent une icône plutôt que des initiales : celles d'une adresse postale — souvent
un numéro et un nom de rue — n'auraient rien d'identifiant. Leur libellé complet reste accessible
en survolant l'avatar.

Dès qu'une photo ou un logo est renseigné, c'est lui qui s'affiche : l'avatar n'apparaît qu'en son
absence, ou si le fichier n'est plus disponible.

## Où c'est visible

- `/entities` — liste des entités et liste des entités externes, et fiche entité
- `/address` — table et mode cartes, et fiche adresse
- `/persons` — annuaires salariés et externes, et fiche personne

## Bon à savoir

**La couleur n'est pas choisie, elle est calculée à partir du nom.** Elle est donc identique sur
tous les écrans, et elle reste la même au fil du temps — sauf si le nom de la fiche est modifié.
**Renommer une entité ou une adresse change son avatar** (couleur et initiales) : c'est le
fonctionnement attendu, pas une anomalie.

**Les avatars des fiches personnes ont changé de couleur** au déploiement de cette évolution. La
fiche utilisait auparavant un calcul différent de celui de la liste `/persons` ; les deux sont
maintenant alignés. Une personne repérée jusqu'ici à la couleur de son avatar sur sa fiche pourra
donc apparaître dans une autre couleur — désormais la même que dans la liste.

**L'ordre du nom sur la fiche personne** est passé de « NOM Prénom » à « Prénom NOM », pour
correspondre à ce qu'affiche la liste.

**Ouvrir une photo en grand** : dans les annuaires personnes, cliquer sur une photo réelle ouvre
la visionneuse sur cette photo. Cliquer sur un avatar à initiales ne déclenche rien — il n'y a
pas d'image à agrandir.

## Limites connues

- Deux fiches aux noms différents peuvent tomber sur la même couleur : la palette compte 8 teintes,
  ce sont les initiales qui les distinguent.
- La couleur n'est pas personnalisable fiche par fiche.