Demo-Zugang: zwei weitere virtuelle Testgeräte für die manuelle UI-Prüfung
Build / build (push) Canceled after 0s

Bisher gab es nur ein einzelnes simuliertes Testgerät (127.127.127.127,
"CHR (Simulator)"). Um Funktionen wie "Bekannte Router" oder den Sidebar-
Umbau mit mehreren, klar unterscheidbaren Einträgen ausprobieren zu können,
ohne echte zweite/dritte Hardware zu brauchen, unterstützt DemoRouterOsClient
jetzt mehrere Profile (DemoDeviceProfile): zusätzlich 127.127.127.128
("Büro-Router", hAP ac2, RouterBOARD) und 127.127.127.129 ("Keller-Switch",
CRS326-24G-2S+, RouterBOARD) — alle mit denselben Zugangsdaten (admin/admin).

Jedes Profil bekommt dynamisch eine zu sich selbst passende Demo-Backup-Datei
in "Backup verwalten" (statt nur das ursprüngliche CHR-Profil). Die simulierte
"/system/routerboard"-Antwort unterscheidet jetzt zwischen "kein RouterBOARD"
(wie beim ursprünglichen CHR-Profil, unverändertes Verhalten) und "echtes
RouterBOARD" (neue Profile, meldet Modell zusätzlich über routerboard.model).

8 neue Unit-Tests, bestehende 132 unverändert grün. Die beiden neuen Router
wurden testweise bereits verbunden und erscheinen jetzt unter "Bekannte
Router" (lokale Datei, unabhängig vom Git-Repository).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
adminandClaude Sonnet 5 committed 2026-09-17 21:31:50 +02:00
1 parent 3010688b12
commit e3e3c71452
4 files changed
+147 -20

No files matched your search

