maxsoch
11da706573
L'horaire de l'email récapitulatif se configure maintenant sur /destinataires (raccourcis courants + expression cron personnalisée) au lieu de .env, avec reprogrammation immédiate sans redémarrage. Stocké en base (ParametrePlanification) plutôt que dans un fichier de config. Défaut changé pour tous les lundis à 9h. Les exemples et le code n'utilisent que des noms de jours (mon, tue, ...) dans les expressions cron : vérifié empiriquement qu'APScheduler ne suit pas la convention Unix pour les jours numériques (0=lundi chez lui, pas 0=dimanche), ce qui rendrait "0 9 * * 1" trompeur.
111 lines
4.3 KiB
Markdown
111 lines
4.3 KiB
Markdown
# Gestion de stock IT
|
|
|
|
Application web pour le département IT d'une clinique, permettant de gérer
|
|
le stock de matériel informatique (catégories / sous-catégories /
|
|
matériels), avec scan de codes-barres et alertes email de stock bas.
|
|
|
|
Pas de système d'authentification dans l'app : l'accès est censé être
|
|
restreint par un mécanisme externe (réseau interne, proxy, etc.).
|
|
|
|
## Stack
|
|
|
|
- **Python + FastAPI** : serveur web, un seul processus.
|
|
- **SQLite** : base de données fichier (`data/stock.db`), aucun serveur à installer.
|
|
- **Jinja2** : pages HTML rendues côté serveur, formulaires classiques (pas de JS de build).
|
|
- **SQLModel** : ORM (combine SQLAlchemy + validation Pydantic).
|
|
|
|
Tout vit dans ce dossier : pas de service externe requis pour développer
|
|
et tester en local (les emails d'alerte sont simulés dans la console tant
|
|
qu'aucun SMTP n'est configuré, voir plus bas).
|
|
|
|
## Démarrer en local
|
|
|
|
```bash
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate # Windows : .venv\Scripts\activate
|
|
pip install -r requirements-dev.txt
|
|
cp .env.example .env # optionnel en local, voir ci-dessous
|
|
uvicorn app.main:app --reload
|
|
```
|
|
|
|
L'app est accessible sur http://127.0.0.1:8000. La base SQLite est créée
|
|
automatiquement au premier démarrage dans `data/stock.db`.
|
|
|
|
## Lancer les tests
|
|
|
|
```bash
|
|
source .venv/bin/activate
|
|
pytest
|
|
```
|
|
|
|
## Lancer le linter
|
|
|
|
```bash
|
|
source .venv/bin/activate
|
|
ruff check .
|
|
```
|
|
|
|
## Configuration des emails
|
|
|
|
Les emails de stock (alerte immédiate + résumé périodique) sont envoyés via
|
|
le relais SMTP interne de la clinique, configuré par variables
|
|
d'environnement (voir `.env.example`) :
|
|
|
|
```
|
|
SMTP_HOST=...
|
|
SMTP_PORT=25
|
|
SMTP_USER=...
|
|
SMTP_PASSWORD=...
|
|
SMTP_FROM=stock-it@clinique.local
|
|
```
|
|
|
|
Si `SMTP_HOST` n'est pas renseigné (cas du dev local), rien n'est réellement
|
|
envoyé : les emails sont affichés dans la console du serveur
|
|
(`--- [EMAIL SIMULÉ] ---`). Ça permet de développer et tester tout le flux
|
|
sans avoir de vrai serveur mail sous la main.
|
|
|
|
Deux emails distincts :
|
|
- **Alerte immédiate** : envoyée dès qu'un matériel passe sous son seuil
|
|
d'alerte (`Materiel.seuil_alerte`). Contient ce matériel, puis un résumé
|
|
de tous les articles actuellement en stock bas.
|
|
- **Résumé périodique** : stock bas en premier, puis le reste du stock
|
|
groupé par catégorie. L'horaire se configure **depuis l'interface**, sur
|
|
`/destinataires` (raccourcis courants + expression cron personnalisée) —
|
|
pas de fichier à éditer, le changement s'applique immédiatement sans
|
|
redémarrer le serveur. Défaut : tous les lundis à 9h. Le planificateur
|
|
(APScheduler) tourne dans le process de l'app, rien à configurer côté
|
|
système d'exploitation. Pour déclencher l'envoi manuellement (test, ou
|
|
pour le brancher sur un cron système / Planificateur de tâches Windows
|
|
à la place) : `python scripts/envoyer_resume_stock.py`.
|
|
|
|
Les destinataires (plusieurs possibles) se gèrent aussi sur `/destinataires`.
|
|
|
|
## Douchette code-barres
|
|
|
|
Aucune intégration logicielle particulière : une douchette USB (ou
|
|
Bluetooth) émule un clavier, elle "tape" le code puis Entrée. La page
|
|
`/scan` a un simple champ de texte auto-focus dans un formulaire ; Entrée
|
|
soumet automatiquement le formulaire.
|
|
|
|
## Structure du projet
|
|
|
|
```
|
|
app/
|
|
main.py point d'entrée FastAPI, démarrage du planificateur
|
|
config.py lecture des variables d'environnement
|
|
database.py connexion SQLite
|
|
models.py modèles SQLModel (Categorie en arborescence, Materiel, DestinataireAlerte)
|
|
categories_arbre.py parcours de l'arborescence de catégories
|
|
email_alerts.py alerte immédiate + résumé périodique de stock
|
|
scheduler.py planification (APScheduler) du résumé périodique
|
|
templates_engine.py instance Jinja2Templates partagée
|
|
routers/ une route FastAPI par ressource (categories, materiels, scan, destinataires)
|
|
templates/ pages HTML (Jinja2)
|
|
static/ CSS
|
|
scripts/
|
|
seed.py peuple la base avec des données de démo
|
|
envoyer_resume_stock.py déclenche manuellement l'email récapitulatif
|
|
tests/ tests pytest (client de test FastAPI + base SQLite en mémoire)
|
|
data/ base SQLite locale (ignorée par git)
|
|
```
|