Développement

BatNotif est écrit en C# / WPF sur .NET 10 LTS. Le code est sur GitHub.

PrérequisCopy Anchor Link

• Windows 10 (19041) ou 11, x64
• SDK .NET 10 (la version est fixée par global.json)
• PowerShell 7 pour le script de publication

Compiler, tester, lancerCopy Anchor Link

git clone https://github.com/brandonviry/BatNotif.git
cd BatNotif
dotnet build BatNotif.sln      # compile les 3 projets
dotnet test BatNotif.sln       # 94 tests du moteur et des réglages
dotnet run --project src/BatNotif.App

Simuler une alerteCopy Anchor Link

En build Debug uniquement, deux arguments remplacent les seuils pour la session, sans les enregistrer :

dotnet run --project src/BatNotif.App -- --high 63   # alerte haute si branché et batterie ≥ 63 %
dotnet run --project src/BatNotif.App -- --low 65    # alerte basse si sur batterie et batterie ≤ 65 %

Ces arguments n'existent pas dans l'exe publié.

Publier l'exe autonomeCopy Anchor Link

./scripts/publish.ps1

Le script lance les tests, puis produit deux exécutables autonomes win-x64 (runtime inclus, un seul fichier chacun) :

ArchitectureCopy Anchor Link

src/
├── BatNotif.Core/        net10.0 — aucune dépendance Windows
│   ├── Alerts/           AlertEngine : machine à états, hystérésis, snooze, pause
│   ├── Battery/          BatterySnapshot, IBatterySource, filtre secteur 2 s
│   ├── Settings/         AppSettings, validation, settings.json
│   └── Logging/          événements du journal
└── BatNotif.App/         net10.0-windows — WPF
    ├── Platform/         batterie (WinRT PowerManager), veille, plein écran, raccourci, démarrage auto
    ├── Audio/            lecture en boucle (NAudio), sons intégrés générés
    ├── Tray/             pastille générée (H.NotifyIcon), menu
    ├── Views/            fenêtre de réglages, notification normale / renforcée
    └── Presentation/     AlertPresenter : relie le moteur à l'affichage et au son
tests/
└── BatNotif.Core.Tests/  xUnit + FakeTimeProvider (temps simulé)

Le moteur d'alerte est isolé dans BatNotif.Core, qui ne peut pas dépendre de Windows : toutes les règles (seuils, marge de 2 %, filtre secteur, alerte continue, snooze, pause, veille) sont testées avec une batterie et une horloge simulées, sans attendre qu'une vraie batterie atteigne 80 %.

Méthode de travailCopy Anchor Link

Le projet suit le développement piloté par les spécifications avec Spec Kit : idée (idee.md) → constitution → spécification → plan → tâches → implémentation. Tous les documents sont dans le dépôt :

• idee.md : le cahier des charges ;
• .specify/memory/constitution.md : les principes non négociables ;
• specs/001-batnotif-mvp/ : spécification, plan, recherche technique, modèle de données, contrats, guide de validation et tâches.

Ce siteCopy Anchor Link

Cette documentation est un site Fumadocs (Next.js) dans le dossier docs/ du dépôt, déployé sur Vercel à chaque push sur main. Les pages sont dans docs/content/docs/.