@@ -13,6 +13,66 @@ public class DemoRouterOsClientTests
Assert.False(DemoRouterOsClient.Matches(new RouterOsCredentials("127.127.127.127", "admin", "falsch")));
}
[Fact]
public void Matches_AllVirtualDeviceProfiles()
{
foreach (var profile in DemoRouterOsClient.Profiles)
{
Assert.True(DemoRouterOsClient.Matches(new RouterOsCredentials(profile.Host, "admin", "admin")));
}
}
[Fact]
public void Profiles_HaveDistinctHostsAndIdentities()
{
Assert.True(DemoRouterOsClient.Profiles.Count >= 3, "Es sollten mehrere virtuelle Testgeräte zur Auswahl stehen.");
Assert.Equal(DemoRouterOsClient.Profiles.Count, DemoRouterOsClient.Profiles.Select(p => p.Host).Distinct().Count());
Assert.Equal(DemoRouterOsClient.Profiles.Count, DemoRouterOsClient.Profiles.Select(p => p.IdentityName).Distinct().Count());
}
[Theory]
[MemberData(nameof(ProfileIndexes))]
public async Task Create_ReportsTheSelectedProfilesIdentity(int profileIndex)
{
var profile = DemoRouterOsClient.Profiles[profileIndex];
var client = DemoRouterOsClient.Create(new RouterOsCredentials(profile.Host, "admin", "admin"));
var resource = (await client.GetAsync("/system/resource")).Single();
var identity = (await client.GetAsync("/system/identity")).Single();
var routerboard = (await client.GetAsync("/system/routerboard")).Single();
Assert.Equal(profile.BoardModel, resource["board-name"]);
Assert.Equal(profile.Architecture, resource["architecture-name"]);
Assert.Equal(profile.IdentityName, identity["name"]);
Assert.Equal(profile.IsRouterBoard ? "yes" : "no", routerboard["routerboard"]);
Assert.Equal(profile.SerialNumber, routerboard.GetValueOrDefault("serial-number"));
}
public static TheoryData<int> ProfileIndexes()
{
var data = new TheoryData<int>();
for (var i = 0; i < DemoRouterOsClient.Profiles.Count; i++)
{
data.Add(i);
}
return data;
}
[Fact]
public async Task Create_EachProfileHasABackupThatMatchesItself()
{
foreach (var profile in DemoRouterOsClient.Profiles)
{
var client = DemoRouterOsClient.Create(new RouterOsCredentials(profile.Host, "admin", "admin"));
var files = await client.GetAsync("/file");
var sanitizedModel = MikrotikInstaller.Core.Backup.RouterBackupService.SanitizeForFileName(profile.BoardModel);
var sanitizedArch = MikrotikInstaller.Core.Backup.RouterBackupService.SanitizeForFileName(profile.Architecture);
Assert.Contains(files, f => f["name"].StartsWith($"mikrotik-installer-{sanitizedModel}_{sanitizedArch}"));
}
}
[Fact]
public async Task GetAsync_ReturnsSimulatedInterfacesAndResource()
{
@@ -0,0 +1,10 @@
namespace MikrotikInstaller.Core.Connectivity.Demo;
/// <summary>
/// Ein simuliertes Testgerät für <see cref="DemoRouterOsClient"/> — eigener Host, damit sich z. B.
/// "Bekannte Router" mit mehreren, klar unterscheidbaren Einträgen ausprobieren lässt, ohne ein
/// echtes zweites Gerät zu brauchen. <paramref name="IsRouterBoard"/> false simuliert ein virtuelles
/// Gerät ohne RouterBOARD (wie ein CHR, das trotzdem eine Seriennummer melden kann); true simuliert
/// echte RouterBOARD-Hardware (meldet Modell zusätzlich über "/system/routerboard").
/// </summary>
public sealed record DemoDeviceProfile(string Host, string IdentityName, string BoardModel, string Architecture, bool IsRouterBoard, string? SerialNumber);
@@ -1,24 +1,55 @@
using MikrotikInstaller.Core.Backup;
namespace MikrotikInstaller.Core.Connectivity.Demo;
/// <summary>
/// Simulierter RouterOS-Client für interne Tests des Assistenten, ganz ohne echtes Gerät.
/// Wird ausschließlich aktiviert, wenn exakt die Test-Zugangsdaten verwendet werden
/// (<see cref="Matches"/>) — es findet dabei keinerlei Netzwerkverbindung statt, alle Daten
/// liegen nur im Arbeitsspeicher dieses Objekts. Nur in Debug-Builds erreichbar
/// (siehe <see cref="RouterOsClientFactory"/>), damit dieser Testzugang nicht in der
/// veröffentlichten Version landet.
/// Wird ausschließlich aktiviert, wenn Benutzername/Passwort den Test-Zugangsdaten entsprechen UND
/// der Host einem der <see cref="Profiles"/> entspricht (<see cref="Matches"/>) — es findet dabei
/// keinerlei Netzwerkverbindung statt, alle Daten liegen nur im Arbeitsspeicher dieses Objekts. Nur
/// in Debug-Builds erreichbar (siehe <see cref="RouterOsClientFactory"/>), damit dieser Testzugang
/// nicht in der veröffentlichten Version landet.
/// </summary>
public sealed class DemoRouterOsClient : IRouterOsClient
{
public const string DemoHost = "127.127.127.127";
public const string DemoUsername = "admin";
public const string DemoPassword = "admin";
private readonly Dictionary<string, List<Dictionary<string, string>>> _data = BuildInitialData();
/// <summary>Rückwärtskompatibel: der ursprüngliche, einzelne Testzugang.</summary>
public const string DemoHost = "127.127.127.127";
/// <summary>
/// Mehrere virtuelle Testgeräte, alle mit denselben Zugangsdaten — z. B. um "Bekannte Router"
/// oder das Backup-Modell-/Architektur-/Seriennummer-Abgleich mit mehreren, klar unterscheidbaren
/// Geräten auszuprobieren, ohne echte zweite/dritte Hardware zu brauchen.
/// </summary>
public static readonly IReadOnlyList<DemoDeviceProfile> Profiles =
[
new(DemoHost, "Test-Router", "CHR (Simulator)", "x86_64", IsRouterBoard: false, SerialNumber: "DEMO1234AB"),
new("127.127.127.128", "Büro-Router", "hAP ac2", "arm", IsRouterBoard: true, SerialNumber: "HAP2AC2DEMO1"),
new("127.127.127.129", "Keller-Switch", "CRS326-24G-2S+", "arm", IsRouterBoard: true, SerialNumber: "CRS326DEMO02"),
];
private readonly Dictionary<string, List<Dictionary<string, string>>> _data;
private int _nextId = 1;
public DemoRouterOsClient()
: this(Profiles[0])
{
}
public DemoRouterOsClient(DemoDeviceProfile profile)
{
_data = BuildInitialData(profile);
}
public static bool Matches(RouterOsCredentials credentials) =>
credentials.Host == DemoHost && credentials.Username == DemoUsername && credentials.Password == DemoPassword;
credentials.Username == DemoUsername && credentials.Password == DemoPassword
&& Profiles.Any(p => p.Host == credentials.Host);
/// <summary>Baut den zum Host passenden simulierten Client — <see cref="Matches"/> muss vorher geprüft worden sein.</summary>
public static DemoRouterOsClient Create(RouterOsCredentials credentials) =>
new(Profiles.First(p => p.Host == credentials.Host));
public RouterOsProtocol Protocol => RouterOsProtocol.Rest;
@@ -114,11 +145,11 @@ public sealed class DemoRouterOsClient : IRouterOsClient
private static string Normalize(string path) => path.TrimEnd('/');
private static Dictionary<string, List<Dictionary<string, string>>> BuildInitialData() => new()
private static Dictionary<string, List<Dictionary<string, string>>> BuildInitialData(DemoDeviceProfile profile) => new()
{
["/system/resource"] = [new() { ["board-name"] = "CHR (Simulator)", ["version"] = "7.15.2 (stable)", ["architecture-name"] = "x86_64" }],
["/system/identity"] = [new() { ["name"] = "Test-Router" }],
["/system/routerboard"] = [new() { ["routerboard"] = "no", ["serial-number"] = "DEMO1234AB" }],
["/system/resource"] = [new() { ["board-name"] = profile.BoardModel, ["version"] = "7.15.2 (stable)", ["architecture-name"] = profile.Architecture }],
["/system/identity"] = [new() { ["name"] = profile.IdentityName }],
["/system/routerboard"] = [BuildRouterboardRow(profile)],
["/interface"] =
[
new() { [".id"] = "*1", ["name"] = "ether1", ["type"] = "ether", ["running"] = "true", ["disabled"] = "false" },
@@ -198,18 +229,44 @@ public sealed class DemoRouterOsClient : IRouterOsClient
new() { ["mac-address"] = "AA:BB:CC:00:00:03", ["on-interface"] = "ether3", ["bridge"] = "bridge-lan", ["local"] = "false" },
],
// Beispieldaten für "Backup verwalten", alle vier Kompatibilitäts-Stufen: eines passt exakt
// (Modell/Architektur/Seriennummer wie oben: "CHR (Simulator)"/"x86_64"/"DEMO1234AB", sanitisiert
// "CHR--Simulator-"/"x86-64"/"DEMO1234AB"), eines stammt vom selben Modell+Architektur, aber
// einem anderen physischen Gerät (andere Seriennummer — auf eigene Gefahr wiederherstellbar),
// eines von einem komplett anderen Modell (älteres Format ohne Architektur/Seriennummer, testet
// gleichzeitig den Modell-only-Fallback), eines hat gar keinen erkennbaren Namen (z. B. WinBox).
// Beispieldaten für "Backup verwalten", alle vier Kompatibilitäts-Stufen: das erste passt immer
// exakt zum jeweiligen Profil (dynamisch aus dessen Modell/Architektur/Seriennummer gebaut),
// eines stammt vom selben Modell+Architektur wie das CHR-Profil, aber einem anderen physischen
// Gerät (andere Seriennummer — auf eigene Gefahr wiederherstellbar), eines von einem komplett
// anderen Modell (älteres Format ohne Architektur/Seriennummer, testet gleichzeitig den
// Modell-only-Fallback), eines hat gar keinen erkennbaren Namen (z. B. WinBox).
["/file"] =
[
new() { ["name"] = "mikrotik-installer-CHR--Simulator-_x86-64_DEMO1234AB-20260910-120000.backup", ["creation-time"] = "2026-09-10T12:00:00Z" },
new() { ["name"] = $"{BuildBackupFileName(profile)}-20260910-120000.backup", ["creation-time"] = "2026-09-10T12:00:00Z" },
new() { ["name"] = "mikrotik-installer-CHR--Simulator-_x86-64_ANDERESGERAET99-20260905-100000.backup", ["creation-time"] = "2026-09-05T10:00:00Z" },
new() { ["name"] = "mikrotik-installer-RB750Gr3-20260901-090000.backup", ["creation-time"] = "2026-09-01T09:00:00Z" },
new() { ["name"] = "winbox-backup.backup", ["creation-time"] = "2026-08-01T08:00:00Z" },
],
};
private static Dictionary<string, string> BuildRouterboardRow(DemoDeviceProfile profile)
{
var row = new Dictionary<string, string> { ["routerboard"] = profile.IsRouterBoard ? "yes" : "no" };
// Ohne RouterBOARD (z. B. CHR) liefert DeviceDiscoveryService das Modell stattdessen über
// "/system/resource"/"board-name" — "model" hier weglassen, sonst würde das simuliert, was ein
// echtes CHR-Gerät gerade nicht tut.
if (profile.IsRouterBoard)
{
row["model"] = profile.BoardModel;
}
if (profile.SerialNumber is not null)
{
row["serial-number"] = profile.SerialNumber;
}
return row;
}
private static string BuildBackupFileName(DemoDeviceProfile profile)
{
var name = $"mikrotik-installer-{RouterBackupService.SanitizeForFileName(profile.BoardModel)}_{RouterBackupService.SanitizeForFileName(profile.Architecture)}";
return profile.SerialNumber is null ? name : $"{name}_{RouterBackupService.SanitizeForFileName(profile.SerialNumber)}";
}
}
@@ -19,7 +19,7 @@ public static class RouterOsClientFactory
// Endnutzer veröffentlichten Version landet.
if (DemoRouterOsClient.Matches(credentials))
{
return new DemoRouterOsClient();
return DemoRouterOsClient.Create(credentials);
}
#endif