NovaDesk est le logiciel avec lequel nous gérons Tensly Solutions : clients, projets, tâches, devis, factures, paiements, dépenses et e-mails dans une seule application auto-hébergée. C’est aussi là que nous testons, sur nous-mêmes, notre façon de construire pour les autres.
Voici six choix qui l’ont façonné, avec la raison de chacun. Les raisons comptent plus que les choix : c’est ce dont une autre équipe a besoin pour reprendre le travail.
1. Une seule application, sans API interne
NovaDesk est une seule application Next.js, avec l’App Router. Les pages lisent la base de données directement, par des composants serveur, et chaque écriture passe par une action serveur.
L’alternative était une API REST séparée, servant une interface séparée : deux déploiements, deux jeux de types et une couche de sérialisation à maintenir — pour une application qui n’a qu’un client, sa propre interface.
L’API publique existe tout de même, sous /api/v1, pour n8n, Make et Zapier. C’est un produit à part entière, authentifié par clés d’API, et non la tuyauterie de l’interface.
2. Les permissions se décident sur le serveur, à chaque fois
Chaque action serveur suit la même séquence : identifier l’utilisateur, vérifier la permission, valider la saisie, écrire, inscrire l’action au journal d’audit, puis rafraîchir les pages concernées.
L’interface masque ce qu’un utilisateur ne peut pas faire, mais c’est une politesse, pas un contrôle. Retirer ce masquage dans le navigateur ne donne aucun droit : la vérification se fait sur le serveur, dans chaque action et chaque route.
3. Les montants sont stockés en centimes entiers
Chaque montant est un nombre entier de centimes. Il n’y a aucun nombre à virgule flottante dans le code financier.
La règle d’arrondi est écrite une seule fois : la remise, puis l’arrondi ligne par ligne, la TVA arrondie ligne par ligne, et les totaux comme somme des lignes arrondies. Le total d’un document est donc toujours exactement la somme des lignes qui y figurent — c’est la première chose qu’un client vérifie. Un devis transformé en facture passe par le même code : son montant ne peut pas dériver.
4. Un seul moteur pour l’aperçu et le PDF
Les devis et factures se dessinent dans un éditeur de modèles visuel, avec un aperçu en direct. Il y avait deux façons de le construire : une bibliothèque de dessin PDF plus un aperçu HTML séparé, ou un seul moteur HTML.
Nous avons choisi la seconde. Une fonction pure transforme un document en HTML. L’éditeur de modèles l’appelle dans le navigateur et rafraîchit l’aperçu à chaque frappe ; la route PDF confie le même résultat à un Chromium sans interface. Ce que vous voyez dans l’éditeur est ce que reçoit le client.
Le coût est connu et accepté : une image de conteneur plus lourde et environ une seconde par document. Le navigateur est lancé une fois, puis réutilisé.
5. Aucune infrastructure dont le produit n’a pas besoin
Une instance unique n’a pas besoin de Redis : il n’y en a donc pas. La limitation de débit tourne en mémoire, derrière une interface qui accepterait une implémentation Redis sans toucher au code qui l’appelle. Les quelques tâches longues — génération des PDF et synchronisation des e-mails — passent par des routes appelées selon un calendrier plutôt que par une file d’attente.
Résultat : un processus, une base de données et un volume de fichiers. L’ensemble tourne sur un serveur modeste et se sauvegarde avec un script, avec une procédure écrite pour une restauration complète.
6. Des graphiques lisibles par tous
La palette des graphiques n’a pas été choisie à l’œil. Elle a été vérifiée par le calcul : plage de luminance, saturation minimale, distinction sous les formes courantes de daltonisme, et contraste avec le fond — en mode clair comme en mode sombre.
Chaque graphique a aussi une vue en tableau. Les données se lisent ainsi avec un lecteur d’écran, s’impriment et se copient facilement dans un tableur.
La suite
Le projet tient une feuille de route écrite, franche sur ce qui reste à faire : la double authentification pour les administrateurs, un portail client pour les devis et factures, et la facturation électronique. L’architecture permet déjà cette dernière — numérotation contrôlée, documents verrouillés, traçabilité — mais le format et la connexion à une plateforme agréée restent à construire.
Une édition en marque blanche de NovaDesk est également prévue. Si elle vous intéresse, écrivez-nous.



