Files

Bertrand Benjamin a90d1c4f64 feat: mode application de bureau + packaging Windows autonome

Permet de distribuer l'application en executable Windows double-clic,
sans Python/Node/terminal pour l'utilisateur final.

- `desktop.py` : demarre le serveur sur un port libre dans un thread et
  ouvre une fenetre native (pywebview). `PLESNA_DEBUG=1` active les
  DevTools. Commande `plesna-gerance desktop` (import paresseux).
- `paths.py` : resolution centralisee des chemins selon le contexte
  (dev, executable PyInstaller, surcharge par variables d'env). Les
  donnees vont dans un dossier utilisateur inscriptible (%APPDATA%),
  les ressources dans le bundle. connection.py/storage.py utilisent
  `get_data_dir()`, app.py `resource_path()`.
- app.py : type MIME `.mjs` force (modules ES / worker PDF.js sous
  Windows).
- Groupes de deps optionnels desktop / desktop-linux / build.
- packaging/ : spec PyInstaller, build_windows.ps1, installeur Inno
  Setup. Workflow GitHub build-windows.yml (runner Windows).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-19 17:21:27 +02:00

2.9 KiB

Raw Blame History

Plesna Gerance

Extracteur de comptes rendus de gerance Oralia/ICS.

Prerequis

Python >= 3.10
uv
Node.js >= 22

L'extraction de PDF utilise pdfplumber (Python pur) : aucun binaire systeme requis (plus besoin de poppler-utils/pdftotext).

Installation

uv sync
cd frontend && npm install

Developpement

Lancer backend et frontend dans deux terminaux separés :

make dev_back   # Backend sur http://localhost:8000 (auto-reload)
make dev_front  # Frontend sur http://localhost:5173 (hot-reload)

Ou les deux en parallele :

make dev

Ouvrir http://localhost:5173 — le proxy Vite redirige /api vers le backend.

Production (Docker)

make docker

Accessible sur http://localhost:8080.

Application de bureau (Windows, sans ligne de commande)

L'application peut etre empaquetee en executable Windows autonome : un seul fichier que l'utilisateur final installe et lance via une icone, sans Python, sans Node, sans terminal. L'extraction etant en Python pur, aucun binaire externe n'est requis.

Tester le mode bureau (depuis les sources)

Sous Windows (pywebview utilise WebView2, deja present) :

uv sync --group desktop
cd frontend && npm run build && cd ..
uv run plesna-gerance desktop   # ouvre une fenetre native

Sous Linux, pywebview a besoin d'un moteur de rendu. Le groupe desktop-linux fournit un backend Qt entierement pip-installable :

uv sync --group desktop-linux
cd frontend && npm run build && cd ..
uv run plesna-gerance desktop   # necessite un environnement graphique ($DISPLAY)

Ce backend Qt ne sert qu'a tester le mode fenetre sous Linux : il n'est pas embarque dans le build Windows.

Produire l'executable + l'installeur

Deux options (le build doit se faire sur Windows, PyInstaller ne croise pas les plateformes) :

Sur une machine Windows — installer uv, Node.js et (optionnel) Inno Setup 6, puis :
```
powershell -ExecutionPolicy Bypass -File packaging\build_windows.ps1
```
Produit dist\PlesnaGerance.exe et, si Inno Setup est present, dist\PlesnaGerance-Setup.exe.
Sans machine Windows — via GitHub Actions : le workflow .github/workflows/build-windows.yml compile sur un runner Windows. Le declencher (onglet Actions ou en poussant un tag v*) puis telecharger l'artefact PlesnaGerance-windows.

Cote utilisateur final

Lancer PlesnaGerance-Setup.exe, suivre l'assistant (installation par utilisateur, sans droits administrateur), puis cliquer sur l'icone Plesna Gerance. Les donnees (base et documents) sont stockees dans %APPDATA%\PlesnaGerance et conservees entre les mises a jour.

Assistant IA (optionnel) : la page IA necessite Ollama installe separement. Sans Ollama, l'application fonctionne normalement et la page IA indique simplement que le service est indisponible.

2.9 KiB Raw Blame History