PACOUPA

PACOUPA a pour but d'outiller les copropriétaires dans l'installation de systèmes de chauffage décarbonés adaptés à leur logement.

A partir de quelques questions simples sur l’immeuble, l'outil permet de diriger les copropriétaires vers les solutions les plus pertinentes.

Installation et lancement local

Mettre à jour le fichier .env avec la variable TURSO_DATABASE_URL="http://127.0.0.1:8080".

turso dev --db-file assets/pacoupa.db 

yarn install
yarn dev
open http://localhost:3000

Build

yarn build

---

Persistence

Les données sont stockées dans une DB SQLite hébergée sur Turso.

1. Création de la DB SQLite

En cas de modification du fichier Google sheet original, il faut :

• exporter en csv les données du simulateur
  • le premier onglet, en le nommant solutions_par_criteres.csv
  • le second, en le nommant solutions.csv
• stocker ces 2 fichiers dans le répertoire assets
• lancer le script /scripts/db/build_db.sh

./scripts/db/build_db.sh

2. Push sur Turso

Il faut auparavant s'authentifier avec turso auth login.

# si besoin de supprimer une base `turso db destroy pacoupa`

# création d'une db suffixée avec le jour d'aujourd'hui
turso db create pacoupa-20240528 --from-file assets/pacoupa.db

Pour créer un nouveau token d'accès en lecture seule

turso db tokens create pacoupa-20240528 -r 

Recopier le token dans .env et .env.local (TURSO_DATABASE_URL et TURSO_AUTH_TOKEN). Il faudra aussi le noter sur Vercel settings.

3. Génération du schéma types Drizzle

D'abord, vérifier que le fichier .env renseigne bien les variables TURSO_DATABASE_URL et TURSO_AUTH_TOKEN.

yarn dk:introspect

Cette commande va regénérer le fichier schema.ts et les types Drizzle.

Modifier le fichier drizzle/schema.ts pour améliorer le typage des objets de persistence:

• pour solutions.type, ajouter drizzleEnumTypes (ex: type: text("type", drizzleEnumTypes).notNull())
• ajouter drizzleEnumUsages pour
  • solutions.usageCh
  • solutions.usageEcs
  • solutions.usageFr
• ajouter drizzlEnumNotes pour
  • solutions.noteImpactSonore
  • solutions.noteImpactEspaceExterieur
  • solutions.noteEnvironnemental
  • solutions.noteMaturite
• ajouter drizzleEnumNotes pour
  • solutionsParCriteres.noteDifficulte
  • solutionsParCriteres.noteImpactTravauxColl
  • solutionsParCriteres.noteImpactTravauxIndiv
  • solutionsParCriteres.noteCout

Vous pouvez lancer la compilation typescript pour vérifier que le code est resté typesafe.

yarn tsc

FAQ

J'ai modifié la DB sur Turso et j'ai une erreur de déploiement sur Vercel?

Cela peut être dû au token d'accès qui a changé. Regénérer le token et le mettre à jour sur Vercel.

Schéma DB

classDiagram
direction BT

class criteres {
   text CH
   text ECS
   text emetteur
   text espace_exterieur
   text env_contraint
   text toiture_terrasse
   text temperature
   text nb_lgts
   text niveau_renovation
   integer id
}
class solutions {
   text name
   text type
   text usage_CH
   text usage_ECS
   text usage_FR
   text num_AFPAC
   text emprise_PAC_exterieur
   text local_technique
   text emprise_logement
   text structure
   text acoustique
   text reseaux_hydrauliques
   text PLU
   text raccordement_electrique
   text impact_visuel
   text note_impact_visuel
   text note_Impact_sonore
   text note_impact_espace_exterieur
   text note_environnemental
   text note_maturite
   text commentaire_app
   text commentaire_pouget
   text id
}
class solutions_par_criteres {
   integer criteres_id
   text id_solution
   integer ordre_solution
   text difficulte
   text impact_travaux_coll
   text impact_travaux_indiv
   text cout
   text type_solution
   text usage_CH
   text usage_ECS
   text usage_FR
   integer alertes
}


solutions_par_criteres  -->  solutions : id_solution

solutions_par_criteres  -->  criteres : criteres_id

Déploiement

Le produit est déployé sur Vercel.

PACOUPA_ENV	Terminologie Vercel	Branche Git	Fonction	URL
prod	Production	main	Site de production	https://pacoupa.ademe.fr/
preprod	Preview	dev	Site de préproduction	https://pacoupa.ademe.vercel.app/
dev (défaut)	Development	(feature branch)	Recette par PR