Stufe 4c (#764): Kommentare in C#, WebUI-Skripten, CSS und HTML auf Englisch

Rund 2.600 Kommentarblöcke in 310 C#-Dateien übersetzt, Begründungen vollständig
erhalten: blockweise gleiche Anzahl wie vorher, kein Block unter 60 % seiner
Länge, der Code außerhalb der Kommentare per Tokenizer byte-identisch geprüft.
Zitate deutscher Oberflächentexte und Testdaten bleiben deutsch.

WebUI: Kommentare in JS/CSS/HTML übersetzt, JSDoc-@param an die in 4b
umbenannten Parameter angeglichen.

Dabei behoben:
- 4b hatte "tag" (HTML-Tag) als deutsches "Tag" gelesen und zu "dayValue"
  gemacht (makeElement, svg, Tagesübersicht) - zurück auf tag/day.
- Aufgaben "InProgress" bekamen die Plakettenart "laufend", für die es nie eine
  CSS-Klasse gab - jetzt "success" wie laufende Instanzen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-10-04 12:45:03 +02:00
co-authored by Claude Opus 5.5
parent da4ceac7d5
commit 837a634a22
311 changed files with 7238 additions and 7252 deletions
@@ -4,16 +4,16 @@ using Shouldly;
namespace ClawdDotNet.Core.Tests.Tasks;
/// <summary>
/// Die Terminberechnung — Antwort auf B6 (keine Delays, nur „was ist jetzt fällig")
/// und B7 (jeder Termin wird explizit in seiner Zeitzone gedeutet). Reine Funktion,
/// deshalb ohne DB und ohne Uhr-Attrappe: „jetzt" wird direkt übergeben.
/// The schedule calculation — answer to B6 (no delays, only "what is due now")
/// and B7 (every occurrence is explicitly interpreted in its time zone). A pure function,
/// therefore without DB and without a fake clock: "now" is passed in directly.
/// </summary>
public sealed class TaskScheduleTests
{
private static DateTime Utc(int y, int mo, int d, int h, int mi)
=> new(y, mo, d, h, mi, 0, DateTimeKind.Utc);
// ─── #597: ungültiger Cron-Ausdruck ───
// ─── #597: invalid cron expression ───
[Fact]
public void Ungueltiger_Cron_Ausdruck_wird_benannt_statt_verschwiegen()
@@ -38,7 +38,7 @@ public sealed class TaskScheduleTests
};
TaskSchedule.InvalidCron(task).ShouldBeNull();
// 13:00 Berlin (MESZ) = 11:00 UTC
// 13:00 Berlin (CEST) = 11:00 UTC
TaskSchedule.DueOccurrence(task, Utc(2026, 9, 14, 11, 0)).ShouldBe("2026-09-14T11:00:00.0000000Z");
}
@@ -49,7 +49,7 @@ public sealed class TaskScheduleTests
Id = "t-1", When = new TaskWhen { Kind = TaskWhenKind.Every, Value = "kaputt" }
}).ShouldBeNull();
// ─── Einmalig, ohne Termin ───
// ─── One-time, without a schedule ───
[Fact]
public void Ohne_Termin_ist_die_Aufgabe_faellig_bis_sie_lief()
@@ -60,7 +60,7 @@ public sealed class TaskScheduleTests
TaskSchedule.DueOccurrence(task with { LastOccurrence = "x" }, Utc(2026, 7, 31, 7, 0)).ShouldBeNull();
}
// ─── at: einmaliger Zeitpunkt ───
// ─── at: one-time point in time ───
[Fact]
public void Ein_at_Termin_ist_erst_ab_dem_Zeitpunkt_faellig()
@@ -71,7 +71,7 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.At, Value = "2026-07-31T09:00:00", TimeZone = "Europe/Berlin" }
};
// 09:00 Berlin (Sommerzeit) = 07:00 UTC
// 09:00 Berlin (summer time) = 07:00 UTC
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 6, 59)).ShouldBeNull();
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 7, 0)).ShouldNotBeNull();
}
@@ -102,7 +102,7 @@ public sealed class TaskScheduleTests
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 9, 0)).ShouldNotBeNull();
}
// ─── every: Intervall ───
// ─── every: interval ───
[Fact]
public void Ein_Intervall_wird_erst_nach_Ablauf_faellig()
@@ -132,7 +132,7 @@ public sealed class TaskScheduleTests
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 8, 0)).ShouldNotBeNull();
}
// ─── cron: mit Zeitzone (der Kern von B7) ───
// ─── cron: with time zone (the core of B7) ───
[Fact]
public void Ein_Cron_Termin_wird_in_seiner_Zeitzone_gedeutet_Sommer()
@@ -144,7 +144,7 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 9 * * *", TimeZone = "Europe/Berlin" }
};
// 09:00 Berlin im Sommer (CEST, UTC+2) = 07:00 UTC
// 09:00 Berlin in summer (CEST, UTC+2) = 07:00 UTC
var occ = TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 7, 5));
occ.ShouldBe("2026-07-31T07:00:00.0000000Z");
}
@@ -159,7 +159,7 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 9 * * *", TimeZone = "Europe/Berlin" }
};
// 09:00 Berlin im Winter (CET, UTC+1) = 08:00 UTC — genau das, was B7 verlangt.
// 09:00 Berlin in winter (CET, UTC+1) = 08:00 UTC — exactly what B7 demands.
var occ = TaskSchedule.DueOccurrence(task, Utc(2026, 1, 15, 8, 5));
occ.ShouldBe("2026-01-15T08:00:00.0000000Z");
}
@@ -174,7 +174,7 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 9 * * *", TimeZone = "Europe/Berlin" }
};
// 06:00 UTC = 08:00 Berlin, vor der 09:00-Marke
// 06:00 UTC = 08:00 Berlin, before the 09:00 mark
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 6, 0)).ShouldBeNull();
}
@@ -184,11 +184,11 @@ public sealed class TaskScheduleTests
var task = new TaskItem
{
Id = "t-1",
CreatedAt = Utc(2026, 7, 31, 8, 0), // nach der heutigen 09:00-Berlin-Marke (07:00 UTC)
CreatedAt = Utc(2026, 7, 31, 8, 0), // after today's 09:00 Berlin mark (07:00 UTC)
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 9 * * *", TimeZone = "Europe/Berlin" }
};
// Jetzt 10:00 UTC — die heutige 09:00-Marke lag vor der Anlage, also nicht nachholen.
// Now 10:00 UTC — today's 09:00 mark was before creation, so do not catch up.
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 10, 0)).ShouldBeNull();
}
@@ -202,10 +202,10 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 9 * * *", TimeZone = "Europe/Berlin" }
};
// Später am selben Tag: der 09:00-Termin ist schon abgehakt.
// Later on the same day: the 09:00 occurrence is already ticked off.
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 10, 0)).ShouldBeNull();
// Der nächste Tag ist wieder fällig.
// The next day is due again.
TaskSchedule.DueOccurrence(task, Utc(2026, 8, 1, 7, 5)).ShouldBe("2026-08-01T07:00:00.0000000Z");
}
@@ -223,9 +223,9 @@ public sealed class TaskScheduleTests
}
/// <summary>
/// Früher fiel eine unbekannte Zone still auf UTC zurück. Das ist der schlechtere
/// Fehler: Ein Task für 09:00 Ortszeit lief im Sommer um 07:00, ohne dass irgendwo
/// etwas auffiel. Jetzt feuert er gar nicht — und der Scanner meldet einmal, warum.
/// Formerly an unknown zone silently fell back to UTC. That is the worse
/// error: a task for 09:00 local time ran at 07:00 in summer without anything
/// being noticed anywhere. Now it does not fire at all — and the scanner reports once why.
/// </summary>
[Fact]
public void Eine_unbekannte_Zeitzone_laesst_den_Termin_nicht_faellig_werden()
@@ -242,9 +242,9 @@ public sealed class TaskScheduleTests
}
/// <summary>
/// Der Kern der Portierung: Dieselbe Zeitzone, zwei Schreibweisen. Eine Task-Datei,
/// die unter Windows entstanden ist, muss unter Linux dieselbe Feuerzeit ergeben —
/// und umgekehrt.
/// The core of the port: the same time zone, two spellings. A task file
/// created under Windows must yield the same fire time under Linux —
/// and vice versa.
/// </summary>
[Theory]
[InlineData("Europe/Berlin")]
@@ -260,7 +260,7 @@ public sealed class TaskScheduleTests
TaskSchedule.UnresolvableTimeZone(task).ShouldBeNull();
// 09:00 Ortszeit im Sommer (MESZ, UTC+2) = 07:00 UTC.
// 09:00 local time in summer (CEST, UTC+2) = 07:00 UTC.
TaskSchedule.DueOccurrence(task, Utc(2026, 7, 31, 9, 5))
.ShouldBe("2026-07-31T07:00:00.0000000Z");
}
@@ -281,12 +281,12 @@ public sealed class TaskScheduleTests
}
// ═══════════════════════════════════════════════════════════
// Zeitumstellung — R4 und R5 der Teststrategie
// Daylight saving changes — R4 and R5 of the test strategy
//
// Europe/Berlin 2026: Am 29. März springt die Uhr um 02:00 auf 03:00, am
// 25. Oktober um 03:00 zurück auf 02:00. Ein täglicher Termin um 02:00 trifft
// also einmal im Jahr eine Uhrzeit, die es nicht gibt, und einmal eine, die es
// doppelt gibt.
// Europe/Berlin 2026: on 29 March the clock jumps at 02:00 to 03:00, on
// 25 October at 03:00 back to 02:00. A daily occurrence at 02:00 thus hits
// once a year a time that does not exist, and once one that exists
// twice.
// ═══════════════════════════════════════════════════════════
private static TaskItem TaeglichUmZwei(DateTime angelegt) => new()
@@ -296,15 +296,15 @@ public sealed class TaskScheduleTests
When = new TaskWhen { Kind = TaskWhenKind.Cron, Value = "0 2 * * *", TimeZone = "Europe/Berlin" }
};
/// <summary>R5 — der Fall, um den es in #235 geht.</summary>
/// <summary>R5 — the case #235 is about.</summary>
[Fact]
public void Zeitumstellung_Maerz_wird_nicht_uebersprungen()
{
var task = TaeglichUmZwei(Utc(2026, 3, 28, 0, 0));
// "02:00" existiert am 29. März nicht. Der Termin fällt trotzdem an, und zwar
// auf dem ersten Zeitpunkt danach: 03:00 MESZ = 01:00 UTC.
// Vorher kam hier null — die Aufgabe fiel an diesem Tag ersatzlos aus.
// "02:00" does not exist on 29 March. The occurrence still happens, namely
// at the first point in time after it: 03:00 CEST = 01:00 UTC.
// Previously null came here — the task was dropped on that day without replacement.
TaskSchedule.DueOccurrence(task, Utc(2026, 3, 29, 2, 0))
.ShouldBe("2026-03-29T01:00:00.0000000Z");
}
@@ -321,15 +321,15 @@ public sealed class TaskScheduleTests
.ShouldBeNull();
}
/// <summary>R4 — die andere Richtung.</summary>
/// <summary>R4 — the other direction.</summary>
[Fact]
public void Zeitumstellung_Oktober_feuert_genau_einmal()
{
var task = TaeglichUmZwei(Utc(2026, 10, 24, 0, 0));
// 02:00 kommt am 25. Oktober zweimal vor: in Sommerzeit (00:00 UTC) und in
// Normalzeit (01:00 UTC). Beide Durchläufe ergeben denselben Occurrence-Key —
// der Marker fängt den zweiten ab.
// 02:00 occurs twice on 25 October: in summer time (00:00 UTC) and in
// standard time (01:00 UTC). Both passes result in the same occurrence key —
// the marker catches the second.
var ersterDurchlauf = TaskSchedule.DueOccurrence(task, Utc(2026, 10, 25, 0, 30));
ersterDurchlauf.ShouldNotBeNull();
@@ -341,10 +341,10 @@ public sealed class TaskScheduleTests
[Fact]
public void An_gewoehnlichen_Tagen_bleibt_es_bei_zwei_Uhr_Ortszeit()
{
// Die Gegenprobe: Die Verschiebung darf nur in der Lücke greifen.
// The counter-check: the shift may only apply in the gap.
var task = TaeglichUmZwei(Utc(2026, 3, 21, 0, 0));
// 02:00 MEZ = 01:00 UTC.
// 02:00 CET = 01:00 UTC.
TaskSchedule.DueOccurrence(task, Utc(2026, 3, 22, 2, 0))
.ShouldBe("2026-03-22T01:00:00.0000000Z");
}
@@ -352,7 +352,7 @@ public sealed class TaskScheduleTests
[Fact]
public void Auch_ein_einmaliger_Termin_in_der_Luecke_faellt_nicht_aus()
{
// Derselbe Umgang auf dem at-Pfad — dort galt dieselbe Regel und dieselbe Lücke.
// The same handling on the at path — the same rule and the same gap applied there.
var task = new TaskItem
{
Id = "t-1",
@@ -364,7 +364,7 @@ public sealed class TaskScheduleTests
}
};
// 02:30 gibt es nicht; es wird 03:00 MESZ = 01:00 UTC.
// 02:30 does not exist; it becomes 03:00 CEST = 01:00 UTC.
TaskSchedule.DueOccurrence(task, Utc(2026, 3, 29, 0, 59)).ShouldBeNull();
TaskSchedule.DueOccurrence(task, Utc(2026, 3, 29, 1, 0))
.ShouldBe("2026-03-29T01:00:00.0000000Z");