lsa-planer

LSA-Planer Professional – Planungssoftware für Lichtsignalanlagen nach RiLSA 2015 und § 45 StVO. EUPL-1.2.

/ tests tools liesmich.test.ts

27,9 KB Rohdatei
tests/tools/liesmich.test.ts — 554 Zeilen
1 import { existsSync, readFileSync, statSync } from 'node:fs';
2 import path from 'node:path';
3 import { describe, expect, it } from 'vitest';
4 import { ANSICHT_DATEINAME } from '@/../electron/schriftgroesse';
5 import { PRUEFSTAND_LABELS, QUELLEN } from '@/domain/rilsa/quellen';
6 import { PROJECT_FILE_EXTENSION, PROJECT_FILE_FILTERS } from '@/services/storage';
7
8 /**
9 * `LIESMICH.txt` - das einzige Blatt im Paket, das sich an den Empfaenger
10 * richtet.
11 *
12 * WARUM ES SIE GIBT. Neben der Programmdatei lagen sieben Beilagen, und alle
13 * sieben waren Lizenztexte. Wer das Paket bekam, fand kein Wort darueber, was
14 * Windows beim Start eines unsignierten Installationsprogramms meldet, welche
15 * der beiden fast gleich grossen Programmdateien er nehmen soll, wo seine
16 * Daten liegen und woher eine neue Fassung kommt.
17 *
18 * SEIT 5.43.0 GILT DAS BLATT FUER JEDEN WEG ZUM PROGRAMM ZUGLEICH. Es geht mit
19 * jedem Paket und muss deshalb fuer Setup, tragbare Fassung und jede andere
20 * Installationsart gleichzeitig wahr sein. Vier Aussagen waren es nur fuer die
21 * ersten beiden: die fehlende Signatur, die Pruefsumme, das Selbstholen neuer
22 * Fassungen und der Datenordner. Die Faelle dazu pruefen deshalb nicht mehr das
23 * ganze Blatt, sondern den Abschnitt und den Satz, in dem die Aussage steht -
24 * eine Warnung "NICHT signiert" irgendwo im Blatt waere auch dann gruen, wenn
25 * sie sich auf ein Paket bezoege, das ein Vertriebsdienst selbst signiert. Bei
26 * derselben Durchsicht fiel die Abgrenzung auf: Sie nannte die Koordinierung
27 * mehrerer Anlagen als etwas, das das Programm nicht tut, und die gibt es seit
28 * 5.35.0.
29 *
30 * WIEDERHERGESTELLT NOCH IN FASSUNG 5.43.0. Bei dieser Durchsicht war der Fall
31 * zu den Vorbehalten des Blattes (offene Kennwerte, fachliche Verantwortung,
32 * kein PDF/UA, kein Konformitaetsnachweis) ersatzlos weggefallen, und kein
33 * anderer Test las diese Saetze. Er steht wieder da, auf den Abschnitt
34 * eingegrenzt - und nicht mehr mit "abzugleichen" irgendwo im Blatt: Der Satz
35 * dazu war falsch ("Fuenf rechenwirksame Kennwerte tragen dort abzugleichen ...
36 * nicht an einer Originalausgabe nachgeschlagen"), und die alte Pruefung hielt
37 * ihn gruen. Die Zahl haengt jetzt an einer eigenen Pruefung. Im selben Zug
38 * bekam die Pruefsumme ihre Grenze: Das Blatt sagte, sie belege die
39 * ausgelieferte Datei, und damit mehr als PRUEFSUMMEN-<Fassung>.txt selbst.
40 *
41 * WAS DIESE DATEI BEWACHT, ist nicht die Prosa, sondern die pruefbaren
42 * Angaben darin: die Dateinamen im Benutzerprofil, die Liste der Beilagen und
43 * die Zusagen, die anderswo im Baum eine Entsprechung haben. Ein Beiblatt, das
44 * still veraltet, ist schlimmer als keines - der Empfaenger richtet sich
45 * danach.
46 *
47 * WAS SIE NICHT KANN: pruefen, ob der Text verstaendlich ist. Das entscheidet,
48 * wer ihn liest. Und die Messungen an einer Installation wiederholen, bei der
49 * Windows die Benutzerdaten gesondert fuehrt - die stehen mit Datum im Blatt
50 * und in docs/datenschutz.md, und ein Testfall installiert kein Programm.
51 */
52
53 const LIESMICH = readFileSync('LIESMICH.txt', 'utf8');
54 const EINZEILIG = LIESMICH.replace(/\s+/gu, ' ');
55 const PAKET = JSON.parse(readFileSync('package.json', 'utf8')) as {
56 readonly name: string;
57 readonly version: string;
58 readonly build: {
59 readonly extraFiles: readonly { readonly from: string; readonly to: string }[];
60 readonly productName: string;
61 };
62 };
63
64 /** Eine Ueberschrift des Blattes: eine Zeile nur aus Grossbuchstaben und Satzzeichen. */
65 const UEBERSCHRIFT = /^[A-ZÄÖÜ][A-ZÄÖÜ .,-]*$/u;
66
67 /**
68 * Der Text unter einer Ueberschrift bis zur naechsten, auf eine Zeile
69 * zusammengezogen. Fehlt die Ueberschrift, schlaegt der Fall hier fehl und
70 * nicht erst an einem leeren Text, der alles `not.toContain` besteht.
71 */
72 function abschnitt(titel: string): string {
73 const zeilen = LIESMICH.split(/\r?\n/u);
74 const anfang = zeilen.indexOf(titel);
75 expect(anfang, `Abschnitt "${titel}" fehlt im Blatt`).toBeGreaterThanOrEqual(0);
76 const rest = zeilen.slice(anfang + 1);
77 const ende = rest.findIndex((zeile) => UEBERSCHRIFT.test(zeile));
78 return (ende < 0 ? rest : rest.slice(0, ende)).join(' ').replace(/\s+/gu, ' ');
79 }
80
81 /** Zahlwoerter, wie das Blatt sie schreibt. */
82 const ZAHLWOERTER: Readonly<Record<string, number>> = {
83 zwei: 2,
84 drei: 3,
85 vier: 4,
86 fünf: 5,
87 sechs: 6,
88 sieben: 7,
89 acht: 8,
90 neun: 9,
91 zehn: 10,
92 elf: 11,
93 zwölf: 12,
94 };
95
96 /** Der eine Satz eines Abschnitts, der `teil` enthaelt. */
97 function satzMit(text: string, teil: string): string {
98 const treffer = text.split(/(?<=[.!?])\s+/u).filter((satz) => satz.includes(teil));
99 expect(treffer, `kein Satz mit "${teil}"`).toHaveLength(1);
100 return String(treffer[0]);
101 }
102
103 describe('LIESMICH.txt geht mit dem Paket', () => {
104 it('steht in build.extraFiles und liegt im Baum', () => {
105 const namen = PAKET.build.extraFiles.map((e) => e.to);
106 expect(namen, 'die Datei geht nicht mit').toContain('LIESMICH.txt');
107 expect(existsSync('LIESMICH.txt')).toBe(true);
108 });
109
110 it('zaehlt die Beilagen auf, die wirklich mitgehen', () => {
111 /*
112 * Die Liste am Ende des Blattes nennt, was daneben liegt. Kommt eine
113 * Beilage hinzu oder faellt eine fort, laeuft sie sonst auseinander - und
114 * der Empfaenger sucht eine Datei, die es nicht gibt.
115 *
116 * Zwei der Namen stehen nicht in `extraFiles`: LICENSE.electron.txt und
117 * LICENSES.chromium.html legt electron-builder von sich aus daneben, und
118 * PRUEFSUMMEN-<Fassung>.txt entsteht erst beim Bau. Beide sind hier
119 * namentlich ausgenommen.
120 */
121 for (const eintrag of PAKET.build.extraFiles) {
122 if (eintrag.to === 'LIESMICH.txt') continue;
123 expect(LIESMICH, `${eintrag.to} fehlt in der Aufzaehlung`).toContain(eintrag.to);
124 }
125 });
126
127 it('nennt die Dateien im Benutzerprofil so, wie sie wirklich heissen', () => {
128 /*
129 * DER ORDNER HAENGT AM FELD name DER package.json, NICHT AM productName.
130 * Hier stand `%APPDATA%\${build.productName}\`, und das Blatt nannte
131 * entsprechend %APPDATA%\LSA-Planer Professional\ - einen Ordner, den
132 * keine gebaute Fassung anlegt. Electron nimmt den Namen der App aus der
133 * package.json IM app.asar, dort aus productName und sonst aus name, und
134 * build.productName gelangt nicht dorthin. Nachgesehen am 17.09.2026 im
135 * app.asar der Fassung 5.43.0 (release/win-unpacked): name
136 * "lsa-planer-professional", kein productName; die Daten des Arbeitsplatzes liegen unter
137 * %APPDATA%\lsa-planer-professional. Der Fall war gruen, weil er die
138 * falsche Annahme mit dem falschen Text verglich.
139 */
140 const daten = abschnitt('WO DAS PROGRAMM DATEN ABLEGT');
141 expect(daten, 'der Ordner von Setup und tragbarer Fassung').toContain(
142 `%APPDATA%\\${PAKET.name}\\`,
143 );
144 expect(LIESMICH, 'der Ordner, den keine Fassung anlegt').not.toContain(
145 `%APPDATA%\\${PAKET.build.productName}\\`,
146 );
147 expect(LIESMICH, 'die Ansichtsdatei').toContain(ANSICHT_DATEINAME);
148 /*
149 * ansicht.json fuehrt die Schriftgroesse und sonst nichts
150 * (electron/schriftgroesse.ts). "Fenstergröße und zuletzt gewählte
151 * Ansicht" stand hier - die Fenstergroesse kuendigt der Kopf jener Datei
152 * nur als kuenftig an, die zuletzt gewaehlte Ansicht gar nicht.
153 */
154 const ansichtszeile = LIESMICH.split(/\r?\n/u).find((z) => z.includes(ANSICHT_DATEINAME));
155 expect(String(ansichtszeile), 'was ansicht.json enthaelt').toContain('Schriftgröße');
156 expect(String(ansichtszeile), 'was ansicht.json nicht enthaelt').not.toContain('Fenstergröße');
157 const protokoll = readFileSync(path.join('electron', 'protokoll.ts'), 'utf8');
158 const treffer = /path\.join\(verzeichnis, '([^']+)'\)/u.exec(protokoll);
159 expect(treffer, 'der Name der Protokolldatei').not.toBeNull();
160 /*
161 * ALS GANZES WORT und nicht als Teilkette. Mit `toContain` blieb dieser
162 * Fall gruen, als die Datei im Programm zu "protokoll.log" umbenannt
163 * wurde: Das steht in "fehlerprotokoll.log" mit drin, und das Beiblatt
164 * haette weiter den alten Namen genannt. Eine Mutation hat es gezeigt.
165 */
166 const name = String(treffer?.[1]);
167 const alsWort = new RegExp(`(^|[^\\w.-])${name.replace(/[.]/gu, '\\.')}([^\\w-]|$)`, 'u');
168 expect(alsWort.test(LIESMICH), `das Beiblatt nennt "${name}" nicht`).toBe(true);
169 });
170
171 it('nennt jede Endung, die der Speichern-Dialog fuer Projekte anbietet', () => {
172 /*
173 * Fassung 5.43.0: Das Blatt sagte, Projekte liegen "als Datei mit der
174 * Endung .lsap" - der Speichern-Dialog bietet aber auch "JSON-Datei" an
175 * (PROJECT_FILE_FILTERS), und dann liegt das Projekt mit allem, was
176 * eingetragen ist, als .json da. Dieselbe Angabe in docs/datenschutz.md
177 * haelt tests/domain/datenschutz.test.ts.
178 */
179 const satz = satzMit(abschnitt('WO DAS PROGRAMM DATEN ABLEGT'), 'Ihre Projekte liegen');
180 const endungen = PROJECT_FILE_FILTERS.flatMap((filter) => [...filter.extensions]);
181 expect(endungen, 'Voraussetzung: die Endung der Projektdatei').toContain(
182 PROJECT_FILE_EXTENSION,
183 );
184 for (const endung of endungen) {
185 expect(satz, `Endung .${endung}`).toMatch(new RegExp(`\\.${endung}\\b`, 'u'));
186 }
187 });
188
189 it('nennt den Speicherort des Quellcodes, den auch QUELLCODE.txt nennt', () => {
190 const quelle = readFileSync('QUELLCODE.txt', 'utf8');
191 const adresse = /https:\/\/[\w.-]+/u.exec(quelle);
192 expect(adresse, 'QUELLCODE.txt nennt keine Adresse').not.toBeNull();
193 expect(LIESMICH, 'zwei Adressen fuer denselben Zweck').toContain(String(adresse?.[0]));
194 /*
195 * WOHER SETUP UND TRAGBARE FASSUNG KOMMEN, steht mit der Adresse selbst da.
196 * Hier stand "von der Internetseite des Herausgebers", und das Hilfemenue
197 * fuehrt einen Eintrag "Internetseite des Herstellers", der auf eine
198 * andere Adresse geht (electron/menu.ts) - wer beide las, hielt sie fuer
199 * dieselbe Seite.
200 */
201 const wege = abschnitt('WEGE ZUM PROGRAMM');
202 expect(wege, 'die Adresse bei den Dateien von der Internetseite').toContain(
203 String(adresse?.[0]),
204 );
205 expect(wege, 'die verwechselbare Umschreibung').not.toMatch(/Internetseite des Herausgebers/u);
206 /*
207 * "Dort finden Sie auch, was sich je Fassung geändert hat" stand hier, ohne
208 * zu sagen, wo dort. Bis 5.43.1 nannte das Blatt dafuer eine Datei im
209 * Quellcode; seit 5.43.2 geht diese Datei nicht mehr mit
210 * dem Quellcode hinaus. Der erste Wortlaut zu 5.43.2 verwies stattdessen
211 * auf die Seite des Programms und sagte einen Aenderungsbericht zu, der
212 * die geaenderten Zahlen nennt - einen solchen Abschnitt hatte die Seite
213 * nicht (nachgesehen am 18.09.2026). Das Blatt sagt jetzt nur, was ohne
214 * ihn stimmt: dass sich gerechnete Zahlen aendern koennen, und wo steht,
215 * was das fuer eine Unterlage heisst.
216 */
217 const aktualisierungen = abschnitt('AKTUALISIERUNGEN');
218 expect(aktualisierungen, 'die Zusage eines Aenderungsberichts').not.toMatch(
219 /Änderungsbericht|je Fassung geändert/u,
220 );
221 expect(aktualisierungen, 'dass sich Zahlen aendern koennen').toContain(
222 'können sich gerechnete Zahlen ändern',
223 );
224 expect(aktualisierungen, 'der Verweis auf die Unterlagen').toContain('im nächsten Abschnitt');
225 });
226
227 it('sagt, was das Programm nicht tut - als Abgrenzung und nicht als Luecke', () => {
228 /*
229 * Die Abgrenzung ist eine Entscheidung des Projekts. Ein Beiblatt, das
230 * dem Empfaenger etwas anderes verspricht, waere die schlechteste Art von
231 * Fehler: Er merkt es erst, wenn er es braucht.
232 */
233 expect(EINZEILIG).toContain('verkehrsabhängige Steuerung');
234 expect(EINZEILIG).toContain('Bevorrechtigung des ÖPNV');
235 expect(EINZEILIG, 'als Entscheidung und nicht als Lücke').toContain(
236 'getroffene Abgrenzung und keine Lücke',
237 );
238 });
239
240 it('fuehrt die Koordinierung nicht mehr unter dem, was das Programm nicht tut', () => {
241 /*
242 * Bis 5.42.1 stand "Koordinierung mehrerer Anlagen" in der Abgrenzung,
243 * obwohl es sie seit 5.35.0 gibt; das Blatt, seit 5.26.0 unveraendert, war
244 * nicht nachgezogen. Geprueft wird der Absatz der Abgrenzung, nicht das
245 * ganze Blatt: Anderswo darf und soll die Koordinierung vorkommen.
246 */
247 const absatz = /WAS ES NICHT TUT[\s\S]*?(?:\r?\n[ \t]*\r?\n|$)/u.exec(LIESMICH);
248 expect(absatz, 'der Absatz der Abgrenzung fehlt').not.toBeNull();
249 expect(String(absatz?.[0]), 'die Abgrenzung nennt die Koordinierung').not.toContain(
250 'Koordinierung',
251 );
252 expect(
253 abschnitt('WAS DAS PROGRAMM TUT'),
254 'die Koordinierung fehlt unter dem, was es tut',
255 ).toContain('Koordinierung');
256 /*
257 * "Lageplanzeichnung nach RSA 21" stand daneben. Ein Lageplanblatt gibt
258 * es seit 5.32.0, einen bemassten Signallageplan und einen
259 * Verkehrszeichenplan weiterhin nicht - das Blatt sagt beides.
260 */
261 expect(EINZEILIG, 'der Signallageplan').toContain('bemaßten Signallageplan');
262 expect(EINZEILIG, 'der Verkehrszeichenplan').toContain('Verkehrszeichenplan');
263 });
264
265 it('verschweigt die Vorbehalte nicht, die das Programm selbst fuehrt', () => {
266 /*
267 * Bis 5.42.1 hier mit `toContain` ueber das ganze Blatt, darunter
268 * "abzugleichen"; in 5.43.0 zunaechst gestrichen, dann
269 * wiederhergestellt (Kopf dieser Datei).
270 */
271 const unterlagen = abschnitt('WAS SIE ÜBER DIE UNTERLAGEN WISSEN SOLLTEN');
272 expect(unterlagen, 'die fachliche Verantwortung').toContain(
273 'nimmt Ihnen die fachliche Verantwortung für den Plan nicht ab',
274 );
275 expect(unterlagen, 'die Barrierefreiheit des PDF').toContain('kein PDF/UA');
276 expect(unterlagen, 'die Auskunft zur Barrierefreiheit').toContain(
277 'Zur Barrierefreiheit der Bedienoberfläche gibt der Hersteller auf Anfrage Auskunft; ' +
278 'sie ist kein Konformitätsnachweis.',
279 );
280
281 /*
282 * DIE OFFENEN KENNWERTE. Hier stand "Fuenf rechenwirksame Kennwerte tragen
283 * dort "abzugleichen": Sie sind praxisueblich, aber nicht an einer
284 * Originalausgabe des Regelwerks nachgeschlagen." Die Zahl stimmte, der
285 * Satz um sie herum nicht: Den Pruefstand tragen in quellen.ts neunzehn
286 * Eintraege, weil er auch Werte kennzeichnet, fuer die kein Regelwerk eine
287 * Zahl nennt, und von den fuenf offenen ist einer an der gekauften RiLSA
288 * 2015 teilweise beantwortet. Die Zahl im Satz haelt eine eigene Pruefung.
289 */
290 expect(unterlagen, 'die alte Aussage').not.toMatch(
291 /nicht an einer Originalausgabe[^.]*nachgeschlagen/u,
292 );
293 const satz = satzMit(unterlagen, 'Originalausgabe');
294 const treffer = /Bei (\S+) Kennwerten aus (.+?) steht das ganz oder teilweise aus\./u.exec(
295 satz,
296 );
297 expect(treffer, `Satz zur Zahl der offenen Kennwerte in: ${satz}`).not.toBeNull();
298 const wort = treffer?.[1] ?? '';
299 const offen = ZAHLWOERTER[wort] ?? Number(wort);
300 expect(offen, `Zahl der offenen Kennwerte: ${wort}`).toBeGreaterThan(0);
301
302 // Und wer die Unterlage aufschlaegt, findet den Pruefstand oefter.
303 const beschriftung = PRUEFSTAND_LABELS.abzugleichen;
304 const mitPruefstand = Object.values(QUELLEN).filter((q) => q.pruefstand === 'abzugleichen');
305 expect(mitPruefstand.length, 'Eintraege mit dem Pruefstand').toBeGreaterThan(offen);
306 expect(satzMit(unterlagen, `"${beschriftung}"`), 'mehr Kennwerte mit dem Pruefstand').toContain(
307 'mehr Kennwerte',
308 );
309 });
310
311 it('warnt vor dem, was Windows bei den unsignierten Dateien von der Internetseite meldet', () => {
312 /*
313 * EINGEGRENZT seit 5.43.0: Die Warnung gilt fuer Setup und tragbare
314 * Fassung. Ein Paket, das ein Vertriebsdienst selbst signiert, ist
315 * signiert; ein Satz "NICHT signiert", der nicht sagt, wofuer er gilt,
316 * schickte dessen Anwender auf die Suche nach einer Pruefsumme, die es
317 * fuer ihn nicht gibt.
318 */
319 const start = abschnitt('BEIM ERSTEN START MELDET SICH WINDOWS');
320 expect(start, 'die fehlende Signatur').toContain('NICHT mit einem Codesignaturzertifikat');
321 expect(start, 'was der Anwender sieht').toContain('Unbekannt');
322 expect(start, 'der Rat, vorher die Prüfsumme zu rechnen').toContain('Prüfsumme');
323 /*
324 * WAS DIE PRUEFSUMME BELEGT, mit ihrer Grenze. Hier stand "Sie belegt, dass
325 * die Datei unveraendert die ist, die ausgeliefert wurde" - unmittelbar
326 * hinter dem Rat, die Warnung zu uebergehen, und staerker als
327 * PRUEFSUMMEN-<Fassung>.txt selbst (scripts/pruefsummen.mjs): Wer die
328 * Programmdatei austauschen kann, kann die Liste daneben ebenso
329 * austauschen.
330 */
331 expect(start, 'die Grenze der Pruefsumme').toContain('Quelle stammt, der Sie trauen');
332 expect(start, 'die Zusage ohne Grenze').not.toContain('die ausgeliefert wurde');
333 const satz = satzMit(start, 'NICHT mit einem Codesignaturzertifikat');
334 expect(satz, 'wofuer die fehlende Signatur gilt').toContain('Internetseite');
335 expect(satz, 'die fehlende Signatur gilt nicht beim Vertriebsdienst').not.toContain(
336 'Vertriebsdienst',
337 );
338 });
339
340 it('sagt, dass beim Bezug ueber einen Vertriebsdienst, der selbst signiert, der Hinweis entfaellt', () => {
341 const start = abschnitt('BEIM ERSTEN START MELDET SICH WINDOWS');
342 const satz = satzMit(start, 'Vertriebsdienst');
343 expect(satz, 'wer signiert').toContain('selbst signiert');
344 expect(satz, 'dass der Hinweis dort entfaellt').toContain('diesen Hinweis nicht');
345 });
346
347 it('sagt, dass sich das Programm nicht selbst aktualisiert', () => {
348 // Es gibt keinen Aktualisierungsweg im Programm; das ist eine Eigenschaft,
349 // die der Empfaenger kennen muss, damit er von Zeit zu Zeit nachsieht.
350 expect(EINZEILIG).toContain('sucht nicht selbst nach neuen Fassungen');
351 });
352
353 it('sagt, dass ein Vertriebsdienst selbst aktualisiert und ueber aeltere Fassungen selbst bestimmt', () => {
354 /*
355 * "Sucht nicht selbst" stimmt fuer das Programm auf jedem Weg - nur kommt
356 * die neue Fassung ueber einen Vertriebsdienst trotzdem, auch ohne dass
357 * der Anwender sie holt. Wer eine Unterlage mit ihrem Rechenstand
358 * nachvollziehen muss, erfaehrt es im Abschnitt ueber die Unterlagen,
359 * weil es dort darauf ankommt. Bis 5.43.1 stand dort, eine aeltere
360 * Fassung gebe es auf jenem Weg nicht; das bestimmt der Dienst, nicht das
361 * Programm.
362 */
363 expect(abschnitt('AKTUALISIERUNGEN'), 'wer ueber den Dienst aktualisiert').toContain(
364 'bekommt neue Fassungen von dort',
365 );
366 const unterlagen = abschnitt('WAS SIE ÜBER DIE UNTERLAGEN WISSEN SOLLTEN');
367 expect(unterlagen, 'die neue Fassung ohne Rueckfrage').toContain('ohne Rückfrage');
368 expect(unterlagen, 'aeltere Fassungen bestimmt der Dienst').toContain(
369 'ob er eine ältere herausgibt, bestimmt er',
370 );
371 });
372
373 it('sagt, dass Windows das Verzeichnis je nach Installationsart gesondert fuehrt', () => {
374 /*
375 * Gemessen am 17.09.2026 unter Windows 11 (Build 26200): Ohne einen
376 * vorhandenen %APPDATA%\lsa-planer-professional fuehrt Windows die Daten
377 * je nach Installationsart in einem gesonderten Bereich, und die
378 * Deinstallation entfernt sie. Seit 5.43.2 nennt das Blatt diesen Bereich
379 * nicht mehr mit Pfad; es sagt, dass es ihn gibt, was mit ihm geschieht
380 * und wann das nachgesehen ist.
381 */
382 const daten = abschnitt('WO DAS PROGRAMM DATEN ABLEGT');
383 expect(daten, 'die gesonderte Ablage').toContain('Je nach Installationsart');
384 expect(daten, 'was die Deinstallation tut').toContain('entfernt es mit der Deinstallation');
385 expect(daten, 'das Messdatum').toContain('17.09.2026');
386 });
387
388 it('nennt die Ausnahme fuer Umsteiger, bei der der Ordner stehen bleibt', () => {
389 /*
390 * Die zweite Messung desselben Tages: Lag %APPDATA%\lsa-planer-professional
391 * schon vom Setup oder vom tragbaren Programm da, schrieb das Programm
392 * dorthin, auch neue Dateien, und nach der Deinstallation stand der
393 * Ordner samt neuer Protokollzeile noch. Ein Blatt, das nur "entfernt
394 * es mit der Deinstallation" sagt, verspricht dem Umsteiger eine
395 * Bereinigung, die nicht stattfindet.
396 */
397 const daten = abschnitt('WO DAS PROGRAMM DATEN ABLEGT');
398 expect(daten, 'die Ausnahme').toContain('Umsteiger');
399 expect(daten, 'auch neue Dateien').toContain('auch neue Dateien');
400 expect(daten, 'was dann bleibt').toContain('lässt das Verzeichnis stehen');
401 const ordner = `%APPDATA%\\${PAKET.name}\\`;
402 expect(daten.split(ordner).length - 1, 'der Ordner in der Ausnahme').toBeGreaterThanOrEqual(2);
403 /*
404 * NUR FUER DAS GEMESSENE. Gemessen ist unter Windows 11 (Build 26200);
405 * das Blatt nennt als Untergrenze Windows 10 Version 1809, und fuer
406 * Windows 10 vor Version 1903 beschreibt Microsoft (abgerufen am
407 * 17.09.2026), dass in diesem Fall jeder Schreibzugriff unter AppData in
408 * eine eigene Kopie geht - dort teilten sich die beiden Programme nichts.
409 * Die Ausnahme stand als allgemeine Tatsache da.
410 */
411 expect(satzMit(daten, 'Umsteiger'), 'wofuer die Ausnahme gemessen ist').toContain('Windows 11');
412 expect(daten, 'was unter Windows 10 nicht nachgesehen ist').toContain('unter Windows 10 nicht');
413 });
414
415 it('verspricht nach einem Absturz nicht mehr, als die Sicherung haelt', () => {
416 /*
417 * "er sorgt dafür, dass nach einem Absturz nichts verloren ist" stand
418 * hier. src/services/autosave.ts sagt selbst weniger - gesichert wird
419 * verzoegert nach der Aenderung, die letzte Eingabe kann fehlen -, das
420 * Zwischenspeichern laesst sich abschalten (`autoSaveEnabled` in
421 * src/services/storage.ts), und nach dem Befund 'nicht-lesbar' sperrt es
422 * sich selbst. Das Blatt sagt jetzt, dass die Sicherung Arbeit retten
423 * kann und das Speichern nicht ersetzt.
424 */
425 const einstellungen = readFileSync(path.join('src', 'services', 'storage.ts'), 'utf8');
426 expect(einstellungen, 'das Zwischenspeichern ist abschaltbar').toContain(
427 'readonly autoSaveEnabled: boolean',
428 );
429 const daten = abschnitt('WO DAS PROGRAMM DATEN ABLEGT');
430 expect(daten, 'die Zusage ohne Verlust').not.toContain('nichts verloren');
431 expect(daten, 'die Grenze der Sicherung').toContain('ersetzt aber nicht das Speichern');
432 });
433
434 it('fuehrt zum Fehlerprotokoll und zu den Datenschutzhinweisen ueber das Menue', () => {
435 /*
436 * Je nach Installationsart liegt das Fehlerprotokoll nicht unbedingt unter
437 * dem Pfad, den das Programm nennt; der Menueeintrag liest es dort, wo das Programm
438 * es kennt. Die Beschriftung kommt aus electron/menu.ts, damit das Blatt
439 * nicht "..." schreibt, wo das Menue "…" zeigt.
440 */
441 const menue = readFileSync(path.join('electron', 'menu.ts'), 'utf8');
442 const eintrag = /label: '(Fehlerprotokoll[^']*)'/u.exec(menue);
443 expect(eintrag, 'der Menueeintrag zum Fehlerprotokoll').not.toBeNull();
444 expect(EINZEILIG, 'der Menueweg zum Fehlerprotokoll').toContain(
445 `Hilfe → ${String(eintrag?.[1])}`,
446 );
447 // Ein Menueweg steht auf einer Zeile: hinter "Hilfe →" umbrochen, liest er
448 // sich im Editor als zwei Angaben, und die Anfuehrung reisst auseinander.
449 for (const zeile of LIESMICH.split(/\r?\n/u)) {
450 expect(zeile, 'ein Menueweg ist hinter dem Pfeil umbrochen').not.toMatch(/→\s*$/u);
451 expect(zeile, 'ein Menueweg ist vor dem Pfeil umbrochen').not.toMatch(/^\s*→/u);
452 }
453 const ueber = readFileSync(path.join('src', 'ui', 'ueber.ts'), 'utf8');
454 expect(ueber, 'die Schaltflaeche im Über-Fenster').toContain("label: 'Datenschutz'");
455 expect(EINZEILIG, 'der Weg zu den Datenschutzhinweisen').toContain(
456 'Hilfe → Über LSA-Planer Professional → Datenschutz',
457 );
458 });
459
460 it('sagt in QUELLCODE.txt, wie eine vierstellige Fassungsnummer zur Programmfassung steht', () => {
461 /*
462 * "Die Fassung dort trägt dieselbe Nummer wie das Programm daneben" - je
463 * nach Installationsart nennt Windows die Nummer vierstellig. Dass die
464 * vierte Stelle 0 bleibt, prueft dieser Fall nicht.
465 */
466 const quelle = readFileSync('QUELLCODE.txt', 'utf8').replace(/\s+/gu, ' ');
467 expect(quelle, 'die Zusage').toContain('dieselbe Nummer wie das Programm daneben');
468 expect(quelle, 'die vierstellige Nummer').toContain('vierstellig, mit einer 0 an vierter');
469 expect(satzMit(quelle, 'vierstellig'), 'wann Windows vierstellig zaehlt').toContain(
470 'Je nach Installationsart',
471 );
472 });
473 });
474
475 describe('Die Groessenangabe des Blattes gegen das Bauergebnis', () => {
476 const dateien = [
477 `release/LSA-Planer Professional ${PAKET.version}.exe`,
478 `release/LSA-Planer Professional Setup ${PAKET.version}.exe`,
479 ];
480 const OHNE_BAU = !dateien.every((datei) => existsSync(datei));
481
482 it.skipIf(OHNE_BAU)(
483 'stimmt die Groesse in Millionen Byte und so, wie Windows sie anzeigt (nur mit Bauergebnis messbar)',
484 () => {
485 /*
486 * Die Pakete der Fassung 5.43.0 hatten am 17.09.2026 111.778.492 und
487 * 112.075.939 Byte. Ohne Bauergebnis uebersprungen - kein Rueckfall auf
488 * eine Zahl hier.
489 *
490 * ZWEI ZAHLEN, WEIL WINDOWS ANDERS RECHNET. Hier stand "rund 112 MB",
491 * dezimal gerundet - und wer die Groesse nachsah, fand 106 MB: Windows
492 * teilt durch 1024 hoch 2 und schreibt trotzdem "MB". GEMESSEN am
493 * 17.09.2026 an beiden Dateien: StrFormatByteSizeW (shlwapi, die
494 * Anzeige der Dateieigenschaften) und die Groessenspalte des Explorers
495 * zeigen je "106 MB". Die zweite Datei hat 106,88 MiB - gerundet waere
496 * das 107; Windows schneidet also ab, und deshalb steht hier
497 * `Math.floor`. Das gilt fuer drei Stellen vor dem Komma: Am selben Tag
498 * zeigte StrFormatByteSizeW fuer 104.333.312 Byte "99,5 MB" und fuer
499 * 1.048.576.000 Byte "0,97 GB". Faellt ein Paket in einen dieser
500 * Bereiche, bricht dieser Fall an der Angabe des Blattes, und das ist
501 * gewollt.
502 */
503 const dezimal = /rund (\d+) Millionen Byte/u.exec(EINZEILIG);
504 const anzeige = /Windows zeigt das als (\d+) MB an/u.exec(EINZEILIG);
505 expect(dezimal, 'die Groesse in Millionen Byte fehlt').not.toBeNull();
506 expect(anzeige, 'die Groesse, wie Windows sie anzeigt, fehlt').not.toBeNull();
507 for (const datei of dateien) {
508 const byte = statSync(datei).size;
509 expect(Math.round(byte / 1e6), `${datei}, Millionen Byte`).toBe(Number(dezimal?.[1]));
510 expect(Math.floor(byte / 1024 ** 2), `${datei}, Anzeige`).toBe(Number(anzeige?.[1]));
511 }
512 },
513 );
514 });
515
516 describe('Die Beilagen im Bauergebnis gegen den Quellbaum', () => {
517 /*
518 * Ein Bau mit veralteter Beilage blieb gruen: Die Lizenztexte hielt
519 * tests/tools/eigeneLizenzImPaket.test.ts, die beiden Blaetter niemand.
520 * GEMESSEN am 17.09.2026: Nach der Ueberarbeitung beider Blaetter lagen im
521 * Bauergebnis noch die alten.
522 *
523 * Verglichen wird in dem Verzeichnis, aus dem electron-builder das Setup und
524 * die tragbare Fassung schnuert. Ohne fertige Programmdatei dort ist nichts
525 * zu messen, und der Fall wird uebersprungen - ein halb gefuellter Ordner
526 * darf nicht als Bauergebnis durchgehen. Rot heisst: Der Bau ist aelter als
527 * die Beilage, und `npm run dist:win` ist neu zu fahren.
528 *
529 * FREMDBESTANDTEILE.md kam am 18.09.2026 dazu, vor dem Commit zu 5.43.0:
530 * Die Beilage ist docs/fremdbestandteile.md woertlich (build.extraFiles),
531 * und am Bau von 00:02 Uhr trug sie noch den Satz, ein Paket dieses Standes
532 * liege nicht vor, samt einer Byte-Zahl von vorher, waehrend dieser Fall
533 * gruen blieb, weil er nur die zwei Blaetter kannte, an denen der Fehler
534 * zuerst gesehen worden war.
535 */
536 for (const verzeichnis of [path.join('release', 'win-unpacked')]) {
537 const ohneBau = !existsSync(path.join(verzeichnis, `${PAKET.build.productName}.exe`));
538 it.skipIf(ohneBau)(
539 `liegen LIESMICH.txt, QUELLCODE.txt und FREMDBESTANDTEILE.md in ${verzeichnis} so wie im Baum (nur mit Bauergebnis messbar)`,
540 () => {
541 for (const [beilage, quelle] of [
542 ['LIESMICH.txt', 'LIESMICH.txt'],
543 ['QUELLCODE.txt', 'QUELLCODE.txt'],
544 ['FREMDBESTANDTEILE.md', path.join('docs', 'fremdbestandteile.md')],
545 ] as const) {
546 expect(
547 readFileSync(path.join(verzeichnis, beilage)).equals(readFileSync(quelle)),
548 `${beilage} in ${verzeichnis} weicht vom Quellbaum ab (${quelle})`,
549 ).toBe(true);
550 }
551 },
552 );
553 }
554 });