# Gestion de documents # Espace de stockage : Nextcloud Comme la plupart des gens, j’utilise [Nextcloud](https://nextcloud.com/), avec le client pour pc pour synchroniser des dossiers et le client pour Android pour envoyer automatiquement des fichiers sur le serveur. # Gestion électronique de documents : Mayan EDMS Bulletins de salaires, dossier scolaire du gamin, factures, modes d’emploi… Oui, tout ça peut se gérer en mettant ça dans un [Nextcloud](/books/logiciels/page/espace-de-stockage-nextcloud) dans des dossiers et sous-dossiers, mais cela ne permet pas de lier des documents entre eux (genre la facture d’un appareil avec son mode d’emploi) ni de multi-classer un fichier (genre dans un dossier `Assurance` et en même temps dans un dossier `Appartement`). C’est pour cela que j’ai installé [Mayan EDMS](https://mayan-edms.com/) sur mon serveur. Attention : l’installation en elle-même ne pose pas particulièrement de problèmes mais il n’est pas simple à prendre en main. J’ai acheté le [bouquin](https://www.mayan-edms.com/book/) et ça m’a permis de mieux appréhender les différents aspects de Mayan. Ce n’était pas du luxe. Dans les points intéressants du logiciel : - possibilité de créer des index soit-même sur les critères qu’on veut - possibilité de mettre des documents dans plusieurs « classeurs » - possibilité de créer des méta-données sur les documents - possibilité d’avoir plusieurs versions d’un même document - recherche de doublons - possibilité de créer des actions automatiques (genre classement automatique dans un classeur, renommage du document selon ses méta-données, etc) ## Ma doc de mise à jour Adapté de la [doc officielle](https://web.archive.org/web/20230617010033/https://docs.mayan-edms.com/parts/upgrades.html) (lien archive.org car la doc d’upgrade n’est plus sur sur le [site de la doc officielle](https://docs.mayan-edms.com/parts/upgrades.html)). ```bash export VERSION=4.11.1 ``` Récupérer les versions des dépendances (copier / coller le résultat de la commande dans le terminal) : ```bash curl -s https://gitlab.com/mayan-edms/mayan-edms/-/raw/series/4.11/config.env | grep "^PYTHON" | sed -e "s/^/export /" ``` ```bash supervisorctl stop mayan-edms-celery-beat \ mayan-edms-gunicorn \ mayan-edms-worker_a \ mayan-edms-worker_b \ mayan-edms-worker_c \ mayan-edms-worker_d \ mayan-edms-worker_e && cp /etc/supervisor/conf.d/mayan-edms.conf /etc/supervisor/conf.d/mayan-edms.conf.bak && sudo --user=mayan /opt/mayan-edms/bin/pip install --no-cache-dir \ pip==${PYTHON_PIP_VERSION} \ setuptools==${PYTHON_SETUPTOOLS_VERSION} \ wheel==${PYTHON_WHEEL_VERSION} && sudo --user=mayan /opt/mayan-edms/bin/pip install --no-cache-dir \ amqp==${PYTHON_AMQP_VERSION} \ mysqlclient==${PYTHON_MYSQL_VERSION} \ psycopg==${PYTHON_PSYCOPG_VERSION} \ redis==${PYTHON_REDIS_VERSION} && sudo --user=mayan /opt/mayan-edms/bin/pip install mayan-edms==${VERSION} && sudo --user=mayan MAYAN_MEDIA_ROOT=/opt/mayan-edms/media/ \ /opt/mayan-edms/bin/mayan-edms.py platforms_template supervisord \ | sudo tee /etc/supervisor/conf.d/mayan-edms.conf && vimdiff -c 'map :diffget]czz | map ]czz | syn off | windo set wrap | winc h' \ /etc/supervisor/conf.d/mayan-edms.conf \ /etc/supervisor/conf.d/mayan-edms.conf.bak ``` ```bash sudo --user=mayan MAYAN_MEDIA_ROOT=/opt/mayan-edms/media/ \ /opt/mayan-edms/bin/mayan-edms.py common_perform_upgrade && supervisorctl start mayan-edms-celery-beat \ mayan-edms-gunicorn \ mayan-edms-worker_a \ mayan-edms-worker_b \ mayan-edms-worker_c \ mayan-edms-worker_d \ mayan-edms-worker_e ``` # Inventaire de livres physiques : Inventaire.io J’utilise [Inventaire](https://inventaire.io), directement sur le site officiel. C’est un des rares logiciels que je n’installe pas sur mon serveur, pour plusieurs raisons : - la complexité (ce n’est pas juste un dossier php + une base de données, c’est un poil plus complexe) - l’intelligence collective : à l’instar de Wikipédia et de Wikidata (qu’il utilise), les utilisateurices d’Inventaire vont enrichir et améliorer la base de données d’Inventaire et de Wikidata en corrigeant les notices de leurs livres ou en les créant. Le plus : pouvoir se contenter de scanner le code-barre d’un livre pour l’ajouter à sa collection. # Wiki : Bookstack et DokuWiki ## Bookstack Vous l’avez sous les yeux, j’ai choisi [Bookstack](https://www.bookstackapp.com/) pour mon wiki. Son organisation en étagères, livres, chapitres, pages me parle énormément, moi qui aime les livres (j’ai même un DUT métiers du livre). C’est une contrainte, mais cela permet aussi de se libérer de la gestion de la structure de son wiki. En PHP/MySQL, il est simple à installer et extrêmement rapide. Points intéressants : - on peut créer des modèles de page - on peut choisir d’écrire en [Markdown](https://fr.wikipedia.org/wiki/Markdown) - on peut ajouter des méta-données qui pourront servir pour la recherche ([exemple](https://wiki.fiat-tux.fr/search?term=+%5Blogiciel%3Dnextcloud%5D)) - pense-bête : [la doc de mise à jour](https://www.bookstackapp.com/docs/admin/updates/) ### Flux RSS des dernières pages Documentation de base sur . Créez un dossier dans `themes`, utilisez ce thème dans le fichier `.env` : ```bash APP_THEME=le_nom_du_dossier ``` Créez un fichier `functions.php` : ```php visible() ->orderBy('created_at', 'desc') ->take(20) ->get(); return response()->view('rss', ['pages' => $pages], 200, ['Content-Type' => 'text/xml']); }); ``` Créez un fichier `rss.blade.php` (le mien diffère de celui de la documentation), en changeant l’adresse et le titre : ```php Derniers articles wiki Fiat Tux {{ url('/') }} Les derniers articles du wiki Fiat Tux {{ date(DATE_RSS) }} @foreach($pages as $page) {{ $page->hasChapter() ? $page->chapter->name.' — ' : '' }}{{ $page->name }} {{ $page->getUrl() }} {{ $page->getExcerpt() }} renderedHTML) ? preg_replace('/href="\/books/', 'href="https://wiki.fiat-tux.fr/books/', $page->renderedHTML) : preg_replace('/href="\/books/', 'href="https://wiki.fiat-tux.fr/books/', $page->html) !!}]]> {{ $page->created_at->format(DATE_RSS) }} {{ $page->getUrl() }}#{{ $page->id }} @endforeach ``` Dans le menu Préférences > Personnalisation, ajoutez ceci dans « HTML personnalisé dans l'en-tête », en modifiant l’adresse et le titre : ```html ``` ## Dokuwiki Pour le boulot, je choisis plutôt [DokuWiki](https://www.dokuwiki.org/dokuwiki). Il a l’avantage d’être sans base de données, donc simple à sauvegarder et à restaurer. Austère de base, on peut étendre ses fonctionnalités de façon très agréable avec ses nombreux plugins, comme lister automatiquement les pages d’une catégorie, faire des redirections, ajouter des méta-données qu’on pourra utiliser dans les listes automatiques… # Gérer sa bibliothèque électronique : Calibre ## Calibre [Calibre](https://calibre-ebook.com) est un logiciel multi-plateforme qui permet de gérer sa bibliothèque d’epub et autres livres électroniques, de les transférer vers sa liseuse et qui possède bien d’autres atouts (conversion de formats, récupération de flux RSS pour en faire des epubs…). Calibre permet de gérer plusieurs bibliothèques différentes (elles seront dans des dossiers séparés). **NB :** si vous voulez accéder à votre bibliothèque calibre via un montage CIFS (Samba), [il faut ajouter l’option `nobrl` aux options de montage](https://coderwall.com/p/zrxobw/calibre-libraries-on-nas) sinon vous aurez des problèmes de `database is locked`. ## Calibre-web [Calibre-web](https://github.com/janeczku/calibre-web) permet d’exposer sa bibliothèque calibre au travers d’un site web. Il permet le téléchargement, la consultation, le téléversement… en mode authentifié ou non, avec la possibilité d’affecter des droits différents selon les utilisateurs. Très simple à utiliser, j’adore ! # Signature électronique de documents : Documenso J’ai une petite activité d’auto-entrepreneur (quelque soit le nom qui est maintenant donné à ce genre d’activité, j’ai autre chose à faire que d’apprendre les nouvelles désignations par un gouvernement qui n’a que ça à faire que de trouver de nouveaux noms aux choses) et pour éviter à mes clients d’imprimer mon devis, le signer, le scanner et me l’envoyer (ou de s’amuser à mettre eux-mêmes un scan de leur signature sur le pdf), j’ai cherché une solution de signature électronique de documents. Le grand gagnant est [Documenso](https://documenso.com/). Je l’avais déjà installé et testé, mais j’avais attendu avec impatience la compatibilité avec Nextcloud 29 de [Libresign](https://apps.nextcloud.com/apps/libresign), et cela semblait fonctionner (d’après mes tests). L’avantage aurait bien évidemment été l’intégration à Nextcloud, plus besoin de téléverser le fichier à signer, hop, pratique. Mais un client n’a pas réussi à signer un document. Comme j’ai autre chose à faire que débuguer ça avec un client à l’autre bout du fil, j’ai décidé de rester sur Documenso. ## Installation Bien évidemment, comme la plupart des logiciels de nos jours, la méthode d’installation suggérée est Docker. Pouah. ### Création d’un utilisateur dédié ```bash adduser --disabled-login \ --disabled-password \ --home /var/www/documenso \ --no-create-home \ --shell /bin/false \ documenso ``` ### Création d’une base de données PostgreSQL ```bash sudo -u postgres createuser -P documenso sudo -u postgres createdb -O documenso documenso ``` ### Récupération du code ```bash export VERSION=1.11.0 ``` ```bash cd /var/www git clone https://github.com/documenso/documenso.git cd documenso chown -R documenso: . sudo -u documenso git checkout -b "v$VERSION" "v$VERSION" ``` ### Configuration ```bash sudo -u documenso cp .env.example .env sudo -u documenso vimdiff -c 'syn off | windo set wrap | winc h' .env .env.example ``` NB : le `vimdiff` ne sert que lors d'une mise à jour, lors de l'installation initiale, contentez-vous d'éditer le fichier ### Compilation ```bash sudo -u documenso npm ci sudo -u documenso npm run build ``` ### Migration de la base de données ```bash sudo -u documenso npm run prisma:migrate-deploy ``` ### Service systemd ```bash cat < /etc/systemd/system/documenso.service [Unit] Description=documenso After=network.target After=postgresql.service Requires=postgresql.service PartOf=postgresql.service [Service] Type=simple User=documenso Environment=PATH=/var/www/documenso/node_modules/.bin/:/usr/local/bin:/usr/bin:/bin WorkingDirectory=/var/www/documenso ExecStart=/usr/bin/npm run start TimeoutSec=15 Restart=always SyslogIdentifier=documenso [Install] WantedBy=multi-user.target EOF systemctl daemon-reload systemctl enable --now documenso ``` ### Configuration Nginx ```nginx location / { include /etc/nginx/proxy_params; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_pass http://127.0.0.1:3001; proxy_redirect http://127.0.0.1:3001 https://documenso.example.org; } ```