Artifact 3097b9a76abb18c713394fa4a224c932d7f1c731dcffea97ce26f270482d809e:

Wiki page [Roadmap] by bohwaz on 2021-04-05 21:00:00.
D 2021-04-05T19:00:00.316
L Roadmap
N text/x-markdown
P bff5f3c7bc7fab9c2e335583a45b71803b918c3c9c7f466a8fb9494fb289531f
U bohwaz
W 13002
# Feuille de route

Les bugs sont corrigés et publiés dans la version stable, les nouvelles fonctionnalités sont ajoutées dans la version de développement (branche `dev`) qui sera publiée quand les objectif de cette version seront atteints.

Une liste plus précise de fonctionnalités demandées est également listée dans les [tickets](/rptview?rn=6) (mais on n'a pas forcément le temps de créer un ticket pour chaque fonctionnalité !).

## État actuel des fonctionnalités

| Fonctionnalité | Statut | État | Remarques |
| --- | --- | --- |
| Membres | Implémenté | Code à moderniser | Refactoring / ré-écriture partielle à faire, code à passer en anglais |
| Comptabilité | Implémenté | Satisfaisant | Quelques détails à revoir pour améliorer la simplicité et l'accessibilité |
| Activités et cotisations | Implémenté | Satisfaisant | Permettre d'enregistrer plusieurs membres en même temps |
| Fichiers | Implémenté | Satisfaisant | Base fonctionnelle. Fonctionnalités à ajouter |
| Site web | Implémenté | Refactoring à terminer | Passer à un modèle d'édition de page proche de Kirby |
| Mailing | Implémenté | À améliorer | Pas de gestion des retours, texte simple, pas de possibilité d'exporter la liste des destinataires facilement |
| Documentation | Succinte | En cours | À réorganiser, rédiger, rendre plus accessible |
| Tests unitaires | Inexistants ou presque | À écrire… | |
| Tests fonctionnels | Dépassés | À refaire | |

## Prochaines versions

### Version 1.1 — Gestion de fichiers / refonte site web (~avril 2021)

Nécessite désormais PHP 7.4 ou supérieur pour fonctionner.

Refonte gestion site web :

* Changement du langage de squelettes, vers [Brindille](Documentation/Brindille), pour permettre plus de choses
* Transformation wiki en catégories et pages web
* Les pages wiki non publiques sont transformées en pages web "brouillon"
* Suppression de la notion de page interne / externe / restreinte à la même catégorie
* Possibilité de mettre une page en "brouillon" (non publiée en ligne)
* Déplacement de l'édition de squelette dans le menu **Site web**
* Stockage des squelettes dans la base de données, avec le reste des fichiers
* Transformation de la page wiki de bienvenue en fichier Skriv éditable
* Suppression de la page wiki d'inscription (en attendant la possibilité de s'inscrire)
* Les pages chiffrées sont désormais accessibles publiquement (sauf si brouillon évidemment)

Ajout section "Documents" :

*  Stockage dans le backend de fichiers de Garradin
*  Possibilité de stocker les fichiers dans le système de fichier directement
*  Gestion répertoires / fichiers
*  Edition / prévisualisation de fichiers textes, images, PDF et audio/vidéo
*  Upload de fichier
* Création de fichier texte
* Refonte gestion des fichiers dans les écritures comptables
* Recherche de fichier
* Déplacement/suppression de fichier en masse
* Limitation possible du quota de fichiers
* Téléchargement de tous les fichiers sous forme de ZIP

Membres :

*  Possibilité d'avoir des champs de type fichier dans les fiches de membre, permettant de joindre un scan ou une photo (trombi) [par exemple](/info/c41169057a3f198871cc82677cd331ae201b778f)

Maintenance du code :

* Ré-écriture catégories de membres
* Ré-écriture configuration
* Pour les fermes à Garradin les templates compilés peuvent être partagés entre toutes les instances (gain de performance)

Divers :

* Ajout d'une [API](API) REST minimaliste
* Ajout du support des images WebP dans les fichiers

#### Stockage de fichiers

Les plugins, la base de données, les sauvegardes et les fichiers de cache sont désormais tous stockés dans un sous-répertoire `data` par défaut, afin de réunir tous les fichiers modifiés par Garradin dans le même dossier.

Les fichiers à l'intérieur de Garradin sont stockés par défaut dans la base de données SQLite. Il est également possible de les stocker dans le système de fichiers directement, via deux constantes de configuration dans le fichier `config.local.php` :

```
const FILE_STORAGE_BACKEND = 'FileSystem';
const FILE_STORAGE_CONFIG = __DIR__ . '/data/files';
```

