# Portail frelons AULA / TernoisCom - V0.2.6

Application interne FastAPI + PostgreSQL/PostGIS pour le signalement, les demandes d'intervention, les devis et le suivi technique des frelons asiatiques.

## Nouveautés V0.2.6

- tarifs officiels stockés dans PostgreSQL ;
- deux prestations initiales conformes aux formulaires TernoisCom :
  - perche et fusil : 120,00 € ;
  - drone : 170,00 € ;
- création d'un devis par demande d'intervention ;
- montant calculé côté serveur à partir du tarif actif ;
- référence automatique `DEV-...`, date, validité et statut du devis ;
- téléchargement du devis en PDF ;
- type d'intervention et coût automatiquement repris dans le compte rendu ;
- demande PDF réorganisée sur deux pages selon la présentation institutionnelle des formulaires transmis ;
- affichage des tarifs dans le formulaire destiné aux élus ;
- conservation des chemins relatifs.

La V0.2.6 conserve les fonctions des versions précédentes : 103 communes de TernoisCom, comptes PostgreSQL, rôles `elu`, `technicien` et `admin`, filtrage communal, photos, historique, archivage et journal d'audit.

## Arborescence portable

```text
data/communes_ternois.geojson
uploads/
logs/
backups/
docs/formulaires_actuels/
```

Les chemins sont résolus à partir de la racine du projet.

## Installation locale sous Windows

À la racine du projet :

```powershell
Set-ExecutionPolicy -Scope Process Bypass
Copy-Item .env.example .env
notepad .env
.\scripts\install_windows.ps1
```

Renseigner au minimum :

```env
PGHOST=
PGPORT=5432
PGDATABASE=Ternois_sig
PGUSER=
PGPASSWORD=
PGSSLMODE=disable
NOTIFICATIONS_ENABLED=false
```

## Mise à niveau depuis la V0.2.5

Copier le fichier `.env` de la V0.2.5, puis exécuter :

```powershell
.\scripts\upgrade_v026.ps1
```

Résultat attendu :

```text
Tarifs actifs : 2
Table des devis : disponible
Mise a niveau V0.2.6 terminee.
```

Cette migration ne supprime aucun dossier existant.

## Nouvelle installation

```powershell
.\scripts\upgrade_v024.ps1
.\scripts\upgrade_v025.ps1
.\scripts\upgrade_v026.ps1
.\scripts\create_first_admin.ps1
```

## Vérification et lancement

```powershell
.\scripts\check_database.ps1
.\scripts\start_windows.ps1
```

Accès :

- connexion : `http://127.0.0.1:8000/login.html`
- espace élu : `http://127.0.0.1:8000/index.html`
- espace technique : `http://127.0.0.1:8000/admin.html`
- gestion des utilisateurs : `http://127.0.0.1:8000/users.html`

## Fonctionnement du devis

Dans la fiche technique d'une demande :

1. choisir le type d'intervention ;
2. vérifier le tarif calculé automatiquement ;
3. choisir le statut du devis ;
4. renseigner sa validité et les éventuelles observations ;
5. enregistrer puis télécharger le PDF.

Le prix n'est pas accepté depuis le navigateur : l'API reprend toujours le tarif présent dans `frelons.tarifs_intervention`.

## Documents institutionnels

Les demandes générées reprennent les principes des formulaires TernoisCom : logo, titres centrés et soulignés, bandeaux jaunes, rappel tarifaire, page de facturation ou autorisation du propriétaire, et cadres de signature.

Les formulaires sources restent disponibles dans :

```text
docs/formulaires_actuels/
```

## Courriels

Les notifications restent désactivées par défaut :

```env
NOTIFICATIONS_ENABLED=false
```

L'application reste utilisable sans SMTP.