Add detailed configuration documentation for Chill administration

This commit is contained in:
2026-01-26 15:52:21 +01:00
parent 9b97544e5e
commit 48721f01a6
3 changed files with 473 additions and 1 deletions

View File

@@ -0,0 +1,469 @@
# Configuration de Chill
Ce document balaie les principaux éléments de configuration de Chill, un logiciel d'accompagnement social. Chill est conçu pour être flexible et adaptable à différents contextes institutionnels, mais nécessite une configuration appropriée pour fonctionner efficacement.
Cette section couvre les aspects clés de la configuration de Chill, y compris les paramètres généraux, les paramètres de sécurité, les paramètres de base de données et les paramètres d'intégration avec d'autres systèmes.
::: {.note}
Cette documentation ne s'attarde que sur les configurations disponibles depuis l'interface d'administration.
Il existe d'autres options qui affectent le comportement de Chill, mais elles nécessitent une configuration manuelle ou une expertise technique avancée. Elles sont disponibles dans la configuration technique.
:::
## Caractéristiques générales pour tous les éléments
### Notion de actif / inactif
Chaque élément peut être indiqué comme actif ou inactif : dans ce cas, il n'apparait plus dans l'interface graphique de l'usager.
::: {.note}
Parfois, la notion de "actif" ou "inactif" est indiquée par une date de désactivation, ce qui permet de programmer une désactivation dans le futur.
:::
Lorsqu'une configuration est devenue obsolète ou a été introduite en erreur, il est nécessaire de la désactiver (donc de la placer comme "inactive"). En effet, les éléments ne peuvent pas être supprimés: ils peuvent être utilisés par certains enregistrements dans le logiciel, et la supprimer pourrait rendre les données incohérentes.
::: {.note}
Il est possible de supprimer les éléments inactifs **via une intervention sur la base de donnée directement**. Cela permet de vérifier les contraintes, et éventuellement, d'indiquer une configuration de remplacement là où l'ancienne donnée a été utilisée.
:::
### Notion d'ordre d'apparition
La plupart des éléments peuvent être triés, pour apparaitre dans un certain ordre dans l'interface graphique.
Dans ce cas, un élément numérique peut être ajouté. Cet "ordre de tri" peut comporter plusieurs chiffres après la virgule, de sorte qu'il soit possible d'insérer des éléments sans devoir modifier tous les autres éléments.
Ainsi, par exemple, la liste des problématiques pourrait être la suivante:
| Nom de la problématique | Ordre de tri |
|---------------------------------|-------------:|
| Logement | 1.0 |
| Santé | 2.0 |
| Insertion socio-professionnelle | 3.0 |
Puis, il sera possible d'ajouter une problématique "scolarité" entre le "logement" et "santé" sans modifier les autres éléments:
| Nom de la problématique | Ordre de tri |
|---------------------------------|-------------:|
| Logement | 1.0 |
| Scolarité | 1.5 |
| Santé | 2.0 |
| Insertion socio-professionnelle | 3.0 |
## Configuration liée aux parcours
## Origine des parcours
Les utilisateurs peuvent indiquer, pour chaque parcours, son motif d'ouverture, en choisissant parmi la liste préparée par l'administrateur.
### Impact statistiques
Les statistiques sur les parcours (nombre de parcours, nombre d'usager concernés par parcours, etc.) peuvent être regroupés ou filtrés en fonction du motif d'ouverture.
### Caractéristiques
Les origines des parcours comportent les caractéristiques suivantes:
- un nom, décliné dans les différentes langues disponibles dans Chill;
## Motifs de cloture
Lors de la clotûre d'un parcours, les utilisateurs doivent indiquer le motif de la cloture.
### Impact statistiques
Les statistiques sur les parcours peuvent être regroupés ou filtrés en fonction du motif de cloture.
Les parcours cloturés au moyen d'un motif "annulé" sont exclus des statistiques.
### Caractéristiques
- un nom, décliné dans les différentes langues disponibles dans Chill;
- un ordre de tri;
- une option spécifique qui permet de considérer comme "annulés" les parcours qui sont clotûrés par ce motif. Cela permet, par exemple, de distinguer les parcours effectifs de ceux qui auraient été créés par erreur, et ne doivent pas être considérés dans les statistiques.
#### Arborescence des motifs
Les motifs de cloture peuvent être organisés en "arbre": l'on peut renseigner une relation parent / enfant dans les motifs.
Dans ce cas, seuls les motifs "enfants" peuvent être choisis par les utilisateurs.
Il est par contre possible d'effectuer des filtres statistiques à partir des motifs "parents".
### Problématiques sociales
#### Pour les utilisateurs
Les problématiques sociales permettent de caractériser les parcours d'accompagnement. Les utilisateurs indiquent les problématiques :
- au sein des parcours;
- éventuellement, pour les échanges. Lorsqu'un utilisateur coche une problématique dans un échange, elle est ajoutée automatiquement au parcours.
#### Impact statistiques
Les problématiques sociales sont utilisées pour calculer des statistiques sur les parcours d'accompagnement. Elles permettent de suivre l'évolution des problématiques traitées et d'identifier les problématiques les plus fréquentes.
Il est possible de comptabiliser le nombre de parcours pour chaque problématique, du nombre d'échanges associés à l'une ou l'autre problématique, ainsi que d'effectuer des filtres à partir de ces problématiques.
#### Caractéristiques des problématiques
##### Arborescences des problématiques sociales
Les problématiques peuvent être organisées en "arbre" : il peut exister des problématiques parents et des problématiques enfants. Les problématiques parents sont plus généralistes.
Les utilisateurs peuvent choisir des problématiques enfants ou parents, indistinctement. Cependant, lorsqu'une problématique enfant est choisie dans l'interface, la problématique parente est automatiquement enlevée: ce comportement vise à conserver uniquement les problématiques les plus fines, celles qui caractérisent le plus précisément le parcours.
::: {.note }
Il est possible de ne configurer qu'un seul niveau de problématique, et de ne pas créer de problématiques "enfants". Cela est tout à fait acceptable et permet de simplifier la gestion de la configuration.
:::
##### Autres caractéristiques
Les caractéristiques ont les propriétés suivantes :
- un nom, qui peut être renseigné dans les différentes langues;
- un ordre d'apparition, qui permet d'ordonner les problématiques dans l'interface.
Pour les problématiques enfants, l'ordre d'apparition est d'abord celui de la problématique parente.
Cela permet de maintenir une cohérence dans l'ordre d'apparition des problématiques dans l'interface.
### Types d'actions d'accompagnement
Les actions d'accompagnement permettent de saisir le travail social d'un parcours. Il enregistre les actions réalisées par les intervenants pour aider les personnes accompagnées à résoudre les difficultés de leur situation sociale.
Chaque action d'accompagnement est liée à une problématique sociale et peut être associée à un échange. Les actions d'accompagnement peuvent être utilisées pour suivre l'évolution du parcours d'accompagnement et pour évaluer l'efficacité des interventions.
Exemple d'action d'accompagnement :
- "Obtenir une aide financière"
- "Trouver un logement stable"
- "Obtenir les droits à l'aide médicale"
#### Pour les utilisateurs
Les utilisateurs créent les actions d'accompagnement dans le parcours:
- soit manuellement;
- soit en les attachant à un échange.
#### Impact statistiques
Il est possible de générer des statistiques à partir des actions d'accompagnement.
Des exports permettent de dénombrer le nombre d'action entreprise, ou le nombre de parcours qui comportent cette action.
#### Caractéristiques
##### Notion de problématique parent / enfant
Les actions peuvent être présentées en "arbre": des actions "parentes" peuvent comporter des actions "enfants".
##### Autres caractéristiques
Les actions d'accompagnement ont les propriétés suivantes :
- un nom, qui peut être renseigné dans les différentes langues;
- un ordre d'apparition, qui permet d'ordonner les actions d'accompagnement dans l'interface.
Pour les actions d'accompagnement enfants, l'ordre d'apparition est d'abord celui de l'action d'accompagnement parente.
Cela permet de maintenir une cohérence dans l'ordre d'apparition des actions d'accompagnement dans l'interface.
- les problématiques sont associées à des évaluations, des objectifs, et des résultats (voir ci-dessous).
### Types d'évaluation ("Évaluation, formulaire, courriers")
Les évaluations sont associées à une, ou plusieurs, actions d'accompagnement.
Elles sont utilisées pour enregistrer un formulaire, un courrier, ou d'autres élements qui sont remplis ou échangés dans le cadre d'une action.
Par exemple, l'action "Obtenir une aide financière" peut comporter une ou plusieurs évaluations de type "Formulaire d'inscription à une agence immobilière sociale", ou "demande de logement social".
Des gabarits de documents peuvent être associés à l'évaluation. L'association est créée à partir de la gestion des gabarits de documents.
#### Caractéristiques
Les évaluations comportent les caractéristiques suivantes:
- un nom, disponible dans les langues d'installation de Chill;
- éventuellement un lien internet, lorsque le formulaire est disponible sur internet. Cela permet d'afficher le lien aux utilisateurs, qui peuvent alors s'y rendre directement;
- un délai, exprimés en jours / semaines / mois. Ce délai est utilisé pour calculer automatiquement la date d'échéance de la réalisation de l'évaluation à partir de sa date de début;
- un délai de notification, qui permet d'afficher un rappel quelques jours, semaines ou mois avant la date d'échéance.
::: {.note}
La date d'échéance, et le délai de notification peuvent être modifiés par l'utilisateur, individuellement pour chaque évaluation enregistrée.
:::
### Objectifs, Résultats
Pour chaque type d'action d'accompagnement, il est possible de lui associer :
- des objectifs (il est possible alors d'ajouter également un résultat);
- des résultats (sans objectif);
::: {.note}
Il est donc possible d'indiquer, dans une action :
- soit des résultats, directement depuis l'action, sans indiquer d'objectif au préalable;
- soit des objectifs, sans y indiquer des résultats;
- soit des objectifs, avec des éventuels résultats.
:::
## Configuration liée aux échanges
Les échanges sont des moments de communication entre les intervenants et les personnes accompagnées (ou leur entourage). Mis ensemble, ils constituent la chronologie du parcours.
Les échanges peuvent être associés à des problématiques, et à des actions d'accompagnement.
::: {.note}
Les échanges sont généralement enregistrés au sein des parcours d'accompagnement.
Selon la configuration souhaitée, les échanges peuvent être créés également (ou exclusivement) dans des dossiers d'usager.
:::
### Types d'échanges, et catégories de types d'échanges
Les types d'échanges déterminent la caractéristique "physique" de l'échange. Ils expliquent le contexte matériel, ou institutionnel de l'échange.
Il peut s'agir, par exemple, d'une rencontre physique dans les bureaux du service, d'une visite à domicile, d'un échange d'email ou d'un rendez-vous auprès d'un association extérieure, etc.
Le type d'échange définit les éléments de l'échange qui peuvent être enregistrés. Par exemple, la question "durée du déplacement" peut n'être rendue disponible que pour les types d'échanges qui impliquent un déplacement ("visite à domicile", "rendez-vous auprès d'une association externe", etc.).
#### Pour les utilisateurs
Au moment de créer un échange, chaque utilisateur doit choisir un type d'échange. En fonction du type d'échange choisi, l'utilisateur dispose ensuite d'un formulaire adapté à ce type d'échange.
Une fois créé, ce type d'échange ne peut plus être modifié.
#### Impact statistique
Chill permet de générer des statistiques sur les échanges, notamment le nombre d'échanges groupés par type d'échange ou catégories de types d'échange.
#### Caractéristiques des types d'échanges
Chaque échange peut être associé à une catégorie de types d'échanges, qui permet de les regrouper dans l'interface.
Les échanges peuvent être ordonnés via leur propriété "ordre de tri".
Pour chaque type d'échange, il est possible d'indiquer quels éléments sont affichés à l'utilisateur, ou doivent être remplis par l'utilisateur, pour chaque échange:
- les usagers impliqués dans l'échange;
- les utilisateurs impliqués dans l'échange;
- les tiers impliqués dans l'échange;
- la date de l'échange;
- le lieu de l'échange;
- la durée de l'échange;
- la durée de déplacement;
- la présence de l'usager (voir ci-dessous);
- les sujets abordés;
- une note générale sur l'échange;
- une note privée sur l'échange;
- les documents attachés à l'échange;
- le fait que l'échange soit urgent, ou non;
- les problématiques et les actions associées à l'échange;
Pour chacun de ces éléments, le titre par défaut peut être adapté.
### Présence aux échanges
En fonction du type d'échange, la présence de l'usager peut être caractérisée.
Il peut s'agir, par exemple, de déterminer si l'usager est correctement présent, où s'il est absent ou excusé.
#### Impact statistiques
Les statistiques sur les échanges (nombre d'échange, durée moyenne des échanges, etc.) peuvent être regroupés ou filtrés en fonction de la présence aux échanges.
### Sujets des échanges
Pour chaque échange, il est possible d'indiquer un ou plusieurs sujets abordés parmi une liste déroulante. Cela constitue un moyen simple de documenter l'échange.
#### Impact statistiques
Les statistiques sur les échanges peuvent être regroupés ou filtrés en fonction des sujets abordés.
## Configuration liée aux rendez-vous
### Motifs d'annulation des rendez-vous
Lors de l'annulation d'un rendez-vous, un motif d'annulation doit être indiqué.
#### Impact statistique
Les statistiques sur les rendez-vous peuvent être regroupés ou filtrés en fonction des motifs d'annulation.
#### Caractéristiques
- un nom, décliné dans les différentes langues disponibles dans Chill;
- une propriété "annulé par", qui permet d'indiquer que les rendez-vous ont été annulé à la demande de l'usager, d'un utilisateur, ou d'une autre partie.
Lors de la génération de statistiques, cela permet d'isoler qui est responsable de l'annulation du rendez-vous.
## Configuration liée au ménage
Dans Chill, le concept de "ménage" associe plusieurs usagers qui vivent sous le même toit.
Un ménage "donne" l'adresse du domicile à l'usager; autrement dit, le domicile n'est pas enregistré dans le dossier de l'usager, mais dans celui de son ménage. Cela permet d'indiquer un déménagement (mais aussi d'autres caractéristiques, comme la situation familiale) pour tous les usagers associés au ménage.
Il existe cependant des exceptions à ce comportement, qui peuvent être renseignée via la position dans le ménage: les "positions dans le ménage" comportent une caractéristique spécifique, appelée "membre du ménage", décrite ci-après.
::: {.warning}
Le domicile est unique. En conséquence, les usagers qui partagent l'adresse du ménage (l'option "membre du ménage" est cochée) ne peuvent être présents que dans un seul ménage à la fois.
:::
### Position dans le ménage
Lorsqu'un usager est associé au ménage, une position peut lui être indiquée.
Cela peut être, classiquement:
- un adulte dans le ménage;
- un enfant dans le ménage;
- un enfant en dehors du ménage.
#### Caractéristiques des positions dans le ménage
Chaque position dans le ménage dispose des caractéristiques suivantes:
- un nom, décliné dans les différentes langues disponibles dans Chill;
- une option "peut être titulaire", qui indique que, pour cette position, la case "titulaire du ménage" est disponible. Typiquement, il s'agira des adultes dans le ménage;
- une option "membre du ménage":
- lorsqu'elle est cochée, les usagers associés à ce ménage partagent la même adresse, ainsi que d'autres caractéristiques comme la composition familiale. Ils ne peuvent être membre que d'une seul ménage simultanément.
- lorsqu'elle est décochée, les usagers ne partagent pas la même adresse. Ils peuvent être membre de plusieurs ménages simultanément.
::: {.warning}
Lorsque l'option "membre du ménage" est modifiée, les usagers associés préalablement à ce ménage ne sont pas impactés. Il est nécessaire d'intervenir sur la base de donnée pour modifier l'adresse des usagers.
En effet, au moment d'ajouter une contrainte "membre du ménage", il faudra vérifier que les usagers associés à ce ménage au travers de cette position ne sont pas simultanément membres d'un autre ménage.
Cette vérification pouvant être fastidieuse, il est recommandé de désactiver l'ancienne configuration et d'en créer une nouvelle, plutôt que de modifier la configuration existante.
:::
### Composition familiale
La composition familiale de chaque ménage peut être précisée manuellement.
#### Impact statistique
Des statistiques peuvent être générée à partir de la composition familiale du ménage de l'usager: regroupement ou filtre par composition familiale.
#### Caractéristiques
Les caractéristiques de la composition familiale sont:
- un nom, décliné dans les différentes langues disponibles dans Chill.
### Types de relation
Un usager peut être lié à un autre usager par une relation. Chaque relation peut être typée, pour indiquer, par exemple, qu'il s'agit d'une relation de parentalité, de fraternité, etc.
Un "graphe des relations" peut être affiché dans Chill.
### Caractéristiques
Les relations relient deux usagers. Elles disposent d'un sens (du parent vers l'enfant, ou de l'enfant vers le parent, par exemple).
Les types de relations sont donc:
- un premier membre (renseigné dans chaque langue);
- un deuxième membre (également renseigné dans chaque langue).
Il peut donc s'agir, par exemple, du "parent" pour le premier membre, et de l'enfant pour le second. Ou, lorsqu'il s'agit de relation de fraternité, de "frère / sœur" pour le premier, et également de "frère / sœur" pour le second.
::: {.note}
Pour plus de simplicité, il est conseillé de configurer le nom des membres dans les différents genres disponibles. Par exemple, il est préférable de configurer une relation de type "parent / enfant" plutôt que "père / fille", puis "père / fils", "mère / fille", "mère / fils".
Cela permet de simplifier les statistiques et la génération des documents, et évite aussi de trop charger l'interface graphique.
:::
## Configuration liée au budget
Le budget de l'usager peut être renseigné tant dans le dossier de l'usager (dépenses qui sont propres à l'usager) que dans le dossier du ménage (dépenses qui sont partagées entre les membres du ménage).
### Types de ressources et types de charges
Les types de ressources et les types de charges sont configurables dans Chill. Ils permettent de catégoriser les dépenses et les revenus de l'usager et du ménage.
#### Caractéristiques
Les types de ressources et les types de charges disposent:
- d'un nom, décliné dans les différentes langues disponibles dans Chill;
- d'un ordre d'apparition, qui permet de trier les éléments dans l'interface;
- d'une clé d'identification. Cette clé permet d'identifier la ressource lors de la génération de document.
<!--
## Configuration liées aux événements
TODO
## Utilisateurs et permissions
TODO
-->
## Configuration des documents
La configuration des documents est détaillée dans un document dédié.
## Configuration générale
### Civilités
Les civilités sont associés à différentes entités, et notamment:
- les usagers;
- les tiers;
- les utilisateurs.
#### Caractéristiques
Chaque civilité comporte les propriétés suivantes:
- un nom, qui peut être indiqué dans les différentes langues de Chill;
- une abbréviation, qui peut être indiquée dans les différentes langues de Chill. Par exemple, "Monsieur" correspondra à "M." comme abbréviation.
- un ordre d'apparition, qui permet d'indiquer les plus fréquentes en premier.
### Genres
Différents genres peuvent être renseignés dans le logiciel.
#### Caractéristiques
Les genres disposent des caractéristiques suivantes:
- un nom, qui peut être indiqué dans les différentes langues de Chill;
- un ordre d'apparition, qui permet d'indiquer les plus fréquents en premier;
- le genre à choisir dans des traductions spécifiques, de sorte que le logiciel puisse féminiser certaines traductions (par exemple, choisir entre "né le", "née le", et "né·e le");
- une icône spécifique, à choisir parmi la liste indiquée.
## Configuration liée aux usagers
### État civil
L'état civil est indiqué dans le dossier des usagers.
#### Caractéristiques
Les états civils disposent des caractéristiques suivantes:
- un nom, qui peut être indiqué dans les différentes langues de Chill;
### Types de personnes ressources
Les utilisateurs peuvent renseigner des personnes ressources dans le dossier des usagers: des personnes qu'il peut être utile de connaitre pour traiter le dossier, ou interagir avec l'usager, par exemple.
Ces personnes ressources peuvent être caractérisées par un type. Notons que ce type n'est pas obligatoire.
#### Caractéristiques
Les personnes ressources disposent des caractéristiques suivantes:
- un nom, qui peut être traduit dans les différents langues de Chill.

View File

@@ -11,11 +11,13 @@ theme:
- content.code.annotate
nav:
- Accueil: index.md
- Élements à configurer: configuration-chill-big-picture.md
- Génération de document: generation-documents.md
- Gestion des droits: gestion-des-droits.md
hooks:
- ../mkdocs/hooks/pandoc-to-mkdocs.py
markdown_extensions:
- tables
- markdown_include.include
# code layout
- pymdownx.highlight:

View File

@@ -52,9 +52,10 @@ if [ $kind = 'user' ]; then
# exports_household.md
elif [ $kind = 'admin' ]; then
export files="
start.md
configuration-chill-big-picture.md
generation-documents.md
"
# start.md
else
echo "kind '$kind' is not valid";
exit 1;