Merge branch 'ticket-app-master' into ticket/64-identifiants-person

Fix mobile layout, update Peloton display, and change comment display

See merge request Chill-Projet/chill-bundles!933

.changes/unreleased/Feature-20240530-160003.yaml

@@ -0,0 +1,6 @@
+kind: Feature
+body: |
+  Upgrade import of address list to the last version of compiled addresses of belgian-best-address
+time: 2024-05-30T16:00:03.440767606+02:00
+custom:
+  Issue: ""

.changes/unreleased/Feature-20240531-190242.yaml

@@ -0,0 +1,6 @@
+kind: Feature
+body: |
+  Upgrade CKEditor and refactor configuration with use of typescript
+time: 2024-05-31T19:02:42.776662753+02:00
+custom:
+  Issue: ""

.changes/unreleased/Feature-20250808-120802.yaml

@@ -0,0 +1,6 @@
+kind: Feature
+body: Create invitation list in user menu
+time: 2025-08-08T12:08:02.446361367+02:00
+custom:
+    Issue: "385"
+    SchemaChange: No schema change

.changes/unreleased/Feature-20251007-155945.yaml

@@ -0,0 +1,6 @@
+kind: Feature
+body: Admin interface for Motive entity
+time: 2025-10-07T15:59:45.597029709+02:00
+custom:
+    Issue: ""
+    SchemaChange: No schema change

.changes/unreleased/Feature-20251022-111552.yaml

@@ -0,0 +1,6 @@
+kind: Feature
+body: Add an admin interface for Motive entity
+time: 2025-10-22T11:15:52.13937955+02:00
+custom:
+    Issue: ""
+    SchemaChange: Add columns or tables

.changes/unreleased/Fixed-20251106-161605.yaml

@@ -0,0 +1,6 @@
+kind: Fixed
+body: Fix suggestion of referrer when creating notification for accompanyingPeriodWorkDocument
+time: 2025-11-06T16:16:05.861813041+01:00
+custom:
+    Issue: "428"
+    SchemaChange: No schema change

.changes/v3.11.0.md

