Skip to content

Tests unitaires, erreurs typees, i18n FR/EN, cadences adaptatives et KDoc - #1

Open
devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/1756552000-tests-i18n-robustesse
Open

Tests unitaires, erreurs typees, i18n FR/EN, cadences adaptatives et KDoc#1
devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/1756552000-tests-i18n-robustesse

Conversation

@devin-ai-integration

Copy link
Copy Markdown

Summary

Points 1 à 5 de la revue de code, sans changement fonctionnel visible : la logique métier est
extraite des API Android pour devenir testable, les erreurs deviennent des états typés affichés
dans l'interface, les textes passent en ressources FR/EN, et les cadences de rafraîchissement
s'adaptent au contexte.

Logique pure extraite (nouveaux fichiers, testables sur la JVM) :

  • SkyAnalysis : meilleur satellite, moyenne vectorielle des azimuts pondérée par cn0DbHz et
    cos(elevation), élévation moyenne. GnssState.bestSatellite / bestSkyAzimuthDeg délèguent ici.
  • NtpTimestamp : encodage/décodage des horodatages 64 bits RFC 5905.
  • Azimuth : normalisation, secteur cardinal, rotation la plus courte, alignement — utilisé par
    l'UI à la place des calculs inline.

SntpClient sépare le réseau du calcul : query(host) fait l'I/O et délègue à
evaluate(buffer, host, requestTime, requestTicks, responseTicks), qui valide le paquet (mode
serveur, stratum 1..15, transmit non nul) et renvoie un Outcome :

sealed interface Outcome {
    data class Success(val result: Result) : Outcome
    data class Failure(val server: String, val reason: FailureReason, val detail: String? = null) : Outcome
}
enum class FailureReason { UNREACHABLE, INVALID_RESPONSE }

Erreurs typées plutôt que chaînes : GnssIssue (pas de service, permission, récepteur
indisponible, localisation désactivée, recherche de fix, signal perdu avec âge du fix),
MobileIssue (pas de téléphonie, permission, aucune cellule, lecture modem échouée) et
TimeSyncState.ntpFailure. L'UI traduit ces enums via gnssIssueText, mobileIssueText,
ntpFailureText. TimeSyncManager expose syncing et espace les réessais NTP :
retryDelayMillis(n) = 15 s << (n - 1), borné, MainActivity détecte le refus définitif de
permission et propose l'ouverture des réglages.

Cadences adaptatives dans MainViewModel : horloge 40 ms au premier plan, 200 ms en économie
d'énergie (PowerManager.isPowerSaveMode), 1 s en arrière-plan ; modem 1 s pendant la mesure 360°,
5 s au repos ; calculs GNSS/pointage ralentis hors premier plan.

i18n : values/strings.xml (FR, défaut) et values-en/strings.xml, formats paramétrés au lieu
de concaténations ; les unités et symboles restent translatable="false". SkyView reçoit les
labels cardinaux en paramètre au lieu de les coder en dur.

Tests (./gradlew test, 46 cas) : GeoSatellites (azimut/élévation/skew/distance depuis Paris,
satellite sous l'horizon, zénith à l'équateur, tri), SkyAnalysis, NtpTimestamp,
SntpClient.evaluate, resolveTimeSource + backoff, DirectionScanner (secteurs, couverture,
seuil de fiabilité 70 %, sectorCount <= 0 désormais refusé par require), Azimuth.

./gradlew test, ./gradlew lint et ./gradlew assembleDebug passent. Les essais terrain (point 6
de la revue : plusieurs téléphones, régions et modems) restent à faire sur appareils réels — aucun
appareil Android n'est disponible ici.

Link to Devin session: https://app.devin.ai/sessions/3081a2bc884747b38aa91e46f88ad2bb
Open in Devin Desktop: https://app.devin.ai/desktop/session/3081a2bc884747b38aa91e46f88ad2bb?variant=devin
Requested by: @maythayus

Tests JVM sur les calculs geo/GNSS/NTP, le scan 360 et les azimuts ; etats d'erreur types (GNSS, modem, capteur, NTP) affiches avec reessai ; textes externalises en FR et EN ; rafraichissements adaptes au premier plan, a l'arriere plan et a l'economie de batterie ; KDoc sur les classes principales.
@devin-ai-integration

Copy link
Copy Markdown
Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant