release v1.3.0

Reviewed-on: #3
Co-authored-by: Julien Fastré <julien.fastre@champs-libres.coop>
Co-committed-by: Julien Fastré <julien.fastre@champs-libres.coop>

.changes/1.0.0.md

@@ -0,0 +1,3 @@
+## 1.0.0 - 2024-09-30
+### Added
+* first release with changie

.changes/1.2.0.md

@@ -0,0 +1,3 @@
+## 1.2.0 - 2024-11-06
+### Added
+* Ajout formation signature électronique

.changes/1.2.1.md

@@ -0,0 +1,3 @@
+## 1.2.1 - 2024-11-06
+### Fixed
+* Use nginx instead of caddy

.changes/1.2.2.md

@@ -0,0 +1,3 @@
+## 1.2.2 - 2024-11-18
+### Fixed
+* Embed resources into presentation formation signature

.changes/1.3.0.md

@@ -0,0 +1,3 @@
+## 1.3.0 - 2024-12-11
+### Added
+* amélirations à la formation formateurs

.changes/header.tpl.md

@@ -0,0 +1,6 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and is generated by [Changie](https://github.com/miniscruff/changie).

.changie.yaml

@@ -0,0 +1,26 @@
+changesDir: .changes
+unreleasedDir: unreleased
+headerPath: header.tpl.md
+changelogPath: CHANGELOG.md
+versionExt: md
+versionFormat: '## {{.Version}} - {{.Time.Format "2006-01-02"}}'
+kindFormat: '### {{.Kind}}'
+changeFormat: '* {{.Body}}'
+kinds:
+- label: Added
+  auto: minor
+- label: Changed
+  auto: major
+- label: Deprecated
+  auto: minor
+- label: Removed
+  auto: major
+- label: Fixed
+  auto: patch
+- label: Security
+  auto: patch
+newlines:
+  afterChangelogHeader: 1
+  beforeChangelogVersion: 1
+  endOfVersion: 1
+envPrefix: CHANGIE_

.drone.yml

@@ -1,35 +0,0 @@
----
-kind: pipeline
-type: docker
-name: default
-
-
-steps:
-    - name: build-presentation
-      image: pandoc/minimal:2.18-alpine
-      commands:
-          - pandoc -t revealjs --resource-path=.:presentation/src/ -s presentation/src/index.md -o presentation/src/index.html
-
-    - name: build-docker-caddy
-      image: plugins/docker
-      settings:
-          registry: h3m6q87t.gra7.container-registry.ovh.net
-          username:
-              from_secret: docker_username
-          password:
-              from_secret: docker_password
-          dockerfile: presentation/Dockerfile
-          context: presentation/
-          repo: h3m6q87t.gra7.container-registry.ovh.net/prez-concept-chill/presentation
-          tag: ${DRONE_TAG:=latest}
-          pull_image: true
-      when:
-        event:
-          - tag
-
-
----
-kind: signature
-hmac: 94e0deac2fd11cf7bd57e9c0bbc11c84f43c4254f7a583ae403b109bf8a0e5b0
-
-...

.fleet/run.json

@@ -0,0 +1,10 @@
+{
+  "configurations": [
+        {
+          "name": "Pandoc Markdown to Reveal.js",
+          "type": "command",
+          "program": "pandoc",
+          "args": ["--from", "markdown", "--to", "revealjs", "--standalone", "-o", "presentation/src/formation-signature.html", "presentation/src/formation-signature.md"]
+        }
+  ]
+}

.gitea/workflows/build-image.yml

@@ -0,0 +1,60 @@
+name: Build an image to deploy website
+
+on:
+  push:
+    tags:
+      - v*
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  # Build jobs
+  build:
+    runs-on: cth-ubuntu-latest
+    steps:
+      - name: Git checkout with LFS
+        # see https://gitea.com/gitea/act_runner/issues/164#issuecomment-921571
+        run: |
+          git init
+          git remote add origin https://gitea.champs-libres.be/champs-libres/prez-concepts-chill.git
+          git fetch --depth 1 origin ${{ gitea.ref }}
+          git checkout FETCH_HEAD
+          git lfs pull
+
+      - name: update packages
+        run: apt-get update
+
+      - name: Setup pandoc
+        uses: https://github.com/r-lib/actions/setup-pandoc@v1
+        with:
+          pandoc-version: '3.5'
+
+      - name: Build presentation main
+        run: pandoc -t revealjs --resource-path=.:presentation/src/ -s presentation/src/index.md -o presentation/src/index.html
+
+      - name: Build presentation essaimage
+        run: pandoc -t revealjs --resource-path=.:presentation/src/ -s presentation/src/essaimage.md -o presentation/src/essaimage.html
+
+      - name: Build presentation formation-signature
+        run: pandoc --from markdown+emoji -t revealjs --embed-resources --resource-path=.:presentation/src/ -s presentation/src/formation-signature.md -o presentation/src/formation-signature.html
+
+      - name: Set up Docker Buildx
+        uses: https://github.com/docker/setup-buildx-action@v3
+
+      - name: Login to registry
+        uses: https://github.com/docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+          registry: 'h3m6q87t.gra7.container-registry.ovh.net'
+
+      - name: Build and push
+        uses: https://github.com/docker/build-push-action@v5
+        with:
+          context: presentation/
+          push: true
+          tags: 'h3m6q87t.gra7.container-registry.ovh.net/prez-concept-chill/presentation:${{ github.ref_name }}'

.vscode/tasks.json

@@ -0,0 +1,29 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Build formation signature",
+            "type": "shell",
+            "command": "pandoc",
+            "args": [
+                "--from",
+                "markdown+emoji",
+                "--to",
+                "revealjs",
+                "--standalone",
+                "--resource-path",
+                "./presentation/src/",
+                "-o",
+                "presentation/src/formation-signature.html",
+                "presentation/src/formation-signature.md"
+            ],
+            "problemMatcher": [],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        }
+    ]
+}

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and is generated by [Changie](https://github.com/miniscruff/changie).
+
+
+## 1.3.0 - 2024-12-11
+### Added
+* amélirations à la formation formateurs
+
+## 1.2.2 - 2024-11-18
+### Fixed
+* Embed resources into presentation formation signature
+
+## 1.2.1 - 2024-11-06
+### Fixed
+* Use nginx instead of caddy
+
+## 1.2.0 - 2024-11-06
+### Added
+* Ajout formation signature électronique
+
+## 1.0.0 - 2024-09-30
+### Added
+* first release with changie

README.md

@@ -1,9 +1,29 @@
-Formation Vendée
-================
+Présentations Chill
+====================
 
-Ressources pour les formations en Vendée.
+Présentation des concepts de Chill.
 
-Dépendance: `pandoc 2.17`
+La présentation est accessible:
+
+* sur https://concepts.chill.pro
+* il est possible de l'imprimer avec cette adresse: https://concepts.chill.pro/?print-pdf 
+## Convertir en pdf la présentation
+
+([Traduction des instructions originales](https://revealjs.com/pdf-export/)).
+
+
+* aller sur https://concepts.chill.pro/?print-pdf
+* ouvrir la fenetre d'impression (CTRL+P)
+* utiliser la destination "Enregistrer comme PDF"
+* changer l'orientation vers "paysage"
+* changer les marges à "aucune"
+* activer l'arrière-plan
+* enregistrer...
+
+
+## Dépendances
+
+Dépendance: `pandoc 2.18`
 
 ## Présentation
 

presentation/Dockerfile

@@ -1,3 +1,6 @@
-FROM caddy:2-alpine
+FROM nginx:1-alpine
 
-ADD src/  /usr/share/caddy/
+COPY src /usr/share/nginx/html
+
+RUN sed -i 's/worker_processes  auto/worker_processes  1/' /etc/nginx/nginx.conf
+RUN sed -i 's/worker_processes auto/worker_processes 1/' /etc/nginx/nginx.conf

presentation/src/.gitignore

@@ -1 +1,3 @@
 index.html
+essaimage.html
+formation-signature.html

presentation/src/essaimage.md

@@ -0,0 +1,243 @@
+---
+title: Chill
+subtitle: Logiciel d'accompagnement social
+
+theme: night
+
+css:
+  - https://www.unpkg.com/fork-awesome@1.2.0/css/fork-awesome.min.css
+  - ./styles.css
+  
+---
+
+
+# Qu'est-ce que Chill ? 
+
+## Logiciel d'accompagnement social
+  
+"Dossier social électronique"
+
+## Logiciel libre
+
+- En évolution selon les demandes des clients;
+- Les clients bénéficient des développements précédents;
+- Les nouveaux développements sont partagés avec tous;
+
+# À quoi sert Chill ?
+
+## Consigner les informations sur l'accompagnement des usagers
+
+## Partager ces informations
+
+## Collecter des statistiques sur l'activité
+
+Le logiciel est utilisable au quotidien par les travailleurs sociaux.
+
+# Champs-Libres
+
+## Coopérative de travailleur·euse·s
+
+- à Namur, Belgique;
+- 6 travailleur·euse·s;
+- logiciel libre;
+
+## Sensible au travail social
+
+- Expérience depuis 2013;
+- 2 développeur·euse·s sont d'anciens travailleur·euse·s sociaux
+
+## Offre Chill
+
+- éditeur principal de Chill;
+- accompagnement, configuration;
+- hébergement;
+- développement;
+- formations 
+
+# Principales fonctionnalités de Chill
+
+## Enregistrer le travail social
+
+- Au sein des parcours;
+- Caractérisé par des problématiques sociales;
+
+## Partager l'information entre collègues
+
+- Dossier électronique partagé
+- Respect de la vie privée: 
+  - droits d'accès, 
+  - traçabilité,
+  - archivage
+- Notification d'éléments-clés
+
+## Génération de documents
+
+- à partir des informations du logiciel;
+- porte sur un grand nombre de champs: budget, membres du ménage, etc.
+
+## Suivi de décision (Workflow)
+
+## Génération de statistiques
+
+Composition de ses propres tableaux croisés dynamiques
+
+
+# 3 Univers
+
+## La couleur du bandeau diffère
+
+* <span class="usager">Usager</span>
+* <span class="parcours">Parcours</span>
+* <span class="menage">Ménage</span>
+
+# Univers <span class="usager">Usager</span>
+
+## Bandeau vert
+
+![Bandeau «Usager»](./img/bandeau_usager.png)
+
+## Informations relatives à un usager
+
+- Informations générales;
+- Documents, tâches, personnes ressources, budget, ...
+- Collecte / synthèse d'informations venant d'autres univers: échanges, ménages, ... 
+
+# Univers <span class="menage">Ménage</span>
+
+## Bandeau gris/vert
+
+![Bandeau ménage](./img/bandeau_menage.png)
+
+## Regroupe les personnes qui forment un ménage
+
+* Adulte dans le ménage
+* Enfants (-18 ans) dans le ménage
+* Enfants (-18 ans) hors ménage
+
+# Univers <span class="parcours">Parcours</span>
+
+## Bandeau gris métallique
+
+![Bandeau parcours](./img/bandeau_parcours.png)
+
+# Qu'est-ce qu'un parcours ?
+
+## Regroupe l'essentiel du travail social
+
+- Pour des usagers;
+- Un référent de parcours;
+
+## Demande de l'usager
+
+Le parcours répond à une demande de l'usager.
+
+Le parcours concerne une ou plusieurs problématiques sociales.
+
+Exemples:
+
+::: { .columns }
+
+:::::: { .column width="60%" }
+* <span class="chill-entity entity-social-issue"><span class="badge"><span>Personnes âgées</span></span></span>
+* <span class="chill-entity entity-social-issue"><span class="badge"><span>Insertion socio-professionnelle</span></span></span>
+::::::
+
+:::::: { .column width="40%" }
+* <span class="chill-entity entity-social-issue"><span class="badge"><span>Logement</span></span></span>
+* <span class="chill-entity entity-social-issue"><span class="badge"><span>…</span></span></span>
+::::::
+
+:::
+
+## Enregistre le travail social
+
+- Rendez-vous (planification);
+- Échanges:
+ 
+  <span class="chill-entity entity-activity"><span class="badge"><span>visites à domicile</span></span></span>, <span class="chill-entity entity-activity"><span class="badge"><span>appel d'un usager</span></span></span>, <span class="chill-entity entity-activity"><span class="badge"><span>Réunion</span></span>, …
+- Actions d'accompagnement
+
+  Mise en place du travail social à long terme
+
+  <span class="chill-entity entity-social-action"><span class="badge"><span>Travail du CV</span></span></span>, <span class="chill-entity entity-social-action"><span class="badge"><span>Demande aide sociale</span></span></span>, …
+
+
+## Plus sur les actions
+
+::: incremental
+
+* Les <span class="chill-entity entity-social-action"><span class="badge"><span>actions</span></span></span> peuvent comporter des <span class="badge">objectifs</span>, et des <span class="badge">Résultats</span>
+* Les <span class="chill-entity entity-social-action"><span class="badge"><span>actions</span></span></span> peuvent comporter des <span class="badge">Évaluations - Courriers - Formulaires</span>
+* Ces <span class="badge">Évaluations - Courriers - Formulaires</span> génèrent des documents
+
+:::
+
+# Mise en place d'un Chill
+
+## Projet de transformation numérique
+
+Réflexion dès le départ sur l'accompagnement au changement
+
+Champs-Libres partenaire de cette réflexion
+
+
+## Accompagnement à la configuration
+
+Définition des problématiques, des actions, …
+
+## Installations techniques
+
+-----
+
+### Mode Saas
+
+Infrastructure en France (OVH)
+
+Monitoring par Champs-Libres
+
+----
+
+### Mode On-Premise
+
+Préférence Kubernetes
+
+Échange technique à prévoir
+
+## Import des données initiales
+
+## Formation
+
+- d'utilisateurs;
+- de formateurs;
+
+## Suivi
+
+Réunion de suivi au moins mensuelle
+
+Plate-forme de gestion de ticket
+
+# Budgets
+
+## Démarrage
+
+De 50&nbsp;000€ à 120&nbsp;000€;
+
+Selon besoins d'intégration: 
+
+- adresses de référence, 
+- paramétrage nécessaire, préparation de documents, problématiques et actions, …
+- ateliers de prototypage, …
+- mode Saas / on-premise, 
+
+## Hébergement annuel:
+
++/- 30&nbsp;000€
+
+- réunion mensuelle, 
+- participation à la maintenance,
+- +/- 400 utilisateurs 
+
+
+## Formations
+
+1&nbsp;350€/jour, dégressif si regroupement des formations.

presentation/src/formation-signature.md

@@ -0,0 +1,353 @@
+---
+title: La signature électronique dans Chill
+
+theme: night
+
+css:
+  - https://www.unpkg.com/fork-awesome@1.2.0/css/fork-awesome.min.css
+  - ./styles.css
+
+---
+
+# Signature électronique dans Chill
+
+## Sommaire
+
+1. Nouveautés relatives à la gestion des documents
+2. Nouveautés relatives aux workflows
+3. Processus de signature
+4. Processus d'envoi externes de documents
+
+# Gestion des documents: nouveautés
+
+## Historique des documents
+
+- À chaque modification d'un document, Chill conserve les anciennes versions;
+- Les anciennes versions sont conservées pendant 90 jours.
+
+----
+
+![Historique d'un document](./img/short-history-of-a-document.png)
+
+----
+
+Il est possible de:
+
+- restaurer un document à une version antérieure;
+- télécharger le document depuis une ancienne version;
+
+## Droits sur les documents associés à un workflow
+
+---
+
+Pour les documents associés à un workflow:
+
+- le document est en **lecture seule** pour tous;
+- **édition possible** par: les utilisateurs qui peuvent appliquer une étape du workflow;
+- **workflow finalisé** ? Le document est en lecture seule.
+
+## Duplication de document
+
+Il est possible de dupliquer un document:
+
+- dans les évaluations (actions d'accompagnement);
+- dans les parcours.
+
+Cela permet de restaurer un document qui serait figé par un workflow.
+
+# Workflows: nouveautés
+
+## Annulation automatique des workflows
+
+- workflows non finalisés;
+- sans intervention d'un agent…
+- …pendant 90 jours
+
+## Suppression des workflows annulés
+
+Il est possible de supprimer les workflows annulés (à partir de mi-novembre)
+
+## Mettre en attente un workflow
+
+Pour indiquer aux collègues que:
+
+- le workflow est vu;
+- mais pas encore traité.
+
+Aucun impact sur la gestion des workflows.
+
+----
+
+La "mise en attente" ne bloque pas l'annulation automatique après 90 jours.
+
+----
+
+![Exemple de mise en attente](./img/mise-en-attente-workflow-display.png)
+
+## Maximum :one: workflow par entité
+
+On ne peut pas créer plusieurs workflows sur un même document.
+
+## Envoi du workflow à des adresses emails 📨
+<!-- ici, très spécifique à vendée -->
+Adresse email manuelles: supprimée
+
+Remplacé par l'adresse email des MDSF
+
+-----
+
+## Adresse email MDSF
+
+- 🆕 Nommées "Groupes utilisateurs";
+- Chaque groupe est associé à :one: adresse email;
+
+-----
+
+- Possibilité d'associer les agents aux groupes
+- droits automatiques, comme si on listait tous les agents d'un groupe
+
+(pas utilisé par le CD85 au lancement)
+
+## Envoi du workflow à…
+
+- des utilisateurs;
+- et/ou des groupes d'utilisateurs;
+
+Même interface de recherche.
+
+
+# Signature électronique des documents
+
+## Principe de la signature
+
+Défini par Règlement UE "Eidas"
+
+- **non-modification du document** après chaque signature;
+- appose une **date certaine** sur le document;
+- identification du signataire;
+
+De manière électronique.
+
+----
+
+## Identification du signataire
+
+Constitue un "dossier de preuve" pour la signature:
+
+- document d'identité pour l'usager;
+- récolte de l'adresse IP, agent signant, etc;
+
+----
+
+**Esprit:** apposer une signature simplement.
+
+ℹ️ Pas de dou️ble vérification de l'identité avec envoi de SMS, etc.
+
+## Associé au workflow
+
+Pour apposer une signature:
+
+- un document est présent dans Chill;
+- workflow sur ce document;
+- étape `Demande de signature`.
+
+## Uniquement documents PDF
+
+- Standard pour l'archivage;
+- Le document est converti automatiquement
+  
+  Depuis `docx`, `odt`, …
+
+- L'ancienne version (modifiable) est conservée;
+
+  Elle n'est donc pas supprimée après 90 jours
+
+## Zones de signatures
+
+Des zones de signatures vont être ajoutées sur les documents.
+
+![Document avec zones de signature](./img/doc-with-zone-signature.png)
+
+----
+
+Possibilité d'ajouter des zones manuellement
+
+## Signature des agents
+
+- :one: seul agent par demande de signature
+- seul l'agent peut signer
+
+## Signature des usagers
+
+- signature de un ou plusieurs usagers par étape
+
+  Ex.: un couple, les parents, …
+
+----
+
+**Tout le monde** peut appliquer la signature d'un usager
+
+Le workflow est visible par tous.
+
+----
+
+![Rappel des signatures résultats de recherche](./img/rappel-signature-resultats-recherche.png)
+
+----
+
+### Pour chaque signature, demande de …
+
+- type de document d'identité;
+- numéro de document;
+- date d'expiration du document. 
+
+----
+
+![Demande de document d'identité](./img/signature-ask-documents.png)
+
+----
+
+### Possibilité de signer plus tard
+
+_L'usager n'a pas sa carte d'identité, il n'est pas présent, …_
+
+L'usager peut revenir signer à l'accueil avec une tablette.
+
+
+## _Et si on ne veut pas signer ?_
+
+Indiquer si:
+
+- signature annulée;
+- signature rejetée.
+
+## Après la signature ?
+
+**Toutes** les signatures doivent être traitées:
+
+<small>Tous les usagers doivent avoir signé</small>
+
+Signature appliquée, rejetée, annulée, …
+
+-----
+
+### Signature des agents
+
+- nouvelle étape `Signature traitée`
+- l'agent qui **a signé** "reprend la main"
+  
+  (il peut donc appliquer la prochaine étape)
+
+----
+
+### Signature des usagers
+
+- nouvelle étape `Signature traitée`
+- l'agent qui a **demandé** la signature "reprend la main"
+
+----
+
+### :warning: 
+
+Délai de quelques secondes après le traitement des signatures
+
+<small>surtout visible après le rejet de la signature</small>
+
+⌛ 3-5 secondes d'attente ⌛
+
+## Qui a signé ?
+
+Liste des signatures dans l'historique.
+
+----
+
+![List des signatures dans l'historique](img/liste-signature-appliquees.png)
+
+# Manipulations ⛏️
+
+## Accès
+
+[https://chillformation.vendee.fr](chillformation.vendee.fr)
+
+`formXX` ― 🔑 `ChillCD85!`
+
+Emails: sur [https://yopmail.com](yopmail.com) ― 📬 `chillcd85`
+
+## Tâches
+
+Générer un document "courrier type" dans le parcours
+
+Signer un document soi-même
+
+-----
+
+Faire signer un document à sa·son voisin·e de gauche, comme **utilisateur·trice**.
+
+-----
+
+Faire signer un document à sa·son voisin·e de droite, comme **usager**.
+
+Convenir à deux du nom de l'usager. 
+
+Le voisin de droite est l'usager.
+
+# Envoi sécurisé des documents 📧
+
+## Calendrier 🗓️
+
+À partir de fin novembre 2024
+
+## But
+
+- Faire parvenir un document à un tiers;
+- Respect du RGPD 🔐;
+
+  (Le document ne transite pas par des boites emails non sécurisées)
+
+## Fonctionnement
+
+1. Le document fait l'objet d'un workflow;
+2. Étape `Envoi sécurisé par courrier électronique`;
+3. Lien sécurisé envoyé par email;
+4. Le tiers consulte le document dans Chill;
+
+  (Il·elle peut télécharger le document) 
+
+----
+
+5. Dès la première consultation, le workflow est finalisé automatiquement. 
+6. Le tiers peut encore consulter le document pendant 30 jours;
+
+## Sécurisation
+
+- lien sécurisé, code unique;
+- maximum 100 consultations (par tiers);
+- traçage adresse IP et dates de consultation;
+  
+:warning: N'empêche pas un tiers de transférer l'email avec le lien.
+
+## Envoi à qui ?
+
+- à une adresse email;
+- à un tiers (avec une adresse email enregistrée dans sa fiche);
+
+----
+
+Envoi en central: sera effectué par ce biais.
+
+## Pièces jointes
+
+(à partir de fin novembre)
+
+- Possibilité d'ajouter des pièces jointes aux documents ➡️ plusieurs documents;
+- Le tiers peut voir le document **et** les pièces jointes.
+
+
+# Manipulations ⛏️
+
+## Tâche
+
+- envoyer un document à un tiers;
+- récupérer le lien sur yopmail;
+- consulter le document;
+- vérifier la finalisation automatique du workflow.