@@ -0,0 +1,19 @@
+## v3.11.0 - 2025-04-17
+### Feature
+* ([#365](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/365)) Add counters of actions and activities, with 2 boxes to (1) show the number of active actions on total actions and (2) show the number of activities in a accompanying period, and pills in menus for showing the number of active actions and the number of activities.
+* ([#364](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/364)) Added a second phone number "telephone2" to the thirdParty entity. Adapted twig templates and vuejs apps to handle this phone number
+
+  **Schema Change**: Add columns or tables
+* Signature: add a button to go directly to the signature zone, even if there is only one
+### Fixed
+* Fixed wrong translations in the on-the-fly for creation of thirdParty
+* Fixed update of phone number in on-the-fly edition of thirdParty
+* Fixed closing of modal when editing thirdParty in accompanying course works
+* Shorten the delay between two execution of AccompanyingPeriodStepChangeCronjob, to ensure at least one execution in a day
+* ([#102](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/102)) Fix display of title in document list
+* When cleaning the old stored object versions, do not throw an error if the stored object is not found on disk
+* Add consistent log prefix and key to logs when stale workflows are automatically canceled
+* ([#380](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/380)) Remove the "not null" validation constraint on recently added properties on HouseholdComposition
+
+### DX
+* Add new chill-col style for displaying title and aside in a flex table

.changes/v3.12.0.md

@@ -0,0 +1,22 @@
+## v3.12.0 - 2025-06-30
+### Feature
+* ([#377](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/377)) Add the document file name to the document title when a user upload a document, unless there is already a document title.   
+* Add desactivation date for social action and issue csv export   
+* Add Emoji and Fullscreen feature to ckeditor configuration   
+* ([#321](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/321)) Create editor which allow us to toggle between rich and simple text editor   
+* Do not remove workflow which are automatically canceled after staling for more than 30 days   
+### Fixed
+* ([#376](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/376)) trying to prevent bug of typeerror in doc-history + improved display of document history   
+* ([#381](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/381)) Display previous participation in acc course work even if the person has left the acc course   
+* ([#372](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/372)) Fix display of text in calendar events   
+* Add missing translation for user_group.no_user_groups   
+* Fix admin entity edit actions for event admin entities and activity reason (category) entities   
+* ([#392](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/392)) Allow null and cast as string to setContent method for NewsItem
+   
+* ([#393](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/393)) Doc Generation: the "dump only" method send the document as an email attachment.   
+### DX
+* ([#352](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/352)) Remove dead code for wopi-link module   
+* Replace library node-sass by sass, and upgrade bootstrap to version 5.3 (yarn upgrade / install is required)   
+### UX
+* ([#374](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/374)) Remove default filter in_progress for the page 'my tasks'; Allows for new tasks to be displayed upon opening of the page   
+* Improve labeling of fields in person resource creation form   

.changes/v3.12.1.md

@@ -0,0 +1,3 @@
+## v3.12.1 - 2025-06-30
+### Fixed
+* Fix loading of the list of documents   

.changes/v4.0.0.md

@@ -0,0 +1,74 @@
+## v4.0.0 - 2025-07-08
+### Feature
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Allow the merge of two accompanying period works
+### Fixed
+* ([#390](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/390)) Display the list of participant in the results, even if there is only one participant and that the search result display the requestor
+* Fix admin entity edit actions for event admin entities and activity reason (category) entities
+* Fix translations for social action fields in admin form: results, goals, evaluations
+### DX
+* Rewrite exports to run them asynchronously
+
+  **Schema Change**: Add columns or tables
+* Allow TranslatableMessage in flash messages
+### UX
+* Improve labeling of fields in person resource creation form
+
+
+**Release notes**
+
+- Add new methods to serialize data using the rector rule
+- Remove all references to the Request in filters, aggregators, filters. Actually, the most frequent occurence is `$security->getUser()`.
+- Refactor manually the initializeQuery method
+- Remove the injection of ExportManager into the constructor of each export element:
+
+  ```diff
+
+  - class MyFormatter implements FormatterInterface
+  + class MyFormatter implements FormatterInterface, \Chill\MainBundle\Export\ExportManagerAwareInterface
+  {
+  +    use \Chill\MainBundle\Export\Helper\ExportManagerAwareTrait;
+
+  -    public function __construct(private ExportManager $exportmanager) {}
+
+       public function MyMethod(): void
+       {
+  -          $this->exportManager->getFilter('alias');
+  +          $this->getExportManager()->getFilter('alias');
+       }
+  }
+  ```
+- configure messenger to handle export in a queue:
+
+```diff
+# config/packages/messenger.yaml
+framework:
+    messenger:
+        routing:
++            'Chill\MainBundle\Export\Messenger\ExportRequestGenerationMessage': priority
+```
+
+- add missing methods to exports, aggregators, filters, formatter:
+
+  ```php
+  public function normalizeFormData(array $formData): array;
+
+  public function denormalizeFormData(array $formData, int $fromVersion): array;
+  ```
+
+  There are rector rules to generate those methods:
+
+  - `Chill\Utils\Rector\Rector\ChillBundleAddNormalizationMethodsOnExportRector`
+
+  See:
+
+  ```php
+  // upgrade chill exports
+  $rectorConfig->rules([\Chill\Utils\Rector\Rector\ChillBundleAddNormalizationMethodsOnExportRector::class]);
+  ```
+
+  This rule will create most of the work necessary, but some manuals changes are still necessary:
+
+  - we must set manually the correct repository for method `denormalizeDoctrineEntity`;
+  - when the form data contains some entities, and the form type is not one of EntityType::class, PickUserDynamicType::class, PickUserLocationType::class, PickThirdpartyDynamicType::class, Select2CountryType::class, then we must handle the normalization manually (using the `\Chill\MainBundle\Export\ExportDataNormalizerTrait`)
+
+

.changes/v4.0.1.md

@@ -0,0 +1,4 @@
+## v4.0.1 - 2025-07-08
+### Fixed
+* Fix package.json for compilation
+   

.changes/v4.0.2.md

@@ -0,0 +1,4 @@
+## v4.0.2 - 2025-07-09
+### Fixed
+* Fix add missing translation   
+* Fix the transfer of evaluations and documents during of accompanyingperiodwork   

.changes/v4.1.0.md

@@ -0,0 +1,12 @@
+## v4.1.0 - 2025-08-26
+### Feature
+* ([#400](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/400)) Add filter to social actions list to filter out actions where current user intervenes   
+* ([#399](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/399)) Show filters on list pages unfolded by default   
+* Expansion of event module with new fields in the creation form: thematic, internal/external animator, responsable, and budget elements. Filtering options in the event list + adapted exports   
+
+  **Schema Change**: Add columns or tables
+### Fixed
+* ([#382](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/382)) adjust display logic for accompanying period dates, include closing date if period is closed.   
+* ([#384](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/384)) add min and step attributes to integer field in DateIntervalType   
+### UX
+* Limit display of participations in event list   

.changes/v4.2.0.md

@@ -0,0 +1,10 @@
+## v4.2.0 - 2025-09-02
+### Feature
+* ([#64](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/64)) Add external identifier for a Person
+
+  **Schema Change**: Add columns or tables
+* ([#330](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/330) Allow users to choose for which notifications they want to receive an email
+### Fixed
+* ([#422](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/422)) Fixed html layout of pages for recovering password
+* Fix typo in 'uncheckAll' script for centers selection
+* Fix incorrect parameter name in event details link

.changes/v4.2.1.md

@@ -0,0 +1,6 @@
+## v4.2.1 - 2025-09-03
+### Fixed
+* Fix exports to work with DirectExportInterface   
+### DX
+* Improve error message when a stored object cannot be written on local disk
+   

.changes/v4.3.0.md

@@ -0,0 +1,10 @@
+## v4.3.0 - 2025-09-08
+### Feature
+* ([#409](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/409)) Add 45 and 60 min calendar ranges   
+* Add a command to generate a list of permissions   
+* ([#412](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/412)) Add an absence end date   
+
+  **Schema Change**: Add columns or tables
+### Fixed
+* fix date formatting in calendar range display   
+* Change route URL to avoid clash with person duplicate controller method   

.changes/v4.4.0.md

@@ -0,0 +1,8 @@
+## v4.4.0 - 2025-09-11
+### Feature
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Allow the merge of two accompanying period works   
+* ([#369](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/369)) Duplication of a document to another accompanying period work evaluation   
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Fusion of two accompanying period works   
+### Fixed
+* Fix display of 'duplicate' and 'merge' buttons in CRUD templates   
+* Fix saving notification preferences in user's profile   

.changes/v4.4.1.md

@@ -0,0 +1,3 @@
+## v4.4.1 - 2025-09-11
+### Fixed
+* fix translations in duplicate evaluation document modal and realign close modal button   

.changes/v4.4.2.md

@@ -0,0 +1,3 @@
+## v4.4.2 - 2025-09-12
+### Fixed
+* Fix document generation and workflow generation do not work on accompanying period work documents   

.changes/v4.5.0.md

@@ -0,0 +1,13 @@
+## v4.5.0 - 2025-10-03
+### Feature
+* Only allow delete of attachment on workflows that are not final   
+* Move up signature buttons on index workflow page for easier access   
+* Filter out document from attachment list if it is the same as the workflow document   
+* Block edition on attached document on workflow, if the workflow is finalized or sent external   
+* Convert workflow's attached document to pdf while sending them external   
+* After a signature is canceled or rejected, going to a waiting page until the post-process routines apply a workflow transition   
+### Fixed
+* ([#426](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/426)) Increased the number of required characters when setting a new password in Chill from 9 to 14 - GDPR compliance   
+* Fix permissions on storedObject which are subject by a workflow   
+### DX
+* Introduce a WaitingScreen component to display a waiting screen   

.changes/v4.5.1.md

@@ -0,0 +1,4 @@
+## v4.5.1 - 2025-10-03
+### Fixed
+* Add missing javascript dependency   
+* Add exception handling for conversion of attachment on sending external, when documens are already in pdf   

.changes/v4.6.0.md

@@ -0,0 +1,14 @@
+## v4.6.0 - 2025-10-15
+### Feature
+* ([#423](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/423)) Create environment banner that can be activated and configured depending on the image deployed   
+* ([#394](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/394)) Only show active workflow on the page "my tracked workflow"   
+### Fixed
+* Fix loading of classLists in SocialIssuesAcc.vue, ensure elements are present   
+* Fix the rendering of list of StoredObjectVersions, where there are kept version (before converting to pdf) and intermediate versions deleted   
+* ([#434](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/434)) Notification: fix editing of sent notification by removing form.addressesEmails, a field that no longer exists   
+* Fix loading of social issues and social actions within vue component   
+* ([#446](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/446)) Add unique condition on stored object filename, with cleaning step on existing duplicate filenames   
+
+  **Schema Change**: Drop or rename table or columns, or enforce new constraint that must be manually fixed
+* [workflow] take permissions into account to delete the workflow attachment   
+* ([#448](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/448)) Fix the execution of daily cronjob notification, when the previous last execution storage was invalid   

.changes/v4.6.1.md

@@ -0,0 +1,3 @@
+## v4.6.1 - 2025-10-27
+### Fixed
+* Fix export case where no 'reason' is picked within the PersonHavingActivityBetweenDateFilter.php   

.changes/v4.7.0.md

@@ -0,0 +1,21 @@
+## v4.7.0 - 2025-11-10
+### Feature
+* ([#385](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/385)) Create invitation list in user menu   
+* ([#404](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/404)) Add columns for comments linked to an activity in the activity list export   
+### Fixed
+* ([#451](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/451)) Fix: display also social actions linked to parents of the selected social issue   
+* ([#453](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/453)) Fix: export actions and their results in csv even when action does not have any goals attached to it.   
+* Fix the possibility to delete a workflow   
+
+  **Schema Change**: Drop or rename table or columns, or enforce new constraint that must be manually fixed
+* ([#457](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/457)) Fix the fusion of thirdparty properties that are located in another schema than public for TO_ONE relations + add extra loop for MANY_TO_MANY relations where thirdparty is the source instead of the target   
+* ([#428](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/428)) Fix suggestion of referrer when creating notification for accompanyingPeriodWorkDocument   
+### DX
+* Send notifications log to dedicated channel, if it exists
+   
+### UX
+* ([#425](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/425)) Change the terms 'cercle' and 'centre' to 'service', and 'territoire' respectively.   
+* ([#542](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/542)) Improve the ux for selecting whether user wants to be notified of the final step of a workflow or all steps   
+* Expand timeSpent choices for evaluation document and translate them to user locale or fallback 'fr'   
+* ([#455](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/455)) Change the order of display for results and objectives in the social work/action form   
+* Wrap text when it is too long within badges   

.changes/v4.8.0.md

@@ -0,0 +1,9 @@
+## v4.8.0 - 2025-11-17
+### Feature
+* ([#461](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/461)) Make a calendar item on the 'mes rendez-vous' page clickable. Clicking will navigate to the edit page of the calendar item.   
+### Fixed
+* ([#463](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/463)) Display calendar items for which an invite was accepted on the mes rendez-vous page   
+* Improve accessibility on login page
+   
+### UX
+* ([#449](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/449)) Remove the label if there is only one scope and no scope picking field is displayed.   

.changes/v4.8.1.md

@@ -0,0 +1,6 @@
+## v4.8.1 - 2025-11-20
+### Fixed
+* Insert name of file as the document title when uploading   
+* Add missing path paramater 'id' for editing multiple participations   
+* ([#471](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/471)) Hide the display of inactive user groups in the api
+   

.changes/v4.8.2.md

@@ -0,0 +1,10 @@
+## v4.8.2 - 2025-11-26
+### Fixed
+* ([#466](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/466)) Associate activity's creator as a participant by default, and retro-actively append the creator to each activity
+   
+
+  **Schema Change**: Add columns or tables
+* Fix template parameter for update_multiple route on event participations   
+### UX
+* ([#470](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/470)) Alphabetically order userJobs and mainLocations within user creation form   
+* ([#437](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/437)) Change position and color of confirm parcours button   

.changes/v4.9.0.md

@@ -0,0 +1,14 @@
+## v4.9.0 - 2025-12-05
+### Feature
+* ([#459](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/459)) Add a counter for invitations awaiting reply   
+### Fixed
+* ([#475](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/475)) Do not suggest a user that is no longer active in the activity form.   
+* ([#441](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/441)) Remove double display of person id in the banner when there is a deathdate   
+### DX
+* ([#280](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/280)) Add missing fixtures for proper loading of AccompanyingPeriods   
+* ([#386](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/386)) Use mkdocs with mkdocs-material instead of sphinx to build chill developer documentation   
+### UX
+* ([#456](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/456)) Display whether doc generation template is active or not in admin and order templates alphabetically   
+* ([#460](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/460)) Display calendar item info on cancel page   
+* ([#424](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/424)) Display entire comment for activity item within list   
+* ([#474](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/474)) Improve accessibility of event form   

.editorconfig

@@ -19,11 +19,11 @@ max_line_length = 80
 [COMMIT_EDITMSG]
 max_line_length = 0
 
-[*.{js, vue, ts}]
+[*.{js,vue,ts}]
 indent_size = 2
 indent_style = space
 
-[.rst]
-ident_size = 3
-ident_style = space
+[*.rst]
+indent_size = 3
+indent_style = space
 

.env

@@ -92,3 +92,7 @@ REDIS_URL=redis://${REDIS_HOST}:${REDIS_PORT}
 ###> symfony/ovh-cloud-notifier ###
 # OVHCLOUD_DSN=ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME
 ###< symfony/ovh-cloud-notifier ###
+
+###> symfony/loco-translation-provider ###
+#LOCO_DSN=loco://API_KEY@default
+###< symfony/loco-translation-provider ###

.gitignore

@@ -18,6 +18,9 @@ migrations/*
 templates/*
 translations/*
 
+# we allow developers to add customization on their installation, without commiting it
+config/packages/dev/*
+
 ###> symfony/framework-bundle ###
 /.env.local
 /.env.local.php

.gitlab-ci.yml

@@ -38,15 +38,67 @@ variables:
     TZ: Europe/Brussels
     # avoid direct deprecations (using symfony phpunit bridge: https://symfony.com/doc/4.x/components/phpunit_bridge.html#internal-deprecations
     SYMFONY_DEPRECATIONS_HELPER: max[total]=99999999&max[self]=0&max[direct]=45&verbose=0
+    # consider the root package at the dev-master version
+    # this is required to work with packages
+    # see https://getcomposer.org/doc/articles/troubleshooting.md#dependencies-on-the-root-package
+    COMPOSER_ROOT_VERSION: dev-master
 
 stages:
+    - mirror
     - Composer install
     - Tests
     - Deploy
 
+mirror_chill_zimbra_bundle:
+    stage: mirror
+    image: alpine:latest
+
+    variables:
+        GIT_DEPTH: 0 # <-- access to the full git history
+
+    rules:
+        # 1) Allow manual run from GitLab UI, whatever the branch
+        -   if: '$CI_PIPELINE_SOURCE == "web"'
+
+        # 2) Auto-run on commits to master or 472-zimbra-connector
+        #    but only if relevant files changed
+        -   if: '$CI_COMMIT_BRANCH == "master" || $CI_COMMIT_BRANCH == "472-zimbra-connector"'
+            changes:
+                - packages/ChillZimbraBundle/**/*
+                - .gitlab-ci.yml
+
+        # 3) Otherwise: never run
+        -   when: never
+
+
+    before_script:
+        - apk add --no-cache git git-subtree openssh
+        # Config git
+        - git config --global user.email "ci@gitlab.com"
+        - git config --global user.name "GitLab CI"
+        # Préparation SSH
+        - mkdir -p ~/.ssh
+        - cp "$DEPLOY_KEY" ~/.ssh/id_ed25519
+        - printf '\n' >> ~/.ssh/id_ed25519
+        - chmod 600 ~/.ssh/id_ed25519
+        - ssh-keyscan gitlab.com >> ~/.ssh/known_hosts
+        # Ajout du remote vers le repo dédié
+        - git remote add chill-zimbra-connector git@gitlab.com:Chill-Projet/chill-zimbra-connector.git || true
+
+    script:
+        # On s'assure d'être sur la bonne branche (celle qui a déclenché le job, master)
+        - git checkout "$CI_COMMIT_REF_NAME"
+
+        # Crée une branche temporaire qui contient uniquement l'historique de packages/ChillZimbraBundle
+        - git subtree split --prefix=packages/ChillZimbraBundle -b chill_zimbra_temp
+
+        # Push vers le repo cible, branche master du repo chill-zimbra-connector
+        - git push chill-zimbra-connector chill_zimbra_temp:main
+
 build:
     stage: Composer install
-    image: gitea.champs-libres.be/chill-project/chill-skeleton-basic/base-image:php82
+    image: chill/base-image:8.3-edge
+    variables:
     before_script:
         - composer config -g cache-dir "$(pwd)/.cache"
     script:
@@ -61,7 +113,7 @@ build:
 
 code_style:
     stage: Tests
-    image: gitea.champs-libres.be/chill-project/chill-skeleton-basic/base-image:php82
+    image: chill/base-image:8.3-edge
     script:
         - php-cs-fixer fix --dry-run -v --show-progress=none
     cache:
@@ -74,7 +126,7 @@ code_style:
 
 phpstan_tests:
     stage: Tests
-    image: gitea.champs-libres.be/chill-project/chill-skeleton-basic/base-image:php82
+    image: chill/base-image:8.3-edge
     variables:
         COMPOSER_MEMORY_LIMIT: 3G
     before_script:
@@ -91,7 +143,7 @@ phpstan_tests:
 
 rector_tests:
     stage: Tests
-    image: gitea.champs-libres.be/chill-project/chill-skeleton-basic/base-image:php82
+    image: chill/base-image:8.3-edge
     before_script:
         - bin/console cache:clear --env=dev
     script:
@@ -132,7 +184,7 @@ lint:
 
 unit_tests:
     stage: Tests
-    image: gitea.champs-libres.be/chill-project/chill-skeleton-basic/base-image:php82
+    image: chill/base-image:8.3-edge
     variables:
         COMPOSER_MEMORY_LIMIT: 3G
     before_script:

.junie/guidelines.md

@@ -0,0 +1,391 @@
+# Project Guidelines for Junie
+
+## Project Overview
+
+Chill is a comprehensive web application built as a set of Symfony bundles. It is a case management system, for social work. The project consists of multiple specialized bundles that provide different functionalities:
+
+- **ChillMainBundle**: Core bundles that provide the foundation of the application
+- **ChillPersonBundle**: Core bundles that provide the foundation of the bundles associated to person (which is the case for all other bundles)
+- **ChillCalendarBundle**: Calendar and scheduling functionality
+- **ChillDocStoreBundle** and **ChillDocGeneratorBundle**: Document management and generation
+- **ChillActivityBundle**, **ChillEventBundle**, **ChillTaskBundle**: Activity and task tracking
+- **ChillBudgetBundle**: Financial management
+- **ChillThirdPartyBundle**: Integration with external systems
+- **ChillCustomFieldsBundle**: Extensibility through custom fields
+- **ChillReportBundle**: Save arbitrary reports about persons
+- **ChillTicketBundle**: Record and track issues about persons
+
+- And several other specialized bundles
+
+## Technology Stack
+
+- **Backend**: PHP 8.3+, Symfony 5.4
+- **Frontend**: JavaScript/TypeScript, Vue.js 3, Bootstrap 5
+- **Build Tools**: Webpack Encore, Yarn
+- **Database**: PostgreSQL with materialized views. We do not support other databases.
+- **Other Services**: Redis, AMQP (RabbitMQ), SMTP
+
+## Project Structure
+
+Note: This is a project that's existed for a long time, and throughout the years we've used multiple structures inside each bundle. When having the choice, the developers should choose the new structure.
+
+The project follows a standard Symfony bundle structure:
+- `/src/Bundle/`: Contains all the Chill bundles. The code is either at the root of the bundle directory, or within a `src/` directory (preferred). See psr4 mapping at the root's `composer.json`.
+- each bundle comes with its own tests, either in the `Tests` directory (when the code is directly within the bundle directory (for instance `src/Bundle/ChillMainBundle/Tests`, `src/Bundle/ChillPersonBundle/Tests`)), or inside the `tests` directory, alongside the `src/` sub-directory (example: `src/Bundle/ChillWopiBundle/tests`) (this is the preferred way).
+- `/docs/`: Contains project documentation
+
+Each bundle typically has the following structure:
+
+- `Controller/`: Contains controllers
+- `Entity/`: Contains Doctrine entities
+- `Repository/`: Contains Doctrine repositories
+- `Resources/`: Contains views, translations, and public assets
+- `DependencyInjection/`: Contains service configuration
+- `Export/`: Contains services related to exports
+- `Security/`: Contains services related to security. Most of the time, those are new voters, and so on.
+
+### A special word about TicketBundle
+
+The ticket bundle is developed using a kind of "Command" pattern. The controller fills a "Command," and a "CommandHandler" handles this command. They are saved in the `src/Bundle/ChillTicketBundle/src/Action` directory.
+
+## Development Guidelines
+
+### Building and Configuration Instructions
+
+All the commands should be run through the `symfony` command, which will configure the required variables.
+
+For assets, we must ensure that we use node at version `^20.0.0`. This is done using `nvm use 20`.
+
+#### Initial Setup
+
+1. **Clone the Repository**:
+   ```bash
+   git clone <repository-url>
+   cd chill-bundles
+   ```
+
+2. **Install PHP Dependencies**:
+   ```bash
+   composer install
+   ```
+
+3. **Install JavaScript Dependencies**:
+   ```bash
+   nvm use 20
+   yarn install
+   ```
+
+4. **Configure Environment Variables**:
+
+   - Create a `.env.local` file with minimal configuration
+   ```bash
+   echo "APP_ENV=dev" >> .env.local
+   ```
+
+5. Start the associated services (database, and so on):
+   ```bash
+   docker compose up -d
+   ```
+
+6. **Set Up the Database**:
+   ```bash
+   # Create the database
+   symfony console doctrine:database:create
+
+   # Run migrations
+   symfony console doctrine:migrations:migrate
+
+   # Load fixtures (optional)
+   symfony console doctrine:fixtures:load
+   ```
+
+7. **Build Assets**:
+   ```bash
+   nvm use 20
+   yarn run encore dev
+   ```
+
+8. **Start the Development Server**:
+   ```bash
+   symfony server:start -d
+   ```
+
+#### Docker Setup
+
+The project includes a Docker configuration for easier development:
+
+1. **Start Docker Services**:
+   ```bash
+   docker-compose up -d
+   ```
+
+2. **Access the Application**:
+   - The application will be available at `http://localhost:8000`
+   - PostgreSQL will be available at `localhost:5432`
+   - Redis will be available at `localhost:6379`
+
+#### Building Assets
+
+Before submitting any changes, you should build the project to ensure that all assets are properly compiled:
+
+```bash
+# For production
+yarn run encore production
+
+# For development with hot-reloading
+yarn run encore dev --watch
+
+# for development
+yarn run encore dev
+```
+
+#### Configuration Files
+
+Key configuration files:
+
+- `config/packages/*.yaml`: Symfony bundle configurations
+- `webpack.config.js`: Webpack Encore configuration
+- `composer.json`: PHP dependencies and scripts
+- `package.json`: JavaScript dependencies and scripts
+- `.env`: Default environment variables. Must usually not be updated: use `.env.local` instead.
+
+### Database migrations
+
+Each time a doctrine entity is created, we generate migration to adapt the database.
+
+The migration is created using the command `symfony console doctrine:migrations:diff --no-interaction --namespace <namespace>`, where the namespace is the relevant namespace for migration. As this is a bash script, remember to quote the `\` (`\` must become `\\` in your command).
+
+Each bundle has his own namespace for migration (always ask me to confirm that command with a list of updated / created entities so that I can confirm to you that it is ok):
+
+- `Chill\Bundle\ActivityBundle` writes migrations to `Chill\Migrations\Activity`;
+- `Chill\Bundle\BudgetBundle` writes migrations to `Chill\Migrations\Budget`;
+- `Chill\Bundle\CustomFieldsBundle` writes migrations to `Chill\Migrations\CustomFields`;
+- `Chill\Bundle\DocGeneratorBundle` writes migrations to `Chill\Migrations\DocGenerator`;
+- `Chill\Bundle\DocStoreBundle` writes migrations to `Chill\Migrations\DocStore`;
+- `Chill\Bundle\EventBundle` writes migrations to `Chill\Migrations\Event`;
+- `Chill\Bundle\CalendarBundle` writes migrations to `Chill\Migrations\Calendar`;
+- `Chill\Bundle\FamilyMembersBundle` writes migrations to `Chill\Migrations\FamilyMembers`;
+- `Chill\Bundle\FranceTravailApiBundle` writes migrations to `Chill\Migrations\FranceTravailApi`;
+- `Chill\Bundle\JobBundle` writes migrations to `Chill\Migrations\Job`;
+- `Chill\Bundle\MainBundle` writes migrations to `Chill\Migrations\Main`;
+- `Chill\Bundle\PersonBundle` writes migrations to `Chill\Migrations\Person`;
+- `Chill\Bundle\ReportBundle` writes migrations to `Chill\Migrations\Report`;
+- `Chill\Bundle\TaskBundle` writes migrations to `Chill\Migrations\Task`;
+- `Chill\Bundle\ThirdPartyBundle` writes migrations to `Chill\Migrations\ThirdParty`;
+- `Chill\Bundle\TicketBundle` writes migrations to `Chill\Migrations\Ticket`;
+- `Chill\Bundle\WopiBundle` writes migrations to `Chill\Migrations\Wopi`;
+
+Once created the, comment's classes should be removed and a description of the changes made to the entities should be added to the migrations, using the `getDescription` method. The migration should not be cleaned by any artificial intelligence, as modifying this migration is error prone.
+
+### Guidelines related to code structure and requirements
+
+#### Usage of clock
+
+When we need to use a DateTime or DateTimeImmutable that need to express "now", we prefer the usage of
+`Symfony\Component\Clock\ClockInterface`, where possible. This is usually not possible in doctrine entities,
+where injection does not work when restoring an entity from a database, but usually possible in services.
+
+In test, we use `\Symfony\Component\Clock\MockClock` which is an implementation of `Symfony\Component\Clock\ClockInterface`
+where we have full and easy control of the date.
+
+### Testing Information
+
+The project uses PHPUnit for testing. Each bundle has its own test suite, and there's also a global test suite at the root level.
+
+#### Use of mock in tests
+
+##### General mocking
+
+For creating mock, we prefer using prophecy (library phpspec/prophecy).
+
+##### Useful helpers and tips that avoid creating a mock
+
+Some notable implementations that are test helpers and avoid creating a mock:
+
+- `\Psr\Log\NullLogger`, an implementation of `\Psr\Log\LoggerInterface`;
+- `\Symfony\Component\Clock\MockClock`, an implementation of `Symfony\Component\Clock\ClockInterface` (already mentioned above);
+- `\Symfony\Component\HttpClient\MockHttpClient`, an implementation of `\Symfony\Contracts\HttpClient\HttpClientInterface`;
+- When using `\Symfony\Component\Mailer\MailerInterface`, we can create the mock with "InMemoryTransport":
+
+    ```php
+    use Symfony\Component\Mailer\Transport\InMemoryTransport;
+    use \Symfony\Component\Mailer\Mailer;
+
+    $transport = new InMemoryTransport();
+    $mailer = new Mailer($transport);
+
+    // After sending:
+    $messages = $transport->getSent(); // array of SentMessage
+    ```
+- When using `\Symfony\Contracts\EventDispatcher\EventDispatcherInterface`, we can use directly an instance of `\Symfony\Component\EventDispatcher\EventDispatcher`;
+
+##### When we prefer not creating a mock
+
+- When we use Doctrine Entities related to the project, we prefer not to use a mock: we instantiate them directly (unless it requires too much code to write);
+
+##### Mocking final and readonly classes
+
+Classes marked as final can't be mocked. To avoid that, either:
+
+- we remove the `final` keyword from the class;
+- we extract an interface from the final class.
+
+This must be a decision made by a human, not by an AI. Every AI task must abort with an explicit message in that case.
+
+#### Running Tests
+
+The tests are run from the project's root (not from the bundle's root: so, do not change the directory to any bundle directory before running tests).
+
+Tests must be run using the `symfony` command:
+
+```bash
+
+# Run a specific test file
+symfony composer exec phpunit -- path/to/TestFile.php
+
+# Run a specific test method
+symfony composer exec phpunit -- --filter methodName path/to/TestFile.php
+```
+
+When writing tests, only test specific files. Do not run all tests or the full
+test suite.
+
+#### Test Structure
+
+Tests are organized by bundle and follow the same structure as the bundle itself:
+
+- Unit tests: Test individual components in isolation
+- Integration tests: Test components working together
+- Functional tests: Test the application from the user's perspective
+
+#### Writing Tests
+
+Tests should be placed in the appropriate bundle's test directory. For example, tests for the TicketBundle should be placed in `src/Bundle/ChillTicketBundle/tests/`.
+
+Here's an example of a simple entity test:
+
+```php
+<?php
+
+namespace Chill\TicketBundle\Tests\Entity;
+
+use Chill\TicketBundle\Entity\Ticket;
+use PHPUnit\Framework\TestCase;
+
+class TicketTest extends TestCase
+{
+    public function testGetAndSetExternalRef(): void
+    {
+        $ticket = new Ticket();
+        $externalRef = 'REF-123';
+
+        // Set the external reference
+        $ticket->setExternalRef($externalRef);
+
+        // Verify that getExternalRef returns the correct value
+        self::assertSame($externalRef, $ticket->getExternalRef());
+
+        // Change the external reference
+        $newExternalRef = 'REF-456';
+        $ticket->setExternalRef($newExternalRef);
+
+        // Verify that getExternalRef returns the updated value
+        self::assertSame($newExternalRef, $ticket->getExternalRef());
+    }
+}
+```
+
+#### Test Database
+
+For tests that require a database, the project uses a postgresql database filled with fixtures (usage of doctrine-fixtures). You can configure a different database for testing in the `.env.test` file.
+
+### Code Quality Tools
+
+The project uses several tools to maintain code quality:
+
+#### PHP Code Style
+
+The project uses PHP-CS-Fixer for code style. You can run it with:
+
+```bash
+# Using the composer script
+composer php-cs-fixer
+
+# Or directly
+php-cs-fixer fix --config=./.php-cs-fixer.dist.php
+```
+
+#### Static Analysis
+
+The project uses PHPStan for static analysis. You can run it with:
+
+```bash
+# Using the composer script
+composer phpstan
+
+# Or directly
+vendor/bin/phpstan analyse
+```
+
+#### Automated Refactoring
+
+The project uses Rector for automated refactoring. You can run it with:
+
+```bash
+# Using the composer script
+composer rector
+
+# Or directly
+vendor/bin/rector
+```
+
+#### JavaScript/TypeScript Linting
+
+The project uses ESLint for JavaScript/TypeScript code quality. You can run it with:
+
+```bash
+yarn run eslint
+```
+
+## Deployment
+
+The project can be deployed in a production environment following Symfony's deployment guidelines. The documentation provides detailed instructions for setting up a production environment.
+
+### Production Deployment Checklist
+
+1. Set environment variables for production
+2. Optimize Composer autoloader: `composer install --no-dev --optimize-autoloader`
+3. Compile assets for production: `yarn run encore production`
+4. Clear and warm up the cache: `php bin/console cache:clear --env=prod`
+5. Run database migrations: `php bin/console doctrine:migrations:migrate --env=prod`
+
+## Documentation
+
+Comprehensive documentation is available in the `/docs/` directory, including installation instructions, configuration guides, and operational procedures.
+
+## Development Workflow
+
+1. **Create a Feature Branch**: Always create a new branch for your feature or bugfix
+2. **Write Tests**: Write tests for your changes before implementing them
+3. **Implement Changes**: Implement your changes following the project's coding standards
+4. **Run Tests**: Make sure all tests pass
+5. **Run Code Quality Tools**: Make sure your code passes all code quality checks
+6. **Submit a Pull Request**: Submit a pull request for review
+
+## Debugging
+
+The project includes several tools for debugging:
+
+- **Symfony Profiler**: Available in development mode at `/_profiler`
+- **Xdebug**: Configure your IDE to use Xdebug for step-by-step debugging
+- **Symfony Debug Toolbar**: Available at the bottom of the page in development mode
+
+## Conclusion
+
+When working with this project, Junie should:
+
+1. Understand the modular bundle structure and how the different components interact
+2. Build the project before submitting changes to ensure assets are properly compiled
+3. Run relevant tests to ensure changes don't break existing functionality
+4. Follow the established code style and patterns
+5. Use the provided tools for debugging and code quality

.php-cs-fixer.dist.php

@@ -14,6 +14,7 @@ $finder = PhpCsFixer\Finder::create();
 $finder
     ->in(__DIR__.'/src')
     ->in(__DIR__.'/utils')
+    ->in(__DIR__.'/packages')
     ->append([__FILE__])
     ->exclude(['docs/', 'tests/app'])
     ->notPath('tests/app')

.prettierrc

@@ -0,0 +1,4 @@
+{
+  "tabWidth": 2,
+  "useTabs": false
+}

.readthedocs.yml

@@ -4,11 +4,11 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.7"
+    python: "3.11"
 
-sphinx:
-  configuration: docs/source/conf.py
+mkdocs:
+  configuration: docs/mkdocs.yml
 
 python:
   install:
-    - requirements: docs/requirements.txt
+    - requirements: docs/requirements.txt

.vscode/launch.json

@@ -0,0 +1,30 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Chill Debug",
+            "type": "php",
+            "request": "launch",
+            "port": 9000,
+            "pathMappings": {
+                "/var/www/html": "${workspaceFolder}"
+            },
+            "preLaunchTask": "symfony"
+        },
+        {
+            "name": "Yarn Encore Dev (Watch)",
+            "type": "node-terminal",
+            "request": "launch",
+            "command": "yarn encore dev --watch",
+            "cwd": "${workspaceFolder}"
+        }
+    ],
+    "compounds": [
+        {
+            "name": "Chill Debug + Yarn Encore Dev (Watch)",
+            "configurations": ["Chill Debug", "Yarn Encore Dev (Watch)"]
+        }
+    ]
+}

.vscode/tasks.json

@@ -0,0 +1,23 @@
+{
+    "tasks": [
+        {
+            "type": "shell",
+            "command": "symfony",
+            "args": [
+                "server:start",
+                "--allow-http",
+                "--no-tls",
+                "--port=8000",
+                "--allow-all-ip",
+                "-d"
+            ],
+            "label": "symfony"
+        },
+        {
+            "type": "shell",
+            "command": "yarn",
+            "args": ["encore", "dev", "--watch"],
+            "label": "webpack"
+        }
+    ]
+}

CHANGELOG.md

@@ -6,6 +6,300 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
 
+## v4.9.0 - 2025-12-05
+### Feature
+* ([#459](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/459)) Add a counter for invitations awaiting reply   
+### Fixed
+* ([#475](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/475)) Do not suggest a user that is no longer active in the activity form.   
+* ([#441](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/441)) Remove double display of person id in the banner when there is a deathdate   
+### DX
+* ([#280](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/280)) Add missing fixtures for proper loading of AccompanyingPeriods   
+* ([#386](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/386)) Use mkdocs with mkdocs-material instead of sphinx to build chill developer documentation   
+### UX
+* ([#456](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/456)) Display whether doc generation template is active or not in admin and order templates alphabetically   
+* ([#460](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/460)) Display calendar item info on cancel page   
+* ([#424](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/424)) Display entire comment for activity item within list   
+* ([#474](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/474)) Improve accessibility of event form   
+
+## v4.8.2 - 2025-11-26
+### Fixed
+* ([#466](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/466)) Associate activity's creator as a participant by default, and retro-actively append the creator to each activity
+   
+
+  **Schema Change**: Add columns or tables
+* Fix template parameter for update_multiple route on event participations   
+### UX
+* ([#470](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/470)) Alphabetically order userJobs and mainLocations within user creation form   
+* ([#437](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/437)) Change position and color of confirm parcours button   
+
+## v4.8.1 - 2025-11-20
+### Fixed
+* Insert name of file as the document title when uploading   
+* Add missing path paramater 'id' for editing multiple participations   
+* ([#471](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/471)) Hide the display of inactive user groups in the api
+   
+
+## v4.8.0 - 2025-11-17
+### Feature
+* ([#461](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/461)) Make a calendar item on the 'mes rendez-vous' page clickable. Clicking will navigate to the edit page of the calendar item.   
+### Fixed
+* ([#463](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/463)) Display calendar items for which an invite was accepted on the mes rendez-vous page   
+* Improve accessibility on login page
+   
+### UX
+* ([#449](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/449)) Remove the label if there is only one scope and no scope picking field is displayed.   
+
+## v4.7.0 - 2025-11-10
+### Feature
+* ([#385](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/385)) Create invitation list in user menu   
+* ([#404](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/404)) Add columns for comments linked to an activity in the activity list export   
+### Fixed
+* ([#451](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/451)) Fix: display also social actions linked to parents of the selected social issue   
+* ([#453](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/453)) Fix: export actions and their results in csv even when action does not have any goals attached to it.   
+* Fix the possibility to delete a workflow   
+
+  **Schema Change**: Drop or rename table or columns, or enforce new constraint that must be manually fixed
+* ([#457](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/457)) Fix the fusion of thirdparty properties that are located in another schema than public for TO_ONE relations + add extra loop for MANY_TO_MANY relations where thirdparty is the source instead of the target   
+* ([#428](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/428)) Fix suggestion of referrer when creating notification for accompanyingPeriodWorkDocument   
+### DX
+* Send notifications log to dedicated channel, if it exists
+   
+### UX
+* ([#425](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/425)) Change the terms 'cercle' and 'centre' to 'service', and 'territoire' respectively.   
+* ([#542](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/542)) Improve the ux for selecting whether user wants to be notified of the final step of a workflow or all steps   
+* Expand timeSpent choices for evaluation document and translate them to user locale or fallback 'fr'   
+* ([#455](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/455)) Change the order of display for results and objectives in the social work/action form   
+* Wrap text when it is too long within badges   
+
+## v4.6.1 - 2025-10-27
+### Fixed
+* Fix export case where no 'reason' is picked within the PersonHavingActivityBetweenDateFilter.php   
+
+## v4.6.0 - 2025-10-15
+### Feature
+* ([#423](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/423)) Create environment banner that can be activated and configured depending on the image deployed   
+* ([#394](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/394)) Only show active workflow on the page "my tracked workflow"   
+### Fixed
+* Fix loading of classLists in SocialIssuesAcc.vue, ensure elements are present   
+* Fix the rendering of list of StoredObjectVersions, where there are kept version (before converting to pdf) and intermediate versions deleted   
+* ([#434](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/434)) Notification: fix editing of sent notification by removing form.addressesEmails, a field that no longer exists   
+* Fix loading of social issues and social actions within vue component   
+* ([#446](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/446)) Add unique condition on stored object filename, with cleaning step on existing duplicate filenames   
+
+  **Schema Change**: Drop or rename table or columns, or enforce new constraint that must be manually fixed
+* [workflow] take permissions into account to delete the workflow attachment   
+* ([#448](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/448)) Fix the execution of daily cronjob notification, when the previous last execution storage was invalid   
+
+## v4.5.1 - 2025-10-03
+### Fixed
+* Add missing javascript dependency   
+* Add exception handling for conversion of attachment on sending external, when documens are already in pdf   
+
+## v4.5.0 - 2025-10-03
+### Feature
+* Only allow delete of attachment on workflows that are not final   
+* Move up signature buttons on index workflow page for easier access   
+* Filter out document from attachment list if it is the same as the workflow document   
+* Block edition on attached document on workflow, if the workflow is finalized or sent external   
+* Convert workflow's attached document to pdf while sending them external   
+* After a signature is canceled or rejected, going to a waiting page until the post-process routines apply a workflow transition   
+### Fixed
+* ([#426](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/426)) Increased the number of required characters when setting a new password in Chill from 9 to 14 - GDPR compliance   
+* Fix permissions on storedObject which are subject by a workflow   
+### DX
+* Introduce a WaitingScreen component to display a waiting screen   
+
+## v4.4.2 - 2025-09-12
+### Fixed
+* Fix document generation and workflow generation do not work on accompanying period work documents   
+
+## v4.4.1 - 2025-09-11
+### Fixed
+* fix translations in duplicate evaluation document modal and realign close modal button   
+
+## v4.4.0 - 2025-09-11
+### Feature
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Allow the merge of two accompanying period works   
+* ([#369](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/369)) Duplication of a document to another accompanying period work evaluation   
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Fusion of two accompanying period works   
+### Fixed
+* Fix display of 'duplicate' and 'merge' buttons in CRUD templates   
+* Fix saving notification preferences in user's profile   
+
+## v4.3.0 - 2025-09-08
+### Feature
+* ([#409](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/409)) Add 45 and 60 min calendar ranges   
+* Add a command to generate a list of permissions   
+* ([#412](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/412)) Add an absence end date   
+
+  **Schema Change**: Add columns or tables
+### Fixed
+* fix date formatting in calendar range display   
+* Change route URL to avoid clash with person duplicate controller method   
+
+## v4.2.1 - 2025-09-03
+### Fixed
+* Fix exports to work with DirectExportInterface   
+### DX
+* Improve error message when a stored object cannot be written on local disk
+   
+
+## v4.2.0 - 2025-09-02
+### Feature
+* ([#64](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/64)) Add external identifier for a Person
+
+  **Schema Change**: Add columns or tables
+* ([#330](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/330) Allow users to choose for which notifications they want to receive an email
+### Fixed
+* ([#422](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/422)) Fixed html layout of pages for recovering password
+* Fix typo in 'uncheckAll' script for centers selection
+* Fix incorrect parameter name in event details link
+
+## v4.1.0 - 2025-08-26
+### Feature
+* ([#400](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/400)) Add filter to social actions list to filter out actions where current user intervenes   
+* ([#399](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/399)) Show filters on list pages unfolded by default   
+* Expansion of event module with new fields in the creation form: thematic, internal/external animator, responsable, and budget elements. Filtering options in the event list + adapted exports   
+
+  **Schema Change**: Add columns or tables
+### Fixed
+* ([#382](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/382)) adjust display logic for accompanying period dates, include closing date if period is closed.   
+* ([#384](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/384)) add min and step attributes to integer field in DateIntervalType   
+### UX
+* Limit display of participations in event list   
+
+## v4.0.2 - 2025-07-09
+### Fixed
+* Fix add missing translation   
+* Fix the transfer of evaluations and documents during of accompanyingperiodwork   
+
+## v4.0.1 - 2025-07-08
+### Fixed
+* Fix package.json for compilation
+   
+
+## v4.0.0 - 2025-07-08
+### Feature
+* ([#359](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/359)) Allow the merge of two accompanying period works
+### Fixed
+* ([#390](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/390)) Display the list of participant in the results, even if there is only one participant and that the search result display the requestor
+* Fix admin entity edit actions for event admin entities and activity reason (category) entities
+* Fix translations for social action fields in admin form: results, goals, evaluations
+### DX
+* Rewrite exports to run them asynchronously
+
+  **Schema Change**: Add columns or tables
+* Allow TranslatableMessage in flash messages
+### UX
+* Improve labeling of fields in person resource creation form
+
+
+**Release notes**
+
+- Add new methods to serialize data using the rector rule
+- Remove all references to the Request in filters, aggregators, filters. Actually, the most frequent occurence is `$security->getUser()`.
+- Refactor manually the initializeQuery method
+- Remove the injection of ExportManager into the constructor of each export element:
+
+  ```diff
+
+  - class MyFormatter implements FormatterInterface
+  + class MyFormatter implements FormatterInterface, \Chill\MainBundle\Export\ExportManagerAwareInterface
+  {
+  +    use \Chill\MainBundle\Export\Helper\ExportManagerAwareTrait;
+
+  -    public function __construct(private ExportManager $exportmanager) {}
+
+       public function MyMethod(): void
+       {
+  -          $this->exportManager->getFilter('alias');
+  +          $this->getExportManager()->getFilter('alias');
+       }
+  }
+  ```
+- configure messenger to handle export in a queue:
+
+```diff
+# config/packages/messenger.yaml
+framework:
+    messenger:
+        routing:
++            'Chill\MainBundle\Export\Messenger\ExportRequestGenerationMessage': priority
+```
+
+- add missing methods to exports, aggregators, filters, formatter:
+
+  ```php
+  public function normalizeFormData(array $formData): array;
+
+  public function denormalizeFormData(array $formData, int $fromVersion): array;
+  ```
+
+  There are rector rules to generate those methods:
+
+  - `Chill\Utils\Rector\Rector\ChillBundleAddNormalizationMethodsOnExportRector`
+
+  See:
+
+  ```php
+  // upgrade chill exports
+  $rectorConfig->rules([\Chill\Utils\Rector\Rector\ChillBundleAddNormalizationMethodsOnExportRector::class]);
+  ```
+
+  This rule will create most of the work necessary, but some manuals changes are still necessary:
+
+  - we must set manually the correct repository for method `denormalizeDoctrineEntity`;
+  - when the form data contains some entities, and the form type is not one of EntityType::class, PickUserDynamicType::class, PickUserLocationType::class, PickThirdpartyDynamicType::class, Select2CountryType::class, then we must handle the normalization manually (using the `\Chill\MainBundle\Export\ExportDataNormalizerTrait`)
+
+
+
+## v3.12.1 - 2025-06-30
+### Fixed
+* Fix loading of the list of documents   
+
+## v3.12.0 - 2025-06-30
+### Feature
+* ([#377](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/377)) Add the document file name to the document title when a user upload a document, unless there is already a document title.   
+* Add desactivation date for social action and issue csv export   
+* Add Emoji and Fullscreen feature to ckeditor configuration   
+* ([#321](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/321)) Create editor which allow us to toggle between rich and simple text editor   
+* Do not remove workflow which are automatically canceled after staling for more than 30 days   
+### Fixed
+* ([#376](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/376)) trying to prevent bug of typeerror in doc-history + improved display of document history   
+* ([#381](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/381)) Display previous participation in acc course work even if the person has left the acc course   
+* ([#372](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/372)) Fix display of text in calendar events   
+* Add missing translation for user_group.no_user_groups   
+* Fix admin entity edit actions for event admin entities and activity reason (category) entities   
+* ([#392](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/392)) Allow null and cast as string to setContent method for NewsItem
+   
+* ([#393](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/393)) Doc Generation: the "dump only" method send the document as an email attachment.   
+### DX
+* ([#352](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/352)) Remove dead code for wopi-link module   
+* Replace library node-sass by sass, and upgrade bootstrap to version 5.3 (yarn upgrade / install is required)   
+### UX
+* ([#374](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/374)) Remove default filter in_progress for the page 'my tasks'; Allows for new tasks to be displayed upon opening of the page   
+* Improve labeling of fields in person resource creation form   
+
+## v3.11.0 - 2025-04-17
+### Feature
+* ([#365](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/365)) Add counters of actions and activities, with 2 boxes to (1) show the number of active actions on total actions and (2) show the number of activities in a accompanying period, and pills in menus for showing the number of active actions and the number of activities.
+* ([#364](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/364)) Added a second phone number "telephone2" to the thirdParty entity. Adapted twig templates and vuejs apps to handle this phone number
+
+  **Schema Change**: Add columns or tables
+* Signature: add a button to go directly to the signature zone, even if there is only one
+### Fixed
+* Fixed wrong translations in the on-the-fly for creation of thirdParty
+* Fixed update of phone number in on-the-fly edition of thirdParty
+* Fixed closing of modal when editing thirdParty in accompanying course works
+* Shorten the delay between two execution of AccompanyingPeriodStepChangeCronjob, to ensure at least one execution in a day
+* ([#102](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/102)) Fix display of title in document list
+* When cleaning the old stored object versions, do not throw an error if the stored object is not found on disk
+* Add consistent log prefix and key to logs when stale workflows are automatically canceled
+* ([#380](https://gitlab.com/Chill-Projet/chill-bundles/-/issues/380)) Remove the "not null" validation constraint on recently added properties on HouseholdComposition
+
+### DX
+* Add new chill-col style for displaying title and aside in a flex table
+
 ## v3.10.3 - 2025-03-18
 ### DX
 * Eslint fixes   

CONVENTIONS-fr.md

@@ -54,7 +54,7 @@ Arborescence:
     - person
     - personvendee
     - household_edit_metadata
-        - index.js
+        - index.ts
 ```
 
 ## Organisation des feuilles de styles

assets/translator.ts

@@ -1,7 +1,12 @@
-import { trans, setLocale, setLocaleFallbacks } from "./ux-translator";
+import {
+  trans,
+  setLocale,
+  getLocale,
+  setLocaleFallbacks,
+} from "./ux-translator";
 
-setLocaleFallbacks({"en": "fr", "nl": "fr", "fr": "en"});
-setLocale('fr');
+setLocaleFallbacks({ en: "fr", nl: "fr", fr: "en" });
+setLocale("fr");
 
-export { trans };
-export * from '../var/translations';
+export { trans, getLocale };
+export * from "../var/translations";

composer.json

@@ -7,6 +7,13 @@
         "chill",
         "social worker"
     ],
+    "repositories": [{
+        "type": "path",
+        "url": "./packages/ChillZimbraBundle",
+        "options": {
+            "symlink": true
+        }
+    }],
     "require": {
         "php": "^8.2",
         "ext-dom": "*",
@@ -14,7 +21,8 @@
         "ext-openssl": "*",
         "ext-redis": "*",
         "ext-zlib": "*",
-        "champs-libres/wopi-bundle": "dev-master@dev",
+        "chill-project/chill-zimbra-bundle": "@dev",
+        "champs-libres/wopi-bundle": "dev-symfony-v5@dev",
         "champs-libres/wopi-lib": "dev-master@dev",
         "doctrine/data-fixtures": "^1.8",
         "doctrine/doctrine-bundle": "^2.1",
@@ -54,6 +62,7 @@
         "symfony/http-client": "^5.4",
         "symfony/http-foundation": "^5.4",
         "symfony/intl": "^5.4",
+        "symfony/loco-translation-provider": "^6.0",
         "symfony/mailer": "^5.4",
         "symfony/messenger": "^5.4",
         "symfony/mime": "^5.4",
@@ -133,6 +142,7 @@
             "Chill\\TaskBundle\\": "src/Bundle/ChillTaskBundle",
             "Chill\\ThirdPartyBundle\\": "src/Bundle/ChillThirdPartyBundle",
             "Chill\\WopiBundle\\": "src/Bundle/ChillWopiBundle/src",
+            "Chill\\TicketBundle\\": "src/Bundle/ChillTicketBundle/src",
             "Chill\\Utils\\Rector\\": "utils/rector/src"
         }
     },

config/bundles.php

@@ -2,7 +2,6 @@
 
 return [
     Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
-    loophp\PsrHttpMessageBridgeBundle\PsrHttpMessageBridgeBundle::class => ['all' => true],
     ChampsLibres\WopiBundle\WopiBundle::class => ['all' => true],
     Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
     Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle::class => ['dev' => true, 'test' => true],
@@ -35,6 +34,9 @@ return [
     Chill\ThirdPartyBundle\ChillThirdPartyBundle::class => ['all' => true],
     Chill\BudgetBundle\ChillBudgetBundle::class => ['all' => true],
     Chill\WopiBundle\ChillWopiBundle::class => ['all' => true],
+    Chill\TicketBundle\ChillTicketBundle::class => ['all' => true],
     Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true],
     Symfony\UX\Translator\UxTranslatorBundle::class => ['all' => true],
+    loophp\PsrHttpMessageBridgeBundle\PsrHttpMessageBridgeBundle::class => ['all' => true],
+    Chill\ZimbraBundle\ChillZimbraBundle::class => ['all' => true],
 ];

config/packages/chill.yaml

@@ -1,6 +1,13 @@
 chill_main:
-    available_languages: [ '%env(resolve:LOCALE)%', 'en' ]
+    available_languages: [ '%env(resolve:LOCALE)%', 'en', 'nl' ]
     available_countries: ['BE', 'FR']
+    top_banner:
+        visible: false
+        text:
+            fr: 'Vous travaillez actuellement avec la version de PRÉ-PRODUCTION.'
+            nl: 'Je werkt momenteel in de PRE-PRODUCTIE versie'
+        color: '#353535'
+        background_color: '#d8bb48'
     notifications:
         from_email: '%env(resolve:NOTIFICATION_FROM_EMAIL)%'
         from_name: '%env(resolve:NOTIFICATION_FROM_NAME)%'
@@ -17,6 +24,7 @@ chill_main:
     acl:
         form_show_scopes: true
         form_show_centers: true
+        filter_stats_by_center: true
     access_global_history: false
     access_user_change_password: true
     access_permissions_group_list: true

config/packages/chill_aside_activity.yaml

@@ -0,0 +1,2 @@
+chill_aside_activity:
+    show_concerned_persons_count: hidden

config/packages/chill_doc_store.yaml

@@ -1,5 +1,5 @@
 chill_doc_store:
-    use_driver: openstack
+    use_driver: local_storage
     local_storage:
         storage_path: '%kernel.project_dir%/var/storage'
     openstack:

config/packages/chill_ticket.yaml

@@ -0,0 +1,5 @@
+chill_ticket:
+    ticket:
+        person_per_ticket:    one # One of "one"; "many"
+        response_time_exceeded_delay: PT12H
+

config/packages/doctrine_migrations_chill.yaml

@@ -14,6 +14,7 @@ doctrine_migrations:
         'Chill\Migrations\Calendar': '@ChillCalendarBundle/migrations'
         'Chill\Migrations\Budget': '@ChillBudgetBundle/migrations'
         'Chill\Migrations\Report': '@ChillReportBundle/migrations'
+        'Chill\Migrations\Ticket': '@ChillTicketBundle/migrations'
     all_or_nothing:
         true
 

config/packages/messenger.yaml

@@ -5,7 +5,6 @@ framework:
 
         # Uncomment this (and the failed transport below) to send failed messages to this transport for later handling.
         failure_transport: failed
-
         transports:
             # those transports are added by chill-bundles recipes
             sync: sync://
@@ -19,7 +18,9 @@ framework:
                         async: ~
                     auto_setup: true
 
-            priority: '%env(MESSENGER_TRANSPORT_DSN)%/priority'
+            priority:
+                dsn: '%env(MESSENGER_TRANSPORT_DSN)%/priority'
+
             # end of transports added by chill-bundles recipes
             # https://symfony.com/doc/current/messenger.html#transport-configuration
             failed: 'doctrine://default?queue_name=failed'
@@ -61,6 +62,11 @@ framework:
             'Chill\MainBundle\Workflow\Messenger\PostSignatureStateChangeMessage': priority
             'Chill\MainBundle\Workflow\Messenger\PostPublicViewMessage': async
             'Chill\MainBundle\Service\Workflow\CancelStaleWorkflowMessage': async
+            'Chill\MainBundle\Notification\Email\NotificationEmailMessages\SendImmediateNotificationEmailMessage': async
+            'Chill\MainBundle\Export\Messenger\ExportRequestGenerationMessage': priority
+            'Chill\MainBundle\Export\Messenger\RemoveExportGenerationMessage': async
+            'Chill\MainBundle\Notification\Email\NotificationEmailMessages\ScheduleDailyNotificationDigestMessage': async
+            'Chill\TicketBundle\Messenger\PostTicketUpdateMessage': async
             # end of routes added by chill-bundles recipes
             # Route your messages to the transports
             # 'App\Message\YourMessage': async

config/packages/translation.yaml

@@ -1,7 +1,12 @@
+# config/packages/translation.yaml
 framework:
-    default_locale: en
+    default_locale: '%env(resolve:LOCALE)%'   # LOCALE=fr in .env
     translator:
         default_path: '%kernel.project_dir%/translations'
         fallbacks:
-            - en
+            - '%env(resolve:LOCALE)%'        # fr
         providers:
+            loco:
+                dsn: '%env(LOCO_DSN)%'
+                domains: [ 'messages' ]
+                locales: [ 'fr', 'nl' ]

config/packages/translation_chill.yaml

@@ -1,4 +0,0 @@
-framework:
-    default_locale:  '%env(resolve:LOCALE)%'
-    translator:
-        fallbacks: [ '%env(resolve:LOCALE)%' ]

config/packages/workflow_chill.yaml

@@ -220,6 +220,7 @@ framework:
                         - attenteModification
                         - attenteMiseEnForme
                         - attenteValidationMiseEnForme
+                        - attenteSignature
                         - attenteVisa
                         - postSignature
                         - attenteTraitement

config/routes/chill_ticket.yaml

@@ -0,0 +1,2 @@
+chill_ticket_bundle:
+    resource: '@ChillTicketBundle/config/routes.yaml'

docs/Makefile

@@ -1,177 +1,34 @@
-# Makefile for Sphinx documentation
+# Makefile for MkDocs documentation
 #
 
 # You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = build
+MKDOCS       = mkdocs
+BUILDDIR     = site
 
-# User-friendly check for sphinx-build
-ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
-$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+# User-friendly check for mkdocs
+ifeq ($(shell which $(MKDOCS) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(MKDOCS)' command was not found. Make sure you have MkDocs installed with 'pip install mkdocs mkdocs-material', then make sure the mkdocs executable is in your PATH.)
 endif
 
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+.PHONY: help clean html build serve
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+	@echo "  html       to build the documentation (same as build)"
+	@echo "  build      to build the documentation"
+	@echo "  serve      to start the development server"
+	@echo "  clean      to clean the build directory"
 
 clean:
 	rm -rf $(BUILDDIR)/*
 
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+html: build
+
+build:
+	$(MKDOCS) build
 	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/."
 
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/chill-doc.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/chill-doc.qhc"
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/chill-doc"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/chill-doc"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-latexpdfja:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through platex and dvipdfmx..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
-xml:
-	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
-	@echo
-	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-pseudoxml:
-	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
-	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
+serve:
+	$(MKDOCS) serve
+	@echo "Development server started at http://127.0.0.1:8000/"

docs/README.md

@@ -10,20 +10,26 @@ Compilation into HTML
 
 To compile this documentation :
 
-1. Install [sphinx-doc](http://sphinx-doc.org)
+1. Install [MkDocs](https://www.mkdocs.org/) and MkDocs Material
     ``` bash
             $ virtualenv .venv # creation of the virtual env (only the first time)
             $ source .venv/bin/activate # activate the virtual env
     (.venv) $ pip install -r requirements.txt
     ```
 2. Install submodules : $ git submodule update --init;
-3. run `make html` from the root directory
-4. The base file is located on build/html/index.html
+3. run `make html` or `mkdocs build` from the root directory
+4. The base file is located on site/index.html
     ``` bash
-    $ cd build/html
+    $ cd site
     $ python -m http.server 8888 # will serve the site on the port 8888
     ```
 
+Alternatively, you can use the built-in development server:
+``` bash
+(.venv) $ mkdocs serve
+```
+This will start a development server at http://127.0.0.1:8000/ with live reload.
+
 Contribute
 ===========
 

docs/mkdocs.yml

@@ -0,0 +1,137 @@
+site_name: Chill Documentation
+site_description: Documentation for Chill - A free software for social workers
+site_url: https://docs.chill.social
+repo_url: https://gitlab.com/Chill-project/chill-bundles
+repo_name: Chill-project/chill-bundles
+
+docs_dir: source
+
+copyright: Copyright © 2014-2024 Champs-Libres Cooperative SCRLFS - GNU Free Documentation License v1.3
+
+theme:
+  name: material
+  language: en
+  features:
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.sections
+    - navigation.expand
+    - navigation.path
+    - navigation.top
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+    - content.code.copy
+    - content.code.annotate
+
+  palette:
+    # Palette toggle for light mode
+    - scheme: default
+      primary: blue
+      accent: blue
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+
+    # Palette toggle for dark mode
+    - scheme: slate
+      primary: blue
+      accent: blue
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+
+  font:
+    text: Roboto
+    code: Roboto Mono
+
+plugins:
+  - search
+  - autorefs
+
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - toc:
+      permalink: true
+  - tables
+  - attr_list
+  - md_in_html
+
+nav:
+  - Home: index.md
+  - Installation:
+    - installation/index.md
+    - Development: installation/installation-development.md
+    - Production: installation/installation-production.md
+    - Document Storage: installation/document-storage.md
+    - Load Addresses: installation/load-addresses.md
+    - Production Setup: installation/prod.md
+    - Calendar SMS: installation/prod-calendar-sms-sending.md
+    - MS Graph Configuration: installation/msgraph-configure.md
+    - Enable Collabora: installation/enable-collabora-for-dev.md
+  - Development:
+    - development/index.md
+    - Access Control: development/access_control_model.md
+    - API: development/api.md
+    - Assets: development/assets.md
+    - Code Quality: development/code-quality.md
+    - Create Bundle: development/create-a-new-bundle.md
+    - Cronjobs: development/cronjob.md
+    - CRUD: development/crud.md
+    - Database Principles: development/database-principles.md
+    - Embeddable Comments: development/embeddable-comments.md
+    - Entity Info: development/entity-info.md
+    - ESLint: development/es-lint.md
+    - Exports: development/exports.md
+    - FAQ: development/FAQ.md
+    - Forms: development/forms.md
+    - Localisation: development/localisation.md
+    - Logging: development/logging.md
+    - Manual:
+      - development/manual/index.md
+      - Routing and Menus: development/manual/routing-and-menus.md
+    - Menus: development/menus.md
+    - Messages to Users: development/messages-to-users.md
+    - Migrations: development/migrations.md
+    - Pagination: development/pagination.md
+    - Render Entity: development/render-entity.md
+    - Routing: development/routing.md
+    - Run Tests: development/run-tests.md
+    - Searching: development/searching.md
+    - Timelines: development/timelines.md
+    - Useful Snippets: development/useful-snippets.md
+    - User Interface:
+      - CSS Classes: development/user-interface/css-classes.md
+      - JS Functions: development/user-interface/js-functions.md
+      - Layout Template: development/user-interface/layout-template-usage.md
+      - Widgets: development/user-interface/widgets.md
+  - Bundles:
+    - bundles/index.md
+    - Activity: bundles/activity.md
+    - Custom Fields: bundles/custom-fields.md
+    - Event: bundles/event.md
+    - Group: bundles/group.md
+    - LDAP: bundles/ldap.md
+    - Main: bundles/main.md
+    - Person: bundles/person.md
+    - Report: bundles/report.md
+
+extra:
+  social:
+    - icon: fontawesome/brands/gitlab
+      link: https://gitlab.com/Chill-project
+    - icon: fontawesome/solid/comments
+      link: https://app.element.io/#/room/#chill-social-admin:matrix.org

docs/requirements.txt

@@ -1,7 +1,4 @@
-docutils==0.13.1
-Pygments==2.2.0
-sphinx==1.8.5
-Jinja2<3.1
-git+https://github.com/fabpot/sphinx-php.git@v2.0.2#egg_name=sphinx-php
-jsx-lexer===0.0.8
-sphinx_rtd_theme==0.5.0
+mkdocs>=1.5.3
+mkdocs-material>=9.4.0
+pymdown-extensions>=10.3.0
+mkdocs-autorefs>=0.5.0

docs/source/_static/bundles/docStore/doc_store_classes.puml

@@ -23,8 +23,8 @@ class "Document" {
     - text description
     - ArrayCollection_DocumentCategory categories
     - varchar_150 content #link to openstack
-    - Center center
-    - Cercle cercle
+    - Territoire territoire
+    - Service service
     - User user
     - DateTime date # Creation date
 }

docs/source/_static/code/exports/BirthdateFilter.php

@@ -12,6 +12,7 @@ declare(strict_types=1);
 namespace Chill\PersonBundle\Export\Filter;
 
 use Chill\MainBundle\Export\ExportElementValidatedInterface;
+use Chill\MainBundle\Export\ExportGenerationContext;
 use Chill\MainBundle\Export\FilterInterface;
 use DateTime;
 use Doctrine\ORM\Query\Expr;
@@ -20,6 +21,7 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
 
 class BirthdateFilter implements ExportElementValidatedInterface, FilterInterface
 {
+    use \Chill\MainBundle\Export\ExportDataNormalizerTrait;
     // add specific role for this filter
     public function addRole(): ?string
     {
@@ -28,7 +30,7 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
     }
 
     // here, we alter the query created by Export
-    public function alterQuery(\Doctrine\ORM\QueryBuilder $qb, $data)
+    public function alterQuery(\Doctrine\ORM\QueryBuilder $qb, $data, \Chill\MainBundle\Export\ExportGenerationContext $exportGenerationContext): void
     {
         $where = $qb->getDQLPart('where');
         // we create the clause here
@@ -52,13 +54,13 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
     }
 
     // we give information on which type of export this filter applies
-    public function applyOn()
+    public function applyOn(): string
     {
         return 'person';
     }
 
     // we build a form to collect some parameters from the users
-    public function buildForm(\Symfony\Component\Form\FormBuilderInterface $builder)
+    public function buildForm(\Symfony\Component\Form\FormBuilderInterface $builder): void
     {
         $builder->add('date_from', DateType::class, [
             'label' => 'Born after this date',
@@ -74,6 +76,18 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
             'format' => 'dd-MM-yyyy',
         ]);
     }
+    public function getNormalizationVersion(): int
+    {
+        return 1;
+    }
+    public function normalizeFormData(array $formData): array
+    {
+        return ['date_from' => $this->normalizeDate($formData['date_from']), 'date_to' => $this->normalizeDate($formData['date_to'])];
+    }
+    public function denormalizeFormData(array $formData, int $fromVersion): array
+    {
+        return ['date_from' => $this->denormalizeDate($formData['date_from']), 'date_to' => $this->denormalizeDate($formData['date_to'])];
+    }
     public function getFormDefaultData(): array
     {
         return ['date_from' => new DateTime(), 'date_to' => new DateTime()];
@@ -81,7 +95,7 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
 
     // here, we create a simple string which will describe the action of
     // the filter in the Response
-    public function describeAction($data, $format = 'string')
+    public function describeAction($data, ExportGenerationContext $context): string|\Symfony\Contracts\Translation\TranslatableInterface|array
     {
         return ['Filtered by person\'s birtdate: '
             . 'between %date_from% and %date_to%', [
@@ -90,7 +104,7 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
             ], ];
     }
 
-    public function getTitle()
+    public function getTitle(): string|\Symfony\Contracts\Translation\TranslatableInterface
     {
         return 'Filter by person\'s birthdate';
     }
@@ -99,7 +113,7 @@ class BirthdateFilter implements ExportElementValidatedInterface, FilterInterfac
     // is executed here. This function is added by the interface
     // `ExportElementValidatedInterface`, and can be ignore if there is
     // no need for a validation
-    public function validateForm($data, ExecutionContextInterface $context)
+    public function validateForm($data, ExecutionContextInterface $context): void
     {
         $date_from = $data['date_from'];
         $date_to = $data['date_to'];

docs/source/_static/code/exports/CountPerson.php

@@ -36,6 +36,18 @@ class CountPerson implements ExportInterface
     {
         // this export does not add any form
     }
+    public function getNormalizationVersion(): int
+    {
+        return 1;
+    }
+    public function normalizeFormData(array $formData): array
+    {
+        return [];
+    }
+    public function denormalizeFormData(array $formData, int $fromVersion): array
+    {
+        return [];
+    }
     public function getFormDefaultData(): array
     {
         return [];
@@ -60,29 +72,29 @@ class CountPerson implements ExportInterface
         };
     }
 
-    public function getQueryKeys($data)
+    public function getQueryKeys($data): array
     {
         // this array match the result keys in the query. We have only
         // one column.
         return ['export_result'];
     }
 
-    public function getResult($query, $data)
+    public function getResult($query, $data, \Chill\MainBundle\Export\ExportGenerationContext $context): array
     {
         return $query->getQuery()->getResult(Query::HYDRATE_SCALAR);
     }
 
-    public function getTitle()
+    public function getTitle(): string|\Symfony\Contracts\Translation\TranslatableInterface
     {
         return 'Count peoples';
     }
 
-    public function getType()
+    public function getType(): string
     {
         return Declarations::PERSON_TYPE;
     }
 
-    public function initiateQuery(array $requiredModifiers, array $acl, array $data = [])
+    public function initiateQuery(array $requiredModifiers, array $acl, array $data, \Chill\MainBundle\Export\ExportGenerationContext $context): \Doctrine\ORM\QueryBuilder
     {
         // we gather all center the user choose.
         $centers = array_map(static fn ($el) => $el['center'], $acl);

docs/source/bundles/activity.md

@@ -0,0 +1,49 @@
+# Activity bundle
+
+This bundle provides the ability to record people in the software. This bundle is required by other bundle.
+
+###### Entities provided
+
+   Describe the entities provided.
+
+###### Configuration options
+
+Those options are available under `chill_activity` key.
+
+Example of configuration:
+
+```yaml
+   chill_activity:
+      form:
+         time_duration:
+            - { label: '12 minutes', seconds: 720 }
+            - { label: '30 minutes', seconds: 1800 }
+```
+
+form.time_duration *array*
+   The duration which might be suggested when the user create or update an activity. The value must be an array of object, where each object must have a `label` and a `seconds` key. The label provide which is shown to user (the label will be translated, if possible) and the seconds the duration.
+
+   Example: see the example above
+
+   Default value: the values available are 5, 10, 15, 20, 25, 30, 45 minutes, and 1 hour, 1 hour 15, 1 hour 30, 1 hour 45 and 2 hours.
+
+###### Macros
+
+## Activity reason sticker
+
+Macro file
+   `ChillActivityBundle:ActivityReason:macro.html.twig`
+Macro envelope
+   `reason(r)`
+
+   `p` is an instance of :class:`Chill\ActivityBundle\Entity\ActivityReason`
+
+When to use this macro ?
+   When you want to represent an activity reason.
+Example usage :
+
+   ```jinja
+   {% import 'ChillActivityBundle:ActivityReason:macro.html.twig' as m %}
+
+   {{ m.reason(r) }}
+   ```

docs/source/bundles/activity.rst

@@ -1,71 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _activity-bundle:
-
-Activity bundle
-###############
-
-This bundle provides the ability to record people in the software. This bundle is required by other bundle.
-
-.. contents:: Table of content
-   :local:
-
-Entities provided
-*****************
-
-.. todo::
-
-   Describe the entities provided.
-
-
-Configuration options
-*********************
-
-Those options are available under `chill_activity` key.
-
-Example of configuration:
-
-.. code-block:: yaml
-
-   chill_activity:
-      form:
-         time_duration: 
-            - { label: '12 minutes', seconds: 720 }
-            - { label: '30 minutes', seconds: 1800 }
-
-form.time_duration *array*
-   The duration which might be suggested when the user create or update an activity. The value must be an array of object, where each object must have a :code:`label` and a :code:`seconds` key. The label provide which is shown to user (the label will be translated, if possible) and the seconds the duration.
-
-   Example: see the example above
-
-   Default value: the values available are 5, 10, 15, 20, 25, 30, 45 minutes, and 1 hour, 1 hour 15, 1 hour 30, 1 hour 45 and 2 hours.
-
-.. _activity-bundle-macros:
-
-Macros
-******
-
-Activity reason sticker
-=======================
-
-Macro file
-   `ChillActivityBundle:ActivityReason:macro.html.twig`
-Macro envelope
-   :code:`reason(r)`
-
-   :code:`p` is an instance of :class:`Chill\ActivityBundle\Entity\ActivityReason`
-
-When to use this macro ?
-   When you want to represent an activity reason.
-Example usage :
-   .. code-block:: html+jinja
-
-      {% import 'ChillActivityBundle:ActivityReason:macro.html.twig' as m %}
-
-      {{ m.reason(r) }}

docs/source/bundles/custom-fields.md

@@ -1,15 +1,4 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-   
-.. _custom-fields-bundle:
-
-Custom fields bundle
-====================
+## Custom fields bundle
 
 This bundle provides the ability to add custom fields to existing entities.
 
@@ -17,79 +6,63 @@ Those custom fields contains extra data and will be stored in the DB, along with
 
 In the database, custom fields are stored in json format.
 
-.. seealso::
+   The full specification discussed [here](https://redmine.champs-libres.coop/issues/239)
 
-   The full specification discussed `here. <https://redmine.champs-libres.coop/issues/239>`_
-   
-   `JSON Type on postgresql documentation <http://www.postgresql.org/docs/9.3/static/datatype-json.html>`_
+   [JSON Type on postgresql documentation](http://www.postgresql.org/docs/9.3/static/datatype-json.html)
       The documentation of json type, which is used to store data in the database.
-   
-.. contents:: Table of contents
-   :depth: 4
-   :local:
 
-Custom Fields concepts
-----------------------
+### Custom Fields concepts
 
 Custom fields are extra data which may be added to entities by user. If a developer implements custom fields on a entity, users will be able to add more fields on this entity.
 
-Example: the `person bundle` allows to record `firstname`, `lastname`, `date of birth` fields. But users need to store information about the kind of house he has (if he owns his house, if he rents it, ...). Custom fields allows to create those fields.
+Example: the [person bundle` allows to record `firstname`, `lastname`, `date of birth` fields. But users need to store information about the kind of house he has (if he owns his house, if he rents it, ...). Custom fields allows to create those fields.
 
 Automatically, those fields are added at the person form. They are also printed in the person view and in exports.
 
-Custom fields and custom fields group
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### Custom fields and custom fields group
 
-Custom fields are associated to a custom fields group. When a user want to add custom fields on an entity, he must first create a custom fields group and associate this field with an entity. Then he may add add custom fields to this groups. 
+Custom fields are associated to a custom fields group. When a user want to add custom fields on an entity, he must first create a custom fields group and associate this field with an entity. Then he may add add custom fields to this groups.
 
 Some entities needs a **default** custom fields group. For instance, the default custom fields group will be printed on the main form for person, and will be appended on the main person view. Some bundle does not use this feature (i.e. the `report` bundle).
 
-.. note::
-
    In the future of the `person bundle`, other custom fields group will be added in forms accessible from the menu, allowing users to completely customize and separate their entities.
-   
-Allow custom fields on an entity
---------------------------------
+
+### Allow custom fields on an entity
 
 As a developer, you must allow your users to add custom fields on your entities.
 
-.. warning::
     For having custom fields, the class of the entity must contain a variable for storing the custom data. **By convention this variable must be called $cFData**
 
-
-Create a json field on your entity
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### Create a json field on your entity
 
 Declare a json field in your database :
-
-.. code-block:: yaml
-
+```bash
    Chill\CustomFieldsBundle\Entity\BlopEntity:
       type: entity
       # ...
       fields:
          cFData:
             type: json_array
-            
+```
+
 Create the field accordingly in the class logic :
 
-.. code-block:: php
-
+```bash
    namespace Chill\CustomFieldsBundle\Entity;
-   
+
    /**
    * BlopEntity
    */
    class BlopEntity
    {
-   
+
    /**
    * @var array
    */
    private $cFData;
-   
+
    /**
-   * You must set a setter in order to save automatically custom 
+   * You must set a setter in order to save automatically custom
    * fields from forms, using Form Component
    *
    * @param array $cFData
@@ -100,9 +73,9 @@ Create the field accordingly in the class logic :
       $this->cFData = $cFData;
       return $this;
    }
-   
+
    /**
-   * You also must create a getter in order to let Form 
+   * You also must create a getter in order to let Form
    * component populate form fields
    *
    * @return array
@@ -111,9 +84,9 @@ Create the field accordingly in the class logic :
    {
       return $this->cFData;
    }
-            
-Declare your customizable entity in configuration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+```
+
+##### Declare your customizable entity in configuration
 
 This step is necessary to allow user to create custom fields group associated with this entity.
 
@@ -130,26 +103,25 @@ This method is discouraged but explained first as it helps to undersand the reco
 
 Add those file under `chill_custom_fields` section :
 
-.. code-block:: yaml
-
+```yaml
    chill_custom_fields:
       customizables_entities:
          - { class: Chill\YourBundleBundle\Entity\BlopEntity, name: blop_entity }
-         
+```
+
 * The `name` allow you to define a string which is translatable. This string will appears when chill's admin will add/retrieve new customFieldsGroup.
 * The class, which is a full FQDN class path
 
 Automatically, in DependencyInjection/Extension class (recommended)
 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
-This is the recommended way for declaring customizable classes. 
+This is the recommended way for declaring customizable classes.
 
 You can prepend configuration of `custom fields bundle` from the class `YourBundle\DependencyInjection\YourBundleExtension`. **Note** that you also have to implements `Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface` on this class to make the `prepend` function being taken into account.
 
-Example here : 
-
-.. code-block:: php
+Example here :
 
+```php
     class ChillYourBundleExtension extends Extension implements PrependExtensionInterface
     {
         /**
@@ -163,48 +135,44 @@ Example here :
             }
 
             $container->prependExtensionConfig('chill_custom_fields',
-                array('customizables_entities' => 
+                array('customizables_entities' =>
                     array(
                         array(
-                            'class' => 'Chill\YourBundleBundle\Entity\BlopEntity', 
+                            'class' => 'Chill\YourBundleBundle\Entity\BlopEntity',
                             'name' => 'blop_entity',)
                    )
                )
             );
         }
     }
+```
 
 * The `name` allow you to define a string which is translatable. This string will appears when chill's admin will add/retrieve new customFieldsGroup.
 * The class, which is a full FQDN class path
 
-.. seealso::
-
-   `How to simplify configuration of multiple bundles <http://symfony.com/doc/current/cookbook/bundles/prepend_extension.html>`_
+   `How to simplify configuration of multiple bundles ](http://symfony.com/doc/current/cookbook/bundles/prepend_extension.html)
       A cookbook page about prepending configuration.
 
-
-Adding options to your custom fields groups
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### Adding options to your custom fields groups
 
 You may add options to the groups associated with an entity.
 
-In `config.yml` the declaration should be : 
-
-.. code-block:: yaml
+In `config.yml` the declaration should be :
 
+```yaml
    chill_custom_fields:
        customizables_entities:
-           - 
+           -
                class: Chill\YourBundleBundle\Entity\BlopEntity
                name: BlopEntity
                options:
                    # this will create a "myFieldKey" field as text, with a maxlength attribute to 150 (see http://symfony.com/doc/master/reference/forms/types/text.html)
-                   myFieldKey: {form_type: text, form_options: {attr: [maxlength: 150]}} 
+                   myFieldKey: {form_type: text, form_options: {attr: [maxlength: 150]}}
+```
 
-In the `PrependExtensionInterface::prepend` function, the options key will be added in the configuration definition : 
-
-.. code-block:: php
+In the `PrependExtensionInterface::prepend` function, the options key will be added in the configuration definition :
 
+```php
    class ChillYourBundleExtension extends Extension implements PrependExtensionInterface
    {
        /**
@@ -218,10 +186,10 @@ In the `PrependExtensionInterface::prepend` function, the options key will be ad
            }
 
            $container->prependExtensionConfig('chill_custom_fields',
-               array('customizables_entities' => 
+               array('customizables_entities' =>
                    array(
                        array(
-                          'class' => 'Chill\YourBundleBundle\Entity\BlopEntity', 
+                          'class' => 'Chill\YourBundleBundle\Entity\BlopEntity',
                           'name' => 'BlopEntity',
                           'options' => array(
                                 'myFieldKey' => [ 'form_type' => 'text', 'form_options' => [ 'attr' => [ 'maxlength' => 150 ] ]
@@ -231,16 +199,15 @@ In the `PrependExtensionInterface::prepend` function, the options key will be ad
            );
        }
    }
-               
-**Example :** the entity `Report` from **ReportBundle** has to pick some custom fields belonging to a group to print them in *summaries* the timeline page. The definition will use the special type `custom_fields_group_linked_custom_field` which will add a select input with all fields associated with the current custom fields group : 
+```
 
-.. code-block:: php
+**Example :** the entity `Report` from **ReportBundle** has to pick some custom fields belonging to a group to print them in *summaries* the timeline page. The definition will use the special type `custom_fields_group_linked_custom_field` which will add a select input with all fields associated with the current custom fields group :
 
+```php
    class ChillReportExtension extends Extension implements PrependExtensionInterface
    {
        /**
-        * 
-        * 
+###### *
         * @param ContainerBuilder $container
         */
        public function prepend(ContainerBuilder $container)
@@ -251,15 +218,15 @@ In the `PrependExtensionInterface::prepend` function, the options key will be ad
            }
 
            $container->prependExtensionConfig('chill_custom_fields',
-               array('customizables_entities' => 
+               array('customizables_entities' =>
                    array(
                        array(
-                          'class' => 'Chill\ReportBundle\Entity\Report', 
+                          'class' => 'Chill\ReportBundle\Entity\Report',
                           'name' => 'ReportEntity',
                           'options' => array(
                              'summary_fields' => array(
                                 'form_type' => 'custom_fields_group_linked_custom_fields',
-                                'form_options' => 
+                                'form_options' =>
                                    [
                                       'multiple' => true,
                                       'expanded' => false
@@ -271,14 +238,13 @@ In the `PrependExtensionInterface::prepend` function, the options key will be ad
            );
        }
    }
+```
 
 Note that `custom_fields_group_linked_custom_fields` does not create any input on `CustomFieldsGroup` creation : there aren't any fields associated with the custom fields just after the group creation... You have to add custom fields and associate them with the newly created group to see them appears.
 
-Rendering custom fields and custom fields group in a template
--------------------------------------------------------------
+### Rendering custom fields and custom fields group in a template
 
-.. warning::
-    Each custom field can be `active` or not. Only `active` custom fields has to be dislayed.
+Each custom field can be `active` or not. Only `active` custom fields has to be dislayed.
 
 For rendering custom fields, two function are available :
 
@@ -290,8 +256,7 @@ For rendering custom fields group, a function is available :
 
 * `chill_custom_fields_group_widget` to render the widget. It will display the custom fields of the group in a dd / dt structure.
 
-chill_custom_field_label
-^^^^^^^^^^^^^^^^^^^^^^^^
+##### chill_custom_field_label
 
 The signature is :
 
@@ -300,29 +265,23 @@ The signature is :
 
 Examples
 
-.. code-block:: jinja
-
    {{ chill_custom_field_label(customField) }}
 
-
-
-chill_custom_field_widget
-^^^^^^^^^^^^^^^^^^^^^^^^^
+##### chill_custom_field_widget
 
 The signature is :
 
 *  array **$fields** the array raw, as stored in the db
-*  CustomField **$customField** a customField instance 
+*  CustomField **$customField** a customField instance
 *  string **$documentType** the type of document. Default to `html`.
 
 Examples:
 
-.. code-block:: jinja
-
+```bash
    {{ chill_custom_field_widget(entity.customFields, customField) }}
+```
 
-chill_custom_field_is_empty
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### chill_custom_field_is_empty
 
 The signature is :
 
@@ -331,13 +290,9 @@ The signature is :
 
 Examples :
 
-.. code-block:: jinja
-
    {%- if chill_custom_field_is_empty(cFData, customField) == false -%}
 
-
-chill_custom_fields_group_widget
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### chill_custom_fields_group_widget
 
 This function only display custom fields that are `active`.
 
@@ -346,19 +301,17 @@ The signature is :
 *  array **$fields** the array raw, as stored in the db
 *  CustomFieldsGroup **$customFieldsGroup** the custom field group to render
 
-.. code-block:: jinja
-
+```bash
    {{ chill_custom_fields_group_widget(entity.cFData, entity.customFieldsGroup) }}
+```
 
-Custom Fields's form
---------------------
+### Custom Fields's form
 
 You should simply use the 'custom_field' type in a template, with the group you would like to render in the `group` option's type.
 
-Example : 
-
-.. code-block:: php
+Example :
 
+```php
    namespace Chill\ReportBundle\Form;
 
    use Symfony\Component\Form\AbstractType;
@@ -377,14 +330,14 @@ Example :
 
            $builder
                ->add('user')
-               ->add('date', 'date', 
+               ->add('date', 'date',
                    array('required' => true, 'widget' => 'single_text', 'format' => 'dd-MM-yyyy'))
                #add the custom fields :
-               ->add('cFData', 'custom_field', 
+               ->add('cFData', 'custom_field',
                    array('attr' => array('class' => 'cf-fields'), 'group' => $options['cFGroup']))
            ;
        }
-       
+
        /**
         * @param OptionsResolverInterface $resolver
         */
@@ -413,29 +366,25 @@ Example :
            return 'chill_reportbundle_report';
        }
    }
+```
 
-
-Available configuration
-------------------------
+### Available configuration
 
 Those options are available in the configuration, under the `chill_custom_field` key.
 
 Example :
-
-.. code-block:: yaml
-
+```yaml
    chill_custom_field:
       show_empty_values_in_views:  false
+```
 
 show_empty_values_in_views *boolean*:
    Allow to hide / show empty values in views. The aim of this configuration parameter is to hide (or show) empty values when :term:`custom fields group` are rendered.
 
    Default value : `true`
 
-Glossary
---------
 
-.. glossary::
+### Glossary
 
    custom fields group
       A group of custom fields

docs/source/bundles/event.md

@@ -1,24 +1,18 @@
-.. Copyright (C)  2016 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-.. _event-bundle:
+# Event bundle
 
-Event bundle
-############
-
-Template & Menu
-===============
+## Template & Menu
 
 The event bundle has a special template with a specific menu for actions on
 events. This menu is called `event`.
 
-ChillEventBundle::layout.html.twig
-----------------------------------
+### ChillEventBundle::layout.html.twig
 
 This layout extends `ChillMainBundle::layoutWithVerticalMenu.html.twig` and add the menu `event`
 
@@ -26,4 +20,4 @@ It proposes a new block :
 
 * event_content
 
-  * where to display content relative to the event.
+  * where to display content relative to the event.

docs/source/bundles/group.md

@@ -0,0 +1,33 @@
+Permission is granted to copy, distribute and/or modify this document
+   under the terms of the GNU Free Documentation License, Version 1.3
+   or any later version published by the Free Software Foundation;
+   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+   A copy of the license is included in the section entitled "GNU
+   Free Documentation License".
+
+# Group bundle
+
+Allow to group people in a group. This group may be a family, an activity group, ...
+
+###### Entities
+
+###### Macros
+
+## Group sticker
+
+Macro file
+   `ChillGroupBundle:Group:macro.html.twig`
+Macro name
+   `_render`
+Macro envelope
+   `group`, instance of :class:`Chill\GroupBundle\Entity\CGroup`
+
+When to use this macro ?
+   When you want to represent group.
+Example usage :
+
+   ```jinja
+   {% import 'ChillGroupBundle:Group:macro.html.twig' as m %}
+
+   {{ m._render(g) }}
+   ```

docs/source/bundles/group.rst

@@ -1,49 +0,0 @@
-.. Copyright (C)  2016 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _group-bundle:
-
-Group bundle
-############
-
-Allow to group people in a group. This group may be a family, an activity group, ...
-
-.. contents:: Table of content
-   :local:
-
-Entities
-********
-
-.. figure:: /_static/bundles/group/group_classes_uml.png
-
-
-.. _group-bundle-macros:
-
-Macros
-******
-
-Group sticker
-==============
-
-Macro file
-   `ChillGroupBundle:Group:macro.html.twig`
-Macro name
-   :code:`_render`
-Macro envelope
-   :code:`group`, instance of :class:`Chill\GroupBundle\Entity\CGroup`
-
-When to use this macro ?
-   When you want to represent group.
-Example usage :
-   .. code-block:: html+jinja
-
-      {% import 'ChillGroupBundle:Group:macro.html.twig' as m %}
-
-      {{ m._render(g) }}
-
-

docs/source/bundles/index.md

@@ -0,0 +1,23 @@
+Permission is granted to copy, distribute and/or modify this document
+   under the terms of the GNU Free Documentation License, Version 1.3
+   or any later version published by the Free Software Foundation;
+   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+   A copy of the license is included in the section entitled "GNU
+   Free Documentation License".
+
+# Bundles documentation
+
+You will find here documentation about bundles working with Chill.
+
+- [Main bundle](main.md)
+- [Custom Fields bundle](custom-fields.md)
+- [Person bundle](person.md)
+- [Report bundle](report.md)
+- [Activity bundle](activity.md)
+- [Group bundle](group.md)
+- [Event bundle](event.md)
+- [Ldap bundle (synchronisation between ldap and database)](ldap.md)
+
+### Your bundle here ?
+
+The contributors still do not have a policy about those bundle integration, but we would like to be very open on this subject. Please write to us [or open an issue ](https://redmine.champs-libres.coop/projects/chill/issues).

docs/source/bundles/index.rst

@@ -1,29 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-Bundles documentation
-###############################
-
-You will find here documentation about bundles working with Chill.
-
-.. toctree::
-    :maxdepth: 2
-
-    Main bundle <main.rst>
-    Custom Fields bundle <custom-fields.rst>
-    Person bundle <person.rst>
-    Report bundle <report.rst>
-    Activity bundle <activity.rst>
-    Group bundle <group.rst>
-    Event bundle <event.rst>
-    Ldap bundle (synchronisation between ldap and database) <ldap.rst>
-
-Your bundle here ?
--------------------
-
-The contributors still do not have a policy about those bundle integration, but we would like to be very open on this subject. Please write to us `or open an issue <https://redmine.champs-libres.coop/projects/chill/issues>`_.

docs/source/bundles/ldap.md

@@ -1,94 +1,70 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-.. _ldap-bundle:
-
-LDAP bundle
-###########
+# LDAP bundle
 
 This bundle binds the database with an ldap directory.
 
 The bundle synchronize the ldap directory with users in the database. It also
 provides a way to check user credentials against the ldap directory.
 
-
-.. contents:: Table of content
    :local:
 
-Current limitations
-*******************
+###### Current limitations
 
 - The length of the ldap dn must be < 255 characters
 - if the username extracted from the ldap is updated, the changes are not reflected in the database and remains the same
 
+###### Entities provided
 
-Entities provided
-*****************
+This bundle provides only one entity : :class:[Chill\\LdapBundle\\Entity\\UserLdapBinding`
 
-This bundle provides only one entity : :class:`Chill\\LdapBundle\\Entity\\UserLdapBinding`
+###### How the synchronizer works ?
 
-How the synchronizer works ?
-****************************
-
-#. The synchronizer performs a query on :code:`dn` and :code:`query` defined in the :ref:`configuration <configuration>`.
-#. For each entry returned by the query, it looks if the :code:`dn` exists in the database
+#. The synchronizer performs a query on `dn` and `query` defined in the [configuration ](configuration.md).
+#. For each entry returned by the query, it looks if the `dn` exists in the database
 
    #. If the entry does not exists :
 
-      #. the synchronizer looks for user with same username as defined by :code:`username_attr`, and bind it with the :code:`dn` if it exists.
-      #. else, a user is created with username defined by :code:`username_attr` (if the ldap contains more than one attribute, the first attribute returned is used)
+      #. the synchronizer looks for user with same username as defined by `username_attr`, and bind it with the `dn` if it exists.
+      #. else, a user is created with username defined by `username_attr` (if the ldap contains more than one attribute, the first attribute returned is used)
 
-   #. if a user exists which is already binded with the :code:`dn`, the entry is ignored.
+   #. if a user exists which is already binded with the `dn`, the entry is ignored.
 
-#. The synchronizer looks for dn existing in database and which were not returned by the query performed in 1. 
+#. The synchronizer looks for dn existing in database and which were not returned by the query performed in 1.
 
-   #. If they exists, those user are set to :code:`enabled=false`: they are not allowed to login.
+   #. If they exists, those user are set to `enabled=false`: they are not allowed to login.
 
-Installation
-************
+###### Installation
 
-This bundle requires : 
+This bundle requires :
 
 - PHP LDAP ext
-- :code:`symfony/ldap` with minimal version 3.1. Note that, currently, Chill uses Symfony 2.8: you should add the dependency on this single package manually
+- `symfony/ldap` with minimal version 3.1. Note that, currently, Chill uses Symfony 2.8: you should add the dependency on this single package manually
 
-In your composer.json, for stable version : 
-
-.. code-block:: json
+In your composer.json, for stable version :
 
    "require": {
-           // .. other dependencies 
+           // .. other dependencies
            "symfony/ldap" : "~3.1",
            "chill-project/ldap": "~1.0"
    }
 
-
-
 And for dev version :
 
-.. code-block:: json
-
    "require": {
-           // .. other dependencies 
+           // .. other dependencies
            "symfony/ldap" : "~3.1",
            "chill-project/ldap": "dev-master@dev"
    }
 
+###### Configuration
 
-.. _configuration:
-
-Configuration
-**************
-
-Configuration of the bundle
-============================
-
-.. code-block:: yaml
+## Configuration of the bundle
 
    # Default configuration for extension with alias: "chill_ldap"
    chill_ldap:
@@ -125,10 +101,7 @@ Configuration of the bundle
            # The attribute which will provide username (=login)
            username_attr:        cn
 
-
-Example : 
-
-.. code-block:: yaml
+Example :
 
    chill_ldap:
        server:
@@ -140,16 +113,12 @@ Example :
            dn: dc=champs-libres,dc=coop
            query: "(&(objectClass=inetOrgPerson)(userPassword=*))"
 
-
-Configuration of the security part of chill
-============================================
+## Configuration of the security part of chill
 
 Simply add the following config in the firewall of the security bundle :
 `chill_ldap_form_login: ~`. This config is located in `app/config/security.yml`
 
-Example of a configuration : 
-
-.. code-block:: yaml
+Example of a configuration :
 
    # in app/config/security.yml
 
@@ -168,37 +137,23 @@ Example of a configuration :
                # enable the login check by a form, against the ldap
                chill_ldap_form_login: ~ # this is the line you should add
 
-
-Note that, if you enable the login check by form **and** by the ldap, 
+Note that, if you enable the login check by form **and** by the ldap,
 the password will be checked against the database **and** against the ldap.
 If one of them match, the login will succeed.
 
-If you want to completely disable login check against the database, 
-simply remove the :code:`form_login` entry and all his options.
+If you want to completely disable login check against the database,
+simply remove the `form_login` entry and all his options.
 
-.. _command-and-crontab:
+## Command and crontab
 
-Command and crontab
-===================
-
-Synchronize the database : 
-
-.. code-block:: bash
+Synchronize the database :
 
    php app/console chill:ldap:synchronize
 
-
-For getting more debug message : 
-
-.. code-block:: bash
+For getting more debug message :
 
    php app/console chill:ldap:synchronize -vvv
 
-
-
-You should run this command regularly (using crontab or 
-`systemd timer <https://www.freedesktop.org/software/systemd/man/systemd.timer.html#>`_)
+You should run this command regularly (using crontab or
+`systemd timer ](https://www.freedesktop.org/software/systemd/man/systemd.timer.html#))
 to synchronize ldap and database automatically.
-
-
-

docs/source/bundles/main.md

@@ -1,15 +1,12 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-.. _main-bundle:
- 
-Main bundle
-###########
+
+# Main bundle
 
 This bundle is **required** for running Chill.
 
@@ -18,32 +15,24 @@ This bundle provide :
 * Access control model (users, groups, and all concepts)
 * ...
 
-
-.. warning::
-
    this section is incomplete.
 
-.. _main-bundle-macros:
+###### Macros
 
-Macros
-******
-
-Address sticker
-===============
+## Address sticker
 
 Macro file
    `ChillMainBundle:Address:macro.html.twig`
 Macro name
-   :code:`_render`
+   `_render`
 Macro envelope
-   :code:`address`, instance of :class:`Chill\MainBundle\Entity\Address`
+   `address`, instance of :class:`Chill\MainBundle\Entity\Address`
 
 When to use this macro ?
    When you want to represent an address.
 Example usage :
-   .. code-block:: html+jinja
-
-      {% import 'ChillMainBundle:Address:macro.html.twig' as m %}
-
-      {{ m._render(address) }}
+   ```jinja
+   {% import 'ChillMainBundle:Address:macro.html.twig' as m %}
 
+   {{ m._render(address) }}
+   ```

docs/source/bundles/person.md

@@ -1,65 +1,41 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _person-bundle:
-
-Person bundle
-#############
+# Person bundle
 
 This bundle provides the ability to record people in the software. This bundle is required by other bundle.
 
-.. contents:: Table of content
-   :local:
-
-Entities provided
-*****************
-
-.. todo::
+###### Entities provided
 
    describe entities provided by person bundle
-   
-   
-Search terms
-************
 
-The class `Chill\PersonBundle\Search\PersonSearch` provide the search module.
 
-Domain
-======
+###### Search terms
+
+The class [Chill\PersonBundle\Search\PersonSearch` provide the search module.
+
+## Domain
 
 The search upon "person" is provided by default. The `@person` domain search may be omitted.
 
 * `@person` is the domain search for people.
 
-
-Arguments
-=========
+## Arguments
 
 * `firstname` : provide the search on firstname. Example : `firstname:Depardieu`. May match part of the firstname (`firsname:dep` will match Depardieu)
 * `lastname` : provide the search on lastname. May match part of the lastname.
 * `birthdate` : provide the search on the birthdate. Example : `birthdate:1996-01-19`
 * `gender`: performs search on man/woman. The accepted values are `man` or `woman`.
-* `nationality` : performs search on nationality. Value must be a country code `as described in ISO 3166 <http://www.iso.org/iso/fr/home/standards/country_codes.htm>`_. Example : `nationality:FR`.
+* `nationality` : performs search on nationality. Value must be a country code `as described in ISO 3166 ](http://www.iso.org/iso/fr/home/standards/country_codes.htm). Example : [nationality:FR`.
 
-Default
-=======
+## Default
 
 The default search is performed on firstname and/or lastname. Both are concatened before search. If values are separated by spaces, the clause `AND` is used : the search `dep ge` will match 'Gérard Depardieu` or 'Jean Depagelles', but not 'Charline Depardieu' (missing 'Ge' in word).
 
-Configuration options
-*********************
+###### Configuration options
 
 Those options are available under `chill_person` key.
 
 Example of configuration:
 
-.. code-block:: yaml
-
+```yaml
    chill_person:
       validation:
          birthdate_not_after: P15Y
@@ -73,17 +49,18 @@ Example of configuration:
          marital_status: visible
          spoken_languages: hidden
          address: visible
+```
 
 birthdate_not_after *string*
-   The period duration before today during which encoding birthdate is not possible. The period is a string matching the format of `ISO_8601`, which is also use to build `DateInterval classes <http://php.net/manual/en/dateinterval.construct.php>`_.
+   The period duration before today during which encoding birthdate is not possible. The period is a string matching the format of `ISO_8601`, which is also use to build `DateInterval classes ](http://php.net/manual/en/dateinterval.construct.php).
 
-   Example: `P1D`, `P18Y`
+   Example: [P1D`, `P18Y`
 
    Default value: `P1D` which means that birthdate before the current day (= yesterday) are allowed.
 
 person_fields *array*
-   This define the visibility of some fields. By default, all fields are visible, but you can choose to hide some of them. Available keys are : 
-   
+   This define the visibility of some fields. By default, all fields are visible, but you can choose to hide some of them. Available keys are :
+
    * `nationality`
    * `country_of_birth`
    * `place_of_birth`
@@ -97,73 +74,62 @@ person_fields *array*
 
    Default value : `visible`, which means that all fields are visible.
 
-   Example: 
-
-   .. code-block:: yaml
+   Example:
 
+```yaml
       chill_person:
          person_fields:
             nationality: hidden
             email: hidden
             phonenumber: hidden
+```
 
-.. note:: 
    If all the field of a "box" are hidden, the whole box does not appears. Example: if the fields `phonenumber` and `email` are hidden, the title `Contact information` will be hidden in the UI.
 
-.. note:: 
-   If you hide multiple fields, for a better integration you may want to override the template, for a better appeareance. See `the symfony documentation <http://symfony.com/doc/current/book/templating.html#overriding-bundle-templates>`_ about this feature.
+   If you hide multiple fields, for a better integration you may want to override the template, for a better appeareance. See `the symfony documentation ](http://symfony.com/doc/current/book/templating.html#overriding-bundle-templates) about this feature.
 
-.. _person-bundle-macros:
+###### Macros
 
-Macros
-******
-
-Sticker for a person
-=====================
+## Sticker for a person
 
 Macro file
    `ChillPersonBundle:Person:macro.html.twig`
 Macro envelope
-   :code:`render(p, withLink=false)`
+   `render(p, withLink=false)`
 
-   :code:`p` is an instance of :class:`Chill\PersonBundle\Entity\Person`
+   `p` is an instance of `Chill\PersonBundle\Entity\Person`
 
-   :code:`withLink` :class:`boolean`
+   `withLink`: `boolean`
 When to use this macro ?
    When you want to represent a person.
 Example usage :
-   .. code-block:: html+jinja
+   ```jinja
+   {% import "ChillPersonBundle:Person:macro.html.twig" as person_ %}
 
-      {% import "ChillPersonBundle:Person:macro.html.twig" as person_ %}
+   {{ person_.render(person, true) }}
+   ```
 
-      {{ person_.render(person, true) }}
+###### Layout events and delegated blocks
 
-Layout events and delegated blocks
-***********************************
-
-:code:`chill_block.person_post_vertical_menu` event
-====================================================
+## `chill_block.person_post_vertical_menu` event
 
 This event is available to add content below of the vertical menu (on the right).
 
-The context is : 
+The context is :
 
-- :code:`person` : the current person which is rendered. Instance of :class:`Chill\PersonBundle\Entity\Person`
+- `person` : the current person which is rendered. Instance of `Chill\PersonBundle\Entity\Person`
 
-Widgets
-*******
+###### Widgets
 
-Add a list of person on homepage
-================================
+## Add a list of person on homepage
 
 The bundle provide a way to add a list of accompanyied person on the homepage:
 
-.. code-block:: yaml
-
+```yaml
    chill_main:
        widgets:
-           homepage: 
-               - 
+           homepage:
+               -
                    order: 10
                    widget_alias: person_list
                    person_list:
@@ -180,15 +146,11 @@ The bundle provide a way to add a list of accompanyied person on the homepage:
                        # when the view is overriden, you can add some custom fields
                        # to the view
                        custom_fields: [school-2fb5440e-192c-11e6-b2fd-74d02b0c9b55]
-  
-Commands
-********
+```
 
+###### Commands
 
-:code:`chill:person:move`
-=========================
-
-.. code-block:: txt
+## `chill:person:move`
 
 	Usage:
 		chill:person:move [options]
@@ -213,21 +175,17 @@ Commands
 
 Move all the entities associated to a person onto another one, and remove the old person.
 
-.. warning:: 
-
-  Some entities are ignored and will be deleted: 
+  Some entities are ignored and will be deleted:
 
   - the accompanying periods ;
   - the data attached to a person entity: name, address, date of birth, etc. Thos should be merge before the move.
 
-It is advised to run first the command with the :code:`dump-sql` option and, then, use the :code:`force` option.
+It is advised to run first the command with the `dump-sql` option and, then, use the `force` option.
 
 The moving and suppression is executed inside a transaction, ensuring no data loss if the migration fails.
 
-.. note::
+  Using bash and awk, it is easy to use a TSV file (values separated by a tab, not a comma) to create move commands. Assuming our file is named `twins.tsv` and contains two columns: the first one with `from` ids, and the second one with `to` ids:
 
-  Using bash and awk, it is easy to use a TSV file (values separated by a tab, not a comma) to create move commands. Assuming our file is named :code:`twins.tsv` and contains two columns: the first one with :code:`from` ids, and the second one with :code:`to` ids: 
-
-  .. code-block:: bash
-
-    awk '{ print "php app/console chill:person:move --dump-sql --from " $1 " --to " $2;}' twins.tsv 
+  ```bash
+    awk '{ print "php app/console chill:person:move --dump-sql --from " $1 " --to " $2;}' twins.tsv
+```

docs/source/bundles/report.md

@@ -0,0 +1,23 @@
+# Report bundle
+
+This bundle provides the ability to record report about people. We use custom fields to let user add fields to reports.
+
+The documentation about report is not written
+
+## Concepts
+
+## Search
+
+### Domain
+
+* `@report` is the domain search for reports.
+
+### Arguments
+
+* `date` : The date of the report
+
+### Default
+
+The report's date is the default value.
+
+An error is thrown if an argument `date` and a default is used.

docs/source/bundles/report.rst

@@ -1,46 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _report-bundle:
-
-Report bundle
-#############
-
-This bundle provides the ability to record report about people. We use custom fields to let user add fields to reports.
-
-.. contents:: Table of content
-   :local:
-
-.. todo::
-
-   The documentation about report is not writtend
-
-Concepts
-========
-
-
-Search
-======
-
-Domain
-------
-
-* `@report` is the domain search for reports.
-
-
-Arguments
----------
-
-* `date` : The date of the report
-
-Default
--------
-
-The report's date is the default value. 
-
-An error is thrown if an argument `date` and a default is used.

docs/source/development/FAQ.md

@@ -0,0 +1,23 @@
+# Frequently asked questions
+
+## Continuous integration
+
+Pipeline fails, but php-cs-fixer doesn't alert me when running it locally?
+========================================
+
+It is possible that you run php-cs-fixer on your local instance of chill and no fixes are made.
+Everything seems fine, so you push. However, once the pipeline is run in gitlab, you're notified that it failed due to php
+cs errors.
+
+In this case it's likely that you have to update your version of php-cs-fixer.
+php-cs-fixer is installed when building the docker image: https://gitea.champs-libres.be/Chill-project/chill-skeleton-basic/src/branch/main/Dockerfile#L50
+
+Consequently, to update php-cs-fixer, we have to update the image by building it again.
+
+For this the following commands can be used.
+
+```
+    docker compose build --pull php
+    # replace existing containers
+    docker compose up -d --force-recreate php
+```

docs/source/development/FAQ.rst

@@ -1,36 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.3
-or any later version published by the Free Software Foundation;
-with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled "GNU
-Free Documentation License".
-
-.. _faq:
-
-
-Frequently asked questions
-####################
-
-Continuous integration
-***********
-
-Pipeline fails, but php-cs-fixer doesn't alert me when running it locally ?
-========================================
-
-It is possible that you run php-cs-fixer on your local instance of chill and no fixes are made.
-Everything seems fine, so you push. However once the pipeline is run in gitlab, you're notified that it failed due to php
-cs errors.
-
-In this case it's likely that you have to update your version of php-cs-fixer.
-php-cs-fixer is installed when building the docker image: https://gitea.champs-libres.be/Chill-project/chill-skeleton-basic/src/branch/main/Dockerfile#L50
-
-Consequently, to update php-cs-fixer we have to update the image by building it again.
-
-For this the following commands can be used,
-
-.. code-block:: php
-
-    docker compose build --pull php
-    # replace existing containers
-    docker compose up -d --force-recreate php

docs/source/development/access_control_model.md

@@ -1,19 +1,15 @@
-.. Copyright (C)  2015 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-Access controle model
-**********************
+###### Access controle model
 
-.. contents:: Table of content
     :local:
 
-Concepts
-========
+## Concepts
 
 Every time an entity is created, viewed or updated, the software check if the user has the permission to make this action. The decision is made with three parameters :
 
@@ -23,20 +19,15 @@ Every time an entity is created, viewed or updated, the software check if the us
 
 The user must be granted access to the action on this particular entity, with this scope and center.
 
-TL;DR
-=====
+## TL;DR
 
-Resolve scope and center
-------------------------
+### Resolve scope and center
 
 In a service, resolve the center and scope of an entity
 
-.. code-block:: php
-
    use Chill\MainBundle\Security\Resolver\CenterResolverDispatcher;
    use Chill\MainBundle\Security\Resolver\ScopeResolverDispatcher;
 
-
    class MyService {
       private ScopeResolverDispatcher $scopeResolverDispatcher;
       private CenterResolverDispatcher $centerResolverDispatcher;
@@ -58,8 +49,6 @@ In a service, resolve the center and scope of an entity
 
 In twig template, resolve the center:
 
-.. code-block:: twig
-
    {# resolve a center #}
 
    {% if person|chill_resolve_center is not null%}
@@ -81,8 +70,6 @@ In twig template, resolve the center:
 
 In twig template, resolve the scope:
 
-.. code-block:: twig
-
    {% if entity|chill_is_scope_concerned %}
 
       {% if entity|chill_resolve_scope is iterable %}
@@ -98,10 +85,7 @@ In twig template, resolve the scope:
       {% endfor %}
    {%- endif -%}
 
-Build a ``Voter``
------------------
-
-.. code-block:: php
+### Build a ``Voter``
 
    <?php
 
@@ -151,7 +135,6 @@ Build a ``Voter``
                ->build();
        }
 
-
        protected function supports($attribute, $subject)
        {
            return $this->voterHelper->supports($attribute, $subject);
@@ -194,25 +177,19 @@ Build a ``Voter``
            return array();
        }
 
-
        public function getRolesWithHierarchy()
        {
            return ['PersonDocument' => $this->getRoles() ];
        }
    }
 
-
-
-
-From an user point of view
-==========================
+## From an user point of view
 
 The software is design to allow fine tuned access rights for complicated installation and team structure. The administrators may also decide that every user has the right to see all resources, where team have a more simple structure. 
 
 Here is an overview of the model.
 
-Chill can be multi-center
--------------------------
+### Chill can be multi-center
 
 Chill is designed to be installed once for social center who work with multiple teams separated, or for social services's federation who would like to share the same installation of the software for all their members. 
 
@@ -222,8 +199,7 @@ Otherwise, it is not required to create multiple center: Chill can also work for
 
 Obviously, users working in the different centers are not allowed to see the entities (_persons_, _reports_, _activities_) of other centers. But users may be attached to multiple centers: consequently they will be able to see the entities of the multiple centers they are attached to.
 
-Inside center, scope divide team
---------------------------------
+### Inside center, scope divide team
 
 Users are attached to one or more center and, inside to those center, there may exists differents scopes. The aim of those _scopes_ is to divide the whole team of social worker amongst different departement, for instance: the social team, the psychologist team, the nurse team, the administrative team, ... Each team is granted of different rights amongst scope. For instance, the social team may not see the _activities_ of the psychologist team. The administrative team may see the date & time's activities, but is not allowed to see the detail of those entities (the personal notes, ...).
 
@@ -233,9 +209,7 @@ As entities have only one scopes, if some entities must be shared across two dif
 
 Example: if some activities must be seen and updated between nurses and psychologists, the administrator will create a scope "nurse and psy" and add the ability for both team "nurse" and "psychologist" to "create", "see", and "update" the activities belonging to scope "nurse and psy".
 
-
-Where does the ``scope`` and ``center`` comes from ?
-====================================================
+## Where does the [`scope`` and ``center`` comes from ?
 
 Most often, scope and center comes from user's input:
 
@@ -256,30 +230,23 @@ But sometimes, this implementation does not fits the needs:
 
 For this reasons, associated center and scopes must be resolved programmatically. The default implementation rely on the model association, as described above. But it becomes possible to change the behaviour on different implementations.
 
-Is my entity "concerned" by scopes ?
-------------------------------------
+### Is my entity "concerned" by scopes ?
 
 Some entities are concerned by scope, some not.
 
 This is also programmatically resolved.
 
-The concepts translated into code
-===================================
+## The concepts translated into code
 
-.. figure:: /_static/access_control_model.png
    
    Schema of the access control model
 
 Chill handle **entities**, like *persons*, *reports* (associated to *persons*), *activities* (also associated to *_persons*), ... On creation, those entities are linked to one center and, eventually, to one scope. They implements the interface `HasCenterInterface`.
 
-.. note::
-
    Somes entities are linked to a center through the entity they are associated with. For instance, *activities* or *reports* are associated to a *person*, and the person is associated to a *center*. The *report*'s *center* is always the *person*'s *center*.
 
 Entities may be associated with a scope. In this case, they implement the `HasScopeInterface`.
 
-.. note::
-
    Currently, only the *person* entity is not associated with a scope. 
 
 At each step of his lifetime (creation, view of the entity and eventually of his details, update and, eventually, deletion), the right of the user are checked. To decide wether the user is granted right to execute the action, the software must decide with those elements :
@@ -291,13 +258,10 @@ At each step of his lifetime (creation, view of the entity and eventually of his
 
 All those action are executed through symfony voters and helpers. 
 
-How to check authorization ?
-============================
+## How to check authorization ?
 
 Just use the symfony way-of-doing, but do not forget to associate the entity you want to check access. For instance, in controller :  
 
-.. code-block:: php
-
    class MyController extends Controller 
    {
 
@@ -311,12 +275,9 @@ Just use the symfony way-of-doing, but do not forget to associate the entity you
 
 And in template :
 
-.. code-block:: twig
-
    {{ if is_granted('CHILL_ENTITY_SEE', entity) %}print something{% endif %}
 
-Retrieving reachable scopes and centers for a user
---------------------------------------------------
+### Retrieving reachable scopes and centers for a user
 
 The class :class:`Chill\\MainBundle\\Security\\Authorization\\AuthorizationHelperInterface` helps you to get centers and scope reachable by a user.
 
@@ -325,9 +286,7 @@ Those methods are intentionnaly build to give information about user rights:
 - getReachableCenters: to get reachable centers for a user
 - getReachableScopes : to get reachable scopes for a user
 
-
-Adding your own roles
----------------------
+### Adding your own roles
 
 Extending Chill will requires you to define your own roles and rules for your entities. You will have to define your own voter to do so.
 
@@ -336,28 +295,20 @@ To create your own roles, you should:
 * implement your own voter. This voter will have to extends the :class:`Chill\\MainBundle\\Security\\AbstractChillVoter`. As defined by Symfony, this voter must be declared as a service and tagged with `security.voter`;
 * declare the role through implementing a service tagged with `chill.role` and implementing :class:`Chill\\MainBundle\\Security\\ProvideRoleInterface`.
 
-.. note::
-
    Both operation may be done through a simple class: you can implements :class:`Chill\\MainBundle\\Security\\ProvideRoleInterface` and :class:`Chill\\MainBundle\\Security\\AbstractChillVoter` on the same class. See live example: :class:`Chill\\ActivityBundle\\Security\\Authorization\\ActivityVoter`, and similar examples in the `PersonBundle` and `ReportBundle`.
 
-.. seealso::
-
-   `How to Use Voters to Check User Permissions <http://symfony.com/doc/current/cookbook/security/voters_data_permission.html>`_
+   `How to Use Voters to Check User Permissions ](http://symfony.com/doc/current/cookbook/security/voters_data_permission.html)
 
    From the symfony cookbook
 
-   `New in Symfony 2.6: Simpler Security Voters <http://symfony.com/blog/new-in-symfony-2-6-simpler-security-voters>`_
+   [New in Symfony 2.6: Simpler Security Voters ](http://symfony.com/blog/new-in-symfony-2-6-simpler-security-voters)
 
    From the symfony blog
 
-
-Declare your role
-^^^^^^^^^^^^^^^^^^
+##### Declare your role
 
 To declare new role, implement the class :class:`Chill\\MainBundle\\Security\\ProvideRoleInterface`. 
 
-.. code-block:: php
-
    interface ProvideRoleInterface
    {
        /**
@@ -375,21 +326,15 @@ To declare new role, implement the class :class:`Chill\\MainBundle\\Security\\Pr
        public function getRolesWithoutScope();
    }
 
-
 Then declare your service with a tag `chill.role`. Example : 
 
-.. code-block:: yaml
-
        your_service:
            class: Chill\YourBundle\Security\Authorization\YourVoter
            tags:
                - { name: chill.role }
 
-
 Example of an implementation of :class:`Chill\\MainBundle\\Security\\ProvideRoleInterface`:
 
-.. code-block:: php
-
    namespace Chill\PersonBundle\Security\Authorization;
 
    use Chill\MainBundle\Security\ProvideRoleInterface;
@@ -412,13 +357,10 @@ Example of an implementation of :class:`Chill\\MainBundle\\Security\\ProvideRole
 
    }
 
-Adding role hierarchy
-^^^^^^^^^^^^^^^^^^^^^
+##### Adding role hierarchy
 
 You should prepend Symfony's security component directly from your code. 
 
-.. code-block:: php
-
    namespace Chill\ReportBundle\DependencyInjection;
    use Symfony\Component\DependencyInjection\ContainerBuilder;
    use Symfony\Component\Config\FileLocator;
@@ -450,10 +392,7 @@ You should prepend Symfony's security component directly from your code.
        }
    }
 
-
-
-Implement your voter
-^^^^^^^^^^^^^^^^^^^^
+##### Implement your voter
 
 Most of the time, Voter will check that:
 
@@ -464,7 +403,6 @@ Most of the time, Voter will check that:
 
 Thats what we call the "autorization logic". But this logic may be replace by a new one, and developers should take care of it.
 
-
 Then voter implementation should take care of:
 
 * check the access to associated entities. For instance, if an ``Activity`` is associated to a ``Person``, the voter should first check that the user can show the associated ``Person``;
@@ -472,9 +410,6 @@ Then voter implementation should take care of:
 
 This is an example of implementation:
 
-
-.. code-block:: php
-
    <?php
 
    namespace Chill\DocStoreBundle\Security\Authorization;
@@ -513,7 +448,6 @@ This is an example of implementation:
                ->build();
        }
 
-
        protected function supports($attribute, $subject)
        {
            return $this->voterHelper->supports($attribute, $subject);
@@ -553,7 +487,6 @@ This is an example of implementation:
            // ...
        }
 
-
        public function getRolesWithHierarchy()
        {
            // ...
@@ -562,8 +495,6 @@ This is an example of implementation:
 
 Then, you will have to declare the service and tag it as a voter :
 
-.. code-block:: yaml
-
    services:
        chill.report.security.authorization.report_voter:
            class: Chill\ReportBundle\Security\Authorization\ReportVoter
@@ -572,18 +503,13 @@ Then, you will have to declare the service and tag it as a voter :
            tags:
             - { name: security.voter }
 
-
-How to resolve scope and center programmatically ?
-==================================================
+## How to resolve scope and center programmatically ?
 
 In a service, resolve the center and scope of an entity
 
-.. code-block:: php
-
    use Chill\MainBundle\Security\Resolver\CenterResolverDispatcher;
    use Chill\MainBundle\Security\Resolver\ScopeResolverDispatcher;
 
-
    class MyService {
       private ScopeResolverDispatcher $scopeResolverDispatcher;
       private CenterResolverDispatcher $centerResolverDispatcher;
@@ -605,8 +531,6 @@ In a service, resolve the center and scope of an entity
 
 In twig template, resolve the center:
 
-.. code-block:: twig
-
    {# resolve a center #}
 
    {% if person|chill_resolve_center is not null%}
@@ -628,8 +552,6 @@ In twig template, resolve the center:
 
 In twig template, resolve the scope:
 
-.. code-block:: twig
-
    {% if entity|chill_is_scope_concerned %}
 
       {% if entity|chill_resolve_scope is iterable %}
@@ -645,8 +567,7 @@ In twig template, resolve the scope:
       {% endfor %}
    {%- endif -%}
 
-What is the default implementation of Scope and Center resolver ?
------------------------------------------------------------------
+### What is the default implementation of Scope and Center resolver ?
 
 By default, the implementation rely on association into entities.
 
@@ -657,16 +578,14 @@ By default, the implementation rely on association into entities.
 
 Then, the default implementation will resolve the center and scope based on the implementation in your model.
 
-How to change the default behaviour ?
--------------------------------------
+### How to change the default behaviour ?
 
 Implements those interface into services:
 
 * ``Chill\MainBundle\Security\Resolver\CenterResolverInterface``;
 * ``Chill\MainBundle\Security\Resolver\ScopeResolverInterface``;
 
-Authorization into lists and index pages
-========================================
+## Authorization into lists and index pages
 
 Due to the fact that authorization model may be overriden, "list" and "index" pages should not rely on center and scope from controller. This must be delegated to dedicated service, which will be aware of the authorization model. We call them ``ACLAwareRepository``. This service must implements an interface, in order to allow to change the implementation.
 
@@ -674,14 +593,11 @@ The controller **must not** performs any DQL or SQL query.
 
 Example in a controller:
 
-.. code-block:: php
-
    namespace Chill\TaskBundle\Controller;
 
    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
    use Chill\TaskBundle\Repository\SingleTaskAclAwareRepositoryInterface;
 
-
    final class SingleTaskController extends AbstractController
    {
 
@@ -729,11 +645,9 @@ Example in a controller:
        }
    }
 
-Writing ``ACLAwareRepository``
-------------------------------
+### Writing ``ACLAwareRepository``
 
-The ACLAwareRepository should rely on interfaces
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### The ACLAwareRepository should rely on interfaces
 
 As described above, the ACLAwareRepository will perform the query for listing entities, and take care of authorization.
 
@@ -743,9 +657,6 @@ The service must rely on this interface, and not on the default implementation.
 
 Example: at first, we design an interface for listing ``SingleTask`` entities: 
 
-
-.. code-block:: php
-
    <?php
 
    namespace Chill\TaskBundle\Repository;
@@ -782,8 +693,6 @@ Example: at first, we design an interface for listing ``SingleTask`` entities:
 
 Implements this interface and register the interface as an alias for the implementation.
 
-.. code-block:: yaml
-
    services:
        Chill\TaskBundle\Repository\SingleTaskAclAwareRepository:
            autowire: true
@@ -791,8 +700,7 @@ Implements this interface and register the interface as an alias for the impleme
 
        Chill\TaskBundle\Repository\SingleTaskAclAwareRepositoryInterface: '@Chill\TaskBundle\Repository\SingleTaskAclAwareRepository'
 
-Write the basic implementation for re-use: separate authorization logic and search logic
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+##### Write the basic implementation for re-use: separate authorization logic and search logic
 
 The logic of such repository may be separated into two logic:
 
@@ -803,8 +711,6 @@ This logic should be separated into your implementation.
 
 Considering this simple interface:
 
-.. code-block:: php
-
    interface MyEntityACLAwareRepositoryInterface {
 
        public function countByAuthorized(array $criterias): int;
@@ -815,15 +721,11 @@ Considering this simple interface:
 
 The base implementation should separate the logic to allow an easy reuse. Here, the method ``buildQuery`` build a basic query without authorization logic, which can be re-used. The authorization logic is dedicated to a private method. For ease of user, the logic of adding ordering criterias and pagination parameters (``$start`` and ``$limit``) are also delegated to a public method.
 
-
-.. code-block:: php
-
    namespace Chill\MyBundle\Repository;
 
    use Doctrine\ORM\EntityManagerInterface;
    use Doctrine\ORM\QueryBuilder;
 
-
    final class MyEntityACLAwareRepository implements MyEntityACLAwareRepositoryInterface {
 
        private EntityManagerInterface $em;
@@ -875,15 +777,12 @@ The base implementation should separate the logic to allow an easy reuse. Here,
 
 Once this logic is executed, it becomes easy to make a new implementation of the repository:
 
-.. code-block:: php
-
    namespace Chill\MyOtherBundle\Repository;
 
    use Doctrine\ORM\EntityManagerInterface;
    use Doctrine\ORM\QueryBuilder;
    use Chill\MyBundle\Repository\MyEntityACLAwareRepository
 
-
    final class AnotherEntityACLAwareRepository implements MyEntityACLAwareRepositoryInterface {
 
        private EntityManagerInterface $em;
@@ -921,14 +820,8 @@ Once this logic is executed, it becomes easy to make a new implementation of the
 
 Then, register this service and decorates the old one:
 
-.. code-block:: yaml
-
    services:
        Chill\MyOtherBundle\Repository\AnotherEntityACLAwareRepository:
            autowire: true
            autoconfigure: true
-           decorates: Chill\MyBundle\Repository\MyEntityACLAwareRepositoryInterface:
-
-
-
-
+           decorates: Chill\MyBundle\Repository\MyEntityACLAwareRepositoryInterface:

docs/source/development/api.md

@@ -1,23 +1,10 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _api:
-
-API
-###
+# API
 
 Chill provides a basic framework to build REST api.
 
-Basic configuration
-*******************
+###### Basic configuration
 
-Configure a route
-=================
+## Configure a route
 
 Follow those steps to build a REST api:
 
@@ -27,36 +14,29 @@ Follow those steps to build a REST api:
 You can also:
 
 * hook into the controller to customize some steps;
-* add more route and steps
-
-.. note::
+* add more routes and steps
 
     Useful links:
 
-    * `How to use annotation to configure serialization <https://symfony.com/doc/current/serializer.html>`_
-    * `How to create your custom normalizer <https://symfony.com/doc/current/serializer/custom_normalizer.html>`_
+    * [How to use annotation to configure serialization ](https://symfony.com/doc/current/serializer.html)
+    * [How to create your custom normalizer ](https://symfony.com/doc/current/serializer/custom_normalizer.html)
 
-Auto-loading the routes
-=======================
+## Autoloading the routes
 
 Ensure that those lines are present in your file `app/config/routing.yml`:
 
-
-.. code-block:: yaml
-
+```yaml
    chill_cruds:
        resource: 'chill_main_crud_route_loader:load'
        type: service
+```
 
+## Create your model
 
-Create your model
-=================
+Create your model in the usual way:
 
-Create your model on the usual way:
-
-.. code-block:: php
-
-   namespace Chill\PersonBundle\Entity\AccompanyingPeriod;
+```php
+namespace Chill\PersonBundle\Entity\AccompanyingPeriod;
 
    use Chill\PersonBundle\Entity\AccompanyingPeriod\OriginRepository;
    use Doctrine\ORM\Mapping as ORM;
@@ -87,16 +67,14 @@ Create your model on the usual way:
        // .. getters and setters
 
    }
+```
 
+## Configure api
 
-Configure api
-=============
+Configure the api using YAML (see the full configuration: [api_full_configuration](api_full_configuration.md)):
 
-Configure the api using Yaml (see the full configuration: :ref:`api_full_configuration`):
-
-.. code-block:: yaml
-
-   # config/packages/chill_main.yaml
+```yaml
+# config/packages/chill_main.yaml
    chill_main:
        apis:
            accompanying_period_origin:
@@ -113,15 +91,13 @@ Configure the api using Yaml (see the full configuration: :ref:`api_full_configu
                        methods:
                            GET: true
                            HEAD: true
+```
+   If you are working on a shared bundle (aka "The chill bundles"), you should define your configuration inside the class `ChillXXXXBundleExtension`, using the "prependConfig" feature:
 
-.. note::
-
-   If you are working on a shared bundle (aka "The chill bundles"), you should define your configuration inside the class :code:`ChillXXXXBundleExtension`, using the "prependConfig" feature:
-
-   .. code-block:: php
-
+```php
       namespace Chill\PersonBundle\DependencyInjection;
 
+
       use Symfony\Component\DependencyInjection\ContainerBuilder;
       use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
       use Symfony\Component\HttpFoundation\Request;
@@ -155,13 +131,13 @@ Configure the api using Yaml (see the full configuration: :ref:`api_full_configu
                           'base_role' => 'ROLE_USER',
                           'actions' => [
                               '_index' => [
-                                  'methods' => [ 
+                                  'methods' => [
                                       Request::METHOD_GET => true,
                                       Request::METHOD_HEAD => true
                                   ],
                               ],
                               '_entity' => [
-                                  'methods' => [ 
+                                  'methods' => [
                                       Request::METHOD_GET => true,
                                       Request::METHOD_HEAD => true
                                   ]
@@ -172,37 +148,35 @@ Configure the api using Yaml (see the full configuration: :ref:`api_full_configu
               ]);
           }
       }
+```
 
-The :code:`_index` and :code:`_entity` action
-*********************************************
+###### The `_index` and `_entity` action
 
-The :code:`_index` and :code:`_entity` action are default actions:
+The `_index` and `_entity` action are default actions:
 
 * they will call a specific method in the default controller;
 * they will generate defined routes:
 
 Index:
-   Name: :code:`chill_api_single_accompanying_period_origin__index`
+   Name: `chill_api_single_accompanying_period_origin__index`
 
-   Path: :code:`/api/1.0/person/accompanying-period/origin.{_format}`
+   Path: `/api/1.0/person/accompanying-period/origin.{_format}`
 
 Entity:
-   Name: :code:`chill_api_single_accompanying_period_origin__entity`
+   Name: `chill_api_single_accompanying_period_origin__entity`
 
-   Path: :code:`/api/1.0/person/accompanying-period/origin/{id}.{_format}`
+   Path: `/api/1.0/person/accompanying-period/origin/{id}.{_format}`
 
-Role
-****
+###### Role
 
-By default, the key `base_role` is used to check ACL. Take care of creating the :code:`Voter` required to take that into account.
+By default, the key `base_role` is used to check ACL. Take care of creating the `Voter` required to take that into account.
 
-For index action, the role will be called with :code:`NULL` as :code:`$subject`. The retrieved entity will be the subject for single queries.
+For index action, the role will be called with `NULL` as `$subject`. The retrieved entity will be the subject for single queries.
 
 You can also define a role for each method. In this case, this role is used for the given method, and, if any, the base role is taken into account.
 
-.. code-block:: yaml
-
-   # config/packages/chill_main.yaml
+```yaml
+# config/packages/chill_main.yaml
    chill_main:
        apis:
            accompanying_period_origin:
@@ -217,16 +191,13 @@ You can also define a role for each method. In this case, this role is used for
                        roles:
                            GET: MY_ROLE_SEE
                            HEAD: MY ROLE_SEE
+```
 
-Customize the controller
-************************
-
-You can customize the controller by hooking into the default actions. Take care of extending :code:`Chill\MainBundle\CRUD\Controller\ApiController`.
-
-
-.. code-block:: php
+###### Customize the controller
 
+You can customize the controller by hooking into the default actions. Take care of extending `Chill\MainBundle\CRUD\Controller\ApiController`.
 
+```php
    namespace Chill\PersonBundle\Controller;
 
    use Chill\MainBundle\CRUD\Controller\ApiController;
@@ -240,14 +211,14 @@ You can customize the controller by hooking into the default actions. Take care
            $qb->where($qb->expr()->gt('e.noActiveAfter', ':now'))
                ->orWhere($qb->expr()->isNull('e.noActiveAfter'));
            $qb->setParameter('now', new \DateTime('now'));
-       }     
+       }
    }
+```
 
 And set your controller in configuration:
 
-.. code-block:: yaml
-
-   chill_main:
+```yaml
+    chill_main:
        apis:
            accompanying_period_origin:
                base_path: '/api/1.0/person/accompanying-period/origin'
@@ -265,15 +236,15 @@ And set your controller in configuration:
                        methods:
                            GET: true
                            HEAD: true
+```
 
-Create your own actions
-***********************
+###### Create your own actions
 
 You can add your own actions:
 
-.. code-block:: yaml
+```yaml
 
-   chill_main:
+chill_main:
        apis:
            -
                class: Chill\PersonBundle\Entity\AccompanyingPeriod
@@ -281,7 +252,7 @@ You can add your own actions:
                base_path: /api/1.0/person/accompanying-course
                controller: Chill\PersonBundle\Controller\AccompanyingCourseApiController
                actions:
-                   # add a custom participation:
+                   # add custom participation:
                    participation:
                        methods:
                            POST: true
@@ -296,13 +267,13 @@ You can add your own actions:
                            HEAD: null
                            PUT: null
                        single-collection: single
+```
 
-The key :code:`single-collection` with value :code:`single` will add a :code:`/{id}/ + "action name"` (in this example, :code:`/{id}/participation`) into the path, after the base path. If the value is :code:`collection`, no id will be set, but the action name will be append to the path.
+The key `single-collection` with value `single` will add a `/{id}/ + "action name"` (in this example, `/{id}/participation`) into the path, after the base path. If the value is `collection`, no id will be set, but the action name will be append to the path.
 
 Then, create the corresponding action into your controller:
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Controller;
 
    use Chill\MainBundle\CRUD\Controller\ApiController;
@@ -326,10 +297,10 @@ Then, create the corresponding action into your controller:
            $this->eventDispatcher = $eventDispatcher;
            $this->validator = $validator;
        }
-       
+
        public function participationApi($id, Request $request, $_format)
        {
-           /** @var AccompanyingPeriod $accompanyingPeriod */ 
+           /** @var AccompanyingPeriod $accompanyingPeriod */
            $accompanyingPeriod = $this->getEntity('participation', $id, $request);
            $person = $this->getSerializer()
                ->deserialize($request->getContent(), Person::class, $_format, []);
@@ -363,20 +334,18 @@ Then, create the corresponding action into your controller:
            return $this->json($participation);
        }
    }
+```
 
-Managing association
-********************
+###### Managing association
 
-ManyToOne association
-=====================
+## ManyToOne association
 
-In ManyToOne association, you can add associated entities using the :code:`PATCH` request. By default, the serializer deserialize entities only with their id and discriminator type, if any.
+In ManyToOne association, you can add associated entities using the `PATCH` request. By default, the serializer deserialize entities only with their id and discriminator type, if any.
 
 Example:
 
-.. code-block:: bash
-
-   curl -X 'PATCH' \
+```
+curl -X 'PATCH' \
      'http://localhost:8001/api/1.0/person/accompanying-course/2668.json' \
      -H 'accept: */*' \
      -H 'Content-Type: application/json' \
@@ -386,16 +355,15 @@ Example:
      "id": 2668,
      "origin": { "id": 11 }
    }'
+```
 
-ManyToMany associations
-=======================
+## ManyToMany associations
 
-In OneToMany association, you can easily create route for adding and removing entities, using :code:`POST` and :code:`DELETE` requests.
+In OneToMany association, you can easily create route for adding and removing entities, using `POST` and `DELETE` requests.
 
-Prepare your entity, creating the methods :code:`addYourEntity` and :code:`removeYourEntity`:
-
-.. code-block:: php
+Prepare your entity, creating the methods `addYourEntity` and `removeYourEntity`:
 
+```php
    namespace Chill\PersonBundle\Entity;
 
    use Chill\MainBundle\Entity\Scope;
@@ -437,12 +405,12 @@ Prepare your entity, creating the methods :code:`addYourEntity` and :code:`remov
        {
            $this->scopes->removeElement($scope);
        }
-
+```
 
 Create your route into the configuration:
 
-.. code-block:: yaml
-
+```yaml
+   # config/packages/chill_main.yaml`
    chill_main:
        apis:
            -
@@ -469,14 +437,12 @@ Create your route into the configuration:
                        controller_action: null
                        path: null
                        single-collection: single
+```
 
 This will create a new route, which will accept two methods: DELETE and POST:
 
-.. code-block:: raw
-
    +--------------+---------------------------------------------------------------------------------------+
    | Property     | Value                                                                                 |
-   +--------------+---------------------------------------------------------------------------------------+
    | Route Name   | chill_api_single_accompanying_course_scope                                            |
    | Path         | /api/1.0/person/accompanying-course/{id}/scope.{_format}                              |
    | Path Regex   | {^/api/1\.0/person/accompanying\-course/(?P<id>[^/]++)/scope\.(?P<_format>[^/]++)$}sD |
@@ -488,14 +454,10 @@ This will create a new route, which will accept two methods: DELETE and POST:
    | Class        | Symfony\Component\Routing\Route                                                       |
    | Defaults     | _controller: csapi_accompanying_course_controller:scopeApi                            |
    | Options      | compiler_class: Symfony\Component\Routing\RouteCompiler                               |
-   +--------------+---------------------------------------------------------------------------------------+
-
-
 
 Then, create the controller action. Call the method:
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Controller;
 
    use Chill\MainBundle\CRUD\Controller\ApiController;
@@ -510,14 +472,14 @@ Then, create the controller action. Call the method:
            return $this->addRemoveSomething('scope', $id, $request, $_format, 'scope', Scope::class, [ 'groups' => [ 'read' ] ]);
        }
    }
+```
 
-This will allow to add a scope by his id, and delete them.
+This will allow adding a scope by his id and deleting them.
 
 Curl requests:
 
-.. code-block:: bash
-
-   # add a scope with id 5
+```
+# add a scope with id 5
    curl -X 'POST' \
      'http://localhost:8001/api/1.0/person/accompanying-course/2868/scope.json' \
      -H 'accept: */*' \
@@ -536,14 +498,13 @@ Curl requests:
      "id": 5,
      "type": "scope"
    }'
+```
 
-Deserializing an association where multiple types are allowed
-=============================================================
+## Deserializing an association where multiple types are allowed
 
-Sometimes, multiples types are allowed as association to one entity:
-
-.. code-block:: php
+Sometimes, multiple types are allowed as association to one entity:
 
+```php
    namespace Chill\PersonBundle\Entity\AccompanyingPeriod;
 
    use Chill\PersonBundle\Entity\Person;
@@ -553,7 +514,6 @@ Sometimes, multiples types are allowed as association to one entity:
    class Resource
    {
 
-
        /**
         * @ORM\ManyToOne(targetEntity=ThirdParty::class)
         * @ORM\JoinColumn(nullable=true)
@@ -566,7 +526,6 @@ Sometimes, multiples types are allowed as association to one entity:
         */
        private $person;
 
-
        /**
         *
         * @param $resource Person|ThirdParty
@@ -575,8 +534,8 @@ Sometimes, multiples types are allowed as association to one entity:
        {
           // ...
        }
-       
-       
+
+
        /**
         * @return ThirdParty|Person
         * @Groups({"read", "write"})
@@ -586,13 +545,13 @@ Sometimes, multiples types are allowed as association to one entity:
            return $this->person ?? $this->thirdParty;
        }
    }
+```
 
 This is not well taken into account by the Symfony serializer natively.
 
 You must, then, create your own CustomNormalizer. You can help yourself using this:
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Serializer\Normalizer;
 
    use Chill\PersonBundle\Entity\Person;
@@ -606,7 +565,6 @@ You must, then, create your own CustomNormalizer. You can help yourself using th
    use Symfony\Component\Serializer\Exception;
    use Chill\MainBundle\Serializer\Normalizer\DiscriminatedObjectDenormalizer;
 
-
    class AccompanyingPeriodResourceNormalizer implements DenormalizerInterface, DenormalizerAwareInterface
    {
        use DenormalizerAwareTrait;
@@ -632,35 +590,34 @@ You must, then, create your own CustomNormalizer. You can help yourself using th
                    DiscriminatedObjectDenormalizer::TYPE,
                    $format,
                    // into the context, we add the list of allowed types:
-                   [ 
-                       DiscriminatedObjectDenormalizer::ALLOWED_TYPES => 
-                       [ 
+                   [
+                       DiscriminatedObjectDenormalizer::ALLOWED_TYPES =>
+                       [
                            Person::class, ThirdParty::class
                        ]
                    ]
                );
 
                $resource->setResource($res);
-           } 
+           }
 
            return $resource;
        }
-       
+
 
        public function supportsDenormalization($data, string $type, string $format = null)
        {
            return $type === Resource::class;
-       }  
+       }
    }
+```
 
-Serialization for collection
-****************************
+###### Serialization for collection
 
 A specific model has been defined for returning collection:
 
-.. code-block:: json
-
-   {
+```
+{
        "count": 49,
        "results": [
        ],
@@ -672,13 +629,13 @@ A specific model has been defined for returning collection:
            "items_per_page": 1
        }
    }
+```
 
 Where this is relevant, this model should be re-used in custom controller actions.
 
-In custom actions, this can be achieved quickly by assembling results into a :code:`Chill\MainBundle\Serializer\Model\Collection`. The pagination information is given by using :code:`Paginator` (see :ref:`Pagination <pagination-ref>`).
-
-.. code-block:: php
+In custom actions, this can be achieved quickly by assembling results into a `Chill\MainBundle\Serializer\Model\Collection`. The pagination information is given by using `Paginator` (see [Pagination ](pagination-ref.md)).
 
+```php
    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
    use Chill\MainBundle\Pagination\PaginatorInterface;
 
@@ -692,15 +649,11 @@ In custom actions, this can be achieved quickly by assembling results into a :co
            return $this->json($model, Response::HTTP_OK, [], $context);
        }
    }
+```
 
+###### Full configuration example
 
-.. _api_full_configuration:
-
-Full configuration example
-**************************
-
-.. code-block:: yaml
-
+```yaml
        apis:
            -
                class: Chill\PersonBundle\Entity\AccompanyingPeriod
@@ -743,5 +696,4 @@ Full configuration example
                        path: null
                        single-collection: single
                base_role: null
-
-
+```

docs/source/development/assets.md

@@ -1,91 +1,61 @@
-
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-.. _forms:
-
-Assets
-#######
+# Assets
 
 The Chill assets (js, css, images, …) can be managed by `Webpack Encore`_, which is a thin wrapper for `Webpack`_ in Symfony applications.
 
-Installation
-************
+###### Installation
 
 Webpack Encore needs to be run in a Node.js environment, using the Yarn package manager. This Node.js environment can be set up using a node docker image. The bash script `docker-node.sh` set up a Node.js environment with an adequate configuration. Launch this container by typing:
 
-
-.. code-block:: bash
-
     $ bash docker-node.sh
 
 In this NodeJS environment, install all the assets required by Chill with:
 
-.. code-block:: bash
-
     node@b91cab4f7cfc:/app$ yarn install
 
 This command will install all the packages that are listed in `package.json`.
 
 Any further required dependencies can be installed using the Yarn package. For instance, jQuery is installed by:
 
-.. code-block:: bash
-
    node@b91cab4f7cfc:/app$ yarn add jquery --dev
 
+###### Usage
 
-Usage
-*****
-
-Organize your assets
---------------------
+### Organize your assets
 
 Chill assets usually lives under the `/Resources/public` folder of each Chill bundle. The Webpack configuration set up in `webpack.config.js` automatically loads the required assets from the Chill bundles that are used.
 
 For adding your own assets to Webpack, you must add an entry in the `webpack.config.js` file. For instance, the following entry will output a file `main.js` collecting the js code (and possibly css, image, etc.) from `./assets/main.js`.
 
-.. code-block:: js
-
    	.addEntry('main', './assets/main.js')
 
 To gather the css files, simply connect them to your js file, using `require`. The css file is seen as a dependency of your js file. :
 
-.. code-block:: js
-
     // assets/js/main.js
     require('../css/app.css');
 
 For finer configuration of webpack encore, we refer to the above-linked documentation.
 
-
-Compile the assets
-------------------
+### Compile the assets
 
 To compile the assets, run this line in the NodeJS container:
 
-.. code-block:: bash
-
    	node@b91cab4f7cfc:/app$ yarn run encore dev
 
 While developing, you can tell Webpack Encore to continuously watch the files you are modifying:
 
-.. code-block:: bash
-
     node@b91cab4f7cfc:/app$ yarn run encore dev --watch
 
-
-Use the assets in the templates
---------------------------------
+### Use the assets in the templates
 
 Any entry defined in the webpack.config.js file can be linked to your application using the symfony `asset` helper:
 
-.. code-block:: html
-
     <head>
         ...
         <link rel="stylesheet" href="{{ asset('build/app.css') }}">
@@ -93,12 +63,4 @@ Any entry defined in the webpack.config.js file can be linked to your applicatio
     <body>
         ...
         <script src="{{ asset('build/app.js') }}"></script>
-    </body>
-
-
-
-
-
-
-.. _Webpack Encore: https://www.npmjs.com/package/@symfony/webpack-encore
-.. _Webpack: https://webpack.js.org/
+    </body>

docs/source/development/code-quality.md

@@ -0,0 +1,23 @@
+# Code style, code quality and other tools
+
+## PHP-cs-fixer
+
+For development, you will also have to install:
+
+- [php-cs-fixer ](https://cs.symfony.com/)
+
+We also encourage you to use tools like [phpstan ](https://phpstan.org) and [rector ](https://getrector.com).
+
+For running php-cs-fixer:
+
+   symfony composer php-cs-fixer
+
+## Execute tests
+
+   symfony composer exec phpunit -- /path/to_your_test.php
+
+Note that IDE like PhpStorm should be able to run tests, even KernelTestcase or WebTestCase, [from within their interfaces ](https://www.jetbrains.com/help/phpstorm/using-phpunit-framework.html#run_phpunit_tests).
+
+## Execute rector
+
+   symfony composer exec rector -- process

docs/source/development/code-quality.rst

@@ -1,34 +0,0 @@
-Code style, code quality and other tools
-########################################
-
-PHP-cs-fixer
-============
-
-For development, you will also have to install:
-
-- `php-cs-fixer <https://cs.symfony.com/>`_
-
-We also encourage you to use tools like `phpstan <https://phpstan.org>`_ and `rector <https://getrector.com>`_.
-
-For running php-cs-fixer:
-
-.. code-block:: bash
-
-   symfony composer php-cs-fixer
-
-Execute tests
-=============
-
-.. code-block:: bash
-
-   symfony composer exec phpunit -- /path/to_your_test.php
-
-Note that IDE like PhpStorm should be able to run tests, even KernelTestcase or WebTestCase, `from within their interfaces <https://www.jetbrains.com/help/phpstorm/using-phpunit-framework.html#run_phpunit_tests>`_.
-
-Execute rector
-==============
-
-.. code-block:: bash
-
-   symfony composer exec rector -- process
-

docs/source/development/create-a-new-bundle.md

@@ -0,0 +1,90 @@
+# Create a new bundle {#create-new-bundle}
+
+:::: warning
+::: title
+Warning
+:::
+
+This part of the doc is not yet tested
+::::
+
+## Create a new directory with Bundle class
+
+``` bash
+mkdir -p src/Bundle/ChillSomeBundle/src/config
+mkdir -p src/Bundle/ChillSomeBundle/src/Controller
+```
+
+Add a bundle file
+
+``` php
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Chill\SomeBundle;
+
+use Symfony\Component\HttpKernel\Bundle\Bundle;
+
+class ChillSomeBundle extends Bundle {}
+```
+
+And a route file:
+
+``` yaml
+chill_ticket_controller:
+    resource: '@ChillTicketBundle/Controller/'
+    type: annotation
+```
+
+## Register the new psr-4 namespace
+
+In composer.json, add the new psr4 namespace
+
+``` diff
+{
+"autoload": {
+    "psr-4": {
++        "Chill\\SomeBundle\\": "src/Bundle/ChillSomeBundle/src",
+    }
+}
+}
+```
+
+## Register the bundle
+
+Register in the file `config/bundles.php`:
+
+``` php
+Vendor\Bundle\YourBundle\YourBundle::class => ['all' => true],
+```
+
+And import routes in `config/routes/chill_some_bundle.yaml`:
+
+``` yaml
+chill_ticket_bundle:
+    resource: '@ChillSomeBundle/config/routes.yaml'
+```
+
+## Add the doctrine_migration namespace
+
+Add the namespace to `config/packages/doctrine_migrations_chill.yaml`
+
+``` diff
+doctrine_migrations:
+    migrations_paths:
++        'Chill\Some\Ticket': '@ChillSomeBundle/migrations'
+```
+
+## Dump autoloading
+
+``` bash
+symfony composer dump-autoload
+```

docs/source/development/create-a-new-bundle.rst

@@ -1,34 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _create-new-bundle:
-
-Create a new bundle
-*******************
-
-Create your own bundle is not a trivial task.
-
-The easiest way to achieve this is seems to be : 
-
-1. Prepare a fresh installation of the chill project, in a new directory
-2. Create a new bundle in this project, in the src directory
-3. Initialize a git repository **at the root bundle**, and create your initial commit.
-4. Register the bundle with composer/packagist. If you do not plan to distribute your bundle with packagist, you may use a custom repository for achieve this [#f1]_
-5. Move to a development installation, made as described in the :ref:`installation-for-development` section, and add your new repository to the composer.json file
-6. Work as :ref:`usual <editing-code-and-commiting>`
-
-.. warning::
-
-    This part of the doc is not yet tested
-
-TODO
-
-
-.. rubric:: Footnotes
-
-.. [#f1] Be aware that we use the Affero GPL Licence, which ensure that all users must have access to derivative works done with this software.

docs/source/development/cronjob.md

@@ -1,37 +1,26 @@
-
-.. Copyright (C)  2014-2023 Champs Libres Cooperative SCRLFS
-    Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
     under the terms of the GNU Free Documentation License, Version 1.3
     or any later version published by the Free Software Foundation;
     with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
     A copy of the license is included in the section entitled "GNU
     Free Documentation License".
 
-.. _cronjob:
-
-Cron jobs
-*********
+###### Cron jobs
 
 Some tasks must be executed regularly: refresh some materialized views, remove old data, ...
 
 For this purpose, one can programmatically implements a "cron job", which will be scheduled by a specific command.
 
-The command :code:`chill:cron-job:execute`
-==========================================
+## The command `chill:cron-job:execute`
 
-The command :code:`chill:cron-job:execute` will schedule a task, one by one. In a classical implementation, it should
+The command `chill:cron-job:execute` will schedule a task, one by one. In a classical implementation, it should
 be executed every 15 minutes (more or less), to ensure that every task can be executed.
 
-.. warning::
-
    This command should not be executed in parallel. The installer should ensure that two job are executed concurrently.
 
-How to implements a cron job ?
-==============================
+## How to implements a cron job ?
 
-Implements a :code:`Chill\MainBundle\Cron\CronJobInterface`. Here is an example:
-
-.. code-block:: php
+Implements a `Chill\MainBundle\Cron\CronJobInterface`. Here is an example:
 
     namespace Chill\MainBundle\Service\Something;
 
@@ -83,19 +72,15 @@ Implements a :code:`Chill\MainBundle\Cron\CronJobInterface`. Here is an example:
        }
     }
 
-How are cron job scheduled ?
-============================
+## How are cron job scheduled ?
 
-If the command :code:`chill:cron-job:execute` is run with one or more :code:`job` argument, those jobs are run, **without checking that the job can run** (the method :code:`canRun` is not executed).
+If the command `chill:cron-job:execute` is run with one or more `job` argument, those jobs are run, **without checking that the job can run** (the method `canRun` is not executed).
 
-If any :code:`job` argument is given, the :code:`CronManager` schedule job with those steps:
+If any `job` argument is given, the `CronManager` schedule job with those steps:
 
 * the tasks are ordered, with:
    * a priority is given for tasks that weren't never executed;
    * then, the tasks are ordered, the last executed are the first in the list
-* then, for each tasks, and in the given order, the first task where :code:`canRun` return :code:`TRUE` will be executed.
-
-The command :code:`chill:cron-job:execute` execute **only one** task.
-
-
+* then, for each tasks, and in the given order, the first task where `canRun` return `TRUE` will be executed.
 
+The command `chill:cron-job:execute` execute **only one** task.

docs/source/development/crud.md

@@ -1,15 +1,11 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-.. _crud:
-
-CRUD
-####
+# CRUD
 
 Chill provide an API to create a basic CRUD.
 
@@ -20,30 +16,21 @@ One can follow those steps to create a CRUD for one entity:
 3. customize the templates if required ;
 4. customize some steps of the controller if required ;
 
+An example with the [`ClosingMotive`` (PersonBundle) in the admin part of Chill:
 
-An example with the ``ClosingMotive`` (PersonBundle) in the admin part of Chill: 
-
-Auto-loading the routes
-***********************
+###### Auto-loading the routes
 
 Ensure that those lines are present in your file `app/config/routing.yml`:
 
-
-.. code-block:: yaml
-
    chill_cruds:
        resource: 'chill_main_crud_route_loader:load'
        type: service
 
-
-
-Create your model
-*****************
+###### Create your model
 
 Create your model on the usual way (in this example, ORM informations are stored in yaml file):
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Entity\AccompanyingPeriod;
 
    use Doctrine\Common\Collections\Collection;
@@ -62,41 +49,40 @@ Create your model on the usual way (in this example, ORM informations are stored
         * @var array
         */
        private $name;
-       
+
        /**
         *
         * @var boolean
         */
        private $active = true;
-       
+
        /**
         *
         * @var self
         */
        private $parent = null;
-       
+
        /**
         * child Accompanying periods
         *
         * @var Collection
         */
        private $children;
-       
+
        /**
         *
         * @var float
         */
        private $ordering = 0.0;
 
-
        // getters and setters come here
 
    }
+```
 
 The form:
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Form;
 
    use Symfony\Component\Form\AbstractType;
@@ -108,7 +94,6 @@ The form:
    use Symfony\Component\Form\Extension\Core\Type\NumberType;
 
    /**
-    *
     *
     */
    class ClosingMotiveType extends AbstractType
@@ -145,22 +130,21 @@ The form:
                ;
        }
    }
+```
 
-Configure the crud
-******************
+###### Configure the crud
 
 The crud is configured using the key ``crud`` under ``chill_main``
 
-.. code-block:: yaml
-
+```yaml
    chill_main:
      cruds:
-       - 
+       -
          # the class which is concerned by the CRUD
          class: '\Chill\PersonBundle\Entity\AccompanyingPeriod\ClosingMotive::class'
          # give a name for the crud. This will be used internally
          name: closing_motive
-         # add a base path for the 
+         # add a base path for the
          base_path: /admin/closing-motive
          # this is the form class
          form_class: 'Chill\PersonBundle\Form\ClosingMotiveType::class'
@@ -170,8 +154,8 @@ The crud is configured using the key ``crud`` under ``chill_main``
          # this is a list of action you can configure
          # by default, the actions `index`, `view`, `new` and `edit` are automatically create
          # you can add more actions or configure some details about them
-         actions: 
-            index: 
+         actions:
+            index:
               # the default template for index is very poor,
               # you will need to override it
               template: '@ChillPerson/ClosingMotive/index.html.twig'
@@ -180,16 +164,16 @@ The crud is configured using the key ``crud`` under ``chill_main``
             new:
               role: ROLE_ADMIN
               # by default, the template will only show the form
-              # you can override it 
+              # you can override it
               template: '@ChillPerson/ClosingMotive/new.html.twig'
             edit:
               role: ROLE_ADMIN
               template: '@ChillPerson/ClosingMotive/edit.html.twig'
+```
 
-To leave the bundle auto-configure the ``chill_main`` bundle, you can `prepend the configuration of the ChillMain Bundle <https://symfony.com/doc/current/bundles/prepend_extension.html>`_:
-
-.. code-block:: php
+To leave the bundle autoconfigure the ``chill_main`` bundle, you can `prepend the configuration of the ChillMain Bundle ](https://symfony.com/doc/current/bundles/prepend_extension.html):
 
+```php
    namespace Chill\PersonBundle\DependencyInjection;
 
    use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -204,13 +188,13 @@ To leave the bundle auto-configure the ``chill_main`` bundle, you can `prepend t
        {
            // skipped here
        }
-       
-       
-       public function prepend(ContainerBuilder $container) 
+
+
+       public function prepend(ContainerBuilder $container)
        {
            $this->prependCruds($container);
        }
-       
+
        protected function prependCruds(ContainerBuilder $container)
        {
            $container->prependExtensionConfig('chill_main', [
@@ -240,20 +224,17 @@ To leave the bundle auto-configure the ``chill_main`` bundle, you can `prepend t
            ]);
        }
    }
+```
 
+###### Customize templates
 
-
-Customize templates
-*******************
-
-The current template are quite basic. You can override and extends them.
+The current template is quite basic. You can override and extends them.
 
 For a better inclusion, you can embed them instead of extending them.
 
 For index. Note that we extend here the `admin` layout, not the default one:
 
-.. code-block:: html+jinja
-
+```php
    {% extends '@ChillMain/Admin/layout.html.twig' %}
 
    {% block admin_content %}
@@ -288,11 +269,11 @@ For index. Note that we extend here the `admin` layout, not the default one:
            {% endblock %}
        {% endembed %}
    {% endblock %}
+```
 
 For edit template:
 
-.. code-block:: html+jinja
-
+```php
    {% extends '@ChillMain/Admin/layout.html.twig' %}
 
    {% block title %}
@@ -309,8 +290,6 @@ For edit template:
 
 For new template:
 
-.. code-block:: html+jinja
-
    {% extends '@ChillMain/Admin/layout.html.twig' %}
 
    {% block title %}
@@ -322,17 +301,16 @@ For new template:
        {% block content_form_actions_save_and_show %}{% endblock %}
    {% endembed %}
    {% endblock %}
+```
 
-Customize some steps in the controller
-**************************************
+###### Customize some steps in the controller
 
 Some steps may be customized by overriding the default controller and some methods. Here, we will override the way the entity is created, and the ordering of the "index" page:
 
 * we will associate a parent ClosingMotive to the element if a parameter `parent_id` is found ;
 * we will order the ClosingMotive by the ``ordering`` property
 
-.. code-block:: php
-
+```php
    namespace Chill\PersonBundle\Controller;
 
    use Chill\MainBundle\CRUD\Controller\CRUDController;
@@ -376,14 +354,13 @@ Some steps may be customized by overriding the default controller and some metho
            return $query->orderBy('e.ordering', 'ASC');
        }
    }
+```
 
-How-to and questions
-********************
+###### How-to and questions
 
-Which role is required for each action ?
-========================================
+## Which role is required for each action ?
 
-By default, each action will use: 
+By default, each action will use:
 
 1. the role defined under the action key ;
 2. the base role as upper, with the action name appended:
@@ -396,22 +373,21 @@ By default, each action will use:
 The entity will be passed to the role:
 
 * for the ``view`` and ``edit`` action: the entity fetched from database
-* for the ``new`` action: the entity which is created (you can override default values using 
-* for index action (or if you re-use the ``indexAction`` method: ``null``  
-  
-How to add some route and actions ?
-===================================
+* for the ``new`` action: the entity which is created (you can override default values using
+* for index action (or if you re-use the ``indexAction`` method: ``null``
+
+## How to add some route and actions ?
 
 Add them under the action key:
 
-.. code-block:: yaml
-
+```yaml
    chill_main:
      cruds:
-       - 
+       -
          # snipped
          actions:
            myaction: ~
+```
 
 The method `myactionAction` will be called by the parameter.
 
@@ -419,13 +395,12 @@ Inside this action, you can eventually call another internal method:
 
 * ``indexAction`` for a list of items ;
 * ``viewAction`` for a view
-* ``editFormAction`` for an edition 
+* ``editFormAction`` for an edition
 * ``createFormAction`` for a creation
 
 Example:
 
-.. code-block:: php
-
+```php
    namespace CSConnectes\SPBundle\Controller;
 
    use Chill\PersonBundle\CRUD\Controller\OneToOneEntityPersonCRUDController;
@@ -456,34 +431,29 @@ Example:
        }
 
    }
+```
 
-How to create a CRUD for entities associated to persons
-=======================================================
+## How to create a CRUD for entities associated to persons
 
 The bundle person provide some controller and template you can override, instead of the ones present in the mainbundle:
 
-* :code:`Chill\PersonBundle\CRUD\Controller\EntityPersonCRUDController` for entities linked with a one-to-may association to :code:`Person` class ;
-* :code:`Chill\PersonBundle\CRUD\Controller\OneToOneEntityPersonCRUDController` for entities linked with a one-to-one association to :code:`Person` class.
+* `Chill\PersonBundle\CRUD\Controller\EntityPersonCRUDController` for entities linked with a one-to-may association to `Person` class ;
+* `Chill\PersonBundle\CRUD\Controller\OneToOneEntityPersonCRUDController` for entities linked with a one-to-one association to `Person` class.
 
 There are also template defined under ``@ChillPerson/CRUD/`` namespace.
 
-Those controller assume that:
+Those controllers assume that:
 
-* the entity provide the method :code:`getPerson` and :code:`setPerson` ;
+* the entity provide the method `getPerson` and `setPerson` ;
 * the `index`'s id path will be the id of the person, and the ids in `view` and `edit` path will be the id of the entity ;
 
-This bundle also use by default the templates inside ``@ChillPerson/CRUD/``.
+This bundle also uses by default the templates inside ``@ChillPerson/CRUD/``.
 
+###### Reference
 
-Reference
-*********
-
-Configuration reference
-=======================
-
-
-.. code-block:: txt
+## Configuration reference
 
+```yaml
    chill_main:
        cruds:
 
@@ -514,9 +484,8 @@ Configuration reference
 
                        # the template to render the view
                        template:             null
+```
 
-Twig default block
-==================
+## Twig default block
 
 This part should be documented.
-

docs/source/development/database-principles.md

@@ -0,0 +1,70 @@
+# Database Principles
+
+This page provides a global understanding of the Chill database and explains some implementation details that help accelerate processing from the database or exploit it more easily.
+
+!!! warning "Database Schema Stability"
+    The stability of the database schema is not guaranteed.
+
+    However, it evolves relatively little. It is rare for tables or columns to be deleted or renamed, but it is not guaranteed that this cannot happen.
+
+## Overview
+
+A commented list of all tables is available in CSV format at `./database/table_list.csv`.
+
+### Schema and naming conventions
+
+At the beginning of Chill's history, PostgreSQL schemas were not used. Data was stored in the `public` schema.
+
+Later, new bundles appeared, and tables were classified into dedicated schemas.
+
+Currently:
+
+- for older bundles, those that already have tables in the public schema, new tables are added to this schema. They are prefixed with `chill_<bundle_name>_`;
+- for more recent bundles, tables are created in the dedicated schema
+
+### Historical data
+
+Some data is historized:
+
+- the referents of an accompanying period;
+- the statuses of an accompanying period;
+- the link between territories and users;
+- etc.
+
+In these cases, Chill generally creates two columns, which are usually named `startDate` and `endDate`. When the `endDate` column is `NULL`, it means that the period is not "closed". The `startDate` column is not nullable.
+
+In some cases, the current data (referent of an accompanying period, for example) is also repeated at the table level itself. For example, the accompanying periods table `chill_person_accompanying_period` has a `step` column (the status of the period) and `user_id` (referent id) in addition to the history. Although redundant, this simplifies processing.
+
+## Special relationships
+
+### Users, households, addresses
+
+Users have an address through households: in the interface, the address is recorded in the household file, and it is "given" to users who are members of the household, **and** who share the address of this household. Indeed, it is possible that users "belong" to a household without being domiciled there: this is the case, for example, for children in shared custody.
+
+The history of users' membership in the household is preserved, as well as the history of addresses for the same household.
+
+The tables involved are as follows:
+
+- the `chill_person_person` table lists the users;
+- the `chill_person_household_members` table lists household memberships: this is the junction between users and households:
+  - the `startDate` and `endDate` columns indicate the start and end date of membership;
+  - the `shareHousehold` column indicates whether the user shares the household address (if yes, its value is `TRUE`)
+- the `chill_person_household` table lists households
+- the `chill_person_household_to_addresses` table associates households with addresses;
+- the `chill_main_address` table contains addresses, indicating the validity start date (`validFrom`) and the validity end date (`validTo`).
+
+To simplify the resolution of addresses and users, two views have been implemented:
+
+- the `view_chill_person_household_address` view takes up, for each user, the history of household memberships broken down by the address history of a household.
+  In other words, a line is created each time a user changes household, or a household changes address. It is therefore possible to find the complete address history for a given user via this table.
+- the `view_chill_person_current_address` view takes up the current address of users.
+
+### Addresses and geographical units
+
+Chill provides statistics on the location of addresses relative to geographical zones (`chill_main_geographical_unit`).
+
+Since the geographical resolution of addresses is costly in CPU and processing time, a materialized view has been created: `view_chill_main_address_geographical_unit`. It is refreshed daily in the production database.
+
+## Table list and comments
+
+A commented list of all tables is available in CSV format at `./database/table_list.csv`.

docs/source/development/database-principles.rst

@@ -1,84 +0,0 @@
-
-.. database-principles:
-
-Principes de la base de données
-###############################
-
-Cette page donne une compréhension globale de la base de donnée de Chill, et explique quelques détails d'implémentations qui permettent d'accélérer les traitements à partir de la base de donnée, ou de l'exploiter plus aisément.
-
-Cette page est rédigée en français.
-
-.. note::
-
-    La stabilité du schéma de la base de donnée n'est pas garantie.
-
-    Toutefois, ce dernier évolue relativement peu. Il est rare que des tables ou des colonnes soient supprimées ou renommées. Mais il n'est pas garanti que cela puisse arriver.
-
-Généralités
-===========
-
-Une liste commentée de toutes les tables :download:`est disponible au format CSV <./database/table_list.csv`.
-
-Schéma et conventions de nommage
---------------------------------
-
-Au début de l'histoire de Chill, les schémas postgresql n'étaient pas exploités. Les données étaient stockées dans le schéma :code:`public`.
-
-Par la suite, des nouveaux bundles sont apparus, et les tables ont été classées dans des schémas dédiés.
-
-A l'heure actuelle:
-
-- pour les anciens bundle, ceux qui ont déjà des tables dans le schéma public, les nouvelles tables sont ajoutées à ce schéma. Elles sont préfixées par :code:`chill_<nom du bundle>_`;
-- pour les bundles plus récents, les tables sont créées dans le schéma dédié
-
-Données avec de l'historicité
------------------------------
-
-Certaines données sont historisées:
-
-- les référents d'un parcours;
-- les statuts d'un parcours;
-- la liaison entre les centres et les usagers;
-- etc.
-
-Dans ces cas-là, Chill crée généralement deux colonnes, qui sont habituellement nommées :code:`startDate` et :code:`endDate`. Lorsque la colonne :code:`endDate` est à :code:`NULL`, cela signifie que la période n'est pas "fermée". La colonne :code:`startDate` n'est pas nullable.
-
-Dans certains cas, la donnée actuelle (référent d'un parcours, par exemple) est également répétée au niveau de la table en elle-même. Par exemple, la table des parcours :code:`chill_person_accompanying_period` comporte une colonne :code:`step` (le statut du parcours) et :code:`user_id` (id du référent) en plus de l'historique. Bien que redondant, cela simplifie les traitements.
-
-Relations particulières
-=======================
-
-Usagers, ménages, adresses
---------------------------
-
-Les usagers ont une adresse au travers des ménages: dans l'interface, l'adresse est inscrite dans le dossier du ménage, et elle est "donnée" aux usagers membres du ménage, **et** qui partagent l'adresse de ce ménage. En effet, il est possible que des usagers "appartiennent" à un ménage sans y être domicilié: c'est le cas, par exemple, des enfants en garde alternée.
-
-L'historique de l'appartenance des usagers au ménage est conservée, de même que l'historique des adresses pour un même ménage.
-
-Les tables en jeu sont les suivantes:
-
-- la table :code:`chill_person_person` liste les usagers;
-- la table :code:`chill_person_household_members` liste les appartenances au ménage: il s'agit de la jointure entre les usagers et les ménages:
-  - les colonnes :code:`startDate` et :code:`endDate` indiquent la date de début et la date de fin de l'appartenance;
-  - la colonne :code:`shareHousehold` indique si l'utilisateur partage l'adresse du ménage (si oui, sa valeur est :code:`TRUE`)
-- la table :code:`chill_person_household` liste les ménages
-- la table :code:`chill_person_household_to_addresses` associe les ménages aux adresses;
-- la table :code:`chill_main_address` contient les adresses, en indiquant la date de début de validité (:code:`validFrom`) et la fin de validité (:code:`validTo`).
-
-Pour simplifier la résolution des adresses et des usagers, deux vues ont été mises en œuvre:
-
-- la vue :code:`view_chill_person_household_address` reprend, pour chaque usager, l'historique des appartenances au ménage découpée par l'historique des adresses d'un ménage.
-  Autrement dit, une ligne est créée à chaque fois qu'un usager change de ménage, ou qu'un ménage change d'adresse. Il est donc possible de retrouver l'historique complet des adresses pour un usager donné via cette table.
-- la vue :code:`view_chill_person_current_address` reprend l'adresse actuelle des usagers.
-
-Adresses et unités géographiques
---------------------------------
-
-Chill propose des statistiques sur la localisation des adresses par rapport à des zones géographiques (:code:`chill_main_geographical_unit`).
-
-Comme la résolution géographique des adresses est coûteuse en CPU et en temps de traitement, une vue matérialisée a été créée: :code:`view_chill_main_address_geographical_unit`. Elle est rafraichie quotidiennement dans la base de donnée de production.
-
-Liste des tables et commentaires
-================================
-
-Une liste commentée de toutes les tables :download:`est disponible au format CSV <./database/table_list.csv`.

docs/source/development/database/table_list.csv

@@ -1,6 +1,6 @@
 order,table_schema,table_name,commentaire
 1,chill_3party,party_category,Catégorie de tiers
-2,chill_3party,party_center,Association entre les tiers et les centres (déprécié)
+2,chill_3party,party_center,Association entre les tiers et les territoires (déprécié)
 3,chill_3party,party_profession,Profession du tiers (déprécié)
 4,chill_3party,third_party,Tiers
 5,chill_3party,thirdparty_category,association tiers - catégories
@@ -54,7 +54,7 @@ order,table_schema,table_name,commentaire
 53,public,activitytpresence,Présence aux échanges
 54,public,activitytype,Types d'échanges
 55,public,activitytypecategory,Catégories de types d'échanges
-56,public,centers,"Centres (territoires, agences, etc.)"
+56,public,centers,"Territoires (territoires, agences, etc.)"
 57,public,chill_activity_activity_chill_person_socialaction,
 58,public,chill_activity_activity_chill_person_socialissue
 59,public,chill_docgen_template,Gabarits de documents
@@ -111,7 +111,7 @@ order,table_schema,table_name,commentaire
 110,public,chill_person_marital_status,Etats civils
 111,public,chill_person_not_duplicate,
 112,public,chill_person_person,Usagers
-113,public,chill_person_person_center_history,Historique des centres d'un usagers
+113,public,chill_person_person_center_history,Historique des territoires d'un usagers
 114,public,chill_person_persons_to_addresses,Déprécié
 115,public,chill_person_phone,Numéros d etéléphone supplémentaires d'un usager
 116,public,chill_person_relations,Types de relations de filiation
@@ -142,7 +142,7 @@ order,table_schema,table_name,commentaire
 141,public,permission_groups
 142,public,permissionsgroup_rolescope
 143,public,persons_spoken_languages
-144,public,regroupment,Regroupement de centres
+144,public,regroupment,Regroupement de territoires
 145,public,regroupment_center,
 146,public,role_scopes,
 147,public,scopes,Services

docs/source/development/embeddable-comments.md

@@ -1,30 +1,17 @@
-
-.. Copyright (C)  2016 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-
-Embeddable comments
-###################
+# Embeddable comments
 
 Those embeddable comments is a comment with some metadata:
 
 * the one who updated the comment (the comment itself, and not the whole entity);
 * the date and time for the last update (again, the comment itself, and not the whole entity).
 
-We make usage of `embeddables <https://www.doctrine-project.org/projects/doctrine-orm/en/2.8/tutorials/embeddables.html>`_.
+We make usage of [embeddable ](https://www.doctrine-project.org/projects/doctrine-orm/en/2.8/tutorials/embeddables.html).
 
-Embed the comment
-=================
+## Embed the comment
 
 The comment may be embedded into the entity:
 
-.. code-block:: php
-
+```php
    namespace Chill\ActivityBundle\Entity;
 
    use Chill\MainBundle\Entity\Embeddable\CommentEmbeddable;
@@ -51,7 +38,6 @@ The comment may be embedded into the entity:
         */
        private $comment;
 
-
        /**
         * @return \Chill\MainBundle\Entity\Embeddalbe\CommentEmbeddable
         */
@@ -68,27 +54,21 @@ The comment may be embedded into the entity:
            $this->comment = $comment;
        }
    }
+```
 
-Note on relation to :class:`User`
-=================================
+## Note on relation to :class:`User`
 
 The embeddable proposed by Doctrine does not support relationship to other entities. The entity Comment is able to render a user's id, but not an User object.
 
+   `$activity->getComment()->getUserId(); // return user id of the last author`
 
-.. code-block:: php
+   `$activity->getComment()->getUser(); // does not work !`
 
-   $activity->getComment()->getUserId(); // return user id of the last author
+## Usage into form
 
-   $activity->getComment()->getUser(); // does not work !
-
-
-Usage into form
-===============
-
-Use the :class:`Chill\MainBundle\Form\Type\CommentType` to load the form widget:
-
-.. code-block:: php
+Use the `Chill\MainBundle\Form\Type\CommentType` to load the form widget:
 
+```php
    namespace Chill\ActivityBundle\Form;
 
    use Chill\MainBundle\Form\Type\CommentType;
@@ -110,12 +90,8 @@ Use the :class:`Chill\MainBundle\Form\Type\CommentType` to load the form widget:
            ;
        }
    }
+```
 
-Render the comment
-==================
-
-.. code-block:: twig
-
-   {{ activity.comment|chill_entity_render_box }}
-
+## Render the comment
 
+   `{{ activity.comment|chill_entity_render_box }}`

docs/source/development/entity-info.md

@@ -1,16 +1,4 @@
-
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.3
-or any later version published by the Free Software Foundation;
-with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled "GNU
-Free Documentation License".
-
-.. _entity-info:
-
-Stats about event on entity in php world
-########################################
+# Stats about event on entity in php world
 
 It is necessary to be able to gather information about events for some entities:
 
@@ -18,11 +6,9 @@ It is necessary to be able to gather information about events for some entities:
 - who did it;
 - ...
 
-Those "infos" are not linked with right management, like describe in :ref:`timelines`.
+Those "infos" are not linked with right management, like describe in [timelines`.
 
-
-“infos” for some stats and info about an entity
------------------------------------------------
+### “infos” for some stats and info about an entity
 
 Building an info means:
 
@@ -32,10 +18,10 @@ Building an info means:
 A framework api is built to be able to build multiple “infos” entities
 through “union” views:
 
--  use a command ``bin/console chill:db:sync-views`` to synchronize view (create view if it does not exists, or update
+-  use a command ``bin/console chill:db:sync-views`` to synchronize view (create view if it does not exist, or update
    views when new SQL parts are added in the UNION query. Internally, this command call a new ``ViewEntityInfoManager``,
    which iterate over available views to build the SQL;
--  one can create a new “view entity info” by implementing a
+-  one can create new “view entity info” by implementing a
    ``ViewEntityInfoProviderInterface``
 -  this implementation of the interface is free to create another
    interface for building each part of the UNION query. This interface
@@ -45,14 +31,13 @@ through “union” views:
 So, converting new “events” into rows for ``AccompanyingPeriodInfo`` is
 just implementing this interface!
 
-Implementation for AccompanyingPeriod (``AccompanyingPeriod/AccompanyingPeriodInfo``)
--------------------------------------------------------------------------------------
+### Implementation for AccompanyingPeriod (``AccompanyingPeriod/AccompanyingPeriodInfo``)
 
 A class is created for computing some statistical info for an
 AccompanyingPeriod: ``AccompanyingPeriod/AccompanyingPeriodInfo``. This
 contains information about “something happens”, who did it and when.
 
-Having those info in table answer some questions like:
+Having that info in the table answers some questions like:
 
 -  when is the last and the first action (AccompanyingPeriodWork,
    Activity, AccompanyingPeriodWorkEvaluation, …) on the period;
@@ -60,46 +45,43 @@ Having those info in table answer some questions like:
    user.
 
 The AccompanyingPeriod info is mapped to a SQL view, not a table. The
-sql view is built dynamically (see below), and gather infos from
+SQL view is built dynamically (see below), and gathers info from
 ActivityBundle, PersonBundle, CalendarBundle, … It is possible to create
-custom bundle and add info on this view.
-
-.. code:: php
+ a custom bundle and add info on this view.
 
+```php
    /**
     *
     * @ORM\Entity()
-    * @ORM\Table(name="view_chill_person_accompanying_period_info") <==== THIS IS A VIEW, NOT A TABLE
+    * @ORM\Table(name="view_chill_person_accompanying_period_info") ](==== THIS IS A VIEW, NOT A TABLE
     */
    class AccompanyingPeriodInfo
    {
      // ...
    }
+```
 
-Why do we need this ?
-~~~~~~~~~~~~~~~~~~~~~
+#### Why do we need this?
 
-For multiple jobs in PHP world:
+For multiple jobs in a PHP world:
 
--  moving the accompanying period to another steps when inactive,
+-  moving the accompanying period to another step when inactive,
    automatically;
 -  listing all the users which are intervening on the action on a new
    “Liste des intervenants” page;
 -  filtering on exports
 
-Later, we will launch automatic anonymise for accompanying period and
+Later we will launch automatic anonymize for an accompanying period and
 all related entities through this information.
 
-How is built the SQL views which is mapped to “info” entities ?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+#### How are the SQL views built that are mapped to “info” entities?
 
 The AccompanyingPeriodInfo entity is mapped by a SQL view (not a regular
 table).
 
-The sql view is built dynamically, it is a SQL view like this, for now (April 2023):
-
-.. code:: sql
+The SQL view is built dynamically; it is a SQL view like this, for now (April 2023):
 
+```sql
    create view view_chill_person_accompanying_period_info
                (accompanyingperiod_id, relatedentity, relatedentityid, user_id, infodate, discriminator, metadata) as
    SELECT w.accompanyingperiod_id,
@@ -191,13 +173,14 @@ The sql view is built dynamically, it is a SQL view like this, for now (April 20
    FROM activity
             LEFT JOIN activity_user au ON activity.id = au.activity_id
    WHERE activity.accompanyingperiod_id IS NOT NULL;
+```
 
-As you can see, the view gather multiple SELECT queries and bind them
+As you can see, the view gathers multiple SELECT queries and binds them
 with UNION.
 
 Each SELECT query is built dynamically, through a class implementing an
 interface: ``Chill\PersonBundle\Service\EntityInfo\AccompanyingPeriodInfoUnionQueryPartInterface``, `like
-here <https://gitlab.com/Chill-Projet/chill-bundles/-/blob/master/src/Bundle/ChillPersonBundle/Service/EntityInfo/AccompanyingPeriodInfoQueryPart/AccompanyingPeriodWorkEndQueryPartForAccompanyingPeriodInfo.php>`__
+here <https://gitlab.com/Chill-Projet/chill-bundles/-/blob/master/src/Bundle/ChillPersonBundle/Service/EntityInfo/AccompanyingPeriodInfoQueryPart/AccompanyingPeriodWorkEndQueryPartForAccompanyingPeriodInfo.php.md)__
 
-To add new `SELECT` query in different `UNION` parts in the sql view, create a
+To add new `SELECT` query in different `UNION` parts in the SQL view, create a
 service and implements this interface: ``Chill\PersonBundle\Service\EntityInfo\AccompanyingPeriodInfoUnionQueryPartInterface``.

docs/source/development/es-lint.md

@@ -1,12 +1,10 @@
-ESLint
-======
+## ESLint
 
 To improve the quality of our JS and VueJS code, ESLint and eslint-plugin-vue are implemented within the chill-bundles project.
 
-Commands
---------
+### Commands
 
-To run ESLint, you can simply use the ``eslint`` command within the chill-bundles directory.
+To run ESLint, you can simply use the [`eslint`` command within the chill-bundles directory.
 This runs eslint **not** taking the baseline into account, thus showing all existing errors in the project.
 
 A script was also added to package.json allowing you to execute ``yarn run eslint``.
@@ -19,20 +17,18 @@ Interesting options that can be used in combination with eslint are:
 - ``--quiet`` to only get errors and silence the warnings
 - ``--fix`` to have ESLint fix what it can, automatically. This will not fix everything.
 
-Baseline
---------
+### Baseline
 
-To allow us the time to fix linting errors/warnings a baseline has been created using the following command
+To allow us the time to fix linting errors/warnings, a baseline has been created using the following command
 - ``npx eslint-baseline "**/*.{js,vue}"``
 
-The baseline has been commited and the gitlab CI setup to only fail upon new errors/warnings being created.
+The baseline has been committed and the gitlab CI setup to only fail upon new errors/warnings being created.
 When fixing errors/warnings manually, please update the baseline.
 
 1. Delete the current baseline file
 2. Run the above command locally, this will automatically create a new baseline that should be commited
 
-Rules
------
+### Rules
 
 We use Vue 3, so the rules can be configured as follows within the ``eslint.config.mjs`` file:
 
@@ -45,17 +41,14 @@ Configurations for using Vue.js 3.x:
 - ``.configs["flat/recommended"]`` ... Above, plus rules to enforce subjective community defaults to ensure consistency.
 
 Detailed information about which rules each set includes can be found here:
-`https://eslint.vuejs.org/rules/ <https://eslint.vuejs.org/rules/>`_
+`https://eslint.vuejs.org/rules/ ](https://eslint.vuejs.org/rules/)
 
-Manual Rule Configuration
--------------------------
+### Manual Rule Configuration
 
 We can also manually configure certain rules or override rules that are part of the ruleset specified above.
 
 For example, if we want to turn off a certain rule, we can do so as follows:
 
-.. code-block:: javascript
-
     rules: {
       'vue/multi-word-component': 'off'
     }
@@ -64,8 +57,6 @@ We could also change the severity of a certain rule from 'error' to 'warning', f
 
 Within specific ``.js`` or ``.vue`` files, we can also override a certain rule only for that specific file by adding a comment:
 
-.. code-block:: javascript
-
     /* eslint multi-word-component: "off", no-child-content: "error"
     --------
     Here's a description about why this configuration is necessary. */

docs/source/development/exports.md

@@ -1,66 +1,49 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-
-Exports
-*******
+###### Exports
 
 Export is an important issue within the Chill software : users should be able to :
 
 - compute statistics about their activity ;
 - list "things" which are a part of their activities.
 
-The `main bundle`_ provides a powerful framework to build custom queries with re-usable parts across differents bundles.
+The [main bundle`_ provides a powerful framework to build custom queries with re-usable parts across differents bundles.
 
-.. contents:: Table of content
    :local:
 
-.. seealso::
-
-   `The issue where this framework was discussed <https://git.framasoft.org/Chill-project/Chill-Main/issues/9>`_
+   `The issue where this framework was [discussed](https://git.framasoft.org/Chill-project/Chill-Main/issues/9)
       Provides some information about the pursued features and architecture.
 
-Concepts
-========
+## Concepts
 
-
-Some vocabulary: 3 "Export elements"
-------------------------------------
+### Some vocabulary: 3 "Export elements"
 
 Four terms are used for this framework :
 
 Exports
    provide some basic operation on the data. Two kinds of exports are available :
 
-   - computed data : it may be "the number of people", "the number of activities", "the duration of activities", ...
-   - list data : it may be "the list of people", "the list of activities", ...
+   - computed data: it may be "the number of people," "the number of activities," "the duration of activities," ...
+   - list data: it may be "the list of people," "the list of activities," ...
 
 Filters
    The filters create a filter on the data: it removes some information the user doesn't want to introduce in the computation done by the export.
 
-   Example of a filter: "people under 18 years olds", "activities between the 1st of June and the 31st December", ...
+   Example of a filter: "people under 18-year-olds," "activities between the 1st of June and the 31st December," ...
 
 Aggregators
    The aggregator aggregates the data into some group (some software use the term 'bucket').
 
-   Example of an aggregator : "group people by gender", "group people by nationality", "group activity by type", ...
+   Example of an aggregator: "group people by gender," "group people by nationality," "group activity by type," ...
 
 Formatters
    The formatters format the data into a :class:`Symfony\Component\HttpFoundation\Response`, which  will be returned "as is" by the controller to the web client.
 
-   Example of a formatter: "format data as CSV", "format data as an ods spreadsheet", ...
+   Example of a formatter: "format data as CSV", "format data as an ods spreadsheet," ...
 
-Anatomy of an export
----------------------
+### Anatomy of an export
 
 An export can be thought of as a sentence where each part of this sentence refers to one or multiple export elements. Examples :
 
-**Example 1**: Count the number of people having at least one activity in the last 12 month, and group them by nationality and gender, and format them in a CSV spreadsheet.
+**Example 1**: Count the number of people having at least one activity in the last month 12, and group them by nationality and gender, and format them in a CSV spreadsheet.
 
 Here :
 
@@ -73,21 +56,16 @@ Here :
 Note that :
 
 - Aggregators, filters, exports and formatters are cross-bundle. Here the bundle *activity* provides a filter which is applied on an export provided by the person bundle ;
-- Multiple aggregator or filter for one export may exist. Currently, only one export is allowed.
+- Multiple aggregators or filters for one export may exist. Currently, only one export is allowed.
 
 The result might be :
 
-+-----------------------+----------------+---------------------------+
-| Nationality           | Gender         | Number of people          |
-+=======================+================+===========================+
-| Russian               | Male           | 12                        |
-+-----------------------+----------------+---------------------------+
-| Russian               | Female         | 24                        |
-+-----------------------+----------------+---------------------------+
-| France                | Male           | 110                       |
-+-----------------------+----------------+---------------------------+
-| France                | Female         | 150                       |
-+-----------------------+----------------+---------------------------+
++-------------+--------+------------------+
+| Nationality | Gender | Number of people |
+| Russian | Male | 12 |
+| Russian | Female | 24 |
+| France | Male | 110 |
+| France | Female| 150 |
 
 **Example 2**: Count the average duration of an activity with type "meeting", which occurs between the 1st of June and the 31st of December, group them by week, and format the data in an OpenDocument spreadsheet.
 
@@ -103,122 +81,97 @@ The result might be :
 
 +-----------------------+----------------------+
 | Week                  | Number of activities |
-+=======================+======================+
 | 2015-10               | 10                   |
-+-----------------------+----------------------+
 | 2015-11               | 12                   |
-+-----------------------+----------------------+
 | 2015-12               | 10                   |
-+-----------------------+----------------------+
 | 2015-13               | 9                    |
-+-----------------------+----------------------+
 
-Authorization and exports
--------------------------
+### Authorization and exports
 
-Exports, filters and aggregators should not show data the user is not allowed to see within the application.
+Exports, filters, and aggregators should not show data the user is not allowed to see within the application.
 
 In other words, developers are required to take care of user authorization for each export.
 
 There should be a specific role that grants permission to users who are allowed to build exports. For more simplicity, this role should apply on a center, and should not require special circles.
 
-How does the magic work ?
-===========================
+## How does the magic work?
 
 To build an export, we rely on the capacity of the database to execute queries with aggregate (i.e. GROUP BY) and filter (i.e. WHERE) instructions.
 
-An export is an SQL query which is initiated by an export, and modified by aggregators and filters.
+An export is an SQL query that is initiated by an export and modified by aggregators and filters.
 
-.. note::
-
-   **Example**: Count the number of people having at least one activity in the last 12 month, and group them by nationality and gender
+   **Example**: Count the number of people having at least one activity in the last month 12, and group them by nationality and gender
 
    1. The report initiates the query
 
-   .. code-block:: SQL
-
+   ```SQL
       SELECT count(people.*) FROM people
+```
 
    2. The filter adds a where and join clause :
 
-   .. code-block:: SQL
-
+   ```SQL
       SELECT count(people.*) FROM people
          RIGHT JOIN activity
          WHERE activity.date IS BETWEEN now AND 6 month ago
+```
 
    3. The aggregator "nationality" adds a GROUP BY clause and a column in the SELECT statement:
 
-   .. code-block:: sql
-
+   ```sql
       SELECT people.nationality, count(people.*) FROM people
          RIGHT JOIN activity
          WHERE activity.date IS BETWEEN now AND 6 month ago
          GROUP BY nationality
+```
 
    4. The aggregator "gender" does the same job as the nationality aggregator : it adds a GROUP BY clause and a column in the SELECT statement :
 
-   .. code-block:: sql
-
+   ```sql
       SELECT people.nationality, people.gender, count(people.*)
          FROM people RIGHT JOIN activity
          WHERE activity.date IS BETWEEN now AND 6 month ago
          GROUP BY nationality, gender
+```
 
-Each filter, aggregator and filter may collect parameters from the user through a form. This form is appended to the export form. Here is an example.
-
-.. figure:: /_static/screenshots/development/export_form-fullpage.png
+Each filter, aggregator, and filter may collect parameters from the user through a form. This form is appended to the export form. Here is an example.
 
    The screenshot shows the export form for ``CountPeople`` (Nombre de personnes). The filter by date of birth is checked (*Filtrer par date de naissance de la personne*), which triggers a subform, which is provided by the :class:`Chill\PersonBundle\Export\Filter\BirthdateFilter`. The other unchecked filter does not show the subform.
 
-   Two aggregators are also checked : by Country of birth (*Aggréger les personnes par pays de naissance*, the corresponding class is :class:`Chill\PersonBundle\Export\Aggregator\CountryOfBirthAggregator`, which also triggers a subform. The aggregator by gender (*Aggréger les personnes par genre*) is also checked, but there is no corresponding subform.
+   Two aggregators are also checked: by Country of birth (*Aggréger les personnes par pays de naissance*, the corresponding class is :class:`Chill\PersonBundle\Export\Aggregator\CountryOfBirthAggregator`, which also triggers a subform. The aggregator by gender (*Aggréger les personnes par genre*) is also checked, but there is no corresponding subform.
 
-The Export Manager
-------------------
+### The Export Manager
 
-The Export manager (:class:`Chill\MainBundle\Export\ExportManager` is the central class which registers all exports, aggregators, filters and formatters.
+The Export manager (:class:`Chill\MainBundle\Export\ExportManager` is the central class which registers all exports, aggregators, filters, and formatters.
 
 The export manager is also responsible for orchestrating the whole export process, producing a :class:`Symfony\FrameworkBundle\HttpFoundation\Request` for each export request.
 
-
-The export form step
---------------------
+### The export form step
 
 The form step allows you to build a form, combining different parts of the module.
 
 The building of forms is split into different subforms, where each one is responsible for rendering their part of the form (aggregators, filters, and export).
 
-.. figure:: /_static/puml/exports/form_steps.png
    :scale: 40%
 
-The formatter form step
------------------------
+### The formatter form step
 
 The formatter form is processed *after* the user filled the export form. It is built the same way, but receives the data entered by the user on the previous step as parameters (i.e. export form). It may then adapt it accordingly (example: show a list of columns selected in aggregators).
 
-Processing the export
----------------------
+### Processing the export
 
-The export process can be explained by this schema :
+This schema can explain the export process :
 
-.. figure:: /_static/puml/exports/processing_export.png
    :scale: 40%
 
    (Click to enlarge)
 
+## Export, formatters, and filters explained
 
-Export, formatters and filters explained
-========================================
-
-Exports
--------
+### Exports
 
 This is an example of the ``CountPerson`` export :
 
-.. literalinclude:: /_static/code/exports/CountPerson.php
-   :language: php
-   :linenos:
-
 * **Line 36**: the ``getType`` function returns a string. This string will be used to find the aggregtors and filters which will apply to this export.
 * **Line 41**: a simple description to help users understand what your export does.
 * **Line 46**: The title of the export. A summary of what your export does.
@@ -226,26 +179,17 @@ This is an example of the ``CountPerson`` export :
 * **Line 56**: We initiate the query here...
 * **Line 59**: We have to filter the query with centers the users checked in the form. We process the $acl variable to get all ``Center`` objects in one array
 * **Line 63**: We create the query with a query builder.
-* **Line 74**: We return the result, but make sure to hydrate the results as an array.
+* **Line 74**: We return the result but make sure to hydrate the results as an array.
 * **Line 103**: return the list of formatter types which are allowed to be applied on this filter
 
-Filters
--------
+### Filters
 
-This is an example of the *filter by birthdate*. This filter asks some information through a form (`buildForm` is not empty), and this form must be validated. To perform this validation, we implement a new Interface: :class:`Chill\MainBundle\Export\ExportElementValidatedInterface`:
-
-.. literalinclude:: /_static/code/exports/BirthdateFilter.php
-   :language: php
-
-.. todo::
+This is an example of the *filter by birthdate*. This filter asks some information through a form (`buildForm` is not empty), and this form must be validated. To perform this validation, we implement a new Interface: `Chill\MainBundle\Export\ExportElementValidatedInterface`:
 
    Continue to explain the export framework
 
-.. _main bundle: https://git.framasoft.org/Chill-project/Chill-Main
-
-
-With many-to-* relationship, why should we set WHERE clauses in an EXISTS subquery instead of a JOIN ?
-``````````````````````````````````````````````````````````````````````````````````````````````````````
+With many-to-* relationship, why should we set WHERE clauses in an EXISTS subquery instead of a JOIN?
+-----------------------------------------------------------------------------------------------------
 
 As we described above, the doctrine builder is converted into a sql query. Let's see how to compute the "number of course
 which count at least one activity type with the id 7". For the purpose of this demonstration, we will restrict this on
@@ -253,79 +197,65 @@ two accompanying period only: the ones with id 329 and 334.
 
 Let's see the list of activities associated with those accompanying period:
 
-.. code-block:: sql
-
    SELECT id, accompanyingperiod_id, type_id FROM activity WHERE accompanyingperiod_id IN (329, 334) AND type_id = 7
        ORDER BY accompanyingperiod_id;
 
 We see that we have 6 activities for the accompanying period with id 329, and only one for the 334's one.
 
-.. csv-table::
-   :header: id, accompanyingperiod_id, type_id
-
-   990,329,7
-   986,329,7
-   987,329,7
-   993,329,7
-   991,329,7
-   992,329,7
-   1000,334,7
+| id   | accompanyingperiod_id | type_id |
+|------|----------------------|---------|
+| 990  | 329                  | 7       |
+| 986  | 329                  | 7       |
+| 987  | 329                  | 7       |
+| 993  | 329                  | 7       |
+| 991  | 329                  | 7       |
+| 992  | 329                  | 7       |
+| 1000 | 334                  | 7       |
 
 Let's calculate the average duration for those accompanying periods, and the number of period:
 
-.. code-block:: sql
-
    SELECT AVG(age(COALESCE(closingdate, CURRENT_DATE), openingdate)), COUNT(id) from chill_person_accompanying_period WHERE id IN (329, 334);
 
 The result of this query is:
 
-.. csv-table::
-   :header: AVG, COUNT
+| AVG                                              | COUNT |
+|--------------------------------------------------|-------|
+| 2 years 2 mons 21 days 12 hours 0 mins 0.0 secs | 2     |
 
-   2 years 2 mons 21 days 12 hours 0 mins 0.0 secs,2
-
-Now, we count the number of accompanying period, adding a :code:`JOIN` clause which make a link to the :code:`activity` table, and add a :code:`WHERE` clause to keep
+Now, we count the number of accompanying period, adding a `JOIN` clause which make a link to the `activity` table, and add a `WHERE` clause to keep
 only the accompanying period which contains the given activity type:
 
-.. code-block:: sql
-
    SELECT COUNT(chill_person_accompanying_period.id) from chill_person_accompanying_period
                  JOIN activity ON chill_person_accompanying_period.id = activity.accompanyingperiod_id
                  WHERE chill_person_accompanying_period.id IN (329, 334) AND activity.type_id = 7;
 
-What are the results here ?
+What are the results here?
 
-.. csv-table::
-   :header: COUNT
+| COUNT |
+|-------|
+| 7     |
 
-   7
-
-:code:`7` ! Why this result ? Because the number of lines is duplicated for each activity. Let's see the list of rows which
+`7` ! Why this result? Because the number of lines is duplicated for each activity. Let's see the list of rows which
 are taken into account for the computation:
 
-.. code-block:: sql
-
    SELECT chill_person_accompanying_period.id, activity.id from chill_person_accompanying_period
    JOIN activity ON chill_person_accompanying_period.id = activity.accompanyingperiod_id
    WHERE chill_person_accompanying_period.id IN (329, 334) AND activity.type_id = 7;
 
-.. csv-table::
-   :header: accompanyingperiod.id, activity.id
+| accompanyingperiod.id | activity.id |
+|----------------------|-------------|
+| 329                  | 993         |
+| 334                  | 1000        |
+| 329                  | 987         |
+| 329                  | 990         |
+| 329                  | 991         |
+| 329                  | 992         |
+| 329                  | 986         |
 
-   329,993
-   334,1000
-   329,987
-   329,990
-   329,991
-   329,992
-   329,986
-
-For each activity, a row is created and, as we count the number of non-null :code:`accompanyingperiod.id` columns, we
+For each activity, a row is created and, as we count the number of non-null `accompanyingperiod.id` columns, we
 count one entry for each activity (actually, we count the number of activities).
 
-So, let's use the :code:`DISTINCT` keyword to count only once the equal ids:
-
-.. code-block::
+So, let's use the `DISTINCT` keyword to count only once the equal ids:
 
    SELECT COUNT(DISTINCT chill_person_accompanying_period.id) from chill_person_accompanying_period
    JOIN activity ON chill_person_accompanying_period.id = activity.accompanyingperiod_id
@@ -333,38 +263,31 @@ So, let's use the :code:`DISTINCT` keyword to count only once the equal ids:
 
 Now, it works again...
 
-.. csv-table::
-   :header: COUNT
+| COUNT |
+|-------|
+| 2     |
 
-   2
+But, for the average duration, this won't work: the duration which are equals (because the `openingdate` is the same and
+`closingdate` is still `NULL`, for instance) will be counted only once, which will give unexpected result.
 
-But, for the average duration, this won't work: the duration which are equals (because the :code:`openingdate` is the same and
-:code:`closingdate` is still :code:`NULL`, for instance) will be counted only once, which will give unexpected result.
-
-The solution is to move the condition "having an activity with activity type with id 7" in a :code:`EXISTS` clause:
-
-.. code-block:: sql
+The solution is to move the condition "having an activity with activity type with id 7" in a `EXISTS` clause:
 
    SELECT COUNT(chill_person_accompanying_period.id) from chill_person_accompanying_period
    WHERE chill_person_accompanying_period.id IN (329, 334) AND EXISTS (SELECT 1 FROM activity WHERE type_id = 7 AND accompanyingperiod_id = chill_person_accompanying_period.id);
 
-The result is correct without :code:`DISTINCT` keyword:
+The result is correct without `DISTINCT` keyword:
 
-.. csv-table::
-   :header: COUNT
-
-   2
+| COUNT |
+|-------|
+| 2     |
 
 And we can now compute the average duration without fear:
 
-.. code-block:: sql
-
   SELECT AVG(age(COALESCE(closingdate, CURRENT_DATE), openingdate)) from chill_person_accompanying_period
   WHERE chill_person_accompanying_period.id IN (329, 334) AND EXISTS (SELECT 1 FROM activity WHERE type_id = 7 AND accompanyingperiod_id = chill_person_accompanying_period.id);
 
 Give the result:
 
-.. csv-table::
-   :header: AVG
-
-   2 years 2 mons 21 days 12 hours 0 mins 0.0 secs
+| AVG                                              |
+|--------------------------------------------------|
+| 2 years 2 mons 21 days 12 hours 0 mins 0.0 secs |

docs/source/development/forms.md

@@ -0,0 +1,25 @@
+# Forms and form types
+
+###### Date picker
+
+Class
+   `Chill\MainBundle\Form\Type\ChillDateType`
+Extend
+   `Symfony\Component\Form\Extension\Core\Type\DateType`
+
+Usage :
+
+```
+   use Chill\MainBundle\Form\Type\ChillDateType;
+
+   $builder->add('date' ChillDateType::class);
+```
+
+###### Text editor
+
+Add a text editor (by default).
+
+Class
+   `Chill\MainBundle\Form\Type\ChillTextareaType`
+Options
+   * `disable_editor` to disable text editor

docs/source/development/forms.rst

@@ -1,42 +0,0 @@
-
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-.. _forms:
-
-Forms and form types
-####################
-
-Date picker
-***********
-
-Class
-   :class:`Chill\MainBundle\Form\Type\ChillDateType`
-Extend
-   :class:`Symfony\Component\Form\Extension\Core\Type\DateType`
-
-
-Usage :
-
-.. code-block:: php
-
-   use Chill\MainBundle\Form\Type\ChillDateType;
-
-   $builder->add('date' ChillDateType::class);
-
-Text editor
-***********
-
-Add a text editor (by default).
-
-Class
-   :class:`Chill\MainBundle\Form\Type\ChillTextareaType`
-Options
-   * :code:`disable_editor` to disable text editor
-
-

docs/source/development/index.md

@@ -0,0 +1,41 @@
+# Development
+
+As Chill relies on the [symfony ](http://symfony.com) framework, reading the framework's documentation should answer most of your questions. We are explaining here some tips to work with Chill, and help with things we've encountered.
+
+- [Instructions to create a new bundle](create-a-new-bundle.md)
+- [CRUD (Create - Update - Delete) for one entity](crud.md)
+- [Helpers for building a REST API](api.md)
+- [Routing](routing.md)
+- [Menus](menus.md)
+- [Forms](forms.md)
+- [Access control model](access_control_model.md)
+- [Messages to users](messages-to-users.md)
+- [Pagination](pagination.md)
+- [Localisation](localisation.md)
+- [Logging](logging.md)
+- [Database migrations](migrations.md)
+- [Searching](searching.md)
+- [Timelines](timelines.md)
+- [Exports](exports.md)
+- [Embeddable comments](embeddable-comments.md)
+- [Run tests](run-tests.md)
+- [ESLint](es-lint.md)
+- [Useful snippets](useful-snippets.md)
+- [Manual](manual/index.md)
+- [Assets](assets.md)
+- [Cron Jobs](cronjob.md)
+- [Info about entities](entity-info.md)
+- [Info about database (in French)](database-principles.md)
+- [Developer FAQ](FAQ.md)
+
+###### Layout and UI
+
+- [Render entities automatically](render-entity.md)
+- [Layout / Template usage](user-interface/layout-template-usage.md)
+- [Classes and mixins](user-interface/css-classes.md)
+- [Widgets](user-interface/widgets.md)
+- [Javascript function](user-interface/js-functions.md)
+
+###### Help, I am lost!
+
+Write an email at info@champs-libres.coop, and we will help you!

docs/source/development/index.rst

@@ -1,59 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-Development
-###########
-
-As Chill relies on the `symfony <http://symfony.com>`_ framework, reading the framework's documentation should answer most of your questions. We are explaining here some tips to work with Chill, and help with things we've encountered.
-
-.. toctree::
-    :maxdepth: 2
-
-    Instructions to create a new bundle <create-a-new-bundle.rst>
-    CRUD (Create - Update - Delete) for one entity <crud.rst>
-    Helpers for building a REST API <api.rst>
-    Routing <routing.rst>
-    Menus <menus.rst>
-    Forms <forms.rst>
-    Access control model <access_control_model.rst>
-    Messages to users <messages-to-users.rst>
-    Pagination <pagination.rst>
-    Localisation <localisation.rst>
-    Logging <logging.rst>
-    Database migrations <migrations.rst>
-    Searching <searching.rst>
-    Timelines <timelines.rst>
-    Exports <exports.rst>
-    Embeddable comments <embeddable-comments.rst>
-    Run tests <run-tests.rst>
-    ESLint <es-lint.rst>
-    Useful snippets <useful-snippets.rst>
-    manual/index.rst
-    Assets <assets.rst>
-    Cron Jobs <cronjob.rst>
-    Info about entities <entity-info.rst>
-    Info about database (in French) <database-principles.rst>
-    Developer FAQ <FAQ.rst>
-
-Layout and UI
-**************
-
-.. toctree::
-   :maxdepth: 2
-
-   Render entities automatically <render-entity.rst>
-   Layout / Template usage <user-interface/layout-template-usage.rst>
-   Classes and mixins <user-interface/css-classes.rst>
-   Widgets <user-interface/widgets.rst>
-   Javascript function <user-interface/js-functions.rst>
-
-
-Help, I am lost !
-*****************
-
-Write an email at info@champs-libres.coop, and we will help you !

docs/source/development/localisation.md

@@ -0,0 +1,30 @@
+###### Localisation
+
+## Language in url
+
+Language should be present in URL, conventionally as the first argument.
+
+   `/fr/your/url/here`
+
+This allows users to change from one language to another one on each page, which may be useful in multilanguages teams. If the installation is single-language, the language switcher will not appears.
+
+This is an example of routing defined in YAML :
+
+```yaml
+   chill_person_general_edit:
+       pattern: /{_locale}/person/{person_id}/general/edit
+       defaults: {_controller: ChillPersonBundle:Person:edit }
+```
+
+## Date and time
+
+The [Intl extension ](http://twig.sensiolabs.org/doc/extensions/intl.html) is enabled on the Chill application.
+
+You may format date and time using the [localizeddate` function :
+
+   `date|localizeddate('long', 'none')`
+
+By default, we prefer using the `long` format for date formatting.
+
+   [Documentation for Intl Extension](http://twig.sensiolabs.org/doc/extensions/intl.html)
+      Read the complete doc for the Intl extension.

docs/source/development/localisation.rst

@@ -1,49 +0,0 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
-   under the terms of the GNU Free Documentation License, Version 1.3
-   or any later version published by the Free Software Foundation;
-   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-   A copy of the license is included in the section entitled "GNU
-   Free Documentation License".
-
-Localisation
-*************
-
-Language in url
-===============
-
-Language should be present in URL, conventionnaly as first argument. 
-
-.. code-block:: none
-
-   /fr/your/url/here
-
-This allow users to change from one language to another one on each page, which may be useful in multilanguages teams. If the installation is single-language, the language switcher will not appears.
-
-This is an example of routing defined in yaml : 
-
-.. code-block:: yaml
-
-   chill_person_general_edit:
-       pattern: /{_locale}/person/{person_id}/general/edit
-       defaults: {_controller: ChillPersonBundle:Person:edit }
-
-
-Date and time
-==============
-
-The `Intl extension <http://twig.sensiolabs.org/doc/extensions/intl.html>`_ is enabled on the Chill application. 
-
-You may format date and time using the `localizeddate` function : 
-
-.. code-block:: jinja
-
-   date|localizeddate('long', 'none')
-
-By default, we prefer using the `long` format for date formatting.
-
-.. seealso::
-
-   `Documentation for Intl Extension <http://twig.sensiolabs.org/doc/extensions/intl.html>`_
-      Read the complete doc for the Intl extension.
-   

docs/source/development/logging.md

@@ -1,50 +1,41 @@
-.. Copyright (C)  2016 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
+###### Logging
 
-Logging
-*******
 
-.. seealso::
-   
-   Symfony documentation: `How to user Monolog to write logs <http://symfony.com/doc/current/cookbook/logging/monolog.html>`_
+   Symfony documentation: [How to user Monolog to write logs ](http://symfony.com/doc/current/cookbook/logging/monolog.html)
       The symfony cookbook page about logging.
 
+A channel for custom logging has been created to store sensitive data.
 
-A channel for custom logging has been created to store sensitive data. 
-
-The channel is named ``chill``. 
+The channel is named ``chill``.
 
 The installer of chill should be aware that this channel may contains sensitive data and encrypted during backup.
 
-Logging to channel `chill`
-============================
+## Logging to channel `chill`
 
-You should use the service named ``chill.main.logger``, as this : 
+You should use the service named ``chill.main.logger``, as this :
 
-.. code-block:: php
+   `$logger = $this->get('chill.main.logger');`
 
-   $logger = $this->get('chill.main.logger');
+You should store data into context, not in the log himself, which should remains the same for the action.
 
-You should store data into context, not in the log himself, which should remains the same for the action. 
-
-Example of usage : 
-
-.. code-block:: php
+Example of usage :
 
+```php
    $logger->info("An action has been performed about a person", array(
       'person_lastname' => $person->getLastName(),
       'person_firstname' => $person->getFirstName(),
       'person_id' => $person->getId(),
       'by_user' => $user->getUsername()
    ));
+```
 
 For further processing, it is a good idea to separate all fields (like firstname, lastname, ...) into different context keys.
 
 By convention, you should store the username of the user performing the action under the ``by_user`` key.
-

docs/source/development/manual/index.md

@@ -1,17 +1,10 @@
-.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
-   Permission is granted to copy, distribute and/or modify this document
+Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.3
    or any later version published by the Free Software Foundation;
    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    A copy of the license is included in the section entitled "GNU
    Free Documentation License".
 
-Developer manual
-*****************
-
-.. toctree::
-   :maxdepth: 2
-
-   routing-and-menus.rst
-
+###### Developer manual
 
+- [Routing and Menus](routing-and-menus.md)