# Les cinq onglets

La fiche complète reprend tout le contenu du site : galerie paginée, faits (dispo, superficie, étage, stationnement…), inclusions, description structurée (digest), carte, points d'intérêt à proximité, statistiques de quartier, et le bouton « Voir l'annonce originale » vers le site du gestionnaire.

# L'app en images

Accueil — recherche & filtres	Découverte — swipe & reco	Fiche complète

Carte province	Le marché en chiffres	Registre des sources

# Le mode Découverte, en 30 secondes

Chaque swipe nourrit un moteur de recommandation on-device (LouKa/Reco.swift) :

1. Chaque annonce est décomposée en caractéristiques : ville, quartier, taille, tranche de prix (300 $), meublé, animaux, balcon, stationnement, gestionnaire.
2. Pour chaque caractéristique, on maintient un taux d'appréciation lissé (Laplace) : (👍 + 1) / (👍 + 👎 + 2), pondéré par la confiance 1 + log(1 + n).
3. Le score d'une annonce = moyenne pondérée des taux de ses caractéristiques. La pile est reclassée toutes les 8 décisions, et ~1 carte sur 6 vient du reste du bassin (exploration) pour éviter la bulle de filtre.
4. Tout est persisté localement (UserDefaults) — aucune donnée ne quitte l'appareil. Les coups de cœur se retrouvent sous le ♥ en haut à droite.

Après 4 likes de studios à ~900 $, l'en-tête affiche déjà « Vos goûts : Studio · ~900 $ » et la pile s'adapte.

# Architecture

ios/
├── project.yml               # définition XcodeGen (cible, Info.plist, polices)
├── ExportOptions.plist       # upload App Store Connect (méthode + team)
└── LouKa/
    ├── App.swift             # point d'entrée, onglets, apparence nav, thème clair forcé
    ├── API.swift             # client HTTPS → www.lou-ka.com (filtres complets)
    ├── Models.swift          # décodage tolérant (un champ inattendu ≠ annonce perdue)
    ├── Reco.swift            # moteur de recommandation du mode Découverte
    ├── Theme.swift           # design system : palette, ombres décalées, typo, fr-CA
    ├── Fonts/                # Space Grotesk (instances statiques) + JetBrains Mono
    └── Views/
        ├── HomeView.swift          # accueil + feuille de filtres
        ├── DiscoverView.swift      # swipe plein écran + coups de cœur
        ├── ListingCardView.swift   # carte d'annonce
        ├── ListingDetailView.swift # fiche complète
        ├── MapTabView.swift        # carte province
        ├── StatsView.swift         # portrait du marché
        └── SourcesView.swift       # registre des gestionnaires

Design « éditorial sharp » — porté du site : papier #f5f3ee, encre #141814, vert profond #1c5c41, lime électrique #d9f26b, bordures encre et ombres décalées, Space Grotesk pour les titres et les prix, JetBrains Mono pour les micro-étiquettes. Thème clair forcé (comme le site) pour que le mode sombre du téléphone ne rende jamais un texte illisible.

Détail typo : la Space Grotesk variable de Google Fonts n'expose aucun nom PostScript d'instance — iOS ne voyait que « Light ». Les instances statiques (Regular/Medium/Bold) sont générées avec fontTools et embarquées.

# Développer

brew install xcodegen
cd ios
xcodegen generate            # (ré)génère LouKa.xcodeproj depuis project.yml
open LouKa.xcodeproj         # ⌘R sur un simulateur iOS 17+

Aucune dépendance externe — SwiftUI, MapKit, Observation, c'est tout. L'app pointe sur l'API de production ; pour une instance locale, changez API.base dans LouKa/API.swift.

# Publier sur TestFlight

# bump MARKETING_VERSION / CURRENT_PROJECT_VERSION dans project.yml, puis :
xcodegen generate
xcodebuild archive -project LouKa.xcodeproj -scheme LouKa \
  -destination 'generic/platform=iOS' -archivePath build/LouKa.xcarchive \
  -allowProvisioningUpdates
xcodebuild -exportArchive -archivePath build/LouKa.xcarchive \
  -exportOptionsPlist ExportOptions.plist -allowProvisioningUpdates

L'export téléverse directement sur App Store Connect (signature automatique, fiche com.spboucher.louka existante) ; la build apparaît dans TestFlight après le traitement d'Apple.

# Principes

1. Fidélité au web — mêmes données, même langage visuel, aucun prix inventé.
2. Robustesse — décodage champ par champ avec repli : une source mal formée ne fait jamais disparaître les autres annonces.
3. Vie privée — le profil de goûts reste sur l'appareil, point.
4. Zéro dépendance — pas de SPM, pas de Pods : le SDK Apple suffit.