Ceci stockera les fichiers dans le répertoire `data/files` de Garradin.

Une autre constante `FILE_STORAGE_QUOTA` permet de définir un quota maximum. Si cette constante n'est pas définie, le quota maximal est l'espace disponible sur le système de fichier.

#### Développeurs⋅ses et utilisateurs⋅trices experts

Squelettes :

* Les anciens squelettes du répertoire `squelettes` ne sont plus utilisés, si vous aviez des squelettes personnalisés votre site retournera aux squelettes par défaut.
* Les squelettes sont désormais stockés dans la base de données, il vous faudra donc utiliser l'éditeur intégré (dans Site web -> Configuration) pour modifier les squelettes ou en créer de nouveaux.
* Le langage des squelettes a changé, nous utilisons maintenant [Brindille](Documentation/Brindille), qui donne plus de possibilités, voir la [documentation des squelettes](Squelettes) pour plus de détails.

Plugins :

* Dans la condition d'affichage du menu (paramètre `menu_condition`), les variables `{$membre.DROIT_*}` deviennent `{ACCESS_*}`. Penser aussi à renommer les colonnes `droit_*` en `perm_*`
* Ajout des signaux suivants (voir [la documentation des plugins pour plus de détails](wiki:Plugins)) :
  * `usertemplate.init`
  * `entity.NAME.save.before`
  * `entity.NAME.save.after`
  * `entity.NAME.delete.before`
  * `entity.NAME.delete.after`
  * `files.ACTION` avec ACTION = move, delete, store ou mkdir

SQL :

* La table `membres_categories` a été renommée en `users_categories` et ses colonnes ont été renommées en anglais (`droit_*` deviennent `perm_*`)
* La colonne `id_categorie` de la table `membres` a été renommée `category_id`
* La version n'est plus stockée dans la table `config` mais dans `PRAGMA user_version` sous forme d'entier
* La table `config` a vu ses colonnes renommées en anglais
* Les tables du wiki ont été supprimées
* La table `fichiers` a été renommée `files`, et `fichiers_contenu` est devenue `files_contents`
* La fonction `transliterate_to_ascii` utilisée pour comparer des `strings` unicode n'existe plus, à la place la collation `NOCASE` de SQLite est remplacée par un une collation qui prend en compte Unicode

PHP :

* Les méthodes `Session->canAccess` et `Session->requireAccess` attendent désormais une constante de type `Session::SECTION_` en premier argument, et une constante de type `Session::ACCESS_` en second argument
* Les classes `Fichiers`, `Wiki`, `Squelette` et `Squelette_Filtres` ont été supprimées
* La classe `Membres\Categories` est devenue `Users\Categories` et `Entities\Users\Categories`

Templates :

* Le modifieur `strftime_fr` a été renommé `strftime`
* Le modifieur `html_money` a été renommé `money`
* Le modifieur `date_fr` a été renommé `date`
* Le modifieur `format_bytes` a été renommé `size_in_bytes`
* Le modifieur `format_wiki` a été renommé en `format_skriv`

Javascript :

* la méthode `g.load()` qui permettait de faire une requête XHR a été supprimée. Il est conseille d'utiliser la promise [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch) à la place.

### Version 1.2 — Amélioration site web / fichiers (~juin/juillet 2021)

Membres :

* refonte du code gestion des membres
* possibilité d'importer la catégorie du membre depuis un CSV, cf. <https://fossil.kd2.org/garradin/tktview?name=8136fedb24>

Site web :

* Re-design formulaire édition de page
*  Les pages comportent des "blocs", chaque bloc peut être soit un bloc texte (markdown), soit une image, soit un fichier, soit un tableau (éditeur de tableau simple à intégrer), soit le résultat d'une requête SQL (sous forme de tableau ou de graphique)
*  Génération de thème simplifiée (couleurs / police / etc.)
*  Les blocs d'une page peuvent être réordonnées un peu comme dans Content Tools : http://getcontenttools.com/
* Utilisation du logo de l'association sur le site web

Ajout de modèles de documents :

Les modèles de documents permettent de générer des documents papier. Ces modèles utilisent la syntaxe Brindille, et permettent de générer également des formulaires. Le contenu des formulaires peut être enregistré en base de données afin d'être réutilisé.

* Utilisation de la syntaxe Brindille
* Possibilité d'accéder aux données sauvegardées du formulaire en [JSON avec SQLite](https://www.sqlite.org/json1.html) et via une variable `$data` : `{{$data.nom}}`
* Ajout fonction `{{:save as="Informations pour %s"|args:$_POST.nom data=$_POST}}` qui permet d'enregistrer un formulaire en base de données
* Ajout fonction `email`, exemple : `{{:email to="...@..." subject="Contact reçu sur le site" body="Message reçu sur le site : %s"|args:$_POST.message}}`
* Supporter l'export PDF via une commande externe (PrinceXML, Chromium, etc.) ou DomPDF

Exemples d'utilisation :

* Déclaration liste dirigeants à la préfecture
* Compte de résultat et bilan conforme au modèle du plan comptable
* Cartes de membres
* Formulaires sur le site web

### Liste pêle-mêle des fonctionnalités prévues mais pas encore planifiées

#### Prioritaire

[Documentation] !

Fichiers :

*  Stockage de versions de fichiers avec l'algo Delta de Fossil
*  Possibilité de restreindre un fichier/dossier à certains membres / catégories
*  Possibilité de créer des notes format texte, HTML (avec Content Tools) et markdown (https://gist.github.com/jbroadway/2836900 ou https://github.com/erusev/parsedown pour la conversion Markdown et https://github.com/commit-intl/micro-down pour la prévisu et enfin https://github.com/asvd/syncscroll pour la synchro de prévisualisation)
* Stockage webdav [https://evertpot.com/167/](Serveur WebDAV) pour le porte-documents
* Possibilité d'utiliser un autre backend de stockage de fichiers via [WebDAV](http://svnbook.red-bean.com/en/1.7/svn.webdav.autoversioning.html), NextCloud, [Mercurial](https://wsgidav.readthedocs.io/en/latest/addons-mercurial.html), etc.)
*  Intégration de [OnlyOffice](https://api.onlyoffice.com/editors/basic) pour éditer/visualiser les documents Libre Office en ligne


Divers :

  *  [Amélioration gestion des emails de retour](/info/7cc2918ddb35ae2df9a3045fc938c18a96dac0f8)
  *  Magasin de plugins dispo depuis la page extensions de la config (pas besoin de télécharger le plugin à la main et le recopier)
  *  Sauvegarde incrémentale (utilisation de Fossil deltas) automatique
  *  Mise à jour de la doc pour les boucles de documents
  *  Utilisation de KD2\Brindille pour les templates de mails de rappel
  *  Tests unitaires et d'intégration
  * Renommer les tables `membres`, `membres_sessions`, `plugins`, `plugins_signaux` et `recherches` en anglais

Securité :

  *  OTP : Enregistrer des codes de secours à usage unique à utiliser en cas de perte du code secret qui génère des OTP

Comptabilité :

  *  Ajout stockage relevé bancaire (joindre un fichier) dans le rapprochement, par période
  *  Ajout total débit/crédit par mois dans le rapprochement
  *  Possibilité de valider une écriture (déjà partiellement implémenté dans la 1.0)
  *  Signature et hashage de chaque écriture validée dans une blockchain (déjà partiellement implémenté dans la 1.0)
  *  Archivage des données de l'exercice lors de la clôture
  *  Suivre les instructions du ministère des finances concernant l'archivage des données comptable, cf. [PDF](http://www11.minefi.gouv.fr/boi/boi2006/13rcpub/textes/13l106/13l106.pdf)

Adhérents :

  *  Inscription autonome en ligne
  *  Possibilité de définir une page wiki utilisée comme "conditions d'inscription" à accepter à l'inscription
  *  Journal des actions utilisateur
  *  Suppression/anonymisation automatique des fiches des anciens adhérents
  *  Log des accès aux fiches de membre en lecture / écriture
  *  Log des tentatives de connexion
  *  Possibilité pour les adhérents de se connecter seulement avec l'adresse email, sans mot de passe (s'ils n'en ont pas choisi un), pour changer leurs infos et suivre leurs cotisations

Divers

  *  Possibilité de gérer les adhérents, la compta, le wiki etc. via la ligne de commande

#### Moins prioritaire

Comptabilité :

  *  Lettrage
  *  Budget prévisionnel
  *  lier plusieurs cotisations à une écriture
  *  lier les membres aux lignes de l'écriture et non à l'écriture elle-même
  *  supprimer une écriture comptable à la suppression d'une cotisation
  *  supprimer une cotisation à la suppression d'une écriture comptable

Adhérents :

  *  Annuaire de membres accessible aux autres membres (avec opt-in de chaque membre)

Plugins :

  *  Caisse
  *  Suivi du temps bénévole/salarié, et inscription dans la compta du temps bénévolat
  *  Agenda collectif
  *  Saisie de note de frais simplifiée
Z fc78dd467b596e232d43a87b587f5dfd