Skip to content

Prévo 2.0.0 bêta 2

Pre-release
Pre-release

Choose a tag to compare

@nicoboy49 nicoboy49 released this 05 Nov 08:24
· 484 commits to main since this release

Prévo 2.0.0 bêta 2 — pour essayer, pas pour la production. C'est une pré-version : elle n'a pas encore été éprouvée sur le terrain. La version stable est la 1.2.1. Si Prévo sert déjà à travailler au quotidien, gardez la 1.2.1.

Cette bêta corrige un défaut de la bêta 1 (perte de données sur un fichier abîmé) et rend les sauvegardes, l'export et l'import beaucoup plus sûrs.

Ce qui change

  • Plus de perte de données sur un fichier abîmé. Si un fichier de Prévo est abîmé en dehors de Prévo (une note tapée dans Excel, un guillemet oublié dans le Bloc-notes), Prévo ne le réécrit plus jamais. Un bandeau « Fichier abîmé » s'affiche, nomme le fichier et dit quoi faire. Ce que vous tapez reste dans le formulaire. Seules la restauration d'une sauvegarde et l'import ZIP peuvent remplacer un fichier abîmé.
  • La sauvegarde du jour n'est plus bloquée par un fichier abîmé. Elle est faite quand même, marquée « abîmé », et les 7 dernières sauvegardes saines sont toujours gardées.
  • Un format de données versionné, avec migration automatique. Au démarrage, une base d'un format plus ancien est mise à niveau toute seule, étape par étape, après une sauvegarde « avant mise à jour ». Si vos données viennent d'une version plus récente de Prévo que la vôtre, Prévo les lit sans rien modifier (lecture seule).
  • Sauvegardes : une avant chaque mise à jour, une par jour, gardées 30 jours. Les sauvegardes « avant mise à jour » ne sont jamais effacées.
  • Export et import ZIP (Paramètres › Sauvegardes) :
    • l'export contient tous les fichiers de données, les documents, les rapports figés et un fichier de description ; avec les comptes, seul le responsable peut exporter et importer ;
    • nouveau : l'export « données seules » (sans les documents), plus léger ; à l'import, aucun document existant n'est supprimé ;
    • règle de base : tout ce que Prévo exporte, Prévo peut le réimporter, y compris une grosse base. Avant d'exporter, Prévo vous prévient s'il produirait un ZIP qu'il refuserait ensuite ;
    • l'import contrôle le fichier, vous demande confirmation en détail, fait une sauvegarde avant de remplacer, et revient en arrière tout seul en cas d'échec ;
    • une base qui contient un fichier abîmé s'exporte quand même : le fichier est marqué « abîmé » et gardé tel quel, et l'import le retrouve dans le même état, avec le bandeau « Fichier abîmé ».
  • Signalement des nouvelles versions : une bêta est maintenant prévenue de la sortie de la 2.0.0 finale.

Avant d'installer

  1. Faites une sauvegarde : Paramètres › Sauvegardes, « Sauvegarder maintenant », puis copiez le dossier donnees/ et prevo.config.json ailleurs (sur une clé USB par exemple), même si Prévo en fait une lui-même.
  2. Fermez Prévo (et la fenêtre du serveur s'il tourne).
  3. Mise à jour par-dessus la bêta 1 : copiez le contenu du dossier prevo-2.0.0-beta.2/ du zip par-dessus le dossier de Prévo, en remplaçant les fichiers. Le zip n'a ni donnees/ ni prevo.config.json : vos fichiers, vos sauvegardes et vos documents restent tels quels (détail : docs/INSTALLATION.md, section 12).
  4. Relancez Prévo. La migration est automatique, et une sauvegarde « avant mise à jour » est faite juste avant. « À propos » affiche la version 2.0.0-beta.2.

Si Prévo est derrière nginx ou IIS

Prévo accepte désormais l'enregistrement d'une table jusqu'à 50 Mo (une grosse base dépasse 10 Mo pour ses ordres de travail vers 18 000 OT). Si Prévo est derrière un autre serveur web (un « mandataire »), relevez la limite d'envoi de celui-ci, sinon les grosses tables seront refusées. À faire par la personne qui s'occupe du serveur :

  • nginx : client_max_body_size 52m; (au lieu de 12m) ;
  • IIS : dans le web.config du site, <security><requestFiltering><requestLimits maxAllowedContentLength="54525952" /></requestFiltering></security> (IIS refuse par défaut au-delà d'environ 30 Mo).

Le détail est dans docs/INSTALLATION.md, section 7. Sans mandataire, il n'y a rien à faire.

Limites de l'export et de l'import

  • 400 Mo pour le ZIP entier ;
  • 10 000 entrées au plus dans un ZIP ;
  • 50 Mo pour une table (un fichier CSV) ;
  • 10 Mo pour un document.

Mémoire nécessaire pour exporter une très grosse base

Exporter une base proche de la limite (ZIP de près de 400 Mo) demande beaucoup de mémoire : l'onglet de Prévo est monté à 2 à 2,5 Go pendant l'export lors de nos mesures, et à 1,6 Go pendant l'import. Sur un PC de 4 Go, préférez l'export « données seules » (sans les documents), ou faites l'export depuis un PC de 8 Go. Au-delà de 150 Mo de données et de documents, l'export complet vous prévient (fenêtre « Export ZIP volumineux ») et propose les données seules. Une prochaine version lira et écrira le ZIP par morceaux pour lever cette contrainte.

Signaler un problème

Écrivez sur https://github.com/prevo-pro/prevo/issues, en disant ce que vous faisiez et ce que Prévo a répondu. Si possible, joignez une copie du fichier concerné et de la sauvegarde du jour (sans données que vous ne voulez pas partager).


Licence MIT. Empreinte SHA-256 du zip : 6ddb441775cdc283461b9a5201e02f4530fb82a773c8b0804824124fc563233e

English

Prévo 2.0.0 beta 2 — to try out, not for production. This is a pre-release: it has not yet been proven in the field. The stable version is 1.2.1. If you already rely on Prévo day to day, stay on 1.2.1.

This beta fixes a defect of beta 1 (data loss on a damaged file) and makes backups, export and import much safer.

What changes

  • No more data loss on a damaged file. If a Prévo file is damaged outside Prévo (a note typed in Excel, a missing quote added in Notepad), Prévo never rewrites it again. A "Fichier abîmé" (damaged file) banner appears, names the file and says what to do. What you typed stays in the form. Only restoring a backup or importing a ZIP can replace a damaged file.
  • The daily backup is no longer blocked by a damaged file. It is still made, marked "damaged", and the last 7 healthy backups are always kept.
  • A versioned data format with automatic migration. At startup, a database in an older format is upgraded on its own, step by step, after a "before update" backup. If your data comes from a newer Prévo than yours, Prévo reads it without changing anything (read-only).
  • Backups: one before each update, one per day, kept for 30 days. "Before update" backups are never deleted.
  • ZIP export and import (Paramètres › Sauvegardes):
    • the export holds all data files, documents, frozen reports and a description file; with accounts, only the manager can export and import;
    • new: the "données seules" export (data only, without documents), lighter; on import, no existing document is deleted;
    • basic rule: whatever Prévo exports, Prévo can import back, including a large database. Before exporting, Prévo warns you if it would produce a ZIP it would later refuse;
    • the import checks the file, asks you to confirm in detail, makes a backup before replacing anything, and rolls back by itself if it fails;
    • a database that contains a damaged file can still be exported: the file is marked "damaged" and kept as it is, and the import brings it back in the same state, with the "Fichier abîmé" (damaged file) banner.
  • New-version notice: a beta is now told when the final 2.0.0 is released.

Before installing

  1. Make a backup: Paramètres › Sauvegardes, "Sauvegarder maintenant" (the interface is in French for now), then copy the donnees/ folder and prevo.config.json elsewhere (for example to a USB stick), even though Prévo makes its own backup.
  2. Close Prévo (and the server window if it is running).
  3. Updating over beta 1: copy the contents of the prevo-2.0.0-beta.2/ folder from the zip over your Prévo folder, replacing the files. The zip has neither donnees/ nor prevo.config.json: your files, backups and documents stay as they are (details: docs/INSTALLATION.md, section 12).
  4. Start Prévo again. The migration is automatic, and a "before update" backup is made just before it. "À propos" (About) shows version 2.0.0-beta.2.

If Prévo runs behind nginx or IIS

Prévo now accepts saving a table of up to 50 MB (in a large database, the work orders file passes 10 MB at around 18,000 work orders). If Prévo sits behind another web server (a "proxy"), raise that server's upload limit, otherwise large tables will be refused. This is for the person who looks after the server:

  • nginx: client_max_body_size 52m; (instead of 12m);
  • IIS: in the site's web.config, <security><requestFiltering><requestLimits maxAllowedContentLength="54525952" /></requestFiltering></security> (IIS refuses anything above about 30 MB by default).

Details are in docs/INSTALLATION.md, section 7. Without a proxy there is nothing to do.

Export and import limits

  • 400 MB for the whole ZIP;
  • at most 10,000 entries in a ZIP;
  • 50 MB for one table (one CSV file);
  • 10 MB for one document.

Memory needed to export a very large database

Exporting a database close to the limit (a ZIP of nearly 400 MB) needs a lot of memory: in our measurements, the Prévo tab rose to 2 to 2.5 GB during the export, and to 1.6 GB during the import. On a PC with 4 GB of RAM, prefer the "données seules" export (without documents), or export from a PC with 8 GB. Beyond 150 MB of data and documents, the full export warns you (window « Export ZIP volumineux ») and offers the data-only export (« Exporter les données seules »). A future version will read and write the ZIP in chunks to remove this constraint.

Reporting a problem

Write at https://github.com/prevo-pro/prevo/issues, saying what you were doing and what Prévo answered. If possible, attach a copy of the file concerned and of the day's backup (leave out any data you do not want to share).


MIT license. SHA-256 of the zip: 6ddb441775cdc283461b9a5201e02f4530fb82a773c8b0804824124fc563233e