Files
Khaemhat/tests/Khaemhat.Web.Tests/Shell/ShellTests.cs
T
Alby96andClaude Opus 5.5 cf6f849cc1 feat: application shell, localized texts and user preferences (M3, part 1)
The pages built so far now live inside the shell of the mockups instead of the
M0 placeholder, every interface text comes from Resources/it-IT, and each user
keeps their own look and start page.

- Shell: top bar, collapsible side menu with fly-out sub-menus, status bar and
  tabs that keep each page alive (page type and route values per tab, so a tab
  never shows another page); at most 12 tabs, least-used clean tab evicted.
- One shortcut table with Alt variants for the combinations browsers keep
  (Ctrl+W, Ctrl+Tab, Ctrl+N); command palette for pages and commands.
- ITexts over embedded JSON; tests forbid literal texts in .razor components
  and check that every key used exists.
- User settings in sys_user_settings / user_settings; theme written on the
  server; profile page with live preview, start page, sessions and shortcuts.
- Home, coming-soon pages for later milestones, localized sign-in and error
  pages; ADR 0020; wiki, CHANGELOG, STATUS and data model updated.

Refs #25 #26 #31 #33

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 16:44:59 +01:00

170 lines
7.2 KiB
C#

using System.Globalization;
using Khaemhat.Application.Localization;
using Khaemhat.Application.Preferences;
using Khaemhat.Application.Security;
using Khaemhat.Web.Hosting;
using Khaemhat.Web.Shell;
namespace Khaemhat.Web.Tests.Shell;
/// <summary>The shell of SPEC §10.2: tabs, menu, shortcuts and help (issues #25, #26).</summary>
[TestClass]
public sealed class ShellTests
{
internal static readonly ITexts Texts = JsonTextProvider.FromAssembly(typeof(KhaemhatApp).Assembly, CultureInfo.GetCultureInfo("it-IT"));
[TestMethod]
public void Tabs_OpenOncePerPath_AndKeepTheLatestAddress()
{
var tabs = new TabService();
Assert.AreEqual(TabOpenResult.Opened, tabs.Open("/anagrafiche/clienti", null));
Assert.AreEqual(TabOpenResult.Opened, tabs.Open("profilo", null));
Assert.AreEqual(TabOpenResult.Activated, tabs.Open("/profilo?scheda=sessioni", null));
Assert.HasCount(2, tabs.Tabs);
Assert.AreEqual("/profilo", tabs.Active!.Path);
Assert.AreEqual("/profilo?scheda=sessioni", tabs.Active.Url);
Assert.AreEqual("/profilo?scheda=sessioni", tabs.Recent[0]);
}
[TestMethod]
public void Tabs_AtTheLimit_CloseTheLeastUsedUnmodifiedTab()
{
var tabs = new TabService();
for (var i = 0; i < TabService.MaxTabs; i++)
{
tabs.Open("/p" + i.ToString(CultureInfo.InvariantCulture), null);
}
tabs.Find("/p0")!.SetModified(true);
tabs.Open("/p1", null);
Assert.AreEqual(TabOpenResult.OpenedAndEvicted, tabs.Open("/nuova", null));
Assert.HasCount(TabService.MaxTabs, tabs.Tabs);
Assert.IsNotNull(tabs.Find("/p0"), "A tab with unsaved changes is never closed for room.");
Assert.IsNotNull(tabs.Find("/p1"), "A tab used recently stays.");
Assert.IsNull(tabs.Find("/p2"), "The least recently used tab goes.");
}
[TestMethod]
public void Tabs_AtTheLimit_WithEveryTabModified_RefuseANewOne()
{
var tabs = new TabService();
for (var i = 0; i < TabService.MaxTabs; i++)
{
tabs.Open("/p" + i.ToString(CultureInfo.InvariantCulture), null);
tabs.Active!.SetModified(true);
}
Assert.AreEqual(TabOpenResult.Refused, tabs.Open("/nuova", null));
Assert.HasCount(TabService.MaxTabs, tabs.Tabs);
Assert.IsTrue(tabs.HasModified);
}
[TestMethod]
public void Tabs_ClosingTheActiveTab_ShowsANeighbour()
{
var tabs = new TabService();
tabs.Open("/a", null);
tabs.Open("/b", null);
tabs.Open("/c", null);
tabs.Open("/b", null);
// The tab after the closed one takes its place (the layout then navigates there).
var next = tabs.Close(tabs.Active!);
Assert.AreEqual("/c", next);
Assert.HasCount(2, tabs.Tabs);
Assert.IsNull(tabs.Find("/b"));
tabs.Open(next!, null);
Assert.IsNull(tabs.Close(tabs.Find("/a")!), "Closing a tab in the background moves nothing.");
Assert.AreEqual("/c", tabs.Active!.Path);
Assert.AreEqual("/", tabs.Close(tabs.Active), "Closing the last tab goes back to the home page.");
}
[TestMethod]
[DataRow("/anagrafiche/clienti", "Shell.Menu.Parties.Customers", "Shell.Menu.Parties")]
[DataRow("/anagrafiche/clienti/42", "Shell.Menu.Parties.Customers", "Shell.Menu.Parties")]
[DataRow("/contabilita", "Shell.Menu.Ledger", "Shell.Menu.Ledger")]
[DataRow("/", "Shell.Menu.Home", "Shell.Menu.Home")]
public void Menu_FindsTheDeepestEntry(string path, string entry, string area)
{
Assert.AreEqual(entry, MenuCatalog.Find(path)?.Key);
Assert.AreEqual(area, MenuCatalog.FindArea(path)?.Key);
}
[TestMethod]
public void Menu_FollowsTheOrderOfTheSpecification_AndEveryEntryHasTextAndIcon()
{
string[] order =
[
"Shell.Menu.Home", "Shell.Menu.Parties", "Shell.Menu.Crm", "Shell.Menu.Sales", "Shell.Menu.Purchases", "Shell.Menu.Inventory",
"Shell.Menu.Ledger", "Shell.Menu.Finance", "Shell.Menu.EInvoicing", "Shell.Menu.Assets", "Shell.Menu.Services", "Shell.Menu.Channels",
"Shell.Menu.Reports", "Shell.Menu.CompanyTables", "Shell.Menu.Automation", "Shell.Menu.Admin",
];
CollectionAssert.AreEqual(order, MenuCatalog.Sections.SelectMany(s => s.Items).Select(i => i.Key).ToArray());
var sprite = File.ReadAllText(Path.Combine(Repository.Root, "src", "Khaemhat.Web", "wwwroot", "icons", "sprite.svg"));
foreach (var item in MenuCatalog.All)
{
Assert.IsTrue(Texts.Contains(item.Key), item.Key);
StringAssert.Contains(sprite, "id=\"" + item.Icon + "\"", item.Key);
}
Assert.AreEqual(MenuCatalog.All.Count(), MenuCatalog.All.Select(i => i.Href).Distinct(StringComparer.Ordinal).Count(), "Addresses are unique.");
}
[TestMethod]
public void Help_EveryMenuEntryOpensAnExistingWikiPage()
{
foreach (var item in MenuCatalog.All.Append(new MenuItem("x", "x", "/profilo", "CORE", null, null)))
{
var page = HelpLinks.PageFor(item.Href);
Assert.IsTrue(File.Exists(Path.Combine(Repository.Root, "docs", "wiki", page + ".md")), item.Href + " -> " + page);
}
Assert.AreEqual("Articoli-e-listini", HelpLinks.PageFor("/anagrafiche/articoli/12?x=1"));
Assert.AreEqual(HelpLinks.DefaultBaseUrl + "IVA", HelpLinks.UrlFor(HelpLinks.DefaultBaseUrl, "/contabilita/registri-iva"));
}
[TestMethod]
public void Shortcuts_AreUnique_AndDescribed()
{
var combos = KeyboardShortcuts.All.SelectMany(s => s.Keys).ToList();
Assert.HasCount(combos.Distinct(StringComparer.Ordinal).Count(), combos, "A key combination belongs to one command.");
foreach (var shortcut in KeyboardShortcuts.All)
{
Assert.IsTrue(Texts.Contains(shortcut.TextKey), shortcut.TextKey);
}
// Browsers keep Ctrl+W, Ctrl+Tab and Ctrl+N for themselves: each has an alternative that reaches the page.
Assert.Contains("Alt+W", KeyboardShortcuts.Find(KeyboardShortcuts.Commands.CloseTab)!.Keys);
Assert.Contains("Alt+PageDown", KeyboardShortcuts.Find(KeyboardShortcuts.Commands.NextTab)!.Keys);
Assert.Contains("Alt+N", KeyboardShortcuts.Find(KeyboardShortcuts.Commands.New)!.Keys);
}
[TestMethod]
public void Theme_WritesEveryRootAttribute()
{
var attributes = ThemeService.RootAttributes(new UserPreferences { Theme = ThemeMode.Dark, Accent = "ocra", TextSize = 110, ReducedMotion = true });
Assert.AreEqual("dark", attributes["data-theme"]);
Assert.AreEqual("ocra", attributes["data-accent"]);
Assert.AreEqual("110", attributes["data-text-size"]);
Assert.AreEqual("reduced", attributes["data-motion"]);
Assert.AreEqual("auto", ThemeService.RootAttributes(null)["data-theme"]);
}
[TestMethod]
public void SignInMessages_ExistForEveryErrorCode()
{
var codes = typeof(SecurityErrors).GetFields().Where(f => f.IsLiteral).Select(f => (string)f.GetRawConstantValue()!).ToList();
Assert.IsNotEmpty(codes);
foreach (var code in codes)
{
Assert.IsTrue(Texts.Contains("Auth.Errors." + code), code);
}
}
}