diff --git a/CHANGELOG.md b/CHANGELOG.md index 68f0bc6b9..86afc7514 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,53 @@ # Changelog +## [1.0.8-rc27] - unstable + +### Added + +* [PostIt, Yavsc.Api] Portage des outils des contrôleurs web + d’administration : tableau de bord, rôles et affectations, clients OIDC + (paramètres, collections et secrets), scopes API et modèles de courriels. + Le dernier administrateur ne peut pas être exclu ; les suppressions et + rotations de secrets demandent une confirmation dans PostIt. +* [Yavsc.Api] Routes `api/v1/administration`, DTO dédiés, client + `AdministrationApiClient` et documentation OpenAPI protégée en développement. + Les secrets OIDC sont hachés en SHA-256 et seule leur création restitue + la valeur en clair, sans cache. +* [PostIt, Yavsc.Api] Export et import JSON transactionnel des données + métier des comptes, billets et activités. Les comptes sont transférés + sans mots de passe, jetons, confirmations ou rôles ; les contrôles + d’accès des billets sont conservés et leurs références sont validées. + +* [PostIt] Service `CameraStreamer` (préliminaire) : détection des + périphériques de capture vidéo (DirectShow sous Windows via le paquet + `DirectShowLib`, `/dev/video*` sous Linux) et création d'un média + LibVLC de capture pour le périphérique choisi. + +### Changed + +* [PostIt] Une seule page Administration regroupe les utilisateurs et + leurs usages, avec le détail d’usage de l’utilisateur sélectionné. + L’accès depuis l’accueil et sa commande sont désormais réservés au rôle `Administrator`, + vérifié via le profil du backend. « Mon profil » conserve la gestion + du compte et accueille l’usage personnel, sans consulter les usages globaux. +* [Yavsc.Api] Les listes d’utilisateurs et d’usages globaux sont désormais + réservées au rôle `Administrator`, comme les autres outils d’administration. + +* [PostIt] La page des blogs passe en deux colonnes lorsque la largeur de + la fenêtre atteint sa hauteur : billet à gauche, recherche, commandes et + liste à droite, avec séparateur vertical redimensionnable. La disposition + verticale revient en portrait sans perdre le brouillon ; la barre de + navigation est plus compacte en mode large et conserve le bouton Retour. + +### Fixed + +* [PostIt.Android] Restauration de la pile de navigation lors de la + recréation de l'activité après suspension : nouvelles pages liées aux + mêmes modèles de vue, sans plus de procès. +* [PostIt] Le changement de disposition de la page des blogs est différé + sur le thread UI, évitant l'exception « Visual was invalidated during + the render pass » au redimensionnement. + ## [1.0.8-rc26] - unstable ### Added @@ -15,10 +63,24 @@ avec lecture/pause, libération du lecteur à la fermeture et accès au navigateur en cas d'indisponibilité de LibVLC. Les autres fichiers et les vidéos sur mobile/navigateur s'ouvrent dans le navigateur système. +* [Yavsc.Api] Contrôleur `DismissClicksApiController` (déplacé depuis + Yavsc.Org) exposant des DTO `DismissedNotification` : + `GET api/v1/dismiss`, `POST api/v1/dismiss/click/{notificationId}` + (idempotent, 404 si la notification n'existe pas) et + `DELETE api/v1/dismiss/click/{notificationId}` ; authentification requise. +* [Yavsc.Api.Client] `NotificationsApiClient.DismissAsync`, + `GetDismissedAsync` et `RestoreAsync`. +* [PostIt] Bouton de fermeture sur chaque notification de l'accueil + qui la démet auprès de Yavsc.Api pour un utilisateur connecté, ou la + masque localement sans appel API pour un visiteur non connecté + (jusqu'au prochain rechargement des notifications). ### Changed * L'administration est maintenant restreinte aux emails configurés dans les paramétres applicatifs de Yavsc.Org (`appsettings-org.json`) +* [Yavsc.Org] L'API `api/v1/dimiss` est supprimée ; le site web démet ses + notifications via `POST /Home/DismissNotification/{id}` (base pour un + utilisateur connecté, session pour un visiteur anonyme). ## [1.0.8-rc25] - unstable diff --git a/Directory.Packages.props b/Directory.Packages.props index b0b055b98..1e3577c72 100644 --- a/Directory.Packages.props +++ b/Directory.Packages.props @@ -33,6 +33,7 @@ + diff --git a/doc/architecture/postit.md b/doc/architecture/postit.md index 439bb8f70..2ba6cb812 100644 --- a/doc/architecture/postit.md +++ b/doc/architecture/postit.md @@ -40,6 +40,104 @@ spécifiques (IntentFilter Android, `app.manifest` Desktop). Toute la logique (VM, services, navigation, settings, OIDC) est dans le code-base partagé. +## Reprise Android + +`IActivityApplicationLifetime.MainViewFactory` crée une nouvelle `MainView` +pour chaque activité Android. Avant de remplacer la racine, PostIt relève +les types et les modèles de vue des pages de la pile précédente, puis +recrée ces pages dans le même ordre, sans animation. Les contrôles de +l'ancienne activité ne sont pas réutilisés ; les modèles de vue conservent +les sélections et brouillons en mémoire. Une nouvelle racine sans historique +reçoit la page d'accueil, même si l'initialisation de session a déjà eu lieu. +Le rafraîchissement silencieux de session reste unique par processus. +Cette restauration couvre la recréation d'activité dans le même processus, +pas la destruction du processus par Android. + +## Administration et profil personnel + +L'accueil présente un seul accès **Administration**, visible et exécutable +uniquement pour le rôle exact `Administrator`. `SessionStatusViewModel.RefreshAsync` +lit les rôles dans `GET account/me` après le rafraîchissement de session ; +une erreur de lecture masque l'accès et affiche une erreur dans la bannière. +La déconnexion invalide aussi les vérifications de droits encore en vol. + +`AdministrationPage` regroupe sept onglets : utilisateurs, usages globaux, +rôles, clients OIDC, scopes API, courriels et données. Les en-têtes se +répartissent sur plusieurs lignes sur les écrans étroits. +Le détail d'un utilisateur associe son usage par `UserId`, sans dépendre +du nom affiché. Les erreurs ne déclenchent pas de repli sur l'usage personnel. +Le backend réserve aussi les listes aux administrateurs, sous la +politique `AdministratorOnly`. Le rôle `Moderator` seul n'ouvre plus +l'administration de PostIt. L'autorisation serveur reste indispensable, +indépendamment de la visibilité du bouton dans PostIt. + +**Mon profil** réutilise la page de gestion du compte existante et les +endpoints `account/me` pour lire et enregistrer les informations personnelles. +Elle affiche aussi `resource-usage/me`, sans appeler la liste des usages +globaux. Une indisponibilité de l'usage n'empêche pas la gestion du profil. + +### Outils d'administration du site + +Les outils portés correspondent aux contrôleurs de +`Yavsc.Org/Controllers/Administration` ; le site web existant est conservé. +Les nouvelles routes vivent dans Yavsc.Api sous `api/v1/administration`. +Les données passent par des records dédiés de Yavsc.Abstract et par +`AdministrationApiClient`, jamais par les entités EF. + +| Routes | Fonction | +| --- | --- | +| `summary`, `roles`, `roles/ensure` | Statistiques, informations du runtime, rôles standards | +| `roles/{id}/members[/{userId}]` | Membres, inscription et exclusion | +| `clients[/{id}]` | Paramètres scalaires des clients OAuth/OIDC | +| `clients/{id}/collections/{collection}[/{rowId}]` | Redirect URIs, post-logout URIs, scopes, grant types, CORS, restrictions IdP, claims et propriétés | +| `clients/{id}/secrets[/regenerate]`, `clients/{id}/secrets/{secretId}` | Ajout, rotation et suppression des secrets | +| `scopes[/{id}]` | Création, consultation, modification et suppression des scopes API | +| `mailing-criteria`, `mailing-templates[/{id}]` | Critères de diffusion et modèles de courriels | +| `transfer` | Export par GET, import transactionnel par POST | + +Les formulaires de clients, scopes et modèles sont construits à partir +des propriétés de leurs DTO typés, afin de conserver tous les champs de +l'interface web. Les booléens et énumérations disposent de contrôles dédiés ; +les valeurs numériques et annotations de validation sont vérifiées avant +l'envoi puis à nouveau côté serveur. + +Un nouveau client démarre avec `authorization_code`, PKCE et les scopes +`openid` et `profile`. Les autres types d'autorisation restent configurables +dans ses collections. Une rotation remplace tous les secrets précédents et +expire par défaut après 90 jours. Le serveur conserve uniquement le SHA-256 +du secret partagé ; les lectures ne rendent que les métadonnées. +PostIt efface la valeur nouvellement créée au changement de client, à la +prochaine opération et au détachement de la page. Une réponse de création +de secret reçue après déconnexion est ignorée ; un rafraîchissement sans +droits efface les données d'administration précédemment chargées. Supprimer un objet, +exclure un membre, remplacer les secrets ou importer demande une confirmation +explicite. Le serveur refuse l'exclusion du dernier administrateur. + +Le transfert JSON version 1 comprend les informations métier des comptes +(identifiant, nom, e-mail, nom complet, avatar, calendrier et limites de +stockage), les billets (contenu, auteur, publication, cercles et étiquettes) +et les paramètres des activités. Ce n'est pas une sauvegarde complète de +la base : fichiers, sessions, mots de passe, jetons, rôles, moyens de paiement, +adresses et historique d'audit ne sont pas transférés. L'e-mail d'un compte +existant, clé alternative du modèle actuel, ne peut pas être changé par import. +Les nouveaux comptes n'ont ni mot de passe ni e-mail confirmé. + +Les identifiants des billets sont préservés et la séquence PostgreSQL est +réajustée après l'import. Tous les auteurs et cercles doivent exister et +les parents d'activités doivent former un graphe sans cycle. Une erreur +annule l'ensemble de l'import ; aucun repli n'élargit les permissions d'un +billet. Les fichiers importés et requêtes sont limités à 16 Mio ; les gros +exports doivent être répartis en plusieurs transferts de même schéma. +Si plusieurs étiquettes portent déjà le même nom, l'import réutilise celle +ayant le plus petit identifiant sans supprimer les autres. + +L'initialisation du premier administrateur reste le mécanisme web existant, +et n'est pas proposée aux utilisateurs non administrateurs par PostIt. +En développement, `/openapi/administration.json` décrit uniquement ces outils, +avec accès `AdministratorOnly`. Les requêtes de référence sont dans +[Administration.http](../../src/Yavsc.Api/Administration.http) ; l'adresse +locale d'exemple est celle du serveur de tests, à adapter au déploiement. + ## Lecture des billets et fichiers utilisateur La page des blogs affiche par défaut une vue de lecture : titre, login @@ -178,6 +276,20 @@ et les commandes restent visibles, tandis que la liste des billets et l'éditeur se partagent l'espace disponible. Un `GridSplitter` permet de modifier cette répartition. La liste et l'article défilent séparément. +Lorsque la largeur de la fenêtre atteint ou dépasse sa hauteur, le lecteur +ou l'éditeur passe à gauche (deux tiers de la largeur par défaut), et +l'en-tête, la recherche, les commandes et la liste passent à droite. +Le séparateur devient vertical. En portrait, la disposition verticale +revient sans recréer les contrôles ni perdre le brouillon. +Le seuil utilise les dimensions clientes de la fenêtre, indépendamment +de la hauteur occupée par la navigation et la bannière de session. + +La page applique `NavigationPage.BarHeightOverride` à 36 en mode large ; +le `NavRoot` de `MainView` conserve ainsi le bouton Retour, sans changer +les autres pages. En portrait, la hauteur de navigation par défaut revient. +Les commandes ont un contexte de données explicite pour conserver leurs +liaisons, y compris lorsqu'elles passent dans le menu de débordement. + Dans `MarkdownEditorControl`, AvaloniaEdit gère son propre défilement ; l'aperçu Markdown est placé dans un `ScrollViewer`. Ne pas limiter la hauteur du `MarkdownViewer` lui-même : son contenu doit pouvoir diff --git a/src/PostIt/Directory.Packages.props b/src/PostIt/Directory.Packages.props index f0b523488..fbfaa1f38 100644 --- a/src/PostIt/Directory.Packages.props +++ b/src/PostIt/Directory.Packages.props @@ -16,6 +16,7 @@ + @@ -37,4 +38,4 @@ - + \ No newline at end of file diff --git a/src/PostIt/PostIt.Tests/ActivityNavigationTests.cs b/src/PostIt/PostIt.Tests/ActivityNavigationTests.cs new file mode 100644 index 000000000..607523deb --- /dev/null +++ b/src/PostIt/PostIt.Tests/ActivityNavigationTests.cs @@ -0,0 +1,60 @@ +using Avalonia; +using Avalonia.Controls; +using Avalonia.Headless.XUnit; +using Avalonia.Threading; +using PostIt.ViewModels; +using PostIt.Views; + +namespace PostIt.Tests; + +public class ActivityNavigationTests +{ + [AvaloniaFact] + public async Task Activity_recreation_restores_fresh_pages_and_back_navigation() + { + var app = Assert.IsType(Application.Current); + var previousView = app.View; + var original = new MainView(); + var home = new HomePage(); + var draft = new Settings { SelectedLanguage = "fr" }; + var editor = new ContentPage { DataContext = draft }; + await original.NavRoot.PushAsync(home, null); + await original.NavRoot.PushAsync(editor, null); + app.AttachMainWindow(original); + var window = new Window(); + try + { + var restored = app.CreateActivityView(new Settings()); + window.Content = restored; + window.Show(); + Dispatcher.UIThread.RunJobs(); + + Assert.Equal(2, restored.NavRoot.NavigationStack.Count); + Assert.IsType(restored.NavRoot.NavigationStack[0]); + Assert.NotSame(home, restored.NavRoot.NavigationStack[0]); + Assert.NotSame(editor, restored.NavRoot.NavigationStack[1]); + Assert.Same(draft, restored.NavRoot.NavigationStack[1].DataContext); + Assert.Equal("fr", draft.SelectedLanguage); + + window.Content = null; + window.Content = restored; + Dispatcher.UIThread.RunJobs(); + Assert.Equal(2, restored.NavRoot.NavigationStack.Count); + + // Another activity recreation must retain the already-restored stack. + window.Content = null; + var recreatedAgain = app.CreateActivityView(new Settings()); + window.Content = recreatedAgain; + Dispatcher.UIThread.RunJobs(); + Assert.Equal(2, recreatedAgain.NavRoot.NavigationStack.Count); + Assert.Same(draft, recreatedAgain.NavRoot.NavigationStack[1].DataContext); + await recreatedAgain.NavRoot.PopAsync(null); + Assert.IsType(Assert.Single(recreatedAgain.NavRoot.NavigationStack)); + } + finally + { + window.Close(); + app.AttachMainWindow(previousView ?? new MainView()); + } + } +} diff --git a/src/PostIt/PostIt.Tests/AdministrationAccessTests.cs b/src/PostIt/PostIt.Tests/AdministrationAccessTests.cs new file mode 100644 index 000000000..50e64f713 --- /dev/null +++ b/src/PostIt/PostIt.Tests/AdministrationAccessTests.cs @@ -0,0 +1,242 @@ +using System.Net.Http; +using System.Text.Json; +using Avalonia.Controls; +using Avalonia.Headless.XUnit; +using Avalonia.Threading; +using Avalonia.VisualTree; +using PostIt.Services; +using PostIt.ViewModels; +using PostIt.Views; +using Yavsc.Abstract.Identity; +using Yavsc.Abstract.Resources; +using Yavsc.Api.Client; + +namespace PostIt.Tests; + +public class AdministrationAccessTests +{ + [AvaloniaTheory] + [InlineData("Moderator", false)] + [InlineData("Administrator", true)] + [InlineData("administrator", false)] + [InlineData("Performer", false)] + [InlineData("moderator", false)] + [InlineData("", false)] + public async Task Home_administration_visibility_and_command_follow_the_administrator_role(string role, bool allowed) + { + await using var api = new ProfileTransport(role); + var session = new SessionStatusViewModel { Api = api }; + var vm = new HomePageViewModel(api, api.Settings, session, null!); + var page = new HomePage { DataContext = vm }; + var window = new Window { Content = page }; + try + { + window.Show(); + var button = Assert.Single(page.GetVisualDescendants().OfType