Publier la documentation de Chill en ligne après chaque mise à jour (#14)
Some checks failed
continuous-integration/drone/push Build is failing
Build and Push MkDocs Docker Image / build-and-push (push) Successful in 2m40s

Reviewed-on: #14
Co-authored-by: Julien Fastré <julien.fastre@champs-libres.coop>
Co-committed-by: Julien Fastré <julien.fastre@champs-libres.coop>
This commit is contained in:
2025-06-30 16:16:24 +00:00
committed by Julien Fastré
parent f531de0351
commit 4c330d7b87
128 changed files with 1345 additions and 22 deletions

177
user/docs/00000-toc.md Normal file
View File

@@ -0,0 +1,177 @@
# Qu'est-ce que Chill ?
## A quoi ça sert ?
=~ dossier social électronique
### Objectifs
* consigner les informations;
* partager avec les collègues;
* générer des statistiques.
Chill n'est pas un logiciel de statistique. Il est pensé pour être utilisé au quotidien, et générer des statistiques à partir de cette utilisation.
## Comment l'installer
Renvoi à la documentation technique
## Comment l'administrer ?
Renvoi à la documentation administrateur
# Survol des concepts dans Chill
Les trois domaines dans Chill.
Chaque domaine est caractérisé par son bandeau, et son menu.
<!-- ici, c'est un survol. renvoi vers les parties plus détaillées -->
## Fiche usager
## Fiche ménage
## Fiche parcours
# L'interface générale
## Boutons et codes couleurs
<!-- récapitulatif des boutons et codes couleurs -->
* vert: ajouter / créer
* bleu (oeil): voir
* etc.
<!-- voir la première page du manuel fait par SB -->
### select2js et multiselect
## Menu section
## Menu utilisateur
# Moteur de recherche
## Recherche directe
Possibilité de recherche par date de naissance, numéro de téléphone, etc.
## Recherche avancée
# Fiche usager
## Créer un usager
## Détails de l'usager
## Quelle adresse pour un usager ?
Différence entre les adresses de résidence et les adresses d'un ménage.
## Personnes ressources
## Adresses de résidence
## Historique
## Traiter les doublons
## Autres entrées dans le menu personne
Renvoi vers les partie ad hoc:
* activité
* rendez-vous
* documents
# Activités (échanges)
## A quoi ça sert ?
## Activité dans les personnes ou les parcours ?
## Créer et modifier une activité
## Effets de la sélection des problématiques ou des actions sur les parcours
# Documents
## A quoi ça sert ?
## Ajouter un document
## Générer un document
# Rendez-vous
TODO
# Tâches
## Principes des tâches
### Statuts sur les tâches
### Tâches en rappel, tâches arrivées à échéance
## Créer une tâche
# Parcours
## Qu'est-ce qu'un parcours ?
### Les étapes d'un parcours: brouillon, confirmé, etc.
### Problématiques et actions
### Parcours confidentiels
### Parcours réguliers et ponctuels
## Créer un parcours
## Commentaires dans les parcours
## Actions d'accompagnement
### Evaluations et objectifs
## Cloturer un parcours
# Ménages
## Qu'est-ce qu'un ménage ?
### Les positions dans le ménage
<!-- attention, les positions "enfants hors ménage", etc., c'est de la configuration -->
## Ajouter des membres au ménage, quitter un ménage, rejoindre un ménage
## Filiations
## Composition familiale
# Notifications
## Créer une notification
## Discuter dans une notification
# Workflows
## Créer un workflow
## Ajouter une décision à un workflow
## Rejoindre un workflow par un lien d'accès
# Activité annexes
# Choisir une adresse

View File

@@ -0,0 +1,47 @@
\newpage
# Activities (exchanges)
<!-- en/activity/?accompanying_period_id={id} -->
![List of exchanges related to a course](user/img/en_activity__accompanying_period_id_2705.png)
Activities (or exchanges) in Chill are used to record activities or exchanges that have taken place and to link them to users and/or support pathways. By activity, we mean an individual interview, an approach via an external
partner, a telephone call relating to the person, an e-mail, etc.
The information to be encoded is different according to the type of activity.
For example, for a telephone call, you can specify the duration of the call, the caller and take a note. For a meeting, you can associate a location (the place where the meeting took place), the parties present at the meeting, notes, documents, etc.
In this way, this information can be centralised and then easily shared between the social workers.
The types of activities and their corresponding fields (location, duration, travel time, documents, presence of the person, users, etc.) can be configured in the administration area.
## Activity in persons or trajectories?
The activities can be encoded in the person or in the support path. It is up to you to choose whether to encode activities in the context of a support pathway or in the context of a person. However, as soon as a person is mentioned in an activity, this activity can be found in the list of activities of the person.
Example: In the support path of the user Gabrielle Durant, I create an activity concerning an email where I also mention another user encoded in Chill: Dominique Duchemin. The activity will be visible in Gabrielle Durant's support path, but also in her user file and in Dominique Duchemin's file.
We can therefore access the list of activities of a person via the "user" menu and the list of activities of a support path via the "support path" menu.
## Create and modify an activity
In the list of activities, click on the "Create" button to create a new activity. First choose the type of activity/exchange, then fill in the relevant information. If the activity has been created in a pathway, the social issues and related support actions will be filled in. Depending on the type of activity, you will be able to fill in the parties involved, the date, the location, the duration of the activity, the possible travel time (in case of a trip), documents, the subject, a free note, etc.
The subject is taken from a predefined list, established in the administration area of the software.
Any type of document can be added to an activity: a text document, a pdf, a photo, etc.
The parties involved, users, third parties or users (social worker), are added by searching for people already encoded in Chill or by creating them on the fly. If the activity has been created in a pathway, you can easily add parties involved by clicking on the proposed names. The proposals are based on the parts mentioned in the accompanying course.
::: { .info }
It is possible to transform an appointment into an activity. (TODO)
:::
Users can create a [private comment](./private_comments.md) per activity, which will only be seen by them.
Once an activity has been created, it is always possible to modify it to make corrections or additions.
## Effects of the selection of issues or actions on trajectories

View File

@@ -0,0 +1,33 @@
/newpage
# Side activities
To allow a user to also keep track of activities that are not directly related to a support trajectory or to a person, there is a side activity section.
A side activity could be a team meeting, a training, but also a phone call or email.
## Listing page
<!-- /fr/asideactivity -->
A user can navigate to his/her list of side activities from within their user menu by clicking on <**My side activities**>. Similar to other sections of the Chill app, you will find here a list that offers a first quick overview of each activity. You can view the activity in more detail, edit, or delete it.
## Creating a side activity
<!-- /fr/asideactivity/new -->
![Creation aside activity](/user/img/new_aside_activity.png)
The form fields of a side activity are self-explanatory. It is important to note however that a user can create a side activity for another user. Multiple users can also be linked, think of a meeting for example.
A side activity can be created for the future, but they can also still be created for activities that already took place. As such it shouldn't be seen as a planning tool, but more to keep record of side activities.
All fields are required, except for any additional note you might want to add.
## Detail page
<!-- /fr/asideactivity/{id}/view -->
Within the detail page the most important thing to note is the option to **duplicate** a side activity. For example, a meeting that is held weekly with more or less the same people can therefore easily be duplicated, while still allowing modifications to be made.

View File

@@ -0,0 +1,13 @@
# Bulk reassign support trajectories
The need may arise for the support trajectories followed by one user to be reassigned to another user. Example cases could be a user being absent for an extended amount of time, switching functions, etc.
For such situations a functionality has been provided to reassign support trajectories in bulk to another user.
To make use of this functionality the user can click on 'Trajectories per user' in the section menu.
A first select field will be visible. Use this to select the user whose trajectories have to be reassigned. A complete list of the trajectories will be provided.
In a second step the user to whom the trajectories on the current page have to reassigned can be selected. Clicking on the button 'reassign' will complete this action and show the remaining trajectories. The action can be repeated.
Each individual trajectory is displayed with the edit button, allowing it to be individually reassigned within the trajectory edit form. Navigate to the [referrer](./support_trajectory.md#referrer) section to reassign this trajectory. During a bulk reassign this trajectory will no longer be taken into account, as it no longer belongs to the initial user.

View File

@@ -0,0 +1,3 @@
/newpage
TODO: translate from french

View File

@@ -0,0 +1,98 @@
/newpage
# Households {#sec:household}
## What is a household?
A household is a set of users living 'under the same roof'. This can be members of a family, members of a blended family, members of a foster family, etc.
<!-- Living "under the same roof" OR living at the same address? -->
A household is characterised by an address, which corresponds to the home address of its members. This address can change (in case of a move): it is therefore defined between a start date and an end date and there may be a history of household addresses. Similarly, a user may change household and have a history of households.
## Household summary
<!-- /en/person/household/{household_id}/summary -->
![Household Summary](user/img/en_person_household_376_summary.png)
The household summary page is accessed via the "person" menu or by clicking on the household icon in the person search. The household summary page shows the current household address, the household members and the composition of the household.
The household address history can be accessed in the household menu under the heading "Address history". The address history shows all successive household addresses and allows for additions.
<!-- /en/person/household/{household_id}/addresses -->
![Household address history](user/img/en_person_household_376_addresses.png)
A list of the household's trajectories can also be displayed by clicking in the household menu on <**trajectories**>.
### Create a household
If there is no household in the list of households for a user, then the software allows you to create a new household. At this stage, you can create a new household or join an existing one. The software will automatically propose possible households by making some suggestions.
#### Which households are suggested?
The software tries to establish links between the persons concerned by the change of household, and other households.
The links made are as follows:
* For each person affected by the change, the software checks whether he or she is present in another support trajectory, with other persons. If these persons are themselves associated with a household, then the software proposes to join that existing household.
* The software also examines the location of the support trajectories in which the person, concerned by the change, is located. If a support trajectory is located at a reference address, the software looks to see if there are other households living at that address. If it finds any, these households will also be suggested.
At this stage, you can enter an address; this will immediately locate the created household. The software will suggest you to re-use known addresses.
#### Which addresses are suggested?
The software suggests you to re-use the temporary location of the support trajectories associated with the household members.
For each person who is going to "change household", the software examines whether he is currently associated with a trajectory. If this trajectory has a temporary address, then this address will be included in the suggestions.
### Join a household
There are several possible ways of getting a person to join a household:
- when creating a social trajectory for a person who is not in a household, the software suggests that he/she should join a household. The action then positions him/her in a household, whether it is an existing household or one to be created.
- When you are on the household summary page, you can always search for and add a person. To do this, use the "Add a member" button at the bottom of the page.
### Positions in the household
<!-- note that the positions "children outside the household", etc., are configurations -->
Each member of the household is detailed in the "household summary" page. The person can have a certain position in the household: adult or child, as well as being the owner of a household. At any time it is possible to remove a person from a household, or to reposition him/her in the household (e.g. to make him/her the owner).
If necessary, it is also possible to view a former membership, i.e. a person who used to belong to the household but is no longer part of it.
## Add members to the household, leave a household, join a household
At the bottom of the household summary page, the <**Add a member**> button allows you to add a user to the household. When clicking on this button, in the following pages, one can:
- add one or more existing persons, or create new ones;
- position each person in the household, i.e. specify whether he/she is a child or an adult, and possibly qualify him/her as a household member;
- enter the date when the person joins the household, and possibly a comment;
- and, finally, save.
In the list of household members, using the buttons on the right, one can
- leave the household: in this case, the person can join another household or leave without joining a household. Again, a change date is encoded.
- reposition the member: i.e. change the position (adult, child, ...) of the member.
- fill in the membership: i.e. change the date and the comment of the change
## Affiliations
<!-- /en/person/household/{household_id}/relationship -->
![Affiliations of a houshold](user/img/menage_filiations.png)
The "affiliations" page provides an overview in graph form of the affiliations within a household, i.e. the relationships between its members. This page allows not only to view the relationships but also to edit them. By clicking on <**Create a relationship**>, then selecting 2 persons, it is possible to define the relationship between these 2 persons: mother/father-daughter/son, brother/sister-brother/sister, uncle/aunt-nephew/niece.
In addition, the graph also shows the support trajectories associated with each household member. By displaying the trajectory, persons who may be linked to these trajectories, but belong to other households can be displayed. The elements of the graph can be moved by clicking and dragging. Finally, the graph can be exported as an image.
In short, this page summarises a household and its relationships in an easy-to-understand diagram.
## Family composition
The family composition is a qualification of the household as a household type, e.g. couple with children, couple without children, single mother, single woman, etc. This composition is valid until a certain date and with a maximum of one year.
As with the addresses of a household, it is possible to view the history of the composition of a household.

View File

@@ -0,0 +1,9 @@
---
title: Chill user manual
lang: en-EN
toc: true
header-includes: |
\usepackage{awesomebox}
...

View File

@@ -0,0 +1,38 @@
\newpage
# Notifications
<!-- en/notification/inbox -->
![Notification inbox](user/img/en_notification_inbox.png)
Notifications are messages sent by one user to one or more others. The purpose of notifications is to quickly exchange information about ongoing social cases between social workers. For example, notifications can be used to inform a caseworker about a case.
They can be accessed either from the Chill homepage, under the "My notifications" tab, or anywhere in the application via the "user" menu at the top right of the screen. Depending on the configuration chosen by the software administrators, notifications are also sent by email to the social worker concerned.
## Create a notification
<!-- en/notification/create?entityClass=Chill%5CPersonBundle%5CEntity%5CAccompanyingPeriod&entityId=2705-->
![Create a notification](user/img/notification_parcours.png)
Notifications can be sent from several places in the software. A notification consists of a subject (such as an email), one or more recipients, a message and the information from which the notification is sent. For example, when sending a notification as part of a course, the general course information is also copied.
It is possible to send a notification:
- from the summary page of a support trajectory
- from an activity/exchange
Notifications sent, for example, from a support trajectory, are listed in the trajectory summary.
<TODO: Are there any other places where notifications are used? -->
In addition, there are notifications that are automatically sent when certain actions are taken.
## Discuss in a notification
<!-- en/notification/{notification_id}/show -->
![Discussion in a notification](user/img/en_notification_126_show.png)
When a notification is received, it is possible to start a discussion with the recipient in the notification page. This allows messages to be left between workers, as in an online chat system.
In the list of notifications, when you click on a notification, you can unfold the content of the notification and access the discussion with the "View associated comment thread" icon.

View File

@@ -0,0 +1,98 @@
\newpage
# Person file {#sec:person}
The person file contains all the information specific to the person: surname, first name, contact information, addresses, etc. It is the basis of the person's electronic social file.
It can be accessed by searching for a person on the homepage or in the toolbar. It can also be accessed from other pages by clicking on a person's name and then clicking on "Open person file".
<!-- TODO a déplacer vers une autre section, sur le concept de l'usager? -->
A person can be part of one or more households. For each person, it is possible to define support trajectories. Finally, each person is linked to exchanges in which the person is involved.
## Create a person
<!-- fr/person/new -->
![Create a person](user/img/fr_person_new.png)
To add a person, click on "Sections" > "Add a person", in the top toolbar.
In the creation page, enter the requested information. Only the surname, first name(s) and gender are mandatory. Then click on "Create person". You can then choose between simply creating the person, creating the person and associating him/her with a household or creating the person and creating an associated support trajectory.
::: { .info }
Please note that there is a standard format for entering telephone numbers. Enter your numbers without spaces, "/" bars or "-" dashes.
<!-- TODO d'autres contraintes sur les numéros de tel? -->
:::
## Person detail page
<!-- fr/person/{id}/general -->
![Person detail page](user/img/fr_person_2811_general.png)
The person record contains all the detailed information of the person, namely:
- surname, first name(s), gender;
- nationality, languages spoken, number of children, marital status
- date and place of birth;
- contact information.
This information can be filled in as you go along, or left blank. At the bottom of the page, the "Edit" button allows you to edit this information. Remarks can also be added.
Some of this information is recalled in the person's banner and in other places in the software when the person's name is clicked on.
## Person addresses
Chill supports two types of addresses:
* home addresses, which are the permanent, official addresses of a person (home address);
* residence addresses, which are temporary addresses of a person, at which he/she resides only for a certain period of time, and which is not intended to be official.
Therefore, the official address is not attached directly to a person, but to his or her household. Only residential addresses can be entered in the person's file.
## Home address
<!-- /fr/person/{id}/residential-address/list -->
![Person home address](user/img/fr_person_2811_residential-address_list.png)
Each person can have one or more home addresses. These are accessed by clicking on "Home addresses" in the right-hand menu.
These addresses are not supposed to be official home addresses, declared to the authorities. They are, for example, a temporary residence in a nursing home, accommodation with an acquaintance or friend for a specific period of time, etc.
When adding a residence address, there is a choice between
- taking an address from another person (from another person);
- taking an address from a third party;
- create a new address [address](#sec:choose-an-address).
## Resource persons
<!-- /fr/person/{id}/resources/list -->
![resource persons](user/img/fr_person_2811_resources_list.png)
Resource persons are other persons or third parties associated with the person's file. A contact person may be a friend or neighbour (another person), a health professional (a third party), etc. Other members of the person's household should be entered in the "household" section instead. If the contact person is not encoded, he/she can also be added as a free description.
<!-- ## Historique
<!-- /fr/person/{id}/timeline
TODO -->
## Treating doubles
<!-- /fr/person/{id}/duplicate/view -->
It is possible that a person has been encoded more than once. The "Dealing with duplicates" page allows you to identify and deal with possible duplicates of a person. The page lists persons with similar names and suggests merging them.
::: { .info }
This page is used to process duplicates, but Chill also automatically detects potential duplicates when encoding a new person.
:::
## Other person menu entries
There are several entries in the person menu that link to other parts of the software, keeping the link to the person. These entries are:
* Support trajectories: list of the trajectories in which the person is involved;
* Activities (or exchanges): list of activities in which the person is involved;
* Documents: list of documents in which the person is involved;
* Tasks: list of tasks in which the person is involved;
* Households: management of the person's household.

View File

@@ -0,0 +1,7 @@
## Private comments
Private comments can be created for [activities](./activity.md#create-and-modify-an-activity), [social actions](./social_actions.md#private-comment) and appointments.
Each user can post one private comment per item (eg. per activity). This comment can of course be edited within the edit forms of the concerning item.
Naturally, users can only see their own private comments and not those of other users.

View File

@@ -0,0 +1,10 @@
\newpage
# Recherche
In the top banner, there is a person search bar. You can search for persons by surname and first name, the search engine being tolerant of different spellings. For example, if you search for "Mathieu", you will also find first names corresponding to "Matthieu".
If you have not found the person, you can click on the "Advanced search" button. In the advanced search page, you can search on the basis of date of birth, a fragment of telephone number, etc.
![Advanced search for a person](user/img/advanced_search.png)

View File

@@ -0,0 +1,75 @@
/newpage
# Social support actions
Social support actions are actions taken within a trajectory and concerning a certain social issue.
Social support actions are easily recognizable throughout the application by the orange title banner.
__note__: Social actions can only be created for **confirmed** trajectories.
## Listing page
<!-- /fr/person/accompanying-period/{id}/work -->
![social_action](/user/img/action_accompagnement.png)
Similar to many other sections within the Chill application, a list of social support actions can be found by clicking on <**social support actions**> in the yellow side-menu of a trajectory.
A concise overview of important information is given for each action in the list.
So long a trajectory is in the **confirmed** state each action can be modified, deleted or a [workflow](/user/English/workflow.md) can be created.
## Creating a social support action
<!-- /fr/person/accompanying-period/{id}/work/new -->
To create a social support action a user will be guided through several steps,
1. Pick one social issue. If the concerning social issue is not amongst the provided choices the user can add it by selecting it from the dropdown menu.
2. Pick a social action. All actions displayed are linked to the previously selected social issue.
3. One or more concerning persons can be selected.
4. Specify a start date.
5. Specify an ending date (optional).
## Modifying a social support action
Once a social support action has been created it is not considered to be a static recording. The modification form allows for much more information to be added in later stages so as to make it a 'working document'.
### Comment
Here the user is free to give whatever extra information necessary.
### Private comment
Users can create a [private comment](./private_comments.md) per social action, which will only be seen by them.
### Motives and goals
Social support actions are never random. They are taken with certain motives or to attain a certain goal.
By clicking on a badge (+) within the dropdown menu of this section, the user can add the motive or goal of the action. By clicking on it again (-) it can be removed.
Multiple goals can be selected.
### Results or outcome
Once a motive or goal is identified it is also possible to specify a result or outcome of the action concerning this specific goal. Similarly they can be selected from a dropdown menu and removed again.
Multiple outcomes can be selected.
### Evaluations, forms or correspondence
Multiple evaluations or forms can be added to a social support action. It is specified which evaluation can be started and clicking on the badge (+) will open a form for the user to fill in.
The form allows a starting date, due date and ending date to be set, as well as a reminder. An extra comment box can be used to give more details and a [document](/user/English/documents.md) can be generated or uploaded.
### Concerned persons
Concerned persons within the trajectory are listed here and the user can select who was involved in this specific social support action.
### Treating thirdparties
If an external partner executed the social action, they can be identified here.
Think of them as the main actor.
### Intervening thirdparties
These are external partners that participate(d) in the social action, but are not the main actors.

View File

@@ -0,0 +1,195 @@
/newpage
# Social support trajectory
Providing meaningful social support is often an intricate combination of goals, actions, involved actors, documents, etc... With its social support module, Chill aims to give it's users a tool which they can keep track of trajectories.
You can look at it as the third big module within the application. Like the person and household modules it can be easily identified by the banner at the top of the screen.
![Trajectory banner](/user/img/banner_course.png)
## Trajectory overview
![Trajectory dashboard](/user/img/parcours_dashboard.png)
<!-- /fr/parcours/{id} -->
The overview page assembles the most important information and latest activity within a trajectory, allowing you to take certain quick actions like clicking on associated person badges, linked activities or social actions, sending a new notification, etc...
In short it is the trajectory dashboard from where you can navigate to specific sections.
## Creation of a social support trajectory
<!-- /fr/parcours/{id}/edit -->
A new trajectory can be created from the section menu. Doing so will direct you to a blank trajectory form for you to fill-out.
> Sections > Create a new trajectory
A trajectory can also be created from within a person file and will immediately link it to this person. You will see the person added in the first section **concerned persons**
> Yellow person menu > Trajectories > Create a trajectory button
### Different states of a trajectory
It is important to distinguish three main states for a trajectory. A badge can be found in the top right corner of the banner or list-item to identify this state.
* **DRAFT**: the trajectory form has missing information and can therefore not be confirmed (badge color: gray) *
* **CONFIRMED**: all required information has been provided and further actions, activities,... can be added (badge color: dark blue).
* **CLOSED**: the social support trajectory has come to closure, the reason can be defined (badge color: red).
Within your user menu you will find a menu entry to direct you to,
* a listing page of **all** the trajectories to which you are the referrer.
* a listing page of all your **DRAFT** trajectories (ones you created, but have not yet confirmed).
While the above three are considered the main states, there are additional properties that distinguish the state of a trajectory. They are the following,
* **Confidential**: A confidential trajectory can only be viewed by the referrer. Other users will not have access to it's information.
* **Intensity**: TODO The intensity can be set to *regular* or *punctual*
* **Emergency**: This state can be toggled when urgent actions are required within this trajectory.
### Required information
The information required to **confirm** a trajectory is the following:
* It is linked to at least one [concerned person](#concerned-person).
* It has at least one linked [social issue](#social-issue).
* It is assigned to at least one [service](#service).
* It has to be [localised](#trajectory-localisation).
![Confirm trajectory](/user/img/parcours_confirm.png)
All of these requirements are listed at the bottom of the form when you have failed to fulfill them. This serves as a reminder to what you should do in order to confirm the trajectory.
### Concerned person
![Concerned persons](/user/img/concerned_persons.png)
A trajectory can be put started to provide support to multiple persons (eg. support is given to a mother and her two children).
### Trajectory localisation
![Localisation](/user/img/parcours_localisation.png)
Every trajectory **has** to be localised and this can be done in one of two ways.
1. You can indicate a temporary address by clicking the designated button. The address will not automatically be adapted when a concerned person moves. Therefore a message is displayed to remind you as a user that the second option, here listed, is preferable.
2. You can link it to a concerned person's **home address** by clicking the map-marker icon in the concerned persons section. If the person moves it will also be automatically adapted within the trajectory.
__Note__: While a trajectory is linked to a concerned person's address...
* it is not possible to dissociate this person from the trajectory.
* the person cannot be moved from a household without indicating another address.
#### Why localize a trajectory ?
Localising a trajectory allows for the following:
* The automatic assignment of a referrer.
* Inclusion in the list of trajectories to be discussed within meetings held by concerning services.
* The generation of localised statistics.
* The management of access rights.
#### Locate the trajectory with a concerned person
If a concerned person has an address, it is possible to locate the trajectory with this person.
When a trajectory is located with a person:
* the trajectory "follows" the person's address when he moves;
* it is not possible to dissociate the concerned person from the trajectory;
In addition,
* the person cannot leave the trajectory as long as the trajectory is located near him/her
* the person cannot leave the household without leaving an address, as long as he/she is located with at least one trajectory.
#### Temporary location
A temporary address may be assigned to a trajectory.
In this case, this location is associated with the route, and will not be automatically changed if a person moves. To avoid this situation, a warning message reminds persons that it is preferable to indicate a real location for the trajectory.
### Origin of the application for support
Within this section you will find a pre-defined list of possible origins (eg. the application was done by telephone)
### Administrative location
The administrative location is the place where the trajectory is processed. This is useful for organisations with several different locations.
### The applicant
This can be an already existing person/thirdparty or a new applicant can be created from within the search modal. Click on the button <**create 'your-search-name'**> to do so.
### Social issue
Using the dropdown menu multiple social issues can be identified. Link at least one to be able to confirm the trajectory.
### Services
Identify at least one service that is concerned with this trajectory. Multiple services can be selected. This will have an impact on who has the right to access the trajectory files.
### Referrer
The referrer is the colleague to whom you can refer yourself concerning this trajectory. They are responsible for the follow-up and they have specific rights linked to the state of the trajectory.
* They can mark it as confidential.
* They can mark it as urgent.
* They can change the intensity.
__Note__: These three states cannot be modified if a trajectory does not have a referrer assigned.
Likewise a referrer cannot be removed from a confidential trajectory.
### External partners
A trajectory is setup to provide support to one or more concerned persons. Naturally, there may also be one or more thirdparties or persons involved to offer this support. These partners can be added in this section by searching for their name.
When a partner does not yet exist they can be created from within the search modal by pressing the button **<create 'your-search-name'>**.
<!-- ## Trajectory history
<!-- /fr/parcours/{id}/history
TODO -->
## Social support actions
<!-- /fr/person/accompanying-period/{id}/work -->
When a trajectory is confirmed (i.e., it is in the state "Confirmed"), it is possible to add social actions to this trajectory. These are the actions that are taken to realize the support. Please read the documentation about [social actions](/user/English/social_actions.md) for in detail information.
## Comments
<!-- /fr/parcours/{id}/comments -->
Comments can be added to a trajectory to notify co-workers of additional information for which there may not be a designated section. A comment can be **pinned** to the trajectory dashboard by clicking on the flag icon.
__note__: Only one comment can be pinned to the dashboard, but all comments will remain available within the comment section to view,modify, re-pin, or delete.
## Tasks
<!-- /fr/task/single-task/by-course/{id} -->
Just as within the person module, tasks can be created and assigned within a trajectory. Please read the documentation about [tasks](/user/English/tasks.md) for in detail information.
## Documents
<!-- /fr/parcours/{id}/documents -->
Just as within the person module, documents can be attached to a trajectory. The only difference here is that a trajectory document can also be generated from a template. This template can be selected from the dropdown menu.
Please read the documentation about [documents](/user/English/documents.md) for in detail information.
## Close a trajectory
<!-- /fr/parcours/{id}/close -->
At any time a trajectory can be closed by clicking on the sidebar menu entry **<close trajectory'>**.
You will be taken to a small form in which you can specify the date of closure and the reason.
## Re-open a trajectory
When a trajectory is closed the menu will adapt itself to offer the user the possibility to re-open it. No further actions are required after clicking this button.

View File

@@ -0,0 +1,43 @@
/newpage
# Tasks
## Listing page
<!-- /fr/task/single-task/by-course/{id} -->
Clicking on the <**task**> menu entry in the person or trajectory side-menu will bring you to the listing page.
Here you have an overview of all tasks related to this particular person or trajectory.
At the top of the list you find a searchbar and several filtering options,
* Future tasks or tasks without due date
* Tasks that are almost due
* Tasks with a passed due date
* New tasks
* Tasks that are in progress
* Closed tasks
* Removed tasks
Listed tasks are displayed with their title, a badge identifying the state in which the task can be found (new, in progress, closed,...) and their starting date, date on which a reminder will be sent and their due date. Your task reminders can be found on the homepage widget, or displayed in your user menu.
A separate user menu entry will take you directly to a listing page of all your tasks that have surpassed their due date and have not been closed. This menu entry is easily identifiable by the exclamation mark triangle (!).
## Creating a new task
<!-- /fr/task/single-task/new -->
![Creation task](/user/img/new_task.png)
To create a new task you will be given a form to fill in.
The fields are self-explanatory but do note that only the title is required.
## Detail page
<!-- /fr/task/single-task/{id}/show -->
You can view the task in more detail by clicking on the **eye** icon button. On the detail page you will see the description of the task, but also the task history. The history gives you an overview of state changes and who undertook them on which day. This allows users to easily keep track of tasks.
Within the detail page, as well as in the listing page you have the ability to navigate to an edit page where you can modify the task. A task can also be deleted and it's current state can be changed using the dropdown button <**change state**>.

View File

@@ -0,0 +1,59 @@
/newpage
# Thirdparty
Within the context of social support you will most likely work together with plenty of professional external partners.
Chill allows you to easily link them to a user and their social support trajectory, giving you a complete overview of each partner involved.
All thirdparty information can be consulted by going to the section menu in the top-right corner and selecting **thirdparties**.
At the top of the list a searchbar allows you to easily find the thirdparty you are looking for on the basis of their name.
## Create a thirdparty
At the bottom of the page you will find the button to create a new thirdparty.
In doing so you will see a distinction being made between creating a thirdparty as a **legal entity** or a **natural person**.
Choose 'legal entity' if you want to add a thirdparty that is, for example, a doctor's practice or an organization.
A 'natural person' would be any professional person that you would like to add as a thirdparty, eg. a psychologist.
It is important to note that within a **legal entity** you can add **contacts**.
These are most likely individual professionals working within the organization or associated with it.
----------
### Legal entity
![Legal entity](/user/img/thirdparty_morale.png)
Creating a **legal entity** takes you to a form which you can complete with the following information.
* **Name**
* **Acronym** (eg. CPAS)
* **Service/department**: you can target a specific department or service within the larger entity (eg. elderly support).
* **Contact information** (phonenumber, email)
* **Address**:
Aside from adding a complete address there are two options to take into account.
> **Incomplete address**: In choosing to enter an incomplete address you will only specify a general location (town or city).
> **Confidential**: The address can be identified as confidential. (eg. the address of a safehouse should not be readily viewable. It will be blurred in overview pages and you will have the option to reveal it.)
* **Contacts**: Contacts are natural persons associated with the legal entity. You can specify their title and role within the entity and add their contact information. As with the address above there is an option to make it a confidential contact. Their information will thus be blurred throughout the application and can be revealed when needed. Each contact can be deleted individually and these changes will be saved when saving the entire entity.
![Thirdparty contact](/user/img/thirdparty_contact.png)
* **Comment**
* **Active/inactive**: a thirdparty can be set to inactive (eg. they are no longer operational).
---------
### Natural person
A natural person is a thirdparty that stands on it's own. Although a thirdparty contact is in fact also a natural person, they are two distinct entities in Chill.
Within the form the following can be specified,
* **Civil title** (eg. Mrs., Mayor, ...)
* **Name**
* **Professional role** (eg. secretary, nurse)
* **Support category**: the category under which their services fall.
* **Contact information**: phonenumer, email, address. Contact information can be identified as confidential.
* **Comment**
* **Active/Inactive**

View File

@@ -0,0 +1,3 @@
/newpage
TODO translate from french

11
user/docs/_a-classer.md Normal file
View File

@@ -0,0 +1,11 @@
## Fonctionnement du moteur de recherche des tiers:
Le moteur de recherche des tiers dans "add person" permet d'effectuer des recherches sur les noms des tiers, les acronymes, et leur service. Il classe également les plus pertinent, en tenant compte éventuellement du nom de la localité du tiers, s'il possède une adresse.
Le moteur sélectionne d'abord les tiers sur base du nom, de l'acronyme ou du nom du service. Lorsqu'une recherche comporte plusieurs mots (séparés par un ou plusieurs espaces), il sélectionne les tiers dont le nom, l'acronyme ou le nom du service contient un de ces mots seulement.
Le moteur affiche les résultats les plus pertinents en premier. Il classe en premier les tiers dont le mot recherché correspond à un des mots du nom, de l'acronyme, ou du nom du service, **ou de la localité du tiers**. Cela permet donc de présenter en premier les tiers dans une localité particulière.
Ainsi, si une recherche est effectuée avec les termes `ADMR roche`, tous les résultats dont l'acronyme est ADMR sont renvoyés. Cependant, les tiers dont la localité est La-Roche-Sur-Yon seront considérés plus pertinents (ils disposeront de deux mots qui correspondent (`admr` et `roche`) plutôt qu'un seul); ils seront donc présentés en premier.

45
user/docs/activite.md Normal file
View File

@@ -0,0 +1,45 @@
\newpage
# Activités (échanges)
<!-- fr/activity/?accompanying_period_id={id} -->
![Liste des échanges liés à un parcours](./img/fr_activity__accompanying_period_id_2705.png)
Les activités (ou échanges) dans Chill servent à consigner des activités ou des échanges ayant eu lieu et de les associer à des usagers et/ou à des parcours d'accompagnement. Par activité, nous entendons un entretien individuel, une démarche via un
partenaire extérieur, un appel téléphonique relatif à la personne, un courriel, etc.
Les informations à saisir sont différentes selon le type d'activité. Par exemple, pour un appel téléphonique, on peut spécifier
la durée de l'appel, l'interlocuteur et prendre une note. Pour une réunion, on peut y associer une localisation (l'endroit où a eu lieu la réunion), les parties présentes à la réunion, des notes, des documents, etc.
Ainsi centralisées, ces informations peuvent ensuite être facilement partagées entre les travailleurs sociaux.
Les types d'activités et leurs champs correspondants (localisation, durée, durée du trajet, documents, présence de la personne, usagers, etc.) sont configurables dans l'espace d'administration.
## Activité dans les personnes ou les parcours ?
Les activités peuvent être enregistrées à la personne ou bien au parcours d'accompagnement. C'est à vous de choisir de saisir des activités dans le cadre d'un parcours d'accompagnement, ou bien dans le cadre d'une personne. Toutefois, dès lors qu'une personne est mentionnée dans une activité, on pourra retrouver cette activité dans la liste des activités de la personne.
Exemple: Dans le parcours d'accompagnement de l'usager Gabrielle Durant, je crée une activité concernant un courriel où je mentionne également un autre usager enregistré dans Chill: Dominique Duchemin. L'activité sera visible dans le parcours d'accompagnement de Gabrielle Durant, mais aussi dans sa fiche usager et dans celle de Dominique Duchemin.
On peut donc accéder à la liste des activités d'une personne via le menu "usager" et à la liste des activités d'un parcours d'accompagnement via le menu "parcours d'accompagnement".
## Créer et modifier une activité
Dans la liste des activités, cliquer sur le bouton "Créer" pour créer une nouvelle activité. Choisissez d'abord le type d'activité/échange, puis remplissez les informations utiles. Si l'activité a été créée dans un parcours, on y renseignera les problématiques sociales et les actions d'accompagnement liées. Selon le type d'activité, vous pourrez renseigner les parties concernées, la date, la localisation, la durée de l'activité, la durée éventuelle de trajet (dans le cas d'un déplacement), des documents, le sujet, une note libre, etc.
Le sujet est pris dans une liste prédéfinie, établie dans l'espace d'administration du logiciel.
Tout type de document peut être ajouté dans une activité: un document texte, un pdf, une photo, etc.
Les parties concernées, usagers, tiers ou utilisateurs (travailleur social), sont ajoutés en recherchant les personnes déjà enregistrées dans Chill ou en les créant à la volée. Si l'activité a été créée dans un parcours, vous pouvez facilement ajouter des parties concernées en cliquant sur les propositions de noms. Les propositions se font sur base des parties mentionnées dans le parcours d'accompagnement.
<!-- ::: { .info }
Il est possible de transformer un rdv en activité. (TODO)
::: -->
Lorsqu'une activité a été créée, il est toujours possible de la modifier pour y faire des corrections ou des ajouts.
<!--
## Effets de la sélection des problématiques ou des actions sur les parcours -->

66
user/docs/adresses.md Normal file
View File

@@ -0,0 +1,66 @@
\newpage
# Gestion des adresses
## Choisir une adresse {#sec:choisir-une-adresse}
Que ce soit dans un ménage, dans un tiers ou encore pour localiser un échange, il y a plusieurs endroits où vous pouvez saisir une adresse dans Chill.
### Création d'une d'adresse
Lorsque le formulaire d'adresse s'ouvre, vous pouvez soit sélectionner une adresse "de référence", soit en saisir une nouvelle. Il est en effet possible de pré-charger une liste d'adresses de référence provenant de sources officielles dans Chill. Suivant votre installation, cela a peut-être été fait pour votre région, votre département ou le pays entier.
![Création d'une d'adresse](./img/choisir-une-adresse.png)
La case à cocher "Adresse confidentielle" permet d'indiquer qu'une adresse doit apparaitre par défaut floutée dans le logiciel ou tout document exporté du logiciel.
La case à cocher "Pas d'adresse complète" permet d'indiquer une adresse uniquement en indiquant la pays et une localité, sans définir la rue et le numéro de bâtiment. Si cette case n'est pas cochée, vous devez remplir la rue et le numéro de bâtiment.
Si des adresses de référence ont été pré-chargées dans le logiciel, vous pouvez successivement choisir la localité (ville ou village), puis l'adresse précise (rue et numéro de bâtiment). Si l'adresse est inconnue par le logiciel, que ce soit au niveau de la localité ou de l'adresse précise, écrivez le nom dans le champ correspondant et le formulaire vous proposera de saisir une nouvelle adresse. Attention, la recherche d'une adresse pré-chargée est sensible à des fautes de frappes ou d'orthographe, donc assurez-vous de l'orthographe de votre saisie avant de créer une nouvelle adresse.
Lorsqu'une adresse de référence est sélectionnée, la localisation de l'adresse est connue et le pointeur se déplace sur la carte à l'endroit de l'adresse. Lors de la création d'une adresse inconnue par le logiciel, la localisation ne peut pas être définie.
En bas du formulaire, une série de champs optionnels peuvent être complétés pour préciser l'adresse (étage, couloir, escalier, complément d'adresse, etc.). En remplissant adéquatement ces champs, le logiciel pourra générer des adresses postales valides utiles pour la génération de documents.
### Dates de validité
Dans le cas d'une adresse d'un ménage, lors de la création d'une adresse, une date de validité doit être choisie, indiquant à partir de quand l'adresse est valide. Lors d'un changement d'adresse, le logiciel va garder l'historique des adresses d'un ménage en tenant compte de ces dates de validité.
## Édition d'une adresse existante
Dans le cas d'une erreur, ou bien dans le cas d'un changement d'adresse d'un tiers, il est possible d'éditer une adresse existante en cliquant sur le bouton "Modifier l'adresse".
## Visualiser les détails d'une adresse
A côté de chaque adresse, un bouton indiquant une carte permet de visualiser les détails d'une adresse, et notamment:
- visualiser l'adresse sur une carte;
- ouvrir, dans une nouvelle fenêtre ou un nouvel onglet, une carte détaillée sur Google maps ou OpenStreetMap, pour visualiser l'endroit de manière plus confortable et éventuellement calculer un itinéraire;
- lister les zones statistiques géographiques qui recouvrent l'adresse.
::: {.note}
La page de visualisation sur Google Maps où OpenStreetMap s'ouvre dans un nouvel onglet, ou une nouvelle fenêtre.
:::
![Une adresse, le bouton avec une carte permettant de visualiser les détails de cette adresse](img/address_inline_with_button.png)
![Visualisation des détails d'une adresse](img/address_details_modal.png)
## Mise à jour des adresses de référence
Les adresses de références devraient être régulièrement mises à jour. Il est probable que des changements aient lieu dans des adresses de référence qui sont associées aux adresses des tiers et des ménages.
Dans ce cas, cela est indiqué dans l'affichage de l'adresse et dans la modale qui permet de visualiser les détails. Vous pouvez alors choisir de mettre à jour cette adresse ou d'ignorer les changements.
![Adresse dont l'adresse de référence a été modifiée](img/address_inline_with_button_and_warning.png)
![Mettre à jour une adresse de référence modifiée](img/address_details_modal_with_address_reference_change.png)
::: {.note}
Il existe un filtre permettant de lister les ménages dont l'adresse de référence a fait l'objet d'une mise à jour.
:::

View File

@@ -0,0 +1,31 @@
/newpage
# Activités annexes
Pour permettre à l'utilisateur de gérer les activités qui ne sont pas directement liées à un parcours d'accompagnement ou à un usager, il existe une section d'activités annexes.
Une activité annexe peut être une réunion d'équipe, une formation, mais aussi un appel téléphonique ou un courriel.
## Page d'inscription
<!-- /fr/asideactivity -->
Un utilisateur peut naviguer vers sa liste d'activités annexes à partir du menu utilisateur en cliquant sur **Mes activités annexes**. Comme pour les autres sections du logiciel, vous trouverez ici une liste qui offre un premier aperçu rapide de chaque activité annexe. Vous pouvez voir l'activité plus en détail, la modifier ou la supprimer.
## Créer une activité annexe
<!-- /fr/asideactivity/new -->
Les champs du formulaire d'une activité annexe sont auto-explicatifs. Il est important de noter cependant qu'un utilisateur peut créer une activité annexe pour un autre utilisateur.
Une activité annexe peut être créée à une date future ou passée. En tant que tel, il ne faut pas le considérer comme un outil de planification, mais plutôt comme un outil d'enregistrement des activités.
Tous les champs sont obligatoires, à l'exception du champ commentaire.
## Page de visualisation
<!-- /fr/asideactivity/{id}/view -->
Dans la page de détail, la chose la plus importante à noter est l'option de **duplication** d'une activité annexe. Par exemple, une réunion qui se tient chaque semaine avec plus ou moins les mêmes personnes peut facilement être dupliquée, tout en permettant d'y apporter des modifications.

36
user/docs/concept.md Normal file
View File

@@ -0,0 +1,36 @@
\newpage
# Survol des concepts dans Chill {#sec:concept}
Chill est un logiciel conçu spécialement pour l'accompagnement social. Il est mis en œuvre dans des contextes institutionnel différents mais repose sur un socle de concepts qui peuvent être utilisés dans plusieurs environnements où évoluent des travailleur·euses sociaux.
Les trois concepts de base du logiciel sont:
- l'**usager**: la personne bénéficiaire de l'accompagnement social. L'usager est au centre du logiciel: sur la page d'accueil, il y a une recherche par nom parmi les usagers enregistrés dans le logiciel. La "fiche usager" (voir [la section "usager"](#sec:person)) résume toutes les informations propre à la personne (date de naissance, information de contact, etc.).
- le **parcours d'accompagnement**: le dossier qui accompagne un ou plusieurs usagers. Un [parcours](#sec:parcours) a une date de début et peut être clôturé à une date de fin. Un référent du parcours peut être désigné. Chaque parcours est associé à une ou plusieurs problématiques sociales. Lors du parcours, des **actions d'accompagnements** sont créées et suivies.
- le **ménage**: le ménage dont fait partie l'usager. Comme l'accompagnement social peut se faire aussi à l'échelle d'un ménage plutôt qu'individuellement, la [page du ménage](#sec:household) rassemble les informations pour les usagers d'un même ménage.
Les pages du logiciel se divisent entre ces trois domaines, chaque domaine étant caractérisé par un bandeau avec une couleur particulière ainsi que son menu.
L'utilisateur peut passer d'un domaine à l'autre, par exemple en ouvrant la fiche d'un usager depuis un parcours ou un ménage. On peut passer du domaine usager vers le domaine ménage en cliquant sur l'icône symbolisant une maison à droite de l'adresse d'un usager, et repasser vers le domaine usager en cliquant sur le nom d'un des usagers du ménage. Plusieurs sections sont aussi accessibles via plusieurs domaines, comme les activités/échanges ou les tâches, accessibles dans le domaine "usager" et "parcours d'accompagnement".
![Les 3 bandeaux dans Chill](./img/banner_all.png)
Au-dessus des bandeaux se trouve la barre d'outil principale, qu'on retrouve dans chaque page du logiciel.
## Autres entités
D'autres entités sont manipulées dans Chill:
* Les travailleurs sociaux inscrivent leurs rencontres, réunions, appels téléphoniques au sein des **échanges**;
* Des **documents** peuvent être associés à chaque utilisateur, ou à chaque parcours. Ces documents peuvent être:
* générés à partir des informations du logiciel (à partir de "gabarits" définis par les administrateurs fonctionnels);
* déposés dans le dossier depuis des ressources externes
* Chill dispose d'un véritable carnet de contact, les **tiers** qui peuvent être associés à différentes entités dans le parcours et le dossier de l'usager;
* Chill peut enregistrer des **tâches**;
* Les utilisateurs peuvent s'envoyer des **notifications**;
* Un suivi des décisions (**Workflow**) peut être activé au sein du logiciel.

BIN
user/docs/cover-user.pdf Normal file

Binary file not shown.

BIN
user/docs/cover-user.svg (Stored with Git LFS) Normal file

Binary file not shown.

23
user/docs/document.md Normal file
View File

@@ -0,0 +1,23 @@
\newpage
# Documents {#sec:documents}
Un dossier social comporte souvent un certain nombre de documents, propre au travail social effectué, qui peuvent être stockés dans Chill. Il peut s'agir d'attestations administratives, de documents juridiques, etc, que ce soit sous forme de document électronique (par exemple au format pdf) ou bien un document en papier qui a été numérisé. Par ailleurs, le logiciel permet aussi de générer ses propres documents à partir de modèles pré-établis.
Tout comme les activités/échanges, les documents peuvent être enregistré à la personne ou bien au parcours d'accompagnement. L'accès aux documents enregistrés se fait par l'entrée "Documents" via le menu "usager" ou via le menu "parcours d'accompagnement". Les documents enregistrés sont téléchargeables: on peut les retrouver à tout moment par cette liste de documents.
![Liste des documents](./img/fr_person_2811_document.png)
## Ajouter un document
![Ajouter un document](./img/fr_person_2811_document_new.png)
Pour ajouter un document, dans la liste des documents, cliquer sur le bouton "Créer un nouveau document". Il est demandé de rentrer un titre, une date (par défaut la date de jour), une catégorie de document et une courte description. Ensuite, le document (un document au format pdf, un document de traitement de texte, ...) peut être glissé-déposé ou retrouvé sur un ordinateur en cliquant dans la zone de téléversement.
## Générer un document
![Générer un document dans un parcours](./img/generer_document_parcours.png)
Il est possible de générer ses propres documents à partir de modèles pré-établis et des données saisies dans chaque dossier social, que ce soit un dossier d'un usager ou d'un parcours. Les modèles sont des fichiers "templates" qui sont préparés par les administrateurs du logiciel et qui sont généralement propres à une organisation.
Par exemple, un document peut être généré à partir d'un modèle où toutes les informations d'un parcours d'accompagnement seront pré-remplies (personnes concernées et leur coordonnées, travailleurs et services impliqués, etc.)

208
user/docs/exports.md Normal file
View File

@@ -0,0 +1,208 @@
```{=latex}
\cleardoublepage
```
# Exports
Chill permet d'exporter les données sous différentes formes:
- des listes;
- des tableaux reprenant un ou plusieurs indicateurs.
Les listes peuvent être filtrées selon différents paramètres: âge de l'usager, date de l'échange, etc.
Les tableaux reprennent un indicateur (par exemple: nombre de parcours, nombre d'usager, durée moyenne des échanges), dont les données servant de base au calcul de cet indicateur peut également être filtré, mais aussi regroupé selon différents paramètres (exemple: statut du parcours, type d'échange, etc.). Ces exports ressemblent donc aux "tableaux croisés dynamiques" disponibles dans les logiciels de tableur.
## Fonctionnement général et concepts
### Export d'indicateurs
Les exports fonctionnent comme des tableaux croisés:
- un "export" permet de choisir l'indicateur.
Quelques exemples d'export: nombre de parcours, durée moyenne des parcours, nombre d'usagers, etc.
- des filtres permettent de ne retenir qu'une partie des données.
Exemple de filtre: uniquement les parcours urgent, les usagers de plus de 18 ans, etc.
- des regroupements créent des "classes statistiques" et permettent d'aggréger les données dans ces classes.
Cela permet de connaitre, par exemple, le "nombre d'échange par type d'échange", "le nombre de parcours par référent", etc.
### Listes de données
Au sein des exports, Chill propose des "listes" de données: liste des parcours, liste des usagers, etc.
Ces listes sont des données au format tableur, et chaque colonne comporte une information.
Les filtres des exports d'indicateurs sont disponibles pour les listes: il est donc possible de connaitre la liste des usagers de plus de 18 ans, etc.[^grouping-non-sense]
[^grouping-non-sense]: Les regroupements ne sont pas, eux disponibles: ils n'ont pas de sens dans ce contexte.
### Sauvegarde des exports configurés
Lorsqu'un export est configuré, il peut être sauvegardé par l'utilisateur. Ce dernier lui indique donc un titre et une description. L'export peut alors être re-joué plusieurs fois à partir des exports sauvegardés.
![Sélecteur qui permet d'accéder à la liste des exports enregistrés](img/export_select_saved_exports.png)
Les exports enregistrés peuvent être modifiés et sauvegardés sous un autre nom.
### Filtres
Les filtres permettent donc de filtrer les données avant l'export.
Ils peuvent être additionnés les uns aux autres: activer deux filtres lors d'un export filtrera les données pour ne retenir que les données qui correspondent aux deux filtres combinés.
Certains filtres demandent des paramètres pour être complétés.
### Regroupements
Les regroupements permettent de créer des classes statistiques pour regrouper les indicateurs.
Typiquement, chaque regroupement va ajouter une colonne dans le résultat, indiquant la nature de la donnée regroupée. Par exemple, le genre des usagers comptabilisés, le nom du référent du parcours, etc.
Ils peuvent également être combinés les uns aux autres. Dans ce cas, cela se matérialise par l'existence de plusieurs colonnes dans le résultat final: une colonne par regroupement.
Lorsque certaines données ne comportent pas de valeur, la cellule de la colonne du regroupement est généralement vide, ou son libellé est explicite.
#### Regroupements dans le cas de relation un-à-plusieurs
Il existe des relations un-à-plusieurs entre différents éléments, et qui font l'objet d'un regroupement. Quelques exemples: un parcours comporte plusieurs problématiques sociales, un échange peut comporter plusieurs utilisateurs participants, etc.
Dans ce cas, l'indicateur est comptabilisé plusieurs fois: une fois en regard de chaque ligne.
Prenons pour exemple les parcours et les problématiques sociales:
- le parcours n°1 comporte les problématiques "Logement", "Santé" et "Emploi";
- le parcours n°2 comporte les problématiues "Logement" et "Santé".
Le résultat sera le suivant:
| Problématique | Nombre de parcours | Explication |
|--------------:|---------:|-----------------------------------------------------|
|Emploi|1|Seul le parcours n°1 est comptabilisé |
|Logement|2|Le parcours n°1 et 2 sont concernés|
|Santé|2|Le parcours n°1 et 2 sont concernés|
Notez que le total des colonnes "nombre de parcours" est supérieur à deux (en l'occurrence il est de 5), alors qu'il y a seulement deux parcours concernés. Il est important d'être attentif à ce comportement lors de la comptabilisation des résultats: l'usage de "totaux" (souvent indiqués en bas de colonne, par exemple) n'est pas pertinent.
### Données historiques
Le logiciel Chill enregistre des données historiques: les référents d'un parcours, les référents des actions, l'appartenance d'un utilisateur à un ménage, etc.
Dès lors, de nombreux filtres et regroupements demandent une "date de calcul" pour ces éléments: il s'agit de la date à laquelle le référent était en position de désignation sur un parcours, l'appartenance de l'usager à un ménage à la date indiquée, etc.
### Dates glissantes
Les parcours peuvent être enregistrés, et rejoués à des dates différentes.
Dès lors, le logiciel utilise des "dates glissantes" pour indiquer une date, plutôt qu'une valeur absolue. Les "dates glissantes" se matérialisent par un menu déroulant dans lequel l'utilisateur indique un calcul de date:
- le début de l'année précédente,
- le début de l'année courante;
- la date du jour,
- etc.
Cet indicateur est converti **au moment de la génération de l'export**. Ainsi, le "début du mois précédent" sera le 1er janvier 2023 lorsque l'export est généré le 15 février 2023. Lorsqu'il sera généré le 15 mars 2023, le "début du mois précédent" sera le 1er février 2023.
Il n'y a pas de mention de "fin" d'une période ("fin du mois courant", "fin du mois précédent", etc.), car la fin d'une période est le début de la période suivante.
### Couches et zones géographiques
Les adresses sont localisées, dans Chill. La localisation géographique est enregistrée à l'endroit exact lorsque l'utilisateur a choisi l'adresse dans une liste de référence. Lorsque seul le code postal est choisi parmi les suggestions, alors l'adresse est géolocalisée à l'intérieur de la zone géographique du code postal, de manière aléatoire.
Les administrateurs peuvent injecter dans le logiciel des zones géographiques, qui appartiennent chacune à une "couche". Chaque zone est définie par une frontière (un polygone géographique). Ainsi, la couche des "communes" comportent plusieurs communes, appelées par leur nom. Chaque adresse peut être géographiquement associée à une zone géographique en fonction de la localisation: toutes les adresses à l'intérieur des frontières de la zone est associée à cette zone.
Chill est en mesure de proposer, dès lors,
- des filtres par zone géographiques;
- des regroupements par couche géographiques;
::: {.warning}
Lorsqu'une adresse n'est pas choisie dans la liste des adresses de référence, l'adresse n'est pas géolocalisée. Les statistiques sont donc inopérantes.
Cependant, Chill "essaie" de donner un géolocalisation aux adresses nouvellement créées par comparaison avec une adresse existante dans la base de donnée de référence, en comparant le nom de la rue et les codes postaux. Cependant, cet essai n'est pas toujours fructueux.
:::
::: {.info}
L'association entre les zones géographiques et les adresses est une opération couteuse, et donc lente, en termes informatiques. Pour permettre de générer des exports rapidement, cette association est calculée une fois par nuit.
En conséquence, l'association entre la zone géographique et les adresses du jour ne sera pas disponible.
:::
## Liste des filtres et regroupements
<!-- PHPFILE: this list was extracted through this command: find src/ -type f -iname '*.php' | grep Export | grep --invert-match Test | grep --invert-match Helper | grep --invert-match Controller | grep --invert-match Constraint | grep --invert-match DependencyInjection | grep --invert-match Interface | grep --invert-match Declaration | sort -->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Export/Formatter/CSVFormatter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Export/Formatter/CSVListFormatter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Export/Formatter/CSVPivotedListFormatter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Export/Formatter/SpreadSheetFormatter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Export/Formatter/SpreadsheetListFormatter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/DataMapper/ExportPickCenterDataMapper.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/SavedExportType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/AggregatorType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/ExportType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/FilterType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/FormatterType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/PickCenterType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Form/Type/Export/PickFormatterType.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Repository/SavedExportRepository.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Security/Authorization/ChillExportVoter.php-->
<!-- PHPFILE: src/Bundle/ChillMainBundle/Security/Authorization/SavedExportVoter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/AbstractAccompanyingPeriodExportElement.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/ActionTypeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/CurrentActionAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/GoalAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/GoalResultAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/JobAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/ReferrerAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/ResultAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/ScopeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountAccompanyingCourse.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountAccompanyingPeriodWork.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountEvaluation.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountHousehold.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountPerson.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/CountPersonWithAccompanyingCourse.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListAccompanyingPeriod.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListAccompanyingPeriodWork.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListEvaluation.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListHouseholdInPeriod.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListPersonDuplicate.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListPerson.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/ListPersonWithAccompanyingPeriod.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Export/StatAccompanyingCourseDuration.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/EvaluationFilters/ByEndDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/EvaluationFilters/ByStartDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/EvaluationFilters/CurrentEvaluationsFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/EvaluationFilters/EvaluationTypeFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/EvaluationFilters/MaxDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/HouseholdFilters/CompositionFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/AccompanyingPeriodWorkEndDateBetweenDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/AccompanyingPeriodWorkStartDateBetweenDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/CurrentActionFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/JobFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/ReferrerFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/ScopeFilter.php-->
<!-- PHPFILE: src/Bundle/ChillReportBundle/Export/Export/ReportList.php-->
<!-- PHPFILE: src/Bundle/ChillReportBundle/Export/Export/ReportListProvider.php-->
<!-- PHPFILE: src/Bundle/ChillReportBundle/Export/Filter/ReportDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/SocialWorkFilters/SocialWorkTypeFilter.php-->

View File

@@ -0,0 +1,506 @@
### Exports liés aux parcours
- liste des parcours;
- nombre de parcours;
- durée moyenne et nombre des participations des usagers aux parcours,
### Filtres liés aux parcours
#### Filtrer les parcours avec une localisation temporaire ou auprès d'un usager
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/HasTemporaryLocationFilter.php-->
Filtre les parcours associés à une localisation temporaire ou une localisation auprès d'un usager. La localisation doit être valable à une date indiquée en paramètre.
#### Filtrer les parcours ayant reçu un échange entre deux dates
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/PeriodHavingActivityBetweenDatesFilter.php -->
Ce filtre permet de ne prendre en compte que les parcours ayant reçu au moins un échange entre les deux dates indiquées en paramètre.
#### Filter les parcours ayant reçu une intervention entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/HavingAnAccompanyingPeriodInfoWithinDatesFilter.php-->
Ce filtre permet d'indiquer deux dates qui forment une période de recherche.
Filtre les parcours qui ont reçu au moins une intervention pendant cette période de recherche. La liste des interventions est identique à celle [utilisée pour le changement de statut des parcours](#sec:evenement-statut-parcours).
#### Filtrer les parcours dont la date d'ouverture est comprise entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/OpenBetweenDatesFilter.php-->
Ce filtre permet d'indiquer deux dates qui forment une période de recherche.
Filtre les parcours dont la date d'ouverture est comprise entre les deux dates indiquées en paramètre. La date de fin est non comprise dans la période de recherche.
Ce filtre permet de filtrer les "nouveaux parcours" qui ont débuté au cours d'une période.
#### Filtrer les parcours ouverts au moins un jour dans la période
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ActiveOneDayBetweenDatesFilter.php-->
Ce filtre permet d'indiquer deux dates qui forment une période de recherche.
Filtre les parcours, pour ne retenir que les parcours qui ont été ouverts au moins un jour pendant la période de recherche. Autrement dit:
- la date d'ouverture est antérieure à la fin de la période de recherche;
- la date de fermeture est postérieure au début de la période de recherche, ou le parcours est toujours ouvert.
#### Filtrer les parcours ouverts à une date
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ActiveOnDateFilter.php-->
Filtre les parcours, pour ne retenir que les parcours dont:
- la date d'ouverture est antérieure à la date communiquée,
- qui ne sont pas clôturés ou dont la date est de clôture est postérieure à la date communiquée.
#### Filtrer les parcours par action d'accompagnement
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/SocialActionFilter.php-->
Filtre les parcours ayant au moins une action d'accompagnement d'un type indiqué en paramètre.
#### Filtrer les parcours par confidentialité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ConfidentialFilter.php-->
Filtre les parcours marqués comme confidentiel ou non.
#### Filtrer les parcours par créateur
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/CreatorFilter.php-->
Filtre les parcours en fonction du créateur.
#### Filtrer les parcours par intensité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/IntensityFilter.php-->
Filtre les parcours en fonction de l'intensité (ponctuel ou régulier).
#### Filter les parcours par intervenant, entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/UserWorkingOnCourseFilter.php-->
Ce filtre permet d'indiquer:
- une date de début et une date de fin, qui forment une période de recherche;
- un ou plusieurs utilisateurs
Le filtre ne retient que les parcours qui ont reçu une intervention de la part d'un des utilisateurs indiqués en paramètre, et pendant la période indiquée. La date de fin est non comprise dans la période de recherche.
La notion d'intervenant est définie [dans le chapitre correspondant](#sec:parcours-intervenant).
Exemples d'utilisation:
- ce filtre permet de répondre à la question "Sur combien de parcours l'utilisateur Y est-il intervenu, entre le début de cette année et aujourd'hui".
#### Filtrer les parcours par localisation administrative
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/AdministrativeLocationFilter.php-->
Filtre les parcours par localisation administrative.
#### Filtrer les parcours par motif de clôture
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ClosingMotiveFilter.php-->
Filtre les parcours par motif de cloture.
#### Filtrer les parcours par métier de l'intervenant, entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/JobWorkingOnCourseFilter.php-->
Ce filtre permet d'indiquer:
- une date de début et une date de fin, qui forment une période de recherche;
- un ou plusieurs métiers
Le filtre ne retient que les parcours qui ont reçu une intervention de la part des utilisateurs ayant un des métiers indiqués en paramètre, et pendant la période indiquée. La date de fin est non comprise dans la période de recherche.
La notion d'intervenant est définie [dans le chapitre correspondant](#sec:parcours-intervenant).
Exemples d'utilisation:
- ce filtre permet de répondre à la question "Combien de parcours reçoivent une intervention des utilisateurs ayant le métier X et Y, entre le début de l'année et aujourd'hui ?"
#### Filtrer les parcours par métier du créateur
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/CreatorJobFilter.php-->
Filtre les parcours par métier du créateur.
Le métier du créateur est pris en compte au moment de la création du parcours.
#### Filtrer les parcours par métier du référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/UserJobFilter.php-->
Filtre les parcours par métier du référent.
Le métier du référent est pris en compte au moment où ce dernier a été désigné comme référent.
#### Filtrer les parcours par origine du parcours
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/OriginFilter.php-->
Filtre les parcours par origine.
L'origine est indiquée dans le formulaire "Modifier le parcours".
#### Filtrer les parcours par problématiques sociales
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/SocialIssueFilter.php-->
Filtre les parcours par problématiques sociales.
Un parcours est pris en compte dès qu'il est associé à au moins une problématique sociale indiquée en paramètre.
#### Filtrer les parcours par référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ReferrerFilter.php-->
Filtre les parcours par référent.
Seuls les parcours dont le référent était un utilisateur indiqué en paramètre, et à la date indiquée en paramètre, sont pris en compte.
#### Filtrer les parcours par service de l'intervenant, entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/ScopeWorkingOnCourseFilter.php-->
Ce filtre permet d'indiquer:
- une date de début et une date de fin, qui forment une période de recherche;
- un ou plusieurs service
Le filtre ne retient que les parcours qui ont reçu une intervention de la part des utilisateurs ayant un des services indiqués en paramètre, et pendant la période indiquée. La date de fin est non comprise dans la période de recherche.
La notion d'intervenant est définie [dans le chapitre correspondant](#sec:parcours-intervenant).
Exemples d'utilisation:
- ce filtre permet de répondre à la question "Combien de parcours reçoivent une intervention des utilisateurs du service X et Y, entre le début de l'année et aujourd'hui ?"
#### Filtrer les parcours par service du référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/UserScopeFilter.php-->
Filtre les parcours par service du référent.
Le service du référent est pris en compte au moment où ce dernier a été désigné comme référent.
#### Filtrer les parcours par statut du parcours
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/StepFilterOnDate.php-->
Ce filtre permet d'indiquer une date en paramètre, ainsi qu'une liste de statuts.
Filtre les parcours qui avaient un des statuts sélectionné à la date indiquée.
Pour les différentes statuts, voir la section correspondante: [statuts du parcours](#sec:parcours-statut).
#### Filtrer les parcours par statut du parcours entre deux dates
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/StepFilterBetweenDates.php-->
Ce filtre permet d'indiquer deux dates qui forment une période de recherche, ainsi qu'une liste de statuts. La date de fin de la période est non comprise dans la période de recherche.
Filtre les parcours qui avaient un des statuts sélectionné pendant la période de recherche.
Note: comme un parcours peut avoir différents statuts au cours du temps, le présent filtre tiendra compte des parcours qui ont eu ce statut au moins un jour dans la période indiquée, même si ce statut a été changé pendant la période.
Pour les différentes statuts, voir la section correspondante: [statuts du parcours](#sec:parcours-statut).
#### Filtrer les parcours par type d'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/ActivityTypeFilter.php -->
Ce filtre permet de ne retenir que les parcours qui sont associé à au moins un échange d'un type donné en paramètre.
#### Filtrer les parcours par urgence
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/EmergencyFilter.php-->
Filtre les parcours urgent, ou non.
#### Filtrer les parcours par zone géographique
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/GeographicalUnitStatFilter.php-->
Filtre les parcours par zone géographique.
La localisation de l'adresse du parcours doit être indiquée: il peut s'agir soit d'une adresse temporaire qu'une localisation auprès d'une adresse d'un usager.
Seules les adresses géolocalisées sont prises en compte. Les adresses sont géolocalisées lorsqu'elles sont choisies parmi les adresses de référence. Lorsque seul le code postal est choisi parmi les suggestions, alors l'adresse est géolocalisée à l'intérieur de la zone géographique du code postal, de manière aléatoire.
La date de prise en compte de l'adresse doit également être indiquée en paramètre. Il s'agira alors de l'adresse temporaire valable sur le parcours à la date indiquée, ou l'adresse de l'usager à la date indiquée (il faut également qu'il ait été désigné comme "localisant" le parcours à la date indiquée).
::: {.info}
L'association entre les zones géographiques et les adresses est une opération couteuse, en termes informatique. Dès lors, cette association est calculée une fois par nuit.
En conséquence, l'association entre la zone géographique et les adresses du jour ne sera pas disponible.
:::
#### Filtrer les parcours par évaluation
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/EvaluationFilter.php-->
Filtre les parcours comportant au moins une évaluation du type indiqué en paramètre.
#### Filtrer les parcours qui nont pas dactions
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/HasNoActionFilter.php-->
Filtre les parcours qui ne comportent aucune action d'accompagnement.
#### Filtrer les parcours qui nont pas déchange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/HasNoActivityFilter.php-->
Filtre les parcours qui ne comportent aucun échange.
#### Filtrer les parcours sans référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/HasNoReferrerFilter.php-->
Filtre les parcours pour ne reprendre que ceux qui ne comportaient aucun référent à la date indiquée en paramètre.
#### Filtrer les parcours selon la nature du demandeur
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/RequestorFilter.php-->
Filtre les parcours pour ne retenir que:
- le demandeur est un usager concerné;
- le demandeur est un usager, mais n'est pas concerné par le parcours;
- le demandeur est un tiers
- le demandeur est ne comporte pas de demandeur.
### Regroupements liés aux parcours
#### Grouper les parcours par action d'accompagnement
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/BySocialActionAggregator.php-->
Groupe les parcours par action d'accompagnement.
**Relation un-à-plusieurs**: lorsqu'un parcours comporte plusieurs actions d'accompagnement, le parcours est comptabilisé en regard de chaque action.
#### Grouper les parcours par confidentialité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ConfidentialAggregator.php-->
Groupe les parcours selon qu'ils ont été marqués comme confidentiels, ou non.
#### Grouper les parcours par date d'ouverture
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/OpeningDateAggregator.php-->
Groupe les parcours par date d'ouverture. La date prise en compte ici est celle reprise dans le bandeau "parcours", elle peut être modifiée par l'utilisateur une fois le parcours ouvert, dans le formulaire `Modifier le parcours`.
Les dates d'ouvertures peuvent être retroupées par mois, année ou semaine. Dans ce dernier cas, la numérotation de la semaine est calculée en suivant la norme ISO 8601[^iso8601week]. Les regroupements par mois ou semaine sont préfixés par l'année correspondante.
[^iso8601week]: Voir <https://fr.wikipedia.org/wiki/Num%C3%A9rotation_ISO_des_semaines>
#### Grouper les parcours par date de cloture
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ClosingDateAggregator.php-->
Groupe les parcours par date de clôture. La date prise en compte ici est celle reprise dans le bandeau "parcours", elle peut être modifiée par l'utilisateur au moment de la cloture du parcours.
Les dates d'ouvertures peuvent être retroupées par mois, année ou semaine. Dans ce dernier cas, la numérotation de la semaine est calculée en suivant la norme ISO 8601[^iso8601week]. Les regroupements par mois ou semaine sont préfixés par l'année correspondante.
#### Grouper les parcours par durée
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/DurationAggregator.php-->
Groupe les parcours par durée du parcours.
La durée peut être exprimée en mois, semaines ou jours.
La durée calculée est la différence entre la date d'ouverture et la date de cloture: la première peut être mise à jour par l'utilisateur dans le formulaire `Modifier le parcours` et, par défaut, correspond à la date de confirmation du parcours. La seconde est indiquée par l'utilisateur au moment de la cloture du parcours. Lorsqu'un parcours est toujours ouvert, la durée est la différence entre la date d'ouverture et la date du jour de génération de l'export.
#### Grouper les parcours par intensité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/IntensityAggregator.php-->
Groupe les parcours par intensité (parcours ponctuel ou régulier).
#### Grouper les parcours par intervenant
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/UserWorkingAggregator.php-->
Ce regroupement permet de classer les indicateurs par intervenants sur le parcours.
Par intervenant sur le parcours, sont pris en compte tous les utilisateurs qui ont réalisé une intervention: [voir chapitre correspondant](#sec:parcours-intervenant).
**Relation un-à-plusieurs**: Lorsqu'un parcours comporte plusieurs intervenants, chaque parcours est comptabilisé en regard de chaque intervenant du parcours.
#### Grouper les parcours par localisation administrative
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/AdministrativeLocationAggregator.php-->
Groupe les parcours par localisation administrative.
#### Grouper les parcours par motif de clôture
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ClosingMotiveAggregator.php-->
Groupe les parcours par motifs de clôture.
Lorsqu'un parcours ne comporte pas de motif de clôture (parce qu'il est toujours ouvert, ou qu'il a été ré-ouvert après une clôture), le regroupement est repris sous une ligne sans contenu.
#### Grouper les parcours par métier de l'intervenant
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/JobWorkingAggregator.php-->
Ce regroupement permet de classer les indicateurs par métier de l'intervenant sur le parcours.
Par intervenant sur le parcours, sont pris en compte tous les utilisateurs qui ont réalisé une intervention: [voir chapitre correspondant](#sec:parcours-intervenant).
#### Grouper les parcours par métier du créateur
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/CreatorJobAggregator.php-->
Regroupe les parcours par métier du créateur.
Le métier du créateur est celui associé au créateur au moment de la création du parcours.
#### Grouper les parcours par métier du référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/UserJobAggregator.php-->
Regroupe les parcours par métier du référent.
Le métier du référent est celui associé au référent au moment où il est désigné référent de ce parcours.
#### Grouper les parcours par nombre dactions
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ByActionNumberAggregator.php-->
Regroupe les parcours par nombre d'actions associés au parcours.
#### Grouper les parcours par nombre déchange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/ByActivityNumberAggregator.php-->
Regroupe les parcours par nombre d'échangers associés au parcours.
#### Grouper les parcours par origine du parcours
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/OriginAggregator.php-->
Groupe les parcours par origine. L'origine est indiquée sur la page `Modifier le parcours`.
#### Grouper les parcours par problématiques sociales
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/SocialIssueAggregator.php-->
Groupe les parcours par problématique sociale.
**Relation un-à-plusieurs**: lorsqu'un parcours comporte plusieurs problématiques sociales, ce parcours est comptabilisé en regard de chaque problématique.
#### Grouper les parcours par référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ReferrerAggregator.php-->
Groupe les parcours par référent.
La date indiquée en paramètre permet de ne tenir compte que du référent valable à la date indiquée.
#### Grouper les parcours par service
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ScopeAggregator.php-->
Groupe les parcours par service.
**Relation un-à-plusieurs**: lorsqu'un parcours est associé à plusieurs services, il est comptabilisé en regard de chaque service coché.
#### Grouper les parcours par service de l'intervenant
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ScopeWorkingAggregator.php-->
Ce regroupement permet de classer les indicateurs par service des intervenants sur le parcours.
Par intervenant sur le parcours, sont pris en compte tous les utilisateurs qui ont réalisé une intervention: [voir chapitre correspondant](#sec:parcours-intervenant).
#### Grouper les parcours par service du référent
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/ReferrerScopeAggregator.php-->
Groupe les parcours par service du référent.
Le service du référent pris en compte est celui associé au référent au moment où ce dernier a été désigné comme référent sur le parcours.
#### Grouper les parcours par statut du parcours
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/StepAggregator.php-->
Groupe les parcours par statut du parcours.
Les différents statuts du parcours [sont décrit dans le chapitre correspondant](#sec:parcours-statut).
Le statut du parcours repris est celui qui est valable à la date indiquée en paramètre.
#### Grouper les parcours par type d'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/ByActivityTypeAggregator.php -->
Ce regroupement permet de classer les parcours par type d'échange reçu sur le parcours. Le regroupement est constitué de tous les parcours ayant au moins un échange du type qui forme le regroupement. Donc, dans l'export du nombre de parcours, cela crée une colonne avec les types d'échange et une colonne "nombre de parcours": un parcours est comptabilisé à chaque fois qu'il présente au moins un échange du type indiqué dans la colonne "type d'échange".
Il est possible d'indider des dates en paramètres: si elles sont remplies, seuls les échanges intervenus entre ces dates sont comptabilisés. Les parcours qui n'ont pas reçu d'échange entre ces deux dates sont alors regroupés dans une colonne vide.
Lorsqu'un parcours comporte plusieurs types d'échange, il est comptabilisé en regard de chaque type d'échange qu'il contient.
#### Grouper les parcours par urgence
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/EmergencyAggregator.php-->
Groupe les parcours selon qu'ils sont urgents, ou non.
#### Grouper les parcours par zone géographique
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/GeographicalUnitStatAggregator.php-->
Groupe les parcours par zone géographique.
La localisation de l'adresse du parcours doit être indiquée: il peut s'agir soit d'une adresse temporaire qu'une localisation auprès d'une adresse d'un usager.
Seules les adresses géolocalisées sont prises en compte. Les adresses sont géolocalisées lorsqu'elles sont choisies parmi les adresses de référence. Lorsque seul le code postal est choisi parmi les suggestions, alors l'adresse est géolocalisée à l'intérieur de la zone géographique du code postal, de manière aléatoire.
La date de prise en compte de l'adresse doit également être indiquée en paramètre. Il s'agira alors de l'adresse temporaire valable sur le parcours à la date indiquée, ou l'adresse de l'usager à la date indiquée (il faut également qu'il ait été désigné comme "localisant" le parcours à la date indiquée).
**Relation un-à-plusieurs**: Si plusieurs couches géographiques sont indiquées, alors un regroupement (et donc une nouvelle ligne de résultat) est créée pour chaque zone du niveau géographique indiqué. Cela veut dire que si plusieurs couches géographiques se superposent, l'usager sera comptabilisée dans chacune d'elle.
Exemple: si les deux couches "région" et "commune" sont cochées; les adresses sont localisées à la fois au niveau communal, et au niveau régional. DAns les résultats de l'export, chaque usager sera comptabilisé une première fois dans la couche "commune" et une autre fois dans la couche région.
::: {.info}
L'association entre les zones géographiques et les adresses est une opération couteuse, en termes informatique. Dès lors, cette association est calculée une fois par nuit.
En conséquence, l'association entre la zone géographique et les adresses du jour ne sera pas disponible.
:::
#### Grouper les parcours par évaluation
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/EvaluationAggregator.php-->
Groupe les parcours selon la présence de types d'évaluation au sein des actions du parcours.
**Relation un-à-plusieurs**: Si un parcours comporte plusieurs types d'évaluation, il est comptabilisé une fois en regard de chaque type d'évaluation. Si plusieurs types évaluations identiques sont associés au même parcours, le parcours n'est comptabilisé qu'une seule fois.
#### Grouper les parcours selon la nature du demandeur
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/AccompanyingCourseAggregators/RequestorAggregator.php-->
Regroupe les parcours selon le demandeur:
- soit il s'agit d'un usager concerné par le parcours;
- ou d'un usager non concerné par le parcours;
- ou d'un tiers;
- ou aucun demandeur n'est renseigné.

View File

@@ -0,0 +1,18 @@
### Filtres et regroupements liés aux actions d'accompagnements
<!-- cette page est temporairement enlevée du résultat, l'ajouter dans build-pandoc.sh -->
#### Filtrer les actions par tiers traitant
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/AccompanyingCourseFilters/HandlingThirdPartyFilter.php-->
Filtre les actions selon le tiers traitant indiqué dans l'interface.
Seules les actions qui comportent le tiers sélectionné sont comptabilisés dans les résultats.
#### Grouper les actions par tiers traitant
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/SocialWorkAggregators/HandlingThirdPartyAggregator.php-->
Comptabilise les actions selon le tiers traitant indiqué dans l'interface.

View File

@@ -0,0 +1,10 @@
### Regroupements liés aux évaluations
<!-- cette page est temporairement enlevée du résultat, l'ajouter dans build-pandoc.sh -->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/EvaluationAggregators/ByEndDateAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/EvaluationAggregators/ByMaxDateAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/EvaluationAggregators/ByStartDateAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/EvaluationAggregators/EvaluationTypeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/EvaluationAggregators/HavingEndDateAggregator.php-->

View File

@@ -0,0 +1,298 @@
### Exports relatifs aux échanges
Les échanges peuvent être créés:
- dans un parcours;
- dans un dossier d'usager.
Les possibilités d'exports séparent les échanges créés dans un dossier d'usager de ceux créés dans un dossier de parcours.
#### Échanges liés à un parcours
- Nombre d'échanges
- Somme de la durée des échanges
- Somme de la durée de déplacement des échanges
- Moyenne de la durée des échanges
- Moyenne de la durée de déplacement des échanges
- Liste des échanges liés à un parcours
#### Échanges liés à un usager
- Nombre d'échanges
- Durée des échanges
- Liste des échanges
### Filtres liés aux échanges
#### Filtrer les échanges par action liée
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/BySocialActionFilter.php-->
Ce filtre n'apparait que dans les exports des échanges liés aux parcours d'accompagnement.
Ce filtre permet d'indiquer des types d'action d'accompagnement. Seuls les échanges qui sont associés à au moins une de ces actions d'accompagnement sont pris en compte.
#### Filtrer les échanges par créateur de l'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/ByCreatorFilter.php-->
Ce filtre permet de filtrer les échanges par créateur de l'échange.
Il permet de sélectionner une liste d'utilisateurs.
Si un échange a été créé par un de ces utilisateurs, il est pris en compte.
#### Filtrer les échanges par date
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ActivityDateFilter.php-->
Ce filtre permet de filtrer les échanges par date: il permet d'indiquer deux dates: une date de début, et une date de fin. Seuls les échanges ayant eu lieu entre ces deux dates sont pris en compte.
#### Filtrer les échanges par envoyé / reçu
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/SentReceivedFilter.php-->
Ce filtre permet de filtrer les changes par le champ Envoyé/Reçu.
Ce champ n'est accessible qu'à certains types d'échange, en fonction de la configuration effectuée par des administrateurs fonctionnels.
#### Filtrer les échanges par localisation
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/LocationFilter.php-->
Ce filtre permet de filtrer les échanges par localisation.
Seuls les échanges qui ont été associé à cette localisation sont pris en compte.
#### Filtrer les échanges par métier d'au moins un utilisateur participant
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/UsersJobFilter.php-->
Ce filtre permet de filtrer les échanges: seuls les échanges dont un des utilisateurs participants est associé au métier sélectionné sont pris en compte.
Le métier doit être associé à l'utilisateur à la date de l'échange.
Le filtre prend en compte tous les utilisateurs ajoutés dans les "parties concernées" de l'échange.
L'échange est pris en compte dès qu'un utilisateur dans les "parties concernées" est associé à l'un des métiers demandés.
#### Filtrer les échanges par métier du créateur de l'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/CreatorJobFilter.php -->
Filtre les échanges par métier du créateur de l'échange.
Le métier doit être associé à l'utilisateur à la date de l'échange.
#### Filtrer les échanges par problématique liée
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/BySocialIssueFilter.php-->
Ce filtre n'apparait que dans les exports des échanges liés aux parcours d'accompagnement.
Ce filtre permet de filtrer les échanges par problématique liée.
Seuls les échanges associés à au moins une problématique liée sont pris en compte.
#### Filtrer les échanges par service du créateur de l'échange
Ce filtre permet de filtrer les échanges par service du créateur de l'échange.
Lorsqu'un utilisateur change de service au cours du temps, le service associé à l'utilisateur au moment de l'échange est pris en compte.
#### Filtrer les échanges par service d'au moins un utilisateur participant
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/UsersScopeFilter.php-->
Ce filtre permet de filtrer les échanges: seuls les échanges dont un des utilisateurs participants est associé au service sélectionné sont pris en compte.
Le service doit être associé à l'utilisateur à la date de l'échange.
Le filtre prend en compte tous les utilisateurs ajoutés dans les "parties concernées" de l'échange.
L'échange est pris en compte dès qu'un utilisateur dans les "parties concernées" est associé à l'un des service demandés.
#### Filtrer les échanges par sujet
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/PersonFilters/ActivityReasonFilter.php-->
Ce filtre permet de filtrer les échanges par sujet.
Seuls les échanges qui comportent au moins un des sujets choisis sont pris en compte.
Le sujet est en champ activé par la configuration de l'instance.
#### Filtrer les échanges par type
Ce filtre permet de filtrer les échanges par type. Un formulaire permet de sélectionner les types d'échanges à prendre en compte.
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ActivityTypeFilter.php-->
#### Filtrer les échanges par type de localisation
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ACPFilters/ActivityTypeFilter.php-->
Ce filtre permet de fitlrer les échanges associés à une localisation d'un certain type.
#### Filtrer les échanges par urgence
Ce filtre permet de filtrer les échanges par urgence.
L'urgence est un champ qui n'apparait qu'en fonction de la configuration de l'instance.
#### Filtrer les échanges par usager participant
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/PersonsFilter.php -->
Filtre les échanges sur base des usagers participants.
Un échange est comptabilisé à partir du moment où il compte un des usagers indiqué dans la configuration du filtre; autrement dit: les échanges qui comportent au moins un des usagers indiqués sont pris en compte. Il n'est donc pas nécessaire que l'échange comporte **tous** les usagers indiqués dans le filtre.
#### Filtrer les échanges par utilisateur participant
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ActivityUsersFilter.php-->
Ce filtre permet de filtrer les échanges par utilisateurs.
Seuls les échanges qui comportent au moins un de ces utilisateurs dans les "utilisateurs concernés" sont pris en compte. Autrement dit: il n'est donc pas nécessaire que l'échange soit associé à **tous** les utilisateurs.
#### Filtrer les échanges par utilisateur principal
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/ActivityUsersFilter.php-->
Ce filtre permet de filtrer les échanges par utilisateur principal.
Le champ "utilisateur principal" n'apparait que pour certains types d'échange, en fonction de la configuration de l'instance.
### Regroupements liés aux échanges
#### Grouper les échanges par action liée
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/BySocialActionAggregator.php -->
Groupe les échanges par action sociale liée à l'échange.
**Relation un-à-plusieurs**: Lorsqu'un échange est lié à plusieurs actions sociales, alors l'échange est comptabilisée une seule fois en regard de chaque type d'action.
#### Grouper les échanges par créateur de l'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/ByCreatorAggregator.php-->
Groupe les échanges par l'utilisateur ayant créé l'échange.
#### Grouper les échanges par date
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/DateAggregator.php-->
Groupe les échanges par date.
Les dates des échanges peuvent être retroupées par mois, année ou semaine. Dans ce dernier cas, la numérotation de la semaine est calculée en suivant la norme ISO 8601[^iso8601week]. Les regroupements par mois ou semaine sont préfixés par l'année correspondante.
[^iso8601week]: Voir <https://fr.wikipedia.org/wiki/Num%C3%A9rotation_ISO_des_semaines>
#### Grouper les échanges par envoyé / reçu
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/SentReceivedAggregator.php-->
Groupe les échanges selon le champ envoyé / reçu indiqué dans l'échange.
#### Grouper les échanges par localisation de l'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityLocationAggregator.php-->
Groupe les échanges par nom de la localisation de l'échange.
Les localisations qui possèdent le même nom sont regroupées ensemble.
#### Grouper les échanges par métier des utilisateurs participants
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityUsersJobAggregator.php-->
Groupe les échanges par métier des utilisateurs participants, ajoutés dans les "parties concernées" de l'échange.
Le métier pris en compte est celui associé à l'utilisateur à la date de l'échange.
**Relation un-à-plusieurs**: lorsque plusieurs utilisateurs participent à l'échange, l'échange est comptabilisé une seule fois par métier de chaque utilisateur. Si plusieurs utilisateurs participant comportent le même métier, l'échange n'est donc comptabilisé qu'une seule fois.
#### Grouper les échanges par métier du créateur de l'échange
Groupe les échanges par métier du créateur de l'échange.
Le métier pris en compte est celui associé à l'utilisateur à la date de l'échange.
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/CreatorScopeAggregator.php -->
#### Grouper les échanges par problématique liée
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/BySocialIssueAggregator.php-->
Groupe les échanges par problématique sociale associée à l'échange.
**Relation un-à-plusieurs**: lorsqu'un échange est associée à plusieurs problématiques, il est comptabilisé une fois en regard de chaque problématique.
#### Grouper les échanges par référent
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityUserAggregator.php-->
Groupe les échanges par le référent de l'échange (l'utilisateur principal).
#### Grouper les échanges par service du créateur de l'échange
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/CreatorScopeAggregator.php-->
Groupe les échange par service du créateur de l'échange.
Le service pris en compte est celui du créateur de l'échange à la date de l'échange.
#### Grouper les échanges par tiers impliqué
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/ByThirdpartyAggregator.php-->
Groupe les échanges par tiers impliqué dans les "usagers concernés" de l'échange.
**Relation un-à-plusieurs**: lorsque plusieurs tiers participent à l'échange, l'échange est comptabilisé une fois pour chaque tiers.
#### Grouper les échanges par type
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityTypeAggregator.php-->
Groupe les échanges par type d'échange.
#### Grouper les échanges par type de localisation
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ACPAggregators/LocationTypeAggregator.php-->
Groupe les échanges par type de localisation associé à l'échange.
#### Grouper les échanges par usager participant
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/PersonsAggregator.php -->
Groupe les échanges par usager participant à l'échange.
**Relation un-à-plusieurs**: Les échanges sont comptabilisés une fois en regard de chaque usager.
Ce regroupement a pour effet de ne pas faire apparaitre les échanges qui ne comptent pas de participants.
#### Grouper les échanges par utilisateurs participants
Groupe les échanges par utilisateurs participant.
**Relation un-à-plusieurs**: Les échanges sont comptabilisés une fois en regard de chaque utilisateur participant.
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityUsersAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/ActivityUsersScopeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Aggregator/PersonAggregators/ActivityReasonAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/AvgActivityDuration.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/AvgActivityVisitDuration.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/CountActivity.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/ListActivity.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/SumActivityDuration.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToACP/SumActivityVisitDuration.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToPerson/CountActivity.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToPerson/ListActivity.php-->
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Export/LinkedToPerson/StatActivityDuration.php-->

View File

@@ -0,0 +1,17 @@
### Filtres et regroupements liés aux activités annexes
<!-- cette page est temporairement enlevée du résultat, l'ajouter dans build-pandoc.sh -->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Aggregator/ByActivityTypeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Aggregator/ByUserJobAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Aggregator/ByUserScopeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Export/AvgAsideActivityDuration.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Export/CountAsideActivity.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Export/ListAsideActivity.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Export/SumAsideActivityDuration.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Filter/ByActivityTypeFilter.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Filter/ByDateFilter.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Filter/ByUserFilter.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Filter/ByUserJobFilter.php-->
<!-- PHPFILE: src/Bundle/ChillAsideActivityBundle/src/Export/Filter/ByUserScopeFilter.php-->

View File

@@ -0,0 +1,21 @@
### Regroupements liés aux rendez-vous
<!-- cette page est temporairement enlevée du résultat, l'ajouter dans build-pandoc.sh -->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/AgentAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/CancelReasonAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/JobAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/LocationAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/LocationTypeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/MonthYearAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/ScopeAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Aggregator/UrgencyAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Export/CountCalendars.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Export/StatCalendarAvgDuration.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Export/StatCalendarSumDuration.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Filter/AgentFilter.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Filter/BetweenDatesFilter.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Filter/CalendarRangeFilter.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Filter/JobFilter.php-->
<!-- PHPFILE: src/Bundle/ChillCalendarBundle/Export/Filter/ScopeFilter.php-->

View File

@@ -0,0 +1,7 @@
### Regroupements liés aux ménages
<!-- cette page est temporairement enlevée du résultat, l'ajouter dans build-pandoc.sh -->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/HouseholdAggregators/ChildrenNumberAggregator.php-->
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/HouseholdAggregators/CompositionAggregator.php-->

210
user/docs/exports_person.md Normal file
View File

@@ -0,0 +1,210 @@
### Exports liés aux usagers
- nombre d'usagers;
- nombre d'usagers concernés par un parcours;
- liste des usagers;
- liste des usagers ayant un parcours d'accompagnement;
- liste des usagers concernés avec le détail de chaque parcours;
- liste des doublons.
### Filtres liés aux usagers
#### Filtrer les usagers ayant été associés à un échange au cours de la période
<!-- PHPFILE: src/Bundle/ChillActivityBundle/Export/Filter/PersonFilters/PersonHavingActivityBetweenDateFilter.php-->
Ce filtre permet de filtrer les usagers: seuls les usagers ayant eu un échange au cours de la période indiquée sont pris en compte.
De plus, si la liste des sujets d'échanges de ce filtre comporte au moins un élément, ce sujet doit avoir été associé à l'échange. Si la liste ne comporte aucun sujet coché, alors cette deuxième condition n'est pas ajoutée.
#### Filtrer les usagers par comparaison avec l'adresse de référence
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/AddressRefStatusFilter.php-->
Ce filtre permet de détecter les usagers dont l'adresse n'est plus synchronisée avec l'adresse de référence.
Chill maintient à jour une liste d'adresses de référence, qui sont proposées lors de la saisie d'une adresse. Cette liste est régulièrement mise à jour, et cela peut amener à ce que des adresses de référence soient changées: re-numérotation de la rue, modification du code postal, etc.
Ces modifications apparaissent dans l'interface, et les utilisateurs peuvent choisir d'appliquer la modification (et donc la nouvelle adresse de référence) ou de conserver l'adresse actuelle sans appliquer la modification.
Ce filtre permet de filtrer les usagers en comparant l'adresse de leur ménage et l'adresse de référence qui a été utilisée lors de la création. Seuls les usagers dont l'adresse:
- soit diffère de l'adresse de référence utilisée lors de la création;
- soit diffère de l'adresse de référence utilisée lors de la création, mais dont l'usager a choisi de conserver la forme précédente;
- soit est identique à l'adresse de référence utilisée lors de la création (ce qui est le cas de la plupart des adresses).
#### Filtrer les usagers par composition de ménage
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/ByHouseholdCompositionFilter.php-->
Ce filtre permet de filtrer les usagers par composition de ménage.
L'historique de l'appartenance d'un usager à un ménage est enregistrée, de même que l'historique des compositions de ménage. Une date de calcul est introduite: elle permet de calculer la composition du ménage à la date donnée.
Seuls les usagers qui appartiennent à un ménage dont la composition est indiquée, et que la composition est également valable à la date indiquée pour le ménage, sont pris en compte.
#### Filtrer les usagers par date de décès
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/DeathdateFilter.php-->
Ce filtre permet de filtrer les usagers en fonction de leur date de décès.
#### Filtrer les usagers par date de naissance
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/BirthdateFilter.php-->
Ce filtre permet de filtrer les usagers en fonction de leur date de naissance.
#### Filtrer les usagers par genre
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/GenderFilter.php-->
Ce filtre permet de filtrer les usagers par genre.
#### Filtrer les usagers par nationalité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/NationalityFilter.php-->
Ce filtre permet de filtrer les usagers par nationalité.
#### Filtrer les usagers par zone géographique (sur base de l'adresse)
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/GeographicalUnitFilter.php-->
Ce filtre permet de filtrer les usagers sur base de zones géographiques.
Seules les adresses géolocalisées sont prises en compte. Les adresses sont géolocalisées lorsqu'elles sont choisies parmi les adresses de référence. Lorsque seul le code postal est choisi parmi les suggestions, alors l'adresse est géolocalisée à l'intérieur de la zone géographique du code postal, de manière aléatoire.
Une date de calcul permet de ne choisir que les adresses valables à la date donnée.
::: {.info}
L'association entre les zones géographiques et les adresses est une opération couteuse, en termes informatique. Dès lors, cette association est calculée une fois par nuit.
En conséquence, l'association entre la zone géographique et les adresses du jour ne sera pas disponible.
:::
#### Filtrer les usagers par âge
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/AgeFilter.php-->
Ce filtre permet de filtrer les usagers sur base de leur âge.
Deux paramètres permettent d'indiquer un âge minimum et un âge maximum. Une date de calcul de l'âge est également disponible en paramètre.
Seuls les usagers dont l'âge est compris entre l'âge minimum et l'âge maximum, à la date de calcul indiqué en paramètre, seront pris en compte.
#### Filtrer les usagers par état matrimonial
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/MaritalStatusFilter.php-->
Seuls les usagers associés à l'état matrimonial indiqué en paramètre seront pris en compte.
#### Filtrer les usagers qui ont une addresse de résidence chez un autre usager
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/ResidentialAddressAtUserFilter.php-->
Seuls les usagers qui ont une adresse de résidence auprès d'une autre usagers sont pris en compte. Cette adresse de résidence doit être valable à la date indiquée en paramètre.
#### Filtrer les usagers qui ont une addresse de résidence chez un tiers
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/ResidentialAddressAtThirdpartyFilter.php-->
Seuls les usagers qui ont une adresse de résidence auprès d'un tiers sont pris en compte. Cette adresse de résidence doit être valable à la date indiquée en paramètre, et le tiers doit être associée à au moins une catégorie de tiers également indiqué en paramètre.
#### Filtrer les usagers qui sont décédés ou vivants à une certaine date
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/DeadOrAliveFilter.php-->
Seuls les usagers décédés ou vivant à la date donnée sont pris en compte.
La date de naissance et la date de décès de la fiche usager sont pris en compte.
#### Filtrer les usagers sans composition de ménage (ni ménage)
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Filter/PersonFilters/WithoutHouseholdComposition.php-->
Seuls les usagers sans composition de ménage sont pris en compte par ce filtre. Les usagers qui n'ont pas de ménage sont également repris.
La date de calcul permet de choisir le ménage à la date indiquée en paramètre.
### Regroupements liés aux usagers
#### Grouper les usagers par composition familiale
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/ByHouseholdCompositionAggregator.php-->
Ce regroupement permet de grouper les usagers par composition familiale.
Une date de calcul est indiquée en paramètre: la composition familiale est indiquée à la date donnée.
#### Grouper les usagers par genre
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/GenderAggregator.php-->
Ce regroupement permet de grouper les usagers par genre.
#### Grouper les usagers par nationalité
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/NationalityAggregator.php-->
Ce regroupement permet de grouper les usagers par nationalité.
#### Grouper les usagers par pays de naissance
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/CountryOfBirthAggregator.php-->
Ce regroupement permet de grouper les usagers par pays de naissance.
#### Grouper les usagers par position dans le ménage
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/HouseholdPositionAggregator.php-->
Ce regroupement permet de grouper les usagers par position dans le ménage.
Une date de calcul est indiquée en paramètre: la position valable à la date indiquée sera utilisée.
#### Grouper les usagers par centre
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/CenterAggregator.php-->
Ce regroupement demande une date en paramètre.
Ce regroupement permet de classer les indicateurs par centre de l'usager. Le centre pouvant évoluer au cours du temps, il est calculé au moment de la date indiquée en paramètre.
Il peut arriver que les usagers concernés par un parcours, ou les usagers associés à un échange ou un rendez-vous appartiennent à différents centres. Lorsque c'est le cas, le parcours ou l'échange sera comptabilisé une fois dans chaque centre.
#### Grouper les usagers par zone géographique (sur base de l'adresse)
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/GeographicalUnitAggregator.php-->
Ce regroupement permet de grouper les usagers par zone géographique.
Seules les adresses géolocalisées sont prises en compte. Les adresses sont géolocalisées lorsqu'elles sont choisies parmi les adresses de référence. Lorsque seul le code postal est choisi parmi les suggestions, alors l'adresse est géolocalisée à l'intérieur de la zone géographique du code postal, de manière aléatoire.
L'adresse utilisée est celle valable à la date indiquée en paramètre.
**Relation un-à-plusieurs**: Si plusieurs couches géographiques sont indiquées, alors un regroupement (et donc une nouvelle ligne de résultat) est créée pour chaque zone du niveau géographique indiqué. Cela veut dire que si plusieurs couches géographiques se superposent, l'usager sera comptabilisée dans chacune d'elle.
Exemple: si les deux couches "région" et "commune" sont cochées; les adresses sont localisées à la fois au niveau communal, et au niveau régional. DAns les résultats de l'export, chaque usager sera comptabilisé une première fois dans la couche "commune" et une autre fois dans la couche région.
::: {.info}
L'association entre les zones géographiques et les adresses est une opération couteuse, en termes informatique. Dès lors, cette association est calculée une fois par nuit.
En conséquence, l'association entre la zone géographique et les adresses du jour ne sera pas disponible.
:::
#### Grouper les usagers par âge
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/AgeAggregator.php-->
Regroupe les usagers par âge.
Une date de calcul est indiquée en paramètre: l'âge des usagers est calculé par rapport à la date indiquée.
#### Grouper les usagers par état matrimonial
<!-- PHPFILE: src/Bundle/ChillPersonBundle/Export/Aggregator/PersonAggregators/MaritalStatusAggregator.php-->
Regroupe les usagers par état matrimonial.

7
user/docs/homepage.md Normal file
View File

@@ -0,0 +1,7 @@
```{=latex}
\includepdf[pages=-]{cover-user.pdf}
\newpage
```

BIN
user/docs/img/a_chill_page.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/action_accompagnement.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/address_details_modal.png (Stored with Git LFS) Normal file

Binary file not shown.

Binary file not shown.

BIN
user/docs/img/address_inline_with_button.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/address_inline_with_button_and_warning.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/advanced_search.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/aside_activity_details.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/banner_all.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/banner_course.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/banner_household.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/banner_person.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/chill_buttons.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/choisir-une-adresse.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/concerned_persons.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/export_select_saved_exports.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_activity__accompanying_period_id_2705.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_notification_126_show.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_notification_inbox.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_2811_document.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_2811_document_new.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_2811_general.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_2811_residential-address_list.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_2811_resources_list.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_household_376_addresses.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_household_376_summary.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/fr_person_new.png (Stored with Git LFS) Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
user/docs/img/generer_document_parcours.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/logo-chill-outil-accompagnement.svg (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/menage_filiations.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/new_aside_activity.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/new_task.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/notification_parcours.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/parcours_comments.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/parcours_confirm.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/parcours_dashboard.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/parcours_list_item.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/parcours_localisation.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/thirdparty_contact.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/thirdparty_morale.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/workflow_create.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/workflow_create_with_existing.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/workflow_list_associated.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
user/docs/img/workflow_page.png (Stored with Git LFS) Normal file

Binary file not shown.

3
user/docs/index.md Normal file
View File

@@ -0,0 +1,3 @@
Documentation utilisateur de chill
En construction.

30
user/docs/interface.md Normal file
View File

@@ -0,0 +1,30 @@
\newpage
# L'interface générale {#sec:interface}
## Une page du logiciel
[Comme expliqué auparavant](#sec:concept), le logiciel est organisé en trois domaines principaux: usager, parcours d'accompagnement et ménage. Voyons une page du logiciel en détail dans la figure suivante.
![Une page de Chill](./img/a_chill_page.png)
De haut en bas, il y a:
- un premier bandeau bleu foncé;
- deux bandeaux propre au domaine "parcours d'accompagnement";
- le contenu de la page à gauche, ici un résumé du parcours d'accompagnement;
- un menu en jaune, propre au domaine "parcours d'accompagnement".
Dans le premier bandeau, il y a:
- le champ de recherche: ce champ permet de chercher des usagers, et d'aller vers leurs fiches usagers
- un **menu section**: ce menu, constamment accessible, permet de faire des actions transversales, c'est-à-dire qui ne sont pas directement liées à un usager, un parcours ou un ménage. Par exemple, ce menu permet d'ajouter un nouvel usager ou un parcours, d'ajouter une activité annexe, de gérer la liste des tiers, de réaliser des exports, etc.
- un **menu utilisateur**: ce menu, où est rappelé le nom de l'utilisateur connecté, permet d'accéder aux dossiers propres à l'utilisateur: ses parcours, ses tâches, rendez-vous, activités annexes, notifications, etc. En outre, une pastille avec un chiffre indique le nombre de notifications et tâches en attente pour lesquelles une action est requise.
## Boutons et codes couleurs
Les mêmes boutons sont utilisés au travers du logiciel. La figure suivante indique la signification de tous les boutons utilisés dans le logiciel.
![Les boutons utilisés dans Chill](./img/chill_buttons.png)

36
user/docs/intro.md Normal file
View File

@@ -0,0 +1,36 @@
# Qu'est-ce que Chill?
## A quoi ça sert ?
Chill est un logiciel libre d'accompagnement social. Le logiciel peut être résumé par un système de « dossier social électronique ».
Chill est une application web : on y accède via un navigateur. Le navigateur recommandé est Firefox : il est libre et gratuit et on y accède sur toutes les plates-formes (Windows, Mac, Linux, tablettes android, …). Le logiciel doit être installé sur un serveur, et peut donc être disponible via le réseau local ou internet.
## Le but du logiciel
Chill vise trois buts :
* partager les informations relatives à l'accompagnement social entre collègues ;
* centraliser, en un seul lieu, les informations relatives aux personnes accompagnées ;
* alléger la charge administrative des travailleurs sociaux en fournissant automatiquement des statistiques relatives à leur activité.
Les concepteurs de Chill ont remarqué qu'il est essentiel d'allier les trois buts. En effet, ils ont constaté qu'il est désagréable, pour les travailleurs, de « remplir des dossiers pour des statistiques ». Chill doit pouvoir être utilisé au quotidien : les travailleurs auront de l'intérêt à enregistrer les éléments si, continuellement, l'outil est utile dans leur travail quotidien.
## Chill est un logiciel libre
Le caractère « libre » du logiciel est affirmé dès sa création. La logique d'ouverture du code est poussée au maximum :
* la documentation (élément essentiel qui permet à d'autres développeurs de continuer ou compléter le code) est présente et complète (voir http://docs.chill.social) ;
* le code est sous licence AGPLv3. Il s'agit d'une des plus restrictives et des plus sûres pour l'utilisateur. Elle impose aux éditeurs de rendre disponible tout le code développé, même lorsque la redistribution est faite sous forme de service en ligne ;
* il n'existe pas de module « propriétaire » : toutes les fonctionnalités sont accessibles.
La libération du code est vécue comme une opportunité pour les éditeurs : c'est en effet l'occasion de mutualiser les coûts de développement en partageant le logiciel entre différentes institutions.
## Comment l'installer ?
Si vous cherchez la documentation d'installation du logiciel, elle se trouve à http://docs.chill.social.
## Comment l'administrer ?
Chill dispose d'une interface d'administration qui sert à configurer le logiciel, afin qu'il corresponde au mieux au métier des travailleur·euses sociaux. Dans ce document, nous appelons "administrateurs" la ou les personnes qui disposent d'un droit d'administration et qui ont configuré le logiciel. La documentation destinée aux administrateurs est rassemblée dans un autre document.

BIN
user/docs/map/map.inkscape.svg (Stored with Git LFS) Normal file

Binary file not shown.

114
user/docs/menage.md Normal file
View File

@@ -0,0 +1,114 @@
\newpage
# Ménages {#sec:household}
## Qu'est-ce qu'un ménage ?
Un ménage est un ensemble d'usagers vivant "sous le même toit". Cela peut être les membres d'une famille, les membres d'une famille recomposée, les membres d'une famille d'accueil, etc.
<!-- vivant "sous le même toit" OU domiciliés à la même adresse? -->
Un ménage est caractérisé par une adresse, qui correspond à l'adresse de domiciliation de ses membres. Cette adresse peut changer (en cas de déménagement): elle est donc définie entre une date de début et une date de fin. Un ménage ne peut avoir **qu'une seule adresse** simultanément. Par contre, un ménage peut changer d'adresse au cours du temps. Chill propose donc d'enregistrer l'historique des adresses du ménage.
Un usager ne peut être membre que **d'un seul ménage à la fois**, avec une exception cependant: les usagers qui ne partagent pas l'adresse du ménage (par exemple, les enfants en garde alternée). L'appartenance à un ménage est caractérisée par une date de début, et une date de fin; Chill présente donc un **historique** des différents ménages auxquels un usager a appartenu.
Chaque usager se voit attribué une **position** dans un ménage, configurée par un administrateur fonctionnel. Par exemple: "Adulte dans le ménage", "Enfant dans le ménage", "Enfant hors domicile", etc.
## Résumé du ménage
<!-- /fr/person/household/{household_id}/summary -->
![Résumé d'un ménage](./img/fr_person_household_376_summary.png)
On accède à la page de résumé du ménage via le menu "usager" ou bien en cliquant sur l'icône représentant le ménage dans la recherche par personne. La page de résumé du ménage présente l'adresse actuelle du ménage, les membres du ménage et la composition du ménage.
### Associer un usager à un ménage
Lorsqu'aucun ménage n'est renseigné dans la liste des ménages d'un usager, alors le logiciel vous permet de créer un nouveau ménage. Lors de cette étape, on peut créer un nouveau ménage ou rejoindre un ménage existant. Le logiciel va automatiquement proposer des ménages possibles en faisant des suggestions de ménages.
::: { .info }
**Quels ménages sont suggérés ?**
Le logiciel essaye d'établir des liens entre les utilisateurs concernés par le changement de ménage, et d'autres ménages.
Les liens effectués sont les suivants:
* Pour chaque usager concerné par le changement, le logiciel vérifie s'il est présent dans un autre parcours, avec d'autres usagers. Si ces usagers sont eux-mêmes associés à un ménage, alors le logiciel propose de rejoindre ce ménage existant.
* Le logiciel examine également la localisation des parcours dans lequel se trouve l'usager concerné par le changement. Si le parcours est localisé à une adresse de référence, le logiciel recherche si d'autres ménages habitent à cette adresse. S'il en trouve, ces ménages seront suggérés également.
:::
Dès cette étape, vous pouvez indiquer une adresse; cela permettra de localiser immédiatement le ménage créé. Le logiciel va vous suggérer de ré-utiliser des adresses connues.
::: { .info }
**Quelles adresses sont suggérées ?**
Le logiciel vous propose de ré-utiliser la localisation temporaire des parcours associés aux usagers.
Pour chaque usager qui va "changer de ménage", le logiciel examine s'il est actuellement associé à un parcours. Si ce parcours dispose d'une adresse temporaire, alors cette adresse sera reprise dans les suggestions.
:::
### Rejoindre un ménage
Il y a plusieurs voies possibles pour faire rejoindre un usager à un ménage:
- lorsqu'on crée un parcours pour un usager qui n'est pas dans un ménage, le logiciel suggère de renseigner leur appartenance à un ménage. L'action permet alors de les positionner dans un ménage, que ce soit un ménage existant ou à créer.
- lorsqu'on est sur la page de résumé du ménage, on peut toujours rechercher et ajouter un usager. Pour cela, on utilise le bouton "Ajouter un membre" en bas de la page.
### Les positions dans le ménage
<!-- attention, les positions "enfants hors ménage", etc., c'est de la configuration -->
Chaque membre du ménage est détaillé dans la page "résumé du ménage". L'usager peut avoir une certaine position dans le ménage: adulte ou enfant, ainsi qu'être titulaire d'un ménage. A tout moment il est possible de faire quitter un usager d'un ménage, ou de le repositionner dans le ménage (par exemple le rendre titulaire).
Le cas échéant, il est possible aussi de visualiser une ancienne appartenance, soit un usager ayant appartenu au ménage mais qui n'en fait plus partie actuellement.
## Ajouter des membres au ménage, quitter un ménage, rejoindre un ménage
En bas de la page de résumé du ménage, le bouton "Ajouter un membre" permet d'ajouter un usager au ménage. Lors d'un clic sur ce bouton, dans les pages suivantes, on peut:
- ajouter un ou plusieurs usagers existants, ou en créer;
- positionner chaque usager dans le ménage, c'est-à-dire spécifier si c'est un enfant ou un adulte, et éventuellement le qualifier en tant que titulaire du ménage;
- inscrire la date où l'usager rejoint le ménage, et éventuellement, un commentaire;
- et, enfin, enregistrer.
Dans la liste des membres du ménage, en utilisant les boutons à droite, on peut:
- quitter le ménage: dans ce cas, l'usager peut rejoindre un autre ménage ou bien quitter sans rejoindre un ménage. A nouveau, une date de changement est enregistrée.
- repositionner le membre: c'est-à-dire changer le positionnement (adulte, enfant, ...) du membre.
- renseigner l'appartenance: c'est-à-dire changer la date et le commentaire du changement
## Historique des adresses d'un ménage
L'historique des adresses du ménage peut être accédé dans le menu du ménage sous le titre "Historique adresse". L'historique des adresses montre toutes les adresses successives des ménages et permet d'en ajouter.
<!-- /fr/person/household/{household_id}/addresses -->
![Historique des adresses d'un ménage](./img/fr_person_household_376_addresses.png)
Une liste des parcours d'accompagnement du ménage peut être également affichée en cliquant dans le menu du ménage sous "parcours d'accompagnement".
## Filiations
<!-- /fr/person/household/{household_id}/relationship -->
![Filiations d'un ménage](./img/menage_filiations.png)
La page "Filiations" propose une vue d'ensemble sous forme de graphe des filiations au sein d'un ménage, c'est-à-dire les liens de parenté entre ses membres. Cette page permet non seulement de visualiser les filiations mais aussi de les éditer. En cliquant sur "Créer un lien de filiation", puis en sélectionnant 2 personnes, il est possible de définir les liens de filiations entre ces 2 personnes: mère/père-fille/fils, frère/soeur-frère/soeur, oncle/tante-neveu/nièce.
En outre, le graphe montre également les parcours d'accompagnement associé à chaque membre du ménage. En affichant les parcours, des usagers éventuellement liés à ces parcours mais appartenant à d'autres ménages peuvent être affichés. Les éléments du graphe peuvent être déplacés en cliquant dessus et en les glissant. Enfin, on peut exporter ce graphe sous forme d'une image.
En bref, cette page résume un ménage et ses liens de filiations sous forme de diagramme facile à appréhender.
## Composition familiale
La composition familiale est une qualification du ménage en tant que type de ménage, par exemple, couple avec enfants, couple sans enfants, mère seule, femme seule, etc. Cette composition est valide jusqu'à une date donnée.
De même que pour les adresses d'un ménage, il est possible de visualiser l'historique de la composition d'un ménage.

17
user/docs/metadata.yaml Normal file
View File

@@ -0,0 +1,17 @@
---
title: Manuel utilisateur de Chill
lang: fr-BE
toc: true
page: a4
# specitfic to template eisvoger
titlepage: true
toc-own-page: true
# cause the numbering to be 0.x for every chapter
book: false
float-placement-figure: H
#logo: "img/logo-chill-outil-accompagnement.svg"
header-includes: |
\usepackage{awesomebox}
...

View File

@@ -0,0 +1,7 @@
# Notes privées
Des notes privées peuvent être créés pour les [activités](./activity.md#create-and-modify-an-activity), les [actions sociales](./social_actions.md#private-comment) et les rendez-vous.
Chaque utilisateur peut publier une note privé par élément (eg. par activité). Cette note peut toujours être modifiée dans les formulaires d'édition de l'élément concerné.
Naturellement, les utilisateurs ne peuvent voir que leurs propres notes privées et non ceux des autres utilisateurs.

View File

@@ -0,0 +1,45 @@
\newpage
# Notifications
<!-- fr/notification/inbox -->
Les notifications sont des messages envoyés par un utilisateur à un ou plusieurs autres utilisateurs. Les notifications ont pour but d'échanger rapidement des informations sur des dossiers sociaux en cours entre travailleurs sociaux. Par exemple, les notifications permettent d'informer un travailleur social à propos d'un parcours.
Chill peut également envoyer des notifications systèmes lors de certains événements.
On y accède soit depuis la page d'accueil de Chill, sous l'onglet "Mes notifications", soit n'importe où dans l'application via le
menu "utilisateur" en haut à droite de l'écran. Selon la configuration choisie par les administrateurs du logiciel, les notifications sont aussi envoyées par courriel au travailleur social concerné.
![Boîte de réception des notifications](./img/fr_notification_inbox.png)
## Créer une notification
<!-- fr/notification/create?entityClass=Chill%5CPersonBundle%5CEntity%5CAccompanyingPeriod&entityId=2705-->
Des notifications peuvent être envoyées à partir de plusieurs endroits du logiciel. Une notification comprend un objet (comme un courriel), un ou plusieurs destinataires, un message et les informations à partir desquelles la notification est envoyée. Par exemple, lors de l'envoi d'une notification dans le cadre d'un parcours, les informations générales du parcours sont également copiées.
Il est possible d'envoyer une notification:
- à propos d'un parcours, de la page résumé d'un parcours
- à propos d'une activité/échange
- à propos d'une action d'accompagnement
- à propos d'un document dans une action d'accompagnement
Les notifications envoyées, par exemple, à partir d'un parcours, sont listées dans le résumé du parcours.
![Créer une notification](./img/notification_parcours.png)
## Discuter dans une notification
<!-- fr/notification/{notification_id}/show -->
![Discussion dans une notification](./img/fr_notification_126_show.png)
Lorsqu'une notification est reçue, il est possible d'engager une discussion avec son destinataire dans la page de la notification. Cela permet de laisser des messages entre travailleurs, comme dans un système de discussion en ligne.
Dans la liste des notifications, lorsqu'on clique sur une notification, on peut déplier le contenu de la notification et accéder à la discussion avec l'icône "Voir le fil de commentaire associé".
## Notification système
Il y a en outre des notifications automatiquement envoyées lors de certaines manipulations.
Pour ces notifications, il n'est pas possible d'entamer une conversation.

39
user/docs/nouveautes.md Normal file
View File

@@ -0,0 +1,39 @@
```{=latex}
\cleardoublepage
```
# Nouveautés
## Mai 2023
### Statut "hors file active" et "pré-archivé" dans les parcours
Jusqu'à maintenant, on avait des parcours avec les statuts "brouillon", "en file active" et "cloturé".
Deux autres statuts sont ajoutés:
- "hors file active"
- pré-archive
Cela correspondra à des parcours ouverts et qui n'ont pas eu d'activité depuis:
- six mois pour "hors file active";
- deux ans pour "pré-archive"
Pour ces parcours "hors file active" et "pré-archive", il est possible d'ajouter des échanges, des actions, des rendez-vous, etc. Et de clôturer ces parcours. Lorsque cela est le cas, le parcours repassera, dans les heures qui suivent, en statut "en file active".
Le passage vers ces deux statuts est effectué automatiquement, sans intervention de l'utilisateur. Sont pris en compte:
- la date des échanges;
- la date de début, de fin, des actions d'accompagnements;
- la date de début, de fin des évaluations
- l'ajout d'une évaluation, d'un document dans une évaluation, la mise à jour d'un document ou la mise à jour d'un commentaire dans une évaluation;
- et, évidemment, la date d'ouverture du parcours.
Les rendez-vous ne sont pas pris en compte.
Pour les parcours existants qui étaient inactifs de puis plus de six mois ou deux ans, un passage automatique à ce nouveau statut est prévu: le nouveau statut sera indiqué six mois ou deux ans après la dernière activité prise en compte.
### Notification depuis des actions et des documents dans les évaluations
Il est maintenant possible d'envoyer une notification à propos d'une action d'accompagnement ou d'un document dans une évaluation.

270
user/docs/parcours.md Normal file
View File

@@ -0,0 +1,270 @@
\newpage
# Parcours d'accompagnement {#sec:parcours}
Fournir un soutien social significatif est souvent une combinaison complexe d'objectifs, d'actions, d'acteurs impliqués, de documents, etc. Avec son module de parcours d'accompagnement, Chill vise à donner à ses utilisateurs un outil leur permettant de suivre les trajectoires sociales des usagers.
Vous pouvez le considérer comme le troisième grand module de l'application. Comme pour les domaines "usager" et "ménage", les pages concernant un parcours sont facilement identifiables par son bandeau en haut de l'écran.
![Bandeau d'un parcours d'accompagnement](./img/banner_course.png)
::: {.note}
Dans le menu utilisateur, vous trouvez une entrée de menu pour vous diriger vers:
* une page de liste de **tous** les parcours dont vous êtes le référent;
* une page de liste de toutes vos parcours **BROUILLON** (ceux que vous avez créés, mais pas encore confirmés).
:::
## Résumé du parcours
![Résumé du parcours](./img/parcours_dashboard.png)
<!-- /fr/parcours/{id} -->
La page de résumé rassemble les informations les plus importantes et les dernières activités au sein d'un parcours, vous permettant de prendre certaines actions rapides comme cliquer sur les badges des personnes associées, les activités liées ou les actions sociales, envoyer une nouvelle notification, etc.
En bref, il s'agit du tableau de bord du parcours à partir duquel vous pouvez naviguer vers des sections spécifiques.
## Les différents statuts d'un parcours { #sec:parcours-statut }
Il est important de distinguer les différents statuts pour un parcours. Un badge se trouve en haut à droite du bandeau ou de l'élément de liste pour identifier ce statut:
* **BROUILLON** : le formulaire du parcours est en cours de rédaction, en attente de confirmation.
Le parcours n'est visible que par son créateur pendant cette période (via le menu utilisateur `Mes parcours brouillon`). Il reste disponible pendant 15 jours à cet état. Ensuite, il est automatiquement supprimé.
* **EN FILE ACTIVE** : le formulaire de création du parcours a été complété, et le parcours est confirmé.
Il est, dès lors, visible par tous les utilisateurs. Des échanges, des actions d'accompagnements, des documents et des tâches peuvent être ajoutés.
* **HORS FILE ACTIVE** : le parcours n'a plus reçu d'interventions depuis plus de six mois.
Il est toujours possible d'ajouter de nouvelles actions ou échanges.
* **PRÉ-ARCHIVÉ** : le parcours n'a plus reçu d'intervention depuis plus de deux ans.
Il est toujours possible d'ajouter de nouvelles actions ou échanges.
* **CLÔTURÉ** : le parcours d'accompagnement social est arrivée à son terme, la raison peut être définie (couleur du badge : rouge).
### Les événements pris en compte pour modifier le statut d'un parcours { #sec:parcours-statut-intervention }
Le passage vers les statuts **HORS FILE ACTIVE** et **PRÉ-ARCHIVÉ** est effectué automatiquement, sans intervention de l'utilisateur. Pour calculer "l'inactivité", le logiciel prend en compte la date de différentes intervention dans le parcours. Si aucune de ces interventions n'a eu lieu, Chill change automatiquement le statut du parcours. Sont pris en compte:
- la date des échanges;
- la date de début, de fin, des actions d'accompagnements;
- l'association d'un référent à une action d'accompagnement;
- la date de début, de fin des évaluations;
- l'ajout d'une évaluation, d'un document dans une évaluation, la mise à jour d'un document ou la mise à jour d'un commentaire dans une évaluation;
- et, évidemment, la date d'ouverture du parcours.
Notez que, lorsqu'un parcours reçoit des nouvelles actions ou échanges, un parcours redevient **EN FILE ACTIVE**. Ce changement de statut est effectué automatiquement également, mais avec un délai de quelques heures.
### Intervenants sur un parcours { #sec:parcours-intervenant }
Ces interventions permettent également de définir des intervenants sur un parcours: ce sont les auteur·e·s d'une intervention.
Il s'agit donc des utilisateurs qui:
- sont concernés par un échange;
- sont agents traitants d'une action;
## Parcours confidentiel, intensité, et caractère urgent d'un parcours
Bien que les trois états ci-dessus soient considérés comme les états principaux, il existe des propriétés supplémentaires qui caractérisent l'état d'un parcours. Il s'agit des propriétés suivantes:
* **Confidentiel** : un parcours confidentiel ne peut être consulté que par le référent. Les autres utilisateurs n'auront pas accès aux informations qu'il contient.
* **Intensité** : Un parcours peut être caractérisé comme *régulier* ou *ponctuel*.
* **Urgent** : Cet état peut être déclenché lorsque des actions urgentes sont requises dans ce parcours.
::: { .note }
Seul le référent peut modifier l'intensité et le caractère confidentiel d'un parcours.
:::
::: { .warning }
Un parcours confidentiel est visible uniquement par:
* le référent du parcours;
* les personnes qui disposent d'un droit d'accès permettant de voir les parcours confidentiels.
:::
## Création d'un parcours d'accompagnement social
<!-- /fr/parcours/{id}/edit -->
Un nouveau parcours peut être créé:
::: { .not-vendee }
* à partir du menu de section: `Sections > Créer un parcours`. En procédant ainsi, vous êtes dirigé vers un formulaire de parcours vierge à remplir;
:::
* à partir des résultats de recherche, en utilisant le bouton "parcours vert" en regard du nom et de l'adresse de l'usager;
* à partir du dossier de l'usager, depuis la liste des parcours d'un usager;
* à partir du dossier du ménage, depuis la liste des parcours du ménage. Dans ce cas, un parcours reprenant tous les membres du ménage est créé;
## Informations requises à la création
Les informations requises pour **confirmer** un parcours sont les suivantes :
* Il doit être lié à au moins un usager concerné.
* Il doit être lié à au moins une problématique sociale.
* Il doit être attribué à au moins un service.
* Il doit être localisé.
![Confirmer le parcours](./img/parcours_confirm.png)
Toutes ces informations requises sont énumérées au bas du formulaire tant qu'elles ne sont pas remplies. Cela sert à vous rappeler ce que vous devez faire pour confirmer le parcours.
### Usagers concernés
![Usagers concernés](./img/concerned_persons.png)
Un parcours peut être mis en place pour apporter un soutien à plusieurs usagers (par exemple, un soutien est apporté à une mère et son enfant).
### Localisation du parcours
![Localisation](./img/parcours_localisation.png)
Chaque parcours **doit** être localisé et ceci peut être fait de deux manières.
1. Vous pouvez indiquer une adresse temporaire en cliquant sur le bouton désigné. L'adresse ne sera pas automatiquement adaptée en cas de déménagement de la personne concernée. C'est pourquoi un message s'affiche pour vous rappeler, en tant qu'utilisateur, que la deuxième option, indiquée ici, est préférable.
2. Vous pouvez la lier à l'adresse personnelle d'un usager concerné en cliquant sur l'icône du marqueur de carte dans la section des usagers concernés. Si l'usager déménage, elle sera également adaptée automatiquement dans le parcours.
::: {.info}
Si un parcours est lié à l'adresse d'un usager concerné:
* il n'est pas possible de dissocier cet usager du parcours.
* l'usager ne peut pas être déplacé d'un foyer sans indiquer une autre adresse.
:::
#### Localiser le parcours auprès d'un usager concerné
Dans le cas où un usager concerné dispose d'une adresse, il est possible de localiser le parcours auprès de cet usager.
Lorsqu'un parcours est localisé auprès d'un usager:
* le parcours "suit" l'adresse de l'usager lorsqu'il déménage;
* il n'est pas possible de dissocier l'usager concerné du parcours;
Par ailleurs,
* l'usager ne peut pas quitter le parcours, tant que le parcours est localisé auprès de lui;
* l'usager ne peut pas quitter son ménage sans laisser d'adresse, tant qu'il localisé auprès d'au moins un parcours.
#### Localisation temporaire
Une adresse temporaire peut être attribuée à un parcours.
Dans ce cas, cette localisation est associée au parcours, et ne sera pas automatiquement modifiée si un usager déménageait. Pour éviter cette situation, un message d'avertissement rappelle qu'il est préférable d'indiquer une réelle localisation pour le parcours.
::: {.vendee}
#### Pourquoi localiser les parcours ?
La localisation des parcours permet:
* de désigner les référents automatiquement, ou d'inclure les parcours dans les listes des réunions de régulation pour les bons services et MDSF;
* de générer des statistiques localisées;
* de gérer les droits
:::
### Origine de la demande
Dans cette section, vous trouverez une liste prédéfinie d'origines possibles (par exemple, la demande a été faite par téléphone).
### Localisation administrative
La localisation administrative est l'endroit où le parcours est traité. Cela est utile pour des organisations ayant plusieurs sites différents.
### Demandeur
Il peut s'agir d'un usager/tiers déjà existant ou d'une nouvelle personne qui peut être créé à partir de la modale de recherche. Cliquez sur le bouton <**Créer "votre-recherche"**> pour en créer.
### Problématiques sociales
En utilisant le menu déroulant, plusieurs problématiques sociales peuvent être identifiées. Choisissez-en au moins une pour pouvoir confirmer le parcours.
### Services concernés
Identifiez au moins un service qui est concerné par ce parcours. Plusieurs services peuvent être sélectionnés. Cela a un impact sur les utilisateurs qui ont le droit d'accéder aux dossiers du parcours: seuls les utilisateurs (travailleurs) qui appartiennent à un service peuvent avoir accès à certaines informations du parcours selon les services concernés.
### Référent du parcours
Le référent est un collègue auquel vous pouvez vous adresser pour ce parcours. Il est responsable du suivi et a des droits spécifiques liés à l'état du parcours:
* il peut le marquer comme confidentiel;
* il peut le marquer comme urgent;
* il peut changer l'intensité.
::: {.info}
Dans un parcours confirmé, ces trois états ne peuvent pas être modifiés si un parcours n'a pas de référent assigné.
De même, un référent ne peut être supprimé d'un parcours confidentiel.
:::
### Interlocuteurs privilégiés
Un parcours est mis en place pour apporter un soutien à un ou plusieurs usagers concernées. Naturellement, il peut également y avoir un ou plusieurs tiers ou usagers impliqués pour offrir ce soutien. Ces partenaires peuvent être ajoutés dans cette section en recherchant leur nom.
Si un partenaire n'existe pas encore, il peut être créé à partir de la modale de recherche en appuyant sur le bouton <**Créer "votre-recherche"**>.
<!-- ## Historique du parcours -->
<!-- /fr/parcours/{id}/histoire -->
<!-- TODO -->
## Les actions d'accompagnement social
<!-- /fr/person/accompagnement-période/{id}/travail -->
Dès qu'un parcours a été confirmé (il est à l'état "en file active"), il est possible d'ajouter des actions d'accompagnement social à ce parcours. Ce sont les actions qui sont entreprises pour réaliser l'accompagnement. Veuillez lire la documentation sur les [actions d'accompagnement](#sec:social_action) pour plus d'informations.
## Commentaires
<!-- /fr/parcours/{id}/comments -->
Des commentaires peuvent être ajoutés à un parcours pour notifier aux collègues des informations supplémentaires pour lesquelles il n'y a peut-être pas de section désignée. Un commentaire peut être **épinglé** au tableau de bord du parcours en cliquant sur l'icône du drapeau.
::: {.info}
Un seul commentaire peut être épinglé au tableau de bord, mais tous les commentaires resteront disponibles dans la section des commentaires pour être consultés, modifiés, ré-épinglés ou supprimés.
:::
## Tâches
<!-- /fr/task/single-task/by-course/{id} -->
Tout comme pour les usagers, des tâches peuvent être créées et assignées dans un parcours. Veuillez lire la documentation sur les [tâches](#sec:tasks) pour des informations détaillées.
## Documents
<!-- /fr/parcours/{id}/documents -->
Tout comme pour les usagers, des documents peuvent être attachés à un parcours. La seule différence ici est qu'un document de parcours peut également être généré à partir d'un modèle. Ce modèle peut être sélectionné dans le menu déroulant.
Veuillez lire la documentation sur les [documents](#sec:documents) pour des informations détaillées.
## Fermer un parcours
<!-- /fr/parcours/{id}/close -->
À tout moment, un parcours peut être fermé en cliquant sur l'entrée du menu latéral **"Clôturer le parcours"**.
Vous serez dirigé vers un petit formulaire dans lequel vous pourrez spécifier la date de fermeture et le motif.
## Ré-ouvrir un parcours
Lorsqu'un parcours est fermé, le menu s'adapte pour offrir à l'utilisateur la possibilité de le ré-ouvrir. Aucune autre action n'est requise après avoir cliqué sur ce bouton.

View File

@@ -0,0 +1,59 @@
\newpage
# Parcours
TODO explication globale
::: { .info }
Les informations suivantes sont **requises** pour valider un parcours:
* le parcours doit renseigner au moins un usager concerné;
* au moins une problématique sociale est renseignée;
* le parcours est attribué à au moins un service;
* le parcours doit être [localisé](#sec:parcours-localisation);
:::
## Localisation du parcours {#sec:parcours-localisation}
Chaque parcours **doit** être localisé.
La localisation est réalisée par l'une ou l'autre manière:
* soit en indiquant une adresse temporaire sur le parcours;
* soit en renseignant un des usagers concerné par le parcours. Dans ce cas, l'adresse du domicile de cet usager sera utilisée pour localiser le parcours. S'il déménage, son adresse sera réutilisée dès son déménagement, de manière automatique.
::: {.vendee}
### Pourquoi localiser les parcours ?
La localisation des parcours permet:
* de désigner les référents automatiquement, ou d'inclure les parcours dans les listes des réunions de régulation pour les bons services et MDSF;
* de générer des statistiques localisées;
* de gérer les droits
:::
### Localiser le parcours auprès d'un usager concerné
Dans le cas où un usager concerné dispose d'une adresse, il est possible de localiser le parcours auprès de cet usager.
Lorsqu'un parcours est localisé auprès d'un usager:
* le parcours "suit" l'adresse de l'usager lorsqu'il déménage;
* il n'est pas possible de dissocier l'usager concerné du parcours;
Par ailleurs,
* l'usager ne peut pas quitter le parcours, tant que le parcours est localisé auprès de lui;
* l'usager ne peut pas quitter son ménage sans laisser d'adresse, tant qu'il localisé auprès d'au moins un parcours.
### Localisation temporaire
Une adresse temporaire peut être attribuée à un parcours.
Dans ce cas, cette localisation est associée au parcours, et ne sera pas automatiquement modifiée si un usager déménageait. Pour éviter cette situation, un message d'avertissement rappelle qu'il est préférable d'indiquer une réelle localisation pour le parcours.

View File

@@ -0,0 +1,38 @@
## Informations socio-professionnelles
<!-- fr/vendee/vendeeperson/{person_id}/infosociopro/ -->
![Informations socio-professionnelles](./img/fr_vendee_vendeeperson_2811_infosociopro_view.png)
La page des informations socio-professionnelles de l'usager rassemble des informations professionnelles (salarié, en recherche d'emploi, ...), le niveau d'étude, des informations de mobilité (permis de conduire, moyen de transport) et les caisses de retraites. Pour ce dernier point, une caisse principale et plusieurs caisses complémentaires peuvent être ajoutées.
Cette page est accessible via le menu "usager".
## Informations médicales
<!-- fr/vendee/vendeeperson/{person_id}/infomedicale/ -->
![Informations médicales](./img/fr_vendee_vendeeperson_2811_infomedicale_view.png)
La page des informations médicales compte des informations de santé telles que le nom du médecin traitant, les caisses de sécurité sociale et mutuelle, et éventuelles allocations (MDPH, AAH, etc.).
Pour enregistrer le médecin traitant, on peut choisir un tiers existant dans le logiciel, ou bien saisir directement sa dénomination dans un champ texte.
Cette page est accessible via le menu "usager".
## Informations logement
La page des informations relatives au logement permet principalement d'enregistrer le statut de l'usager par rapport à son logement (propriétaire, locataire, etc.).
Cette page est accessible via le menu "usager".
## Informations propres aux mineurs d'âge
Lorsque l'usager est un mineur (<18 ans), des informations supplémentaires peuvent être saisies quant à sa situation familiale et sa scolarité.
La page des informations familiales peut être plus ou moins détaillée selon la situation du mineur. S'il y a des dispositifs tels que délégation, tuteur, JAF, enfant confié, etc., d'autres champs se déplient dans le formulaire.
![Situation familiale](./img/fr_vendee_vendeepersonmineur_2821_infofamille_view.png)
La page de la scolarité contient des informations sur l'établissement scolaire, l'enseignant référent, la formation en alternance le cas échéant, et d'autres informations scolaires.
![Scolarité](./img/fr_vendee_vendeepersonmineur_2821_scolarite_view.png)

110
user/docs/person.md Normal file
View File

@@ -0,0 +1,110 @@
\newpage
# Fiche usager {#sec:person}
La fiche usager renseigne toutes les informations propres à l'usager: nom, prénom, informations de contacts, adresses, etc. C'est la base du dossier social électronique de l'usager.
On y accède par la recherche d'un usager sur la page d'accueil ou dans la barre d'outil. On peut y accéder aussi par d'autres pages en cliquant sur le nom d'un usager, puis en cliquant sur "Ouvrir la fiche de l'usager".
Pour chaque usager, on peut définir des parcours d'accompagnements. Enfin, à chaque usager est relié des échanges dans lesquels l'usager est impliqué.
## Créer un usager
<!-- fr/person/new -->
![Créer un usager](./img/fr_person_new.png)
Pour ajouter un usager, cliquez sur "Sections" > "Ajout d'un usager", depuis:
::: { .not-vendee }
* la barre d'outil supérieure.
:::
* les résultats de recherche
Dans la page de création, rentrez les informations demandées. Seuls le nom, le(s) prénom(s) et le genre sont obligatoire. Cliquez ensuite sur "Créer l'usager". Vous avez alors le choix entre créer simplement l'usager, créer l'usager et l'associer à un ménage ou bien créer l'usager et créer un parcours d'accompagnement associé.
::: { .info }
À noter que l'inscription des numéros de téléphone doit respecter un certain format standard. Rentrez vos numéros sans espaces, sans barre "/" ou tirets "-".
Les numéros de téléphones sont vérifiés auprès d'un annuaire. Ils doivent donc être actifs auprès d'un opérateur téléphonique.
:::
Chill va rechercher les doublons potentiels pour un usager qui est créé. La recherche des doublons est effectuée en comparant la similarité entre le nom et le prénom.
## Détails de l'usager
<!-- fr/person/{id}/general -->
![Page de détails de l'usager](./img/fr_person_2811_general.png)
La fiche de l'usager contient toutes les informations détaillées de l'usager, à savoir:
- nom, prénom(s), genre;
- nationalité, langues parlées, nombre d'enfants, état matrimonial;
- date et lieu de naissance;
- informations de contact.
Ces informations peuvent être remplies au fur et à mesure, ou bien rester inconnues. En bas de la page, le bouton "Modifier" permet d'éditer ces informations. On peut aussi y ajouter des remarques.
Une partie de ces informations sont rappelées dans le bandeau de la personne ainsi qu'à d'autres endroits du logiciel lors d'un clic sur le nom de l'usager.
## Quelle adresse pour un usager ?
Chill supporte deux types d'adresses:
* les adresses de domicile, qui sont les adresses permanentes, officielles, d'un usager (adresse de domiciliation);
* les adresses de résidences, qui sont des adresses temporaires d'un usager, auquel il ne réside que pour une période de temps déterminée, et qui n'est pas destinée à être officielle.
::: { .warning }
En conséquence, on n'attache pas l'adresse de domicile directement à un usager, mais bien à son ménage. Seules des adresses de résidence peuvent être saisies dans le dossier de l'usager.
:::
## Adresses de résidences
<!-- /fr/person/{id}/residential-address/list -->
![Adresse de résidence pour un usager](./img/fr_person_2811_residential-address_list.png)
Chaque usager peut avoir une ou plusieurs adresses de résidences. On y accède en cliquant sur "Adresses de résidence" dans le menu à droite.
Ces adresses ne sont pas censées être des adresses de domicile, officielles, déclarées auprès des autorités. Il s'agit, par exemple, d'une résidence temporaire en maison de repos, d'un logement chez une connaissance ou un ami pendant une période de temps déterminée, etc.
Lors de l'ajout d'une adresse de résidence, il y a le choix entre:
- prendre une adresse d'une autre personne (d'un autre usager);
- prendre une adresse d'un tiers;
- créer une nouvelle [adresse](#sec:choisir-une-adresse).
## Personnes ressources
<!-- /fr/person/{id}/resources/list -->
![Personnes ressources d'un usager](./img/fr_person_2811_resources_list.png)
Les personnes ressources sont des autres usagers ou des tiers (#sec:tiers) associés au dossier de l'usager. Une personne-ressource peut être un ami ou un voisin (un autre usager), un professionnel de la santé (un tiers), etc. Les autres membres du ménage de la personne sont plutôt à saisir dans la partie "ménage". Si la personne-ressource n'est pas enregistrée, on peut également l'ajouter en tant que description libre.
<!-- ## Historique
<!-- /fr/person/{id}/timeline
TODO -->
## Traiter les doublons
<!-- /fr/person/{id}/duplicate/view -->
Il se peut qu'un usager ait été enregistré plus d'une fois. La page "Traiter les doublons" permet de repérer et de traiter les éventuels doublons d'un usager. La page liste les usagers ayant des noms similaires et propose de les fusionner.
::: { .info }
Cette page est utilisée pour traiter les doublons, mais Chill détecte également de manière automatique les doublons potentiels lors de la création d'un nouvel usager.
:::
## Autres entrées dans le menu usager
Il y a plusieurs entrées du menu de l'usager qui renvoient vers les autres parties du logiciel, en gardant le lien avec la personne. Ces entrées sont:
* Parcours d'accompagnement: liste des parcours d'accompagnement dans lesquels l'usager est concerné;
* Activités (ou échanges): liste des activités dans lesquelles l'usager est impliqué;
* Documents: liste des documents dans lesquels l'usager est impliqué;
* Tâches: liste des tâches dans lesquelles l'usager est impliqué;
* Ménages: gestion du ménage de l'usager.
-->

View File

@@ -0,0 +1,13 @@
# Réassigner des parcours
Il peut s'avérer nécessaire de réassigner les parcours suivis par un utilisateur à un autre utilisateur. Par exemple, un utilisateur peut être absent pendant une période prolongée, changer de fonction, etc.
Pour de telles situations, une fonctionnalité a été prévue pour réassigner les parcours en lot à un autre utilisateur.
Pour utiliser cette fonctionnalité, cliquez sur "Parcours des utilisateurs" dans le menu "Sections".
Un premier champ de sélection sera visible. Utilisez-le pour sélectionner l'utilisateur dont les parcours doivent être réassignés. Une liste complète des parcours sera fournie.
Dans une deuxième étape, l'utilisateur auquel les parcours de la page actuelle doivent être réassignés peut être sélectionné. En cliquant sur le bouton "Réassigner", cette action sera terminée et les parcours restants seront affichées. L'action peut être répétée.
Chaque parcours individuel est affiché avec le bouton d'édition, ce qui permet de le réassigner individuellement dans le formulaire d'édition du parcours. Accédez à la section [referrant](./support_trajectory.md#referrer) pour réassigner ce parcours. Lors d'un réassignement en lot, ce parcours ne sera plus pris en compte, car il n'appartient plus à l'utilisateur initial.

31
user/docs/search.md Normal file
View File

@@ -0,0 +1,31 @@
\newpage
# Recherche
Dans le bandeau supérieur, il y a une barre de recherche des usagers. On peut y rechercher des usagers par nom et prénoms, le moteur de recherche étant tolérant sur des graphies différentes. Par exemple, si on cherche "Mathieu", on trouvera aussi les prénoms correspondant à "Matthieu".
Si vous n'avez pas trouvé l'usager, vous pouvez cliquer sur le bouton "Recherche avancé". Dans la page de recherche avancée, on peut rechercher sur base de la date de naissance, un fragment de numéro de téléphone, etc.
![Recherche avancée d'un usager](./img/advanced_search.png)
## Motifs de recherche
La recherche est effectuée de la manière suivante:
* par partie du nom et du prénom;
* par date de naissance:
La date de naissance doit être formatée de la manière suivante: `15/06/1981`, `15-06-1981` ou, au format anglais, `1981-06-15` (pour exprimer le 15 juin 1981). Le mois et le jour **doit toujours être inscrit avec deux chiffres**, en indiquant donc un "zéro" lorsque le chiffre du mois ou du jour est inférieur à dix.
* par numéro de téléphone
La recherche par numéro de téléphone s'enclenche à partir de cinq chiffres: il est donc nécessaire d'indiquer au moins cinq chiffres du numéro. Si le premier chiffre est un zéro, alors le numéro est considéré comme étant issu du pays d'installation (paramètre de la configuration du logiciel). Pour une recherche sur des numéros étrangers, le préfixe international est requis (par exemple `+32` pour la Belgique).
::: { .note }
Ces motifs sont appliqués sur la recherche de la page d'accueil, du bandeau de recherche présent sur chaque page, mais aussi dans toutes les zones de recherche des usagers présent dans les parcours, personnes ressources, etc.
:::

View File

@@ -0,0 +1,92 @@
\newpage
# Actions d'accompagnement social {#sec:social_action}
Les actions d'accompagnement sont des actions entreprises dans le cadre d'un parcours et concernant une certaine problématique sociale.
Les actions d'accompagnement sont facilement reconnaissables dans l'application grâce à une vignette orange.
::: {.info}
Les actions d'accompagnement ne peuvent être créées que pour les parcours **confirmés**.
:::
Les types d'actions sont reliés aux problématiques: des types d'actions sont disponibles en fonction des problématiques.
::: {.note}
Bien que les types d'actions soient limités par les problématiques du parcours, l'interface permet d'ajouter la problématique au parcours **en même temps** que la création de l'action.
:::
## Créer une action d'accompagnement
<!-- /fr/personne/accompagnement-période/{id}/travail -->
![Action d'accompagnement](./img/action_accompagnement.png)
Comme de nombreuses autres sections de l'application Chill, une liste des actions d'accompagnement social peut être trouvée en cliquant sur <**Actions d'accompagnement**> dans le menu latéral jaune d'un parcours.
Un aperçu concis des informations importantes est donné pour chaque action de la liste.
Tant qu'un parcours est à l'état **confirmé**, chaque action peut être modifiée, supprimée ou un [workflow](#sec:workflow) peut être créé.
## Création d'une action d'accompagnement social
<!-- /fr/person/accompanying-period/{id}/work/new -->
Pour créer une action d'accompagnement social, l'utilisateur est guidé à travers plusieurs étapes:
1. Choisir une problématique sociale. Si la problématique en question ne figure pas parmi les choix proposés, l'utilisateur peut l'ajouter en la sélectionnant dans le menu déroulant.
2. Choisissez une action d'accompagnement. Toutes les actions affichées sont liées à la problématique sociale sélectionnée précédemment.
3. Un ou plusieurs usagers concernés peuvent être sélectionnés.
4. Spécifiez une date de début.
5. Indiquez une date de fin (facultatif).
## Modifier une action d'accompagnement social
Une fois qu'une action d'accompagnement a été créée, elle n'est pas considérée comme un dossier clôturé. Le formulaire de modification permet d'ajouter beaucoup plus d'informations dans les étapes ultérieures afin d'en faire un "document de travail".
### Commentaire
Ici, l'utilisateur est libre de donner toutes les informations supplémentaires nécessaires.
### Motifs et objectifs
Les actions de soutien social ne sont jamais faites au hasard. Elles sont entreprises avec certains motifs ou pour atteindre un certain objectif.
En cliquant sur un badge (+) dans le menu déroulant de cette section, l'utilisateur peut ajouter le motif ou le but de l'action. En cliquant à nouveau sur le badge (-), il peut le supprimer.
Il est possible de sélectionner plusieurs objectifs.
Les motifs et objectifs disponibles dépendent du type d'action d'accompagnement.
### Résultats ou orientations
Une fois qu'un motif ou un objectif est identifié, il est également possible de spécifier un résultat ou une orientation de l'action concernant cet objectif spécifique. De la même manière, ils peuvent être sélectionnés dans un menu déroulant et supprimés à nouveau.
Plusieurs résultats peuvent être sélectionnés.
Les résultats et orientations disponibles dépendant du type d'action d'accompagnement.
::: { .note }
Certains résultats peuvent être indiqués sans objectif préalables.
:::
### Évaluations, formulaires ou correspondance
Plusieurs évaluations ou formulaires peuvent être ajoutés à une action d'accompagnement social. Il est précisé quelle évaluation peut être lancée et en cliquant sur le badge (+), un formulaire s'ouvrira pour que l'utilisateur le remplisse.
Le formulaire permet de définir une date de début, une date d'échéance et une date de fin, ainsi qu'un rappel. Un champ de commentaire supplémentaire peut être utilisé pour donner plus de détails et un [document](#sec:documents) peut être généré ou téléversé.
Les gabarits de document dépendent du type d'évaluation.
### Usagers concernés
Les usagers concernés par le parcours sont listés ici et l'utilisateur peut sélectionner les personnes impliquées dans cette action d'accompagnement social spécifique.
### Tiers traitant
Si un partenaire externe a exécuté l'action sociale, il peut être identifié ici. Considérez-le comme l'acteur principal.
### Tiers intervenant
Il s'agit de partenaires externes qui ont participé à l'action sociale, mais qui ne sont pas les acteurs principaux.

40
user/docs/tasks.md Normal file
View File

@@ -0,0 +1,40 @@
\newpage
# Tâches {#sec:tasks}
## Liste des tâches
<!-- /fr/task/single-task/by-course/{id} -->
En cliquant sur l'entrée de menu **Mes tâches** dans le menu latéral de la personne ou de la trajectoire, vous accédez à la page de la liste des tâches.
Ici, vous avez un aperçu de toutes les tâches liées à cette personne ou trajectoire particulière.
En haut de la liste, vous trouverez une barre de recherche et plusieurs options de filtrage:
* Tâches futures ou tâches sans date d'échéance;
* Tâches dont l'échéance est proche;
* Tâches dont la date d'échéance est dépassée;
* Nouvelles tâches;
* Tâches en cours;
* Tâches fermées;
* Tâches supprimées.
Les tâches listées sont affichées avec leur titre, un badge identifiant l'état dans lequel se trouve la tâche (nouvelle, en cours, clôturé,...), leur date de début, la date à laquelle un rappel sera envoyé et leur date d'échéance. Les rappels de vos tâches peuvent être trouvés directement dans la page d'accueil, ou affichés dans le menu utilisateur.
Une entrée de menu utilisateur distincte vous mènera directement à une page de liste de toutes vos tâches dont la date d'échéance est dépassée et qui n'ont pas été clôturées. Cette entrée de menu est facilement identifiable par un sigle "attention" (!).
## Créer une nouvelle tâche
<!-- /fr/task/single-task/new -->
Pour créer une nouvelle tâche, il y a un formulaire à remplir. Les champs sont auto-explicatifs mais notez que seul le titre est obligatoire.
## Page de détail
<!-- /fr/task/single-task/{id}/show -->
Vous pouvez visualiser la tâche de manière plus détaillée en cliquant sur le bouton avec l'icône **œil**. Sur la page de détail, vous avez la description de la tâche, mais aussi l'historique de la tâche. L'historique vous donne un aperçu des changements d'état et de qui les a entrepris à quel jour. Cela permet aux utilisateurs de garder facilement la trace des tâches.
Dans la page de détail, ainsi que dans la page de liste, vous avez la possibilité de naviguer vers une page d'édition où vous pouvez modifier la tâche. Une tâche peut également être supprimée et son état actuel peut être modifié à l'aide du bouton déroulant **changer le statut**.

57
user/docs/thirdparty.md Normal file
View File

@@ -0,0 +1,57 @@
\newpage
# Tiers {#sec:tiers}
<!-- /fr/3party/3party -->
Dans le cadre de l'accompagnement social, vous êtes amené à travailler avec de nombreux partenaires professionnels externes (professionels de santé, services administratifs, ...). Chill vous permet de les associer facilement à un utilisateur et à son parcours d'accompagnement, vous donnant ainsi un aperçu complet de chaque partenaire impliqué.
Toutes les informations sur les tiers peuvent être consultées en allant dans le menu de la section dans le coin supérieur droit et en sélectionnant **Tiers**. On peut aussi accéder à la fiche de chaque tiers mentionné dans l'application en cliquant sur le badge du tiers puis en cliquant sur "Voir le tiers".
En haut de la liste, une barre de recherche vous permet de trouver facilement le tiers que vous recherchez sur base de son nom.
## Personnes morales, personnes physiques, et contacts
Chill propose trois types de tiers:
* les **personnes morales**, qui sont, généralement, une institution;
* les **contacts**, qui sont des tiers associés à une personne morale. Il s'agira, généralement, de tiers qui travaillent au sein d'une institution;
* les **personnes physiques** qui proposent d'enregistrer des informations adaptées aux personnes physiques. Aucun contact ne peut être associé à une personne physique.
::: { .note }
Le type de tiers ne peut pas être modifié après la création.
:::
## Créer un tiers
Au bas de la page, vous trouverez un bouton permettant de créer un nouveau tiers. Ce faisant, vous verrez qu'une distinction est faite entre la création d'un tiers en tant que **personne morale** ou **personne physique**.
Choisissez "personne morale" si vous voulez ajouter un tiers qui est, par exemple, un cabinet médical ou une organisation.
Une "personne physique" correspond à tout professionnel que vous souhaitez ajouter en tant que tiers, par exemple un psychologue.
### Personne morale
La création d'une **personne morale** vous amène à un formulaire que vous pouvez remplir avec les informations suivantes.
* **Nom**
* **Acronyme**
* **Service/département** : vous pouvez cibler un service ou un département spécifique au sein de l'organisation (par exemple, assistance aux personnes âgées, service juridique).
* **Informations de contact** (numéro de téléphone, email).
* **Adresse** : l'adresse du tiers. Comme pour toute les adresses, elle peut être rendue confidentielle.
* **Contacts** : Les contacts sont des personnes physiques associées à l'entité juridique. Vous pouvez préciser leur titre et leur rôle au sein de l'organisation et ajouter leurs coordonnées. Comme pour l'adresse ci-dessus, il existe une option pour en faire un contact confidentiel. Leurs informations seront donc floutées dans toute l'application et pourront être révélées en cas de besoin. Chaque contact peut être supprimé individuellement et ces modifications seront enregistrées lors de la sauvegarde du tiers.
* **Commentaire**
* **Actif/inactif** : un tiers peut être mis à l'état inactif (par exemple, il n'est plus opérationnel).
### Personne physique
Une personne physique est un tiers équivalent à une personne. Bien qu'un contact soit en fait également une personne physique, il s'agit de deux entités distinctes dans Chill.
Dans le formulaire, les éléments suivants peuvent être spécifiés:
* **Civilité** (ex. Mme, Maire, ...)
* **Nom**
* **Qualité (rôle professionnel)** (ex : secrétaire, infirmière)
* **Catégorie** : la catégorie dont relève les services du tiers.
* **Informations de contact** : téléphone, courriel, adresse. Les informations de contact peuvent être spécifiées comme confidentielles.
* **Commentaire**
* **Actif/Inactif**

Some files were not shown because too many files have changed in this diff Show More