strom-research 1.28.0-beta.3 → 1.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.cs.md +1 -1
  2. package/CHANGELOG.de.md +1 -1
  3. package/CHANGELOG.md +1 -1
  4. package/CHANGELOG.pl.md +1 -1
  5. package/assets/strom-doc/CISLA.md +4 -0
  6. package/assets/strom-doc/PIN +1 -1
  7. package/assets/strom-doc/REJSTRIK.md +17 -5
  8. package/assets/strom-doc/cs/A1-the-app-in-brief.md +23 -1
  9. package/assets/strom-doc/cs/A3-evidence-in-the-app.md +4 -1
  10. package/assets/strom-doc/cs/A6-views.md +16 -6
  11. package/assets/strom-doc/cs/R1-research-in-brief.md +34 -7
  12. package/assets/strom-doc/cs/R10-people-and-hypotheses.md +33 -12
  13. package/assets/strom-doc/cs/R11-material-from-the-user.md +17 -6
  14. package/assets/strom-doc/cs/R3-verification-and-citation.md +32 -13
  15. package/assets/strom-doc/cs/R6-awaiting-action.md +21 -5
  16. package/assets/strom-doc/cs/R7-when-the-agent-works.md +2 -0
  17. package/assets/strom-doc/cs/R8-reading-scans.md +3 -1
  18. package/assets/strom-doc/cs/R9-archives.md +19 -1
  19. package/assets/strom-doc/cs/S3-what-the-research-knows.md +2 -1
  20. package/assets/strom-doc/de/A1-the-app-in-brief.md +28 -1
  21. package/assets/strom-doc/de/A3-evidence-in-the-app.md +6 -1
  22. package/assets/strom-doc/de/A6-views.md +21 -6
  23. package/assets/strom-doc/de/R1-research-in-brief.md +36 -7
  24. package/assets/strom-doc/de/R10-people-and-hypotheses.md +40 -15
  25. package/assets/strom-doc/de/R11-material-from-the-user.md +20 -6
  26. package/assets/strom-doc/de/R3-verification-and-citation.md +34 -14
  27. package/assets/strom-doc/de/R6-awaiting-action.md +23 -5
  28. package/assets/strom-doc/de/R7-when-the-agent-works.md +3 -0
  29. package/assets/strom-doc/de/R8-reading-scans.md +3 -1
  30. package/assets/strom-doc/de/R9-archives.md +22 -1
  31. package/assets/strom-doc/de/S3-what-the-research-knows.md +2 -1
  32. package/assets/strom-doc/en/A1-the-app-in-brief.md +25 -1
  33. package/assets/strom-doc/en/A3-evidence-in-the-app.md +5 -1
  34. package/assets/strom-doc/en/A6-views.md +17 -6
  35. package/assets/strom-doc/en/R1-research-in-brief.md +35 -7
  36. package/assets/strom-doc/en/R10-people-and-hypotheses.md +34 -13
  37. package/assets/strom-doc/en/R11-material-from-the-user.md +18 -6
  38. package/assets/strom-doc/en/R3-verification-and-citation.md +31 -12
  39. package/assets/strom-doc/en/R6-awaiting-action.md +21 -4
  40. package/assets/strom-doc/en/R7-when-the-agent-works.md +2 -0
  41. package/assets/strom-doc/en/R8-reading-scans.md +3 -1
  42. package/assets/strom-doc/en/R9-archives.md +21 -1
  43. package/assets/strom-doc/en/S3-what-the-research-knows.md +2 -1
  44. package/assets/strom-doc/pl/A1-the-app-in-brief.md +24 -1
  45. package/assets/strom-doc/pl/A3-evidence-in-the-app.md +5 -1
  46. package/assets/strom-doc/pl/A6-views.md +18 -6
  47. package/assets/strom-doc/pl/R1-research-in-brief.md +34 -7
  48. package/assets/strom-doc/pl/R10-people-and-hypotheses.md +33 -12
  49. package/assets/strom-doc/pl/R11-material-from-the-user.md +18 -6
  50. package/assets/strom-doc/pl/R3-verification-and-citation.md +32 -14
  51. package/assets/strom-doc/pl/R6-awaiting-action.md +22 -5
  52. package/assets/strom-doc/pl/R7-when-the-agent-works.md +2 -0
  53. package/assets/strom-doc/pl/R8-reading-scans.md +3 -1
  54. package/assets/strom-doc/pl/R9-archives.md +22 -1
  55. package/assets/strom-doc/pl/S3-what-the-research-knows.md +2 -1
  56. package/dist/core/tree.js +1 -1
  57. package/package.json +2 -5
@@ -363,6 +363,8 @@ Nalezený zápis se zapíše najednou: pramen s výřezem, přepisem a místem v
363
363
  - pramen ze skenu dostane `--clip` (výřez, ve kterém se zápis četl), `--transcript` (slova zápisu po řádcích,
364
364
  nepřečtené `[?]`) a `--locator` (folio, strana, pořadí zápisu); podrobně
365
365
  [R3.4](R3-verification-and-citation.md#R3.4);
366
+ - zápis v jiném jazyce nebo písmu, než je jazyk výzkumu, dostane vedle doslovného přepisu i překlad do jazyka
367
+ výzkumu (`--translation`), od výzkumu 1.28.0;
366
368
  - do polí (`--date`, `--house`, `--age`, jméno) jen jistě přečtené. Nejisté jde do přepisu s `[?]` a do poznámky
367
369
  údaje („dům 21 nebo 27“). Co čtenář nahlásil jako nečitelné, zůstane nečitelné, dokud to agent nepřečte sám.
368
370
  Prázdný sloupec je prázdný; nic se nedoplňuje podle obvyklého;
@@ -376,7 +378,7 @@ Nalezený zápis se zapíše najednou: pramen s výřezem, přepisem a místem v
376
378
  - **Ovládání:** terminál (agent). Aplikace: stránka pramene ukazuje výřez a přepis ([A3.3](A3-evidence-in-the-app.md#A3.3)).
377
379
  - **Platí od:** výzkum 1.0.0; výřez 1.1.0
378
380
 
379
- <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ -->
381
+ <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ · překlad: recording.md "--translation", link.md krok 7 (od v1.28.0) -->
380
382
 
381
383
  <a id="R8.7"></a>
382
384
  ## R8.7 Jistota a ověření přečteného
@@ -400,7 +400,8 @@ Kroky u úkolu, který čeká na snímky archivu, kam agent nesmí:
400
400
  <a id="R9.10"></a>
401
401
  ## R9.10 Příklady
402
402
 
403
- Úrovně a meze jsou ze seznamu archivů výzkumu 1.27.0. Rodina Horákových je vymyšlená.
403
+ Úrovně a meze jsou ze seznamu archivů výzkumu 1.27.0, DigiArchiv SOA Třeboň z výzkumu 1.28.0. Rodina Horákových je
404
+ vymyšlená.
404
405
 
405
406
  <a id="R9.10.1"></a>
406
407
  ### R9.10.1 Moravský zemský archiv (Acta Publica)
@@ -464,3 +465,20 @@ Kroky u úkolu, který čeká na snímky archivu, kam agent nesmí:
464
465
  - **Platí od:** výzkum 1.27.0
465
466
 
466
467
  <!-- zdroj: research:assets/archives.json szukajwarchiwach.gov.pl (restricted, browserOnly) -->
468
+
469
+ <a id="R9.10.6"></a>
470
+ ### R9.10.6 DigiArchiv SOA Třeboň
471
+
472
+ - Archiv: jen ručně, jen přes prohlížeč člověka. Podmínky na úvodní stránce DigiArchivu (`/Uvod`): „Snímky jsou
473
+ poskytnuty pouze za účelem on-line prohlížení v DigiArchivu SOA v Třeboni, jejich kopírování, distribuování,
474
+ prodávání, využití v jiných projektech a na jiných stránkách je zakázáno.“ Server požadavky stromu odmítá (403),
475
+ podle archivu záměrně.
476
+ - Archiv potvrdil: člověk smí ručně uložit jen vybrané snímky, nikdy celou knihu ani její podstatnou část. Nástroje ke
477
+ stahování nejsou dovolené, ani prohlížeč agenta.
478
+ - Úkol: zápis Marie Horákové v matrice v DigiArchivu. Úkol vždy čeká na snímky, které vybere a uloží člověk. Svolení
479
+ to neotevře; stahovač, stažení webu ani prohlížeč agenta tam nesmí.
480
+ - Citace: trvalý odkaz na snímek je adresa jeho stránky `https://digi.ceskearchivy.cz/<kniha>/<snímek>`, nebo
481
+ **Odkaz na snímek** v panelu **POPIS**.
482
+ - **Platí od:** výzkum 1.28.0
483
+
484
+ <!-- zdroj: research:assets/archives.json digi.ceskearchivy.cz (manual, browserOnly, terms https://digi.ceskearchivy.cz/Uvod, quote, robots 403, scope, checked 2026-11-05), www.ceskearchivy.cz (stejné terms/quote) · src/core/terms.ts allows (browserOnly + manual) · CHANGELOG.cs.md 1.28.0 · znalosti/archivy-cz.md „SOA v Třeboni (DigiArchiv)“ (odpověď archivu 5. 11. 2026) · commit 805b871d -->
@@ -152,7 +152,8 @@ a poznámka. Otevřené jsou rozbalené.
152
152
  „+ 2 lidí“, „Tak to strom už vede“, „Jen text, nedá se ukázat.“, „bez vazby k osobám stromu“,
153
153
  u rozhodnuté *zvolená*, „Teď spojeno doopravdy“, „Už neplatí: …“.
154
154
  - **Které hypotézy výzkum pošle:** otevřené; rozhodnuté a zrušené jen ty, jejichž verze nesou vazby. Odvolané nikdy.
155
- - **Hranice:** rozhodnout hypotézu z aplikace nejde; rozhoduje se ve výzkumu.
155
+ - **Hranice:** rozhodnout hypotézu z aplikace nejde; rozhoduje ji člověk ve výzkumu, v terminálu
156
+ ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
156
157
  - **Ovládání:** aplikace: přepínač **Ukázat** u verze ([S3.5.1](#S3.5.1)).
157
158
  - **Platí od:** aplikace 3.11.0 s výzkumem 1.14.0 (verze, stav, **Ukázat**); seznam hypotéz od aplikace 3.4.0
158
159
 
@@ -2,7 +2,8 @@
2
2
  # A1 Die App im Überblick
3
3
 
4
4
  Wie die Strom-App als Ganzes arbeitet, auf einer Seite. Jeder Abschnitt führt zu einem Kapitel mit den genauen
5
- Regeln. Beschrieben werden die Strom-App 3.21.2 und die Forschung 1.25.2.
5
+ Regeln. Beschrieben werden die Strom-App 3.21.2 und die Forschung 1.25.2. Änderungen aus einer neueren Version tragen
6
+ deren Nummer.
6
7
 
7
8
  <a id="A1.1"></a>
8
9
  ## A1.1 Stammbaum im Browser, Daten auf dem Gerät
@@ -65,3 +66,29 @@ zurück an die Forschung ([R1.6](R1-research-in-brief.md#R1.6)).
65
66
  - Verbindung: [S1](S1-connecting-app-and-research.md). Änderungen aus der App: [S2](S2-edits-from-the-app.md).
66
67
  Was die Forschung weiß: [S3](S3-what-the-research-knows.md). Forschung aus der App gesteuert:
67
68
  [S4](S4-research-from-the-app.md). Telefon: [S5](S5-phone.md).
69
+
70
+ <a id="A1.7"></a>
71
+ ## A1.7 So funktioniert Strom in der App
72
+
73
+ Diese Dokumentation liegt der App bei und lässt sich auch ohne Internet lesen. Das Fenster **So funktioniert Strom**
74
+ hat den Inhalt der Teile A, R und S, das **Begriffsverzeichnis** und eine Suche nach einem Wort oder einer Nummer der
75
+ Regel.
76
+
77
+ - **Grenzen:**
78
+ - das Öffnen des Fensters sendet nichts und lädt nichts aus dem Netz;
79
+ - die Nummer einer Regel und Enter springen direkt zur Regel (`R4.3`); eine unbekannte Nummer zeigt den Inhalt;
80
+ - Links zwischen Regeln haben **Zurück**; **Im Web** öffnet dieselbe Regel auf stromapp.info;
81
+ - eine Regel, die neuer ist als die verbundene Forschung, sagt das („Die mit diesem Baum verbundene Forschung hat
82
+ Version …, dies gilt ab …“).
83
+ - **Bedienung:** App: **Aktionen → So funktioniert Strom**, auf dem Telefon **Mehr → So funktioniert Strom**, oder
84
+ **Über Strom → So funktioniert Strom**. Der Kreis **?** in der Kopfzeile öffnet die Hilfe direkt bei der Regel: in
85
+ der Forschungsübersicht und im kleinen Panel bei den Abschnitten **Warteschlange**
86
+ ([R2.4](R2-lines-and-queue.md#R2.4)), **Wartet auf Bearbeitung** ([R6.4](R6-awaiting-action.md#R6.4)) und
87
+ **Jetzt** ([R7](R7-when-the-agent-works.md), beim Pausieren [R7.6](R7-when-the-agent-works.md#R7.6)), im Fenster
88
+ **Orte** ([R4.5](R4-places.md#R4.5)), in der Verwaltung der Orte ([R4.4](R4-places.md#R4.4)), im Panel der
89
+ Widersprüche ([R5.3](R5-conflicts.md#R5.3)) und in **Was die Forschung weiß → Widersprüche**
90
+ ([R5.6](R5-conflicts.md#R5.6)). Im Fenster ist auch der **Rundgang durch die App**. In der Forschung: `strom doc`
91
+ ([R1.8](R1-research-in-brief.md#R1.8)).
92
+ - **Gilt seit:** App 3.24.0
93
+
94
+ <!-- zdroj: app:src/help/help-data.ts, src/help/topics.ts HELP_TOPICS · src/ui/help-mark.ts · strings.ts help.title, index, search, searchPh, web, back, unknown, verRes, topics; tour.menu · vendor/strom-doc/PIN · prace/1105-app-napoveda-impl (§1–§11, e2e help.spec: otevření okna bez síťového požadavku) -->
@@ -55,8 +55,13 @@ Forschung verbundenen Stammbaum bestimmt die Einstellung **Meine Quellenabschrif
55
55
  Quellen** der Filter **Abschrift nicht geprüft** (nur bei einem Stammbaum auf **Beleg** mit älteren ungeprüften
56
56
  Quellen).
57
57
  - **Gilt seit:** App 3.9.0
58
+ - **Ab App 3.24.0:** die Übersetzung der Transkription, die die Forschung gesendet hat
59
+ ([R3.4](R3-verification-and-citation.md#R3.4)), steht unter der Transkription als zugeklappter Abschnitt
60
+ **Übersetzung der Transkription**: im Quellenbetrachter und auf der Karte der Quelle auf der Seite der Person. Die
61
+ Notiz der Quelle ändert sich dadurch nicht; der Editor der Notiz zeigt sie ganz. Eine Quelle ohne Übersetzung sieht
62
+ aus wie früher.
58
63
 
59
- <!-- zdroj: app:src/research-sync.ts:357 researchReadSource, :365 isOlderSource, :377 verifiedOffer, :385 unverifiedOlderSources · src/ui/sources.ts:618 renderSourceReading, :658 sourceVerifiedValue, :296 renderSourcesFilter, :377 renderSourceViewer · strings.ts sources.verified/verifiedHintGuide/verifiedHintOlder/verifiedByTree/readBy/userReadingNote/filterUnverified -->
64
+ <!-- zdroj: app:src/research-sync.ts:357 researchReadSource, :365 isOlderSource, :377 verifiedOffer, :385 unverifiedOlderSources · src/ui/sources.ts:618 renderSourceReading, :658 sourceVerifiedValue, :296 renderSourcesFilter, :377 renderSourceViewer · strings.ts sources.verified/verifiedHintGuide/verifiedHintOlder/verifiedByTree/readBy/userReadingNote/filterUnverified · překlad (od 3.24.0): src/source-translation.ts SOURCE_TRANSLATION_LABELS, splitSourceTranslation · strings.ts viewerTranslation, translation · commit c2942b0 -->
60
65
 
61
66
  <a id="A3.2"></a>
62
67
  ## A3.2 Zitation: was eine Quelle belegt
@@ -2,7 +2,7 @@
2
2
  # A6 Ansichten und Auswahl der Personen
3
3
 
4
4
  Wie die Strom-App auswählt, welche Personen sie zeigt, und wie die einzelnen Ansichten sie zeigen. Beschrieben wird
5
- die App 3.21.2.
5
+ die App 3.21.2. Änderungen aus einer neueren Version tragen deren Nummer.
6
6
 
7
7
  Eine Ansicht ist eine andere Lesart **derselben Auswahl der Personen**. Die Auswahl bestimmen die zentrale Person
8
8
  (die angeklickte) und die Tiefe **Vorfahren** und **Nachkommen**. Familie, Nachkommen, Zeitleiste und Karte zeigen
@@ -145,13 +145,27 @@ Stammbaum aus der Forschung bestimmt die Forschung die Orte ([R4](R4-places.md))
145
145
  keine Namen von Personen, keine Daten und Beziehungen. Höchstens etwa eine Anfrage pro Sekunde;
146
146
  - die Koordinaten werden im Stammbaum gespeichert: jeder Ort wird einmal nachgeschlagen, und die Karte funktioniert
147
147
  dann auch ohne Verbindung;
148
- - das automatische Nachschlagen nimmt das **erste Ergebnis** des Dienstes für den geschriebenen Namen.
149
- Gleichnamige Gemeinden unterscheidet es dabei nicht: ein Ort kann so in eine gleichnamige Gemeinde anderswo
150
- fallen. Eine solche Lage markiert dann **Prüfen** ([R4.4.1](R4-places.md#R4.4.1));
148
+ - das automatische Nachschlagen nimmt das **erste Ergebnis** des Dienstes für den geschriebenen Namen. Bis App
149
+ 3.23.0 unterschied es dabei gleichnamige Gemeinden nicht: ein Ort konnte so in eine gleichnamige Gemeinde
150
+ anderswo fallen. Eine Lage, die nicht in den Stammbaum passt, markiert **Prüfen** ([R4.4.1](R4-places.md#R4.4.1));
151
151
  - nur ein Ort mit Hausnummer, den der Dienst nicht gefunden hat, wird nach der Gemeinde nachgeschlagen. Von den
152
152
  Gemeinden dieses Namens wird die gewählt, die den übrigen Orten des Stammbaums am nächsten liegt („Mehrere Orte
153
153
  tragen diesen Namen; gewählt wurde der, der den übrigen Orten des Stammbaums am nächsten liegt.“); beim Ort steht
154
154
  **Lage nach dem Ort …**;
155
+ - **ab App 3.24.0** wird die nächste Gemeinde bei jedem Ort gewählt: heißen zwei oder mehr Gemeinden genau wie der
156
+ geschriebene Ort (ohne Rücksicht auf Groß- und Kleinschreibung und diakritische Zeichen), wird die genommen, die
157
+ der Mitte des Stammbaums am nächsten liegt, nicht das erste Ergebnis. Die Mitte ist der Median der Lagen, die von
158
+ Hand eingetragen oder mit **Beibehalten** bestätigt sind, wenn es mindestens 3 sind; sonst der Median aller Lagen
159
+ des Stammbaums und der Orte, die das Nachschlagen ohne Zweifel gefunden hat. Ein Ort mit weiterer Angabe („Lhota u
160
+ Kolína“, „Lhota 16“), eine einzige Gemeinde oder ein Stammbaum ohne Lagen bekommt das erste Ergebnis wie früher.
161
+ Es bleibt bei einer Anfrage je Ort;
162
+ - die Prüfung des Ortes sagt, wie viele Gemeinden dieses Namens die Karte gefunden hat („Die Karte fand 3 Orte
163
+ dieses Namens und nahm den, der den übrigen Orten des Stammbaums am nächsten liegt.“); ab App 3.24.0, früher
164
+ immer „zwei“;
165
+ - eine Lage, die schon im Stammbaum ist, wird nicht verschoben: das Nachschlagen sucht nur Orte ohne Lage. Auch das
166
+ Zusammenführen mit einem anderen Stammbaum oder einer GEDCOM-Datei überschreibt eine von Hand eingetragene oder
167
+ mit **Beibehalten** bestätigte Lage nicht, es ergänzt nur fehlende. Eine falsche ältere Lage lässt sich nur von
168
+ Hand verschieben;
155
169
  - was nicht gefunden wird, bleibt ohne Lage. Die App rät nichts: „Schreibweise prüfen oder das Land hinzufügen“.
156
170
  - **Bedienung:** App: **Einstellungen → Orte online nachschlagen**; im Fenster der Orte **Falsche Stelle? Diesen Ort
157
171
  korrigieren**, **Diesen Ort unter einem anderen Namen suchen** (nur die Lage wird ergänzt, der Eintrag im Stammbaum
@@ -160,9 +174,10 @@ Stammbaum aus der Forschung bestimmt die Forschung die Orte ([R4](R4-places.md))
160
174
  Zustimmung, nur Namen und jeden Ort einmal (Kommentar im Code). Das Limit von einer Anfrage pro Sekunde ist eine
161
175
  Bedingung des Dienstes.
162
176
  - **Gilt seit:** App 1.10.0; **Falsche Stelle? Diesen Ort korrigieren** 1.10.1; **Verwaiste Orte bereinigen** 2.1.0;
163
- Lage nach dem Ort 3.21.0
177
+ Lage nach dem Ort 3.21.0; die nächste gleichnamige Gemeinde bei jedem Ort und die Zahl der Gemeinden in der Prüfung
178
+ 3.24.0
164
179
 
165
- <!-- zdroj: app:src/geocode.ts hlavička, REQUEST_INTERVAL_MS=1100, geocodePlace (limit 1, parseGeocodeResponse první výsledek), geocodeTown/pickTownHit nearestTo (od v3.21.0), geocodePlaces townFallback · app:src/strings.ts map.consentTitle, consentBody, settingLabel, wrongSpot (v1.10.1), searchLabel, attachOnly, useForOthers, cleanOrphans (v2.1.0), nearestTown, byTown, doneWithMisses · FB podnět 2026-11-04 (stejnojmenná obec) -->
180
+ <!-- zdroj: app:src/geocode.ts hlavička, REQUEST_INTERVAL_MS=1100, geocodePlace (limit 1, parseGeocodeResponse první výsledek), geocodeTown/pickTownHit nearestTo (od v3.21.0), geocodePlaces townFallback · app:src/strings.ts map.consentTitle, consentBody, settingLabel, wrongSpot (v1.10.1), searchLabel, attachOnly, useForOthers, cleanOrphans (v2.1.0), nearestTown, byTown, doneWithMisses · FB podnět 2026-11-04 (stejnojmenná obec) · od 3.24.0: geocode.ts treeCenter (medián, PERSONS_CENTER_MIN=3), sameNamedTowns, pickPlaceHit (townChoices), buildGeocodeUrl limit · place-check.ts multi count · strings.ts checkMulti(n) · merge-executor test (ruční poloha zůstane) · commit 046967d -->
166
181
 
167
182
  <a id="A6.6"></a>
168
183
  ## A6.6 Stammlinie in der Ansicht
@@ -2,7 +2,8 @@
2
2
  # R1 Die Forschung im Überblick
3
3
 
4
4
  Wie die Forschung als Ganzes arbeitet, auf einer Seite. Jeder Abschnitt führt zu einem Kapitel mit den genauen
5
- Regeln. Beschrieben werden die Forschung 1.25.2 und die Strom-App 3.21.2.
5
+ Regeln. Beschrieben werden die Forschung 1.25.2 und die Strom-App 3.21.2. Änderungen aus einer neueren Version tragen
6
+ deren Nummer.
6
7
 
7
8
  <a id="R1.1"></a>
8
9
  ## R1.1 Die Forschung ist eine Aufzeichnung, kein Gespräch
@@ -57,8 +58,9 @@ Der Agent arbeitet nach dem **Genealogical Proof Standard** (GPS): gründliche S
57
58
  und Vergleich der Beweise, Auflösung von Widersprüchen und eine niedergeschriebene Schlussfolgerung, die eine weitere
58
59
  forschende Person versteht.
59
60
 
60
- - Jede Angabe hat einen Grad der Sicherheit: **Hinweis**, **Möglich**, **Wahrscheinlich**, **Belegt**. Ein Stammbaum
61
- und die Familienüberlieferung sind immer nur ein Hinweis, ein Register dient zum Finden des Eintrags. Ausführlich:
61
+ - Jede Angabe hat einen Grad der Sicherheit: **Hinweis**, **Möglich**, **Wahrscheinlich**, **Belegt**. Ein Stammbaum,
62
+ die Familienüberlieferung und ein Register sind immer nur ein Hinweis: das Register führt zum Eintrag, belegt erst
63
+ der Eintrag selbst (das Register prüft der Code ab Forschung 1.28.0). Ausführlich:
62
64
  [R3](R3-verification-and-citation.md).
63
65
  - Ein Namensvetter ist nicht die gesuchte Person. Eine Person bestimmen Jahr, Ort, Haus, Beruf, Ehemann oder Ehefrau
64
66
  und die Eltern. Zwei Einträge mit demselben Namen und anderen Eltern sind zwei Personen. Identifizierung von
@@ -69,7 +71,7 @@ forschende Person versteht.
69
71
  Ausführlich: [R5](R5-conflicts.md).
70
72
  - Ein Ort bekommt eine Lage auf der Karte nur, wenn sicher ist, welcher Ort es ist. Ausführlich: [R4](R4-places.md).
71
73
 
72
- <!-- zdroj: research:assets/method/core.md (úvod, „Certainty is explicit“, „A namesake is not your person“, „Negative results are results“) -->
74
+ <!-- zdroj: research:assets/method/core.md (úvod, „Certainty is explicit“, „A namesake is not your person“, „Negative results are results“) · src/core/evidence.ts isWeak (rejstřík od 1.28.0) -->
73
75
 
74
76
  <a id="R1.5"></a>
75
77
  ## R1.5 Was der Mensch entscheidet
@@ -77,14 +79,16 @@ forschende Person versteht.
77
79
  Manche Entscheidungen gehören nur dem Menschen. Die Forschung fragt danach in **Wartet auf Bearbeitung**, und der
78
80
  Agent antwortet nicht an Stelle des Menschen.
79
81
 
80
- - Was auf den Menschen wartet (Briefe, Bilder zum Herunterladen, Fragen zu Orten, Widersprüche, Erzählungen zur
81
- Freigabe) und wo es erledigt wird: [R6](R6-awaiting-action.md).
82
+ - Was auf den Menschen wartet (Briefe, Bilder zum Herunterladen, Fragen zu Orten, Widersprüche, Hypothesen,
83
+ Erzählungen zur Freigabe) und wo es erledigt wird: [R6](R6-awaiting-action.md).
84
+ - Eine Hypothese entscheidet nur der Mensch; der Agent schlägt die Entscheidung vor (ab Forschung 1.28.0):
85
+ [R10.3.1](R10-people-and-hypotheses.md#R10.3.1).
82
86
  - Die Entscheidung des Menschen gilt. Der Agent ändert sie nur auf Grund einer neuen Quelle: [R5.4](R5-conflicts.md#R5.4).
83
87
  - Eine vom Menschen eingetragene Lage eines Ortes wird nicht geändert: [R4.3](R4-places.md#R4.3).
84
88
  - Einstellungen, die ändern, was der Agent darf, bestätigt der Mensch (zum Beispiel die Bedingung für die Arbeit des
85
89
  Agenten allein, [R7](R7-when-the-agent-works.md)).
86
90
 
87
- <!-- zdroj: research:assets/method/waiting.md · src/core/conflicts.ts againAllowed · src/core/placeid.ts personsHand · src/core/config.ts run.gate -->
91
+ <!-- zdroj: research:assets/method/waiting.md · src/core/conflicts.ts againAllowed · src/core/placeid.ts personsHand · src/core/config.ts run.gate · src/commands/analysis.ts hypothesis decide (person, od 1.28.0) -->
88
92
 
89
93
  <a id="R1.6"></a>
90
94
  ## R1.6 Die Forschung und die Strom-App
@@ -109,3 +113,28 @@ KI-Modell ist nicht hundertprozentig; wichtige Angaben soll idealerweise noch ei
109
113
  - **Gilt seit:** Forschung 1.0.0
110
114
 
111
115
  <!-- zdroj: research:assets/method/reading.md · assets/method/locate.md · assets/method/recording.md · src/commands/read.ts:183-200 -->
116
+
117
+ <a id="R1.8"></a>
118
+ ## R1.8 So funktioniert Strom: `strom doc`
119
+
120
+ Diese Dokumentation liegt der Forschung bei und lässt sich auch ohne Internet lesen. `strom doc` gibt den Inhalt aus,
121
+ `strom doc R10.1` eine Regel samt den Regeln darunter und `strom doc <Wörter>` sucht in den Überschriften, im
122
+ Begriffsverzeichnis und im Text.
123
+
124
+ - **Grenzen:**
125
+ - die Nummer lässt sich auch in Kleinbuchstaben oder mit Bindestrich schreiben (`r4.3`, `R4-3`). Eine unbekannte
126
+ Nummer endet mit einem Fehler, der die nächsten Nummern nennt;
127
+ - die Suche achtet weder auf diakritische Zeichen noch auf Groß- und Kleinschreibung. Sie zeigt höchstens 10 Regeln,
128
+ die besten zuerst, und wie viele es noch gibt (`--limit` eine andere Anzahl);
129
+ - der Text ist in der Sprache der Forschung (`--lang` eine andere). Eine Sprache, in die die Dokumentation nicht
130
+ übersetzt ist, bekommt Englisch mit einem Hinweis;
131
+ - bei der Regel steht ein Link auf dieselbe Regel auf stromapp.info;
132
+ - funktioniert auch außerhalb der Forschung und im Strom-Archiv und schreibt nichts.
133
+ - **Nur Methodik:** auf die Frage des Menschen, wie oder warum Strom etwas tut, antwortet der Agent nach `strom doc`:
134
+ mit der Nummer der Regel und mit dem Link, den `strom doc` ausgibt.
135
+ - **Bedienung:** Terminal: `strom doc`, `strom doc R2.3`, `strom doc hypotéza --lang en`, `--json`. Die Hilfe für den
136
+ Menschen (`strom help --human`) endet mit einem Verweis auf `strom doc`. Die App hat dieselbe Dokumentation in
137
+ **So funktioniert Strom** ([A1.7](A1-the-app-in-brief.md#A1.7)).
138
+ - **Gilt seit:** Forschung 1.28.0
139
+
140
+ <!-- zdroj: research:src/commands/doc.ts (SEARCH_ROWS=10, --limit, ui.docs.fallback, docUrl) · src/core/doc.ts · assets/strom-doc/ (PIN) · src/agents/files.ts:188 "answer from `strom doc`" · src/cli/help.ts (help --human, poslední řádek) · CHANGELOG.cs.md 1.28.0 · commity 314ab218, 4acfb170 -->
@@ -3,8 +3,8 @@
3
3
 
4
4
  Wie die Forschung erkennt, dass ein Eintrag der gesuchten Person gehört, was sie mit zwei Datensätzen einer Person
5
5
  tut, wie sie konkurrierende Erklärungen (Hypothesen) führt und wie sie Namen und die Personen erfasst, die ein Eintrag
6
- nennt. Beschrieben werden die Forschung 1.27.0 und die Strom-App 3.23.0. Bei den Regeln wird unterschieden, was
7
- **der Code prüft** und was nur eine **Regel der Methodik** ist.
6
+ nennt. Beschrieben werden die Forschung 1.27.0 und die Strom-App 3.23.0. Änderungen aus einer neueren Version tragen
7
+ deren Nummer. Bei den Regeln wird unterschieden, was **der Code prüft** und was nur eine **Regel der Methodik** ist.
8
8
 
9
9
  <a id="R10.1"></a>
10
10
  ## R10.1 Ein Namensvetter ist nicht die gesuchte Person
@@ -49,6 +49,8 @@ Datensatz verschwindet nicht: er bleibt zurückgezogen, mit einer Notiz, in wen
49
49
  es dieselben Eltern in zwei Datensätzen, werden zuerst die Familien zusammengeführt (`strom family merge`).
50
50
  - **Nur Methodik:** eine Person aus einem übernommenen Stammbaum, die in der Forschung schon erforscht ist, wird **in**
51
51
  die erforschte Person zusammengeführt; diese behält ihre Belege ([R11.3](R11-material-from-the-user.md#R11.3)).
52
+ - **Warum:** strom wählt zwischen zwei Angaben nie stillschweigend: welche gilt, entscheidet der Beleg. Die andere
53
+ wird mit Grund zurückgezogen, so bleibt sichtbar, was wo stand.
52
54
  - **Bedienung:** Terminal: `strom person merge`, `strom family merge`. Mögliche doppelte Personen im Stammbaum meldet
53
55
  die App in der Prüfung des Stammbaums ([A5.6](A5-tree-check.md#A5.6)).
54
56
  - **Gilt seit:** Forschung 1.0.0
@@ -85,23 +87,43 @@ A, B, C… mit dem, was für jede spricht und was dagegen.
85
87
  <a id="R10.3.1"></a>
86
88
  ### R10.3.1 Entscheidung einer Hypothese
87
89
 
88
- Eine Hypothese wird für eine Version entschieden oder verworfen, wenn sich keine entscheiden lässt. Entschieden wird in
89
- der Forschung; die App lässt eine Hypothese nicht entscheiden.
90
+ Eine Hypothese wird für eine Version entschieden oder verworfen, wenn sich keine entscheiden lässt. Entscheiden kann
91
+ nur der Mensch, in der Forschung; der Agent schlägt die Entscheidung vor. Die App lässt eine Hypothese nicht
92
+ entscheiden.
90
93
 
91
94
  - **Prüft der Code:**
92
- - die Entscheidung braucht den Text der Entscheidung (`--decision`); das Verwerfen ist `--abandon`;
93
- - erneut entscheiden lässt sich nur mit Grund (`--reason`). Die vorige Entscheidung bleibt in einer Notiz der
94
- Hypothese;
95
- - nach der Entscheidung gibt strom die Quellen aus, die die Hypothese nennt und die keine Angabe ihrer Personen
96
- zitiert: was sie sagen, soll bei den Personen erfasst werden.
97
- - **Nur Methodik:** eine Hypothese, deren Versionen Verbindungen tragen, wird mit der Wahl einer Version entschieden
98
- (`--variant B`). Eine entschiedene Hypothese, die ein neuer Eintrag umstößt, entscheidet der Agent mit Grund erneut.
99
- Was der Agent zurückgehalten hat, solange die Person nur eine Hypothese war, erfasst er nach der Entscheidung bei
100
- der Person.
101
- - **Bedienung:** Terminal: `strom hypothesis decide H… --variant B --decision "…"` (erneut mit `--reason "…"`).
95
+ - die Entscheidung ist ein Schritt des Menschen. Startet der Agent `strom hypothesis decide` (auch innerhalb von
96
+ `strom batch`), lehnt strom den Befehl ab;
97
+ - der Agent schlägt die Entscheidung vor: die Version und den Text der Entscheidung (`strom hypothesis propose`)
98
+ oder das Verwerfen (`--abandon`). Ein neuer Vorschlag ersetzt den vorigen. Auf die Antwort wird nicht gewartet,
99
+ die Arbeit geht weiter;
100
+ - der Vorschlag wartet in **Was wartet** in der Gruppe **Hypothesen zu entscheiden**
101
+ ([R6.3.4](R6-awaiting-action.md#R6.3.4)): der Mensch entscheidet wie vorgeschlagen, anders (eine andere Version
102
+ oder keine, mit Grund) oder lässt die Hypothese, wie sie ist. Ein nicht übernommener Vorschlag bleibt in einer
103
+ Notiz der Hypothese;
104
+ - sowohl die Entscheidung als auch der Vorschlag brauchen den Text der Entscheidung (`--decision`); das Verwerfen
105
+ ist `--abandon`;
106
+ - eine Hypothese, deren Versionen sagen, was sie verbinden würden, wird nur mit angegebener Version entschieden und
107
+ vorgeschlagen (`--variant B`). Ohne sie lehnt strom ab und erfasst nichts;
108
+ - erneut entscheiden (und erneut vorschlagen) lässt sich nur mit Grund (`--reason`). Die vorige Entscheidung bleibt
109
+ in einer Notiz der Hypothese;
110
+ - was die Entscheidung des Menschen verbindet, und die Quellen, die die Hypothese nennt und die keine Angabe ihrer
111
+ Personen zitiert, bekommt der Agent zu Beginn der nächsten Arbeit als erste Aufgabe zum Erfassen im Stammbaum.
112
+ - **Nur Methodik:** der Agent schlägt eine Entscheidung vor, wenn die Einträge auf eine Version zeigen, und sagt es dem
113
+ Menschen in einem Satz. Eine entschiedene Hypothese, die ein neuer Eintrag umstößt, schlägt der Agent mit Grund
114
+ erneut vor. Was der Agent zurückgehalten hat, solange die Person nur eine Hypothese war, erfasst er bei der Person,
115
+ sobald der Mensch die Hypothese entscheidet.
116
+ - **Warum:** eine neue Entscheidung braucht einen Grund, weil sich Entscheidungen offen ändern: die vorige bleibt
117
+ lesbar, und die neue sagt, was sie geändert hat (meist ein neuer Eintrag).
118
+ - **Bedienung:** Terminal: Menü `strom` → **Was wartet** → **Hypothesen zu entscheiden** → **Wie vorgeschlagen
119
+ entscheiden**, **Anders entscheiden**, **So lassen (Vorschlag nicht übernommen)**; per Befehl
120
+ `strom hypothesis decide H… --proposed`, `--keep-open` oder `--variant B --decision "…"` (erneut mit
121
+ `--reason "…"`). Agent: `strom hypothesis propose H… --variant B --decision "…"`.
102
122
  - **Gilt seit:** Forschung 1.0.0; Ausgabe nicht erfasster Quellen 1.12.0
123
+ - **Ab Forschung 1.28.0:** entscheidet nur der Mensch, der Agent schlägt vor; die angegebene Version prüft der Code
124
+ (früher nur Methodik). Hypothesen, die früher der Agent entschieden hat, bleiben, wie sie waren.
103
125
 
104
- <!-- zdroj: research:src/commands/analysis.ts hypothesis decide (earlier decision in a note, "deciding again needs --reason", sourcesNotOnPeople od v1.12.0) · research:assets/method/core.md "Write as you go", "Say what a hypothesis would connect" · research:assets/method/recording.md "A decided hypothesis that a new record overturns" -->
126
+ <!-- zdroj: research:src/commands/analysis.ts hypothesis propose, hypothesis decide (person: …, --proposed, --keep-open, againNeedsReason, decidedVariant) · src/cli/main.ts:288 def.person && isAgent · src/commands/batch.ts (def.person) · src/core/waiting.ts (hypotheses, TERMINAL_ONLY) · src/cli/menu-waiting.ts decideHypothesis · src/core/hypolinks.ts decidedToRecord, sourcesNotOnPeople · src/brief/brief.ts "Decided by the user — record it on the tree first" · assets/lang/cs.json wait.group.hypotheses, ui.wait.hypothesis.* · research:assets/method/core.md "The user decides a hypothesis" · assets/method/recording.md "is proposed again" · CHANGELOG.cs.md 1.28.0 · commit 9b12256a -->
105
127
 
106
128
  <a id="R10.4"></a>
107
129
  ## R10.4 Eine Familie außerhalb des Stammbaums wartet auf eine belegte Verbindung
@@ -146,6 +168,9 @@ hat seinen eigenen Datensatz. Namen werden so erfasst, wie sie im Eintrag stehen
146
168
  - eine Person, die ein schwächerer Eintrag anders genannt hat, behält diesen Namen als Variante; der richtige Name
147
169
  wird als Hauptname markiert. Nichts wird gelöscht;
148
170
  - ein nur teilweise gelesener Name: [R8.6](R8-reading-scans.md#R8.6).
171
+ - **Warum:** eine Beschreibung an Stelle des Namens („totgeborener Sohn“) würden die App und GEDCOM als Vornamen
172
+ zeigen und suchen, und der Abgleich der Namen hielte sie für einen Namen. Dass das Kind ohne Namen starb, ist eine
173
+ Angabe (Tod, Notiz).
149
174
  - **Bedienung:** Terminal: `strom name add P… "Marie /Vlková/" --kind birth --cite S…`, `strom name primary P…
150
175
  "…"` (`--clear` stellt den Geburtsnamen wieder her). Formen des Nachnamens in der App:
151
176
  [A4.5](A4-surnames-and-families.md#A4.5), [A4.6](A4-surnames-and-families.md#A4.6).
@@ -23,12 +23,19 @@ erfasst daraus nur, was wirklich darin steht.
23
23
  - **Nur Methodik:** Namen und Orte werden so erfasst, wie sie geschrieben sind; vereinheitlicht werden nur Daten. Die
24
24
  Aufgabe wird mit dem geschlossen, was aus der Unterlage hervorging, und mit weiteren Aufgaben: wo nach Einträgen zu
25
25
  suchen ist, die die Hinweise belegen.
26
+ - **Warum:**
27
+ - 20 Bilder: Scans einer Matrik gehören nicht als Hunderte Aufgaben Unterlagen in die Historie des Stammbaums.
28
+ Familienunterlagen eines Ordners sind meist einige bis einige Dutzend Dateien; mehr als 20 Bilder sind meist
29
+ Scans eines Buches und werden als Buch erfasst;
30
+ - 20 MB: die Historie des Stammbaums wird nie umgeschrieben und geht mit dem Stammbaum in Sicherungen und
31
+ Übertragungen mit. Große Dateien (Video, unkomprimierte Scans) würden sie dauerhaft vergrößern, deshalb liegen
32
+ sie im gemeinsamen Medienspeicher.
26
33
  - **Bedienung:** Terminal: `strom intake <soubory nebo složky>`, `strom intake --text "…"` (was der Benutzer sagt),
27
34
  `strom input list`, `strom input show I…`. App: **Material senden…**, **Materialien hinzufügen…**
28
35
  ([A3.5](A3-evidence-in-the-app.md#A3.5)).
29
36
  - **Gilt seit:** Forschung 1.0.0
30
37
 
31
- <!-- zdroj: research:src/commands/intake.ts intake (description, BOOK_OF_SCANS=20, sha256 known, intakeTask) · research:src/core/media.ts MAX_IN_TREE=20 MB · research:assets/method/intake.md kroky 1, 4, 6, 7 -->
38
+ <!-- zdroj: research:src/commands/intake.ts intake (description, BOOK_OF_SCANS=20, sha256 known, intakeTask) · research:src/core/media.ts MAX_IN_TREE=20 MB · commit ff18ac678 "a folder full of images is a book of scans" · commit e9386db84 · research:assets/method/intake.md kroky 1, 4, 6, 7 -->
32
39
 
33
40
  <a id="R11.2"></a>
34
41
  ## R11.2 Eine Urkunde ist eine Quelle, der Rest ist ein Hinweis
@@ -85,7 +92,8 @@ Einen Ordner, eine ZIP-Datei oder eine Schachtel Dokumente, aus der App gesendet
85
92
  Stapel an. Der Agent sortiert ihn dann nach Aufgaben.
86
93
 
87
94
  - **Prüft der Code:**
88
- - ein Stapel wird geschlossen, wenn die App meldet, dass er vollständig ist, oder einen Tag nach der letzten Datei;
95
+ - ein Stapel wird geschlossen, wenn die App meldet, dass er vollständig ist, oder einen Tag nach der letzten Datei
96
+ (ein Stapel vom Telefon eine Stunde nach dem letzten Foto, [S5.4](S5-phone.md#S5.4));
89
97
  - dann werden daraus Aufgaben Unterlagen zu je etwa 25 Dateien, nach den Ordnern, in denen die Dateien kamen. Im
90
98
  Strom-Archiv warten die Aufgaben zurückgestellt;
91
99
  - die Dateien eines Stapels werden als Originale im gemeinsamen Medienspeicher gespeichert, nicht in der Historie
@@ -101,10 +109,16 @@ Stapel an. Der Agent sortiert ihn dann nach Aufgaben.
101
109
  erfasst, und die Einträge werden daraus gelesen wie aus jedem Buch ([R8](R8-reading-scans.md));
102
110
  - die Aufgabe wird geschlossen, wenn jede ihrer Dateien eingeordnet ist; ein weiterer Teil des Stapels ist eine
103
111
  eigene Aufgabe.
104
- - **Warum:** der Pfad einer Datei im Stapel sagt viel (`Babička/Dopisy/1946.jpg`); was nicht zur Familie gehört, soll
105
- nicht in den Stammbaum gelangen (Methodik).
112
+ - **Warum:**
113
+ - einen Tag nach der letzten Datei: die App sendet die Dateien einzeln. Ein Stapel, von dem niemand gesagt hat, dass
114
+ er vollständig ist, wird mit dem geschlossen, was kam, damit nichts länger wartet; ein Tag ohne weitere Datei
115
+ heißt, dass das Senden vorbei ist. Die Seite auf dem Telefon wird leicht geschlossen, ohne den Stapel zu
116
+ übergeben, deshalb genügt dort eine Stunde;
117
+ - 25 Dateien: eine Aufgabe Unterlagen liest eine Sitzung des Agenten, und etwa 25 Dateien passen hinein;
118
+ - der Pfad einer Datei im Stapel sagt viel (`Babička/Dopisy/1946.jpg`); was nicht zur Familie gehört, soll nicht in
119
+ den Stammbaum gelangen (Methodik).
106
120
  - **Bedienung:** Terminal: `strom input batch` (Stapel und wie viel eingeordnet ist), `strom input sort I… --as
107
121
  source|document|photo|unrelated --person P…`. App: **Materialien hinzufügen…** im Menü der Forschung.
108
- - **Gilt seit:** Forschung 1.12.0
122
+ - **Gilt seit:** Forschung 1.12.0; Stapel vom Telefon 1.18.0
109
123
 
110
- <!-- zdroj: research:src/core/batches.ts hlavička, BATCH_TASK_FILES=25 (od v1.12.0) · research:src/commands/intake.ts input batch done (--idle), input sort (unrelated --reason) · research:assets/method/intake.md "A batch from the Strom app" -->
124
+ <!-- zdroj: research:src/core/batches.ts hlavička, BATCH_TASK_FILES=25 (od v1.12.0), BATCH_IDLE_MS, PHONE_BATCH_IDLE_MS (od v1.18.0) · research:src/commands/intake.ts input batch done (--idle), input sort (unrelated --reason) · research:assets/method/intake.md "A batch from the Strom app" -->
@@ -38,7 +38,7 @@ Schlussfolgerung aus allen Quellen der Angabe ist, nicht, wie gut eine einzelne
38
38
  ### R3.1.1 Standardgrad und die Zitation, die ihn hebt
39
39
 
40
40
  - Eine ohne `--status` erfasste Angabe: ohne Zitation **Hinweis**; mit Zitation mindestens einer Quelle, die nicht
41
- schwach ist ([R3.3](#R3.3)), **Wahrscheinlich**; sonst Hinweis.
41
+ schwach ist ([R3.3](#R3.3)), **Wahrscheinlich**; sonst Hinweis. Ab Forschung 1.28.0 ist auch ein Register schwach.
42
42
  - `strom cite` ohne `--status` hebt Hinweis auf Wahrscheinlich, wenn die neue Quelle nicht schwach ist. Einen anderen
43
43
  Grad ändert es nicht.
44
44
  - Eine Änderung des Grades über `strom event edit --status` braucht `--reason`; eine Zitation mit Grad
@@ -56,19 +56,21 @@ eines Grades: `event add`, `cite`, `event edit` und auch bei Angaben, die aus de
56
56
  - **Grenzen (prüft der Code),** in dieser Reihenfolge:
57
57
  1. Wahrscheinlich und Belegt brauchen mindestens eine Zitation.
58
58
  2. Mindestens eine Zitation muss aus einer Quelle stammen, die nicht schwach ist. Schwach sind ein Stammbaum
59
- (`--kind family-tree`), eine Erinnerung (`--kind family-memory`) und ein verfasstes Werk (`--form authored`).
59
+ (`--kind family-tree`), eine Erinnerung (`--kind family-memory`), ein verfasstes Werk (`--form authored`) und ab
60
+ Forschung 1.28.0 ein Register (`--kind index`).
60
61
  3. Belegt braucht zusätzlich unter den Zitationen aus nicht schwachen Quellen mindestens eine mit
61
62
  Primärinformation (`--information primary`): ein Eintrag, zur Zeit des Ereignisses geschrieben von jemandem,
62
63
  der es wusste. Die Information bei der Zitation hat Vorrang vor der Information bei der Quelle.
63
64
  - **Nur Methodik:** der Code prüft nicht, dass die Quelle eine Originalquelle ist (`--form original`), dass der Agent
64
65
  sie selbst gelesen hat, dass der Eintrag die Angabe direkt nennt, und auch nicht die blinde zweite Lesung
65
- ([R3.5](#R3.5)). Belegt geht darum auch bei einer Kopie oder einem Register mit Primärinformation durch.
66
+ ([R3.5](#R3.5)). Belegt geht darum auch bei einer Kopie mit Primärinformation durch (bei einem Register bis
67
+ Forschung 1.27.0 ebenfalls).
66
68
  - **Bedienung:** Terminal: `strom event add P… BIRT --date "…" --cite S… --information primary --status proven`.
67
69
  Die Ablehnung nennt den Grund und was stattdessen geht (Hinweis lassen, `--status possible` oder
68
70
  `--status probable`).
69
71
  - **Gilt seit:** Forschung 1.0.0
70
72
 
71
- <!-- zdroj: research:src/core/evidence.ts:27 isWeak, :32 informationOf, :55-68 checkStatus · src/core/actions.ts:196-209 makeEvent, :648, :906 · src/commands/people.ts:745 -->
73
+ <!-- zdroj: research:src/core/evidence.ts:27 isWeak, :32 informationOf, :55-68 checkStatus · src/core/actions.ts:196-209 makeEvent, :648, :906 · src/commands/people.ts:745 · od v1.28.0 evidence.ts isWeak (kind index), checkStatus "… or an index cannot make a fact" -->
72
74
 
73
75
  <a id="R3.2.1"></a>
74
76
  ### R3.2.1 Quelle: Form und Information
@@ -95,18 +97,21 @@ eines Grades: `event add`, `cite`, `event edit` und auch bei Angaben, die aus de
95
97
  Stammbaum, Erinnerung, Register, Katalog und Online-Stammbaum sagen, wo zu suchen ist. Sie sind kein Nachweis einer
96
98
  Angabe. Eine Angabe aus ihnen bleibt Hinweis, bis ein Eintrag sie belegt.
97
99
 
98
- - **Prüft der Code:** Stammbaum, Erinnerung und verfasstes Werk sind schwache Quellen: eine Angabe nur aus ihnen ist
99
- nie Wahrscheinlich oder Belegt ([R3.2](#R3.2)). Ein übernommener Stammbaum:
100
- [R11.3](R11-material-from-the-user.md#R11.3).
101
- - **Nur Methodik:** das Register. Der Code hält es nicht für schwach: mit seiner Zitation bekommt eine Angabe ohne
102
- `--status` den Grad Wahrscheinlich, und mit `--information primary` geht auch Belegt durch. Die Methodik will das
103
- Register nur zum Finden der Seite; der Eintrag wird im Kirchenbuch gelesen. Auch ein fehlender Eintrag im Register
104
- ist nur ein Hinweis: eine ähnliche Form des Familiennamens ist ein Kandidat.
100
+ - **Prüft der Code:** Stammbaum, Erinnerung, verfasstes Werk und Register (`--kind index`) sind schwache Quellen: eine
101
+ Angabe nur aus ihnen ist nie Wahrscheinlich oder Belegt ([R3.2](#R3.2)). Eine Angabe, die nur ein Register zitiert,
102
+ bleibt Hinweis, bis der Eintrag selbst gelesen und zitiert ist; mit der Zitation des Eintrags ist es eine Angabe des
103
+ Eintrags. Ein übernommener Stammbaum: [R11.3](R11-material-from-the-user.md#R11.3).
104
+ - **Grenzen:** bei Änderungen aus der App zählt ein Register als Eintrag: die Änderung einer Angabe, die ein Register
105
+ belegt, wird zu einem Widerspruch ([R5.2](R5-conflicts.md#R5.2)), nichts wird stillschweigend überschrieben.
106
+ - **Nur Methodik:** das Register dient nur zum Finden der Seite; der Eintrag wird im Kirchenbuch gelesen. Auch ein
107
+ fehlender Eintrag im Register ist nur ein Hinweis: eine ähnliche Form des Familiennamens ist ein Kandidat.
105
108
  - Unterlagen vom Benutzer (Urkunde, Foto, Brief, was der Benutzer sagt):
106
109
  [R11.2](R11-material-from-the-user.md#R11.2).
107
110
  - **Gilt seit:** Forschung 1.0.0
111
+ - **Ab Forschung 1.28.0:** das Register prüft der Code als schwache Quelle (früher nur Methodik: mit seiner Zitation
112
+ bekam eine Angabe Wahrscheinlich, und mit `--information primary` ging auch Belegt durch).
108
113
 
109
- <!-- zdroj: research:assets/method/core.md:8-12 · locate.md:22-24 · link.md:6-12 · intake.md:9-16 · src/core/evidence.ts:27 isWeak · src/core/import.ts:1-7, :113-117 · src/commands/sources.ts:221 -->
114
+ <!-- zdroj: research:assets/method/core.md:8-12 · locate.md:22-24 · link.md:6-12 · intake.md:9-16 · src/core/evidence.ts isWeak (kind index od v1.28.0), isCompiled (sync) · src/core/sync.ts isCompiled · src/core/import.ts:1-7, :113-117 · src/commands/sources.ts:221 · test/cli/index-weak.test.ts · commit 9685fcbe -->
110
115
 
111
116
  <a id="R3.4"></a>
112
117
  ## R3.4 Zitation: Ausschnitt und Abschrift
@@ -119,19 +124,24 @@ Seite sind mehrere Quellen.
119
124
  `--locator` (Folio, Seite, Nummer des Eintrags) und bei der Angabe `--quote`. In ein Feld (`--date`, `--house`,
120
125
  `--age`, Name) kommt nur, was sicher gelesen ist; Unsicheres kommt mit `[?]` in die Abschrift und in die Notiz der
121
126
  Angabe.
127
+ - **Nur Methodik, ab Forschung 1.28.0:** ein Eintrag in einer anderen Sprache oder Schrift als der Sprache der
128
+ Forschung (Latein, Kurrent, Polnisch, Kyrillisch…) bekommt neben der wörtlichen Abschrift auch eine Übersetzung in
129
+ die Sprache der Forschung (`--translation`). Die Abschrift bleibt in der Sprache des Eintrags. Die App zeigt die
130
+ Übersetzung zugeklappt unter der Abschrift ([A3.1.1](A3-evidence-in-the-app.md#A3.1.1)).
122
131
  - **Prüft der Code:** höchstens 3 Ausschnitte je Quelle (der Eintrag und seine Fortsetzung über einen Seitenumbruch).
123
132
  Einen fehlenden Ausschnitt oder eine fehlende Abschrift lehnt der Code nicht ab, er erinnert nur bei einer Quelle
124
133
  auf einem Scan daran: nach `strom source add`, nach `strom source edit` mit Bild oder Ausschnitt und bei
125
134
  `strom task done` bei den Quellen, die die Aufgabe erfasst hat.
126
135
  - Ältere Quellen: den Ausschnitt ergänzt `strom clips`, die Abschrift `strom transcripts` (Leser, ein zweiter Blick
127
136
  prüft sie).
128
- - **Bedienung:** Terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --locator "…"`.
137
+ - **Bedienung:** Terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --translation
138
+ @notes/preklad.txt --locator "…"`; Ergänzung `strom source edit S… --translation "…"`.
129
139
  Die App zeigt den Ausschnitt des Eintrags neben der Abschrift.
130
140
  - **Gilt seit:** Forschung 1.1.0 (Ausschnitt, `strom clips`, `strom transcripts`); Abschrift 1.0.0
131
141
  - **Ab Forschung 1.26.0:** die Hilfe der Option `--clip` sagt „ein weiterer bei jedem Seitenumbruch, höchstens 3“ (in 1.25.2
132
142
  „ein zweiter“). Die Regel ändert sich nicht.
133
143
 
134
- <!-- zdroj: research:assets/method/recording.md:19-27, :55-62 · src/core/media.ts:285 MAX_CLIPS, :481 transcriptNote, :492 clipNote · src/commands/sources.ts:183, :214, :250, :893 · src/commands/tasks.ts:366-369 finishTask · src/commands/clips.ts · src/commands/transcripts.ts · HEAD commit 6bc7430b -->
144
+ <!-- zdroj: research:assets/method/recording.md:19-27, :55-62 · src/core/media.ts:285 MAX_CLIPS, :481 transcriptNote, :492 clipNote · src/commands/sources.ts:183, :214, :250, :893 · src/commands/tasks.ts:366-369 finishTask · src/commands/clips.ts · src/commands/transcripts.ts · HEAD commit 6bc7430b · překlad: assets/method/recording.md "--translation", link.md krok 7, src/brief/brief.ts (Research language), src/commands/sources.ts:196 translation, src/gedcom/export.ts:557 (oddíl poznámky pramene „Překlad:“), commit a1ccd24e -->
135
145
 
136
146
  <a id="R3.5"></a>
137
147
  ## R3.5 Blinde zweite Lesung
@@ -303,6 +313,16 @@ Eine Erzählung wird aus den Angaben für die Familie geschrieben. Was nicht bel
303
313
  Sprache der Forschung;
304
314
  - Format des Textes: nur Absätze, Zwischenüberschriften, Aufzählungspunkte, Fettdruck und Kursivschrift. Anderes
305
315
  (Links, Tabellen, Zitate, nummerierte Listen) zeigt die App nach der Methodik als einfachen Text.
316
+ - **Warum:**
317
+ - nichts wird hinzugedacht: eine Erzählung ist für die Familie und stützt sich auf Belege. Was wahrscheinlich
318
+ klänge, aber nicht belegt ist, würde in der Familie bald als Tatsache gelten;
319
+ - Hintergrund: er ist für den Ort belegt, nicht für die Person; als Ursache dessen, was die Person tat, wäre er eine
320
+ als Tatsache ausgegebene Vermutung. Die Erzählung nennt die Quelle des Hintergrunds (`--source`), damit sie sich
321
+ prüfen lässt;
322
+ - Erzählung eines Paares: das gemeinsame Leben wird einmal erzählt, beim Paar, damit dasselbe Leben nicht zweimal
323
+ erzählt wird und die Fassungen nicht auseinandergehen;
324
+ - Format: die Strom-App zeigt nur Absätze, Zwischenüberschriften, Aufzählungspunkte, Fettdruck und Kursivschrift;
325
+ alles andere sähen die Lesenden als einfachen Text mit Zeichen.
306
326
  - Freigabe und neue Fassung einer freigegebenen Erzählung: [R6.3.2](R6-awaiting-action.md#R6.3.2).
307
327
  - **Bedienung:** Terminal: `strom story set P… --text @notes/… --fact E… --source S… --note "co je odvozené"`
308
328
  (Erzählung eines Paares bei der Familie F…).
@@ -25,7 +25,9 @@ nur dort erledigt wird. Die Liste wird jedes Mal aus der Forschung berechnet, in
25
25
  - Die Zeile **Wartet: N (davon X nur hier im Terminal, Y warten auf Antwort)** teilt die Zahl wie die App. Die Zahl
26
26
  der App ist N ohne die Einträge nur für das Terminal und ohne gesendete Anfragen.
27
27
  - Nur im Terminal sind Stammbäume, die aus der App gesendet wurden (**Die Strom-App**), Fragen zum Lesen der Scans
28
- (**Das Lesen der Scans**), Widersprüche (**Widersprüche zu entscheiden**, siehe [R5](R5-conflicts.md)) und mildere Bedingungen eines Archivs. In der Übersicht **Was wartet** kommen sie zuerst unter
28
+ (**Das Lesen der Scans**), Widersprüche (**Widersprüche zu entscheiden**, siehe [R5](R5-conflicts.md)), Hypothesen zu
29
+ entscheiden (ab Forschung 1.28.0) und mildere Bedingungen eines Archivs. In der Übersicht **Was wartet** kommen sie
30
+ zuerst unter
29
31
  der Überschrift **Nur hier im Terminal (nicht in der Strom-App)**, danach **Auch in der Strom-App**.
30
32
  - Die Seite für das Telefon liest nur: ohne die Einträge nur für das Terminal, mit Erzählungen, zuerst 20 Einträge,
31
33
  höchstens 200 auf einmal. Sie schreibt **Entscheiden lässt sich am Computer in der Forschungsübersicht.**
@@ -87,12 +89,12 @@ freiwilligen Notiz.
87
89
  ## R6.3 Entscheidungen
88
90
 
89
91
  Der Abschnitt **Entscheidungen** sammelt Fragen, die den Agenten aufhalten: Erlaubnis eines Archivs, zu bestätigende
90
- Downloader, mildere Bedingungen, Seite prüfen, Erzählung, Ort (siehe [R4](R4-places.md)), Widerspruch (siehe [R5](R5-conflicts.md)), Stammbäume aus der App und das Lesen der Scans. Entscheidungen
91
- stehen in der Liste zuerst.
92
+ Downloader, mildere Bedingungen, Seite prüfen, Erzählung, Ort (siehe [R4](R4-places.md)), Widerspruch (siehe [R5](R5-conflicts.md)), Hypothese (siehe
93
+ [R6.3.4](#R6.3.4)), Stammbäume aus der App und das Lesen der Scans. Entscheidungen stehen in der Liste zuerst.
92
94
 
93
95
  - **Bedienung:** Terminal: **Was wartet** → Eintrag; `strom allow archive --way`, `strom place answer`,
94
96
  `strom conflict resolve`, `strom media calibrate --answer`.
95
- - **Gilt seit:** Forschung 1.14.0. Widersprüche seit 1.20.0, Orte seit 1.25.0.
97
+ - **Gilt seit:** Forschung 1.14.0. Widersprüche seit 1.20.0, Orte seit 1.25.0, Hypothesen seit 1.28.0.
96
98
 
97
99
  <!-- zdroj: research:src/core/waiting.ts:51-65 SECTION, :75 DECIDE_RANK · src/cli/menu-waiting.ts:486 decideConflictHere, :518 decidePlace, :712 decideTune · CHANGELOG.cs.md 1.20.0, 1.25.0 -->
98
100
 
@@ -135,6 +137,20 @@ stehen in der Liste zuerst.
135
137
 
136
138
  <!-- zdroj: research:HEAD src/core/waiting.ts:428-451 (group branches) · src/cli/menu-waiting.ts decideBranch · assets/lang/cs.json:2359 wait.group.branches -->
137
139
 
140
+ <a id="R6.3.4"></a>
141
+ ### R6.3.4 Hypothesen zu entscheiden
142
+
143
+ - Eine Hypothese, deren Entscheidung der Agent vorgeschlagen hat ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)),
144
+ wartet in der Gruppe **Hypothesen zu entscheiden**: die Frage, die Versionen und der Vorschlag („Vorschlag:
145
+ Variante B – …“). Wahl: **Wie vorgeschlagen entscheiden**, **Anders entscheiden** (eine andere Version oder keine,
146
+ mit Grund), **So lassen (Vorschlag nicht übernommen)**.
147
+ - **Grenzen:** es entscheidet nur der Mensch ([R6.6](#R6.6)). Sie ist nur im Terminal, die Strom-App zeigt sie nicht
148
+ ([R6.1.1](#R6.1.1)). Im Strom-Archiv gibt es die Gruppe nicht.
149
+ - **Bedienung:** Terminal: **Was wartet** → Eintrag, `strom hypothesis decide H… --proposed | --keep-open`.
150
+ - **Gilt seit:** Forschung 1.28.0
151
+
152
+ <!-- zdroj: research:src/core/waiting.ts (kind hypothesis, section decide, DECIDE_RANK 0, TERMINAL_ONLY hypotheses, actsAsArchive) · src/cli/menu-waiting.ts decideHypothesis · assets/lang/cs.json wait.group.hypotheses, ui.wait.hypothesis.proposed/accept/other/keep -->
153
+
138
154
  <a id="R6.4"></a>
139
155
  ## R6.4 Gruppen und Reihenfolge
140
156
 
@@ -200,8 +216,10 @@ startet, fragt die Forschung den Menschen in einem Systemfenster, oder sie lehnt
200
216
  wachsenden Zweig (`strom offline answer`), das Überlassen eines Widerspruchs aus einer Änderung an den Agenten
201
217
  (`strom conflict leave`), das Zurücknehmen und Verwerfen eines Sendens aus der App (`strom sync undo|discard`) und
202
218
  die Korrekturen `strom fixes … edit-decisions|woken-waits`.
219
+ - **Ab Forschung 1.28.0:** nur der Mensch entscheidet auch eine Hypothese (`strom hypothesis decide`, auch innerhalb
220
+ von `strom batch`); der Agent schlägt sie nur vor ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
203
221
 
204
- <!-- zdroj: research:src/commands/tasks.ts:897-970 (requireHuman :941, task.check-person :932) · src/commands/archives.ts:586-645 · src/commands/calibrate.ts:320 · src/commands/placeid.ts:343 person · assets/method/waiting.md, narrate.md:26-31 · src/cli/menu-waiting.ts:45 ANSWER_MAX · 1.26.0: userOnly u story approve/discard, offline answer, conflict leave, sync undo/discard (commity 4683a22d, 1189532f, 942c56f9), fixes.ts edit-decisions/woken-waits (person at the terminal) -->
222
+ <!-- zdroj: research:src/commands/tasks.ts:897-970 (requireHuman :941, task.check-person :932) · src/commands/archives.ts:586-645 · src/commands/calibrate.ts:320 · src/commands/placeid.ts:343 person · assets/method/waiting.md, narrate.md:26-31 · src/cli/menu-waiting.ts:45 ANSWER_MAX · 1.26.0: userOnly u story approve/discard, offline answer, conflict leave, sync undo/discard (commity 4683a22d, 1189532f, 942c56f9), fixes.ts edit-decisions/woken-waits (person at the terminal) · 1.28.0: analysis.ts hypothesis decide (person), batch.ts def.person (commit 9b12256a) -->
205
223
 
206
224
  <a id="R6.7"></a>
207
225
  ## R6.7 Gesendet, Antwort und Rückkehr in die Warteschlange
@@ -299,6 +299,9 @@ anderen Computer übertragen), wartet auf ihn. Bis dahin verhält sie sich wie e
299
299
  - der gespeicherte Modus ändert sich nicht, und die Aufgaben werden nicht zurückgestellt. Nach der Installation des
300
300
  Agenten macht die Forschung von selbst mit den Aufgaben weiter, die sie hatte;
301
301
  - ein Agent, der gerade in der Forschung arbeitet (auch ein anderer als der eingestellte), macht sie zur Forschung.
302
+ - **Warum:** ein Archiv ist die Wahl des Menschen, und strom erfasst sie nicht für ihn. Eine Forschung ohne Agenten
303
+ verhält sich nur wie ein Archiv, deshalb macht sie nach der Installation des Agenten von selbst mit den Aufgaben
304
+ weiter, die sie hatte; keine ist zurückgestellt.
302
305
  - **Bedienung:** Terminal: Menü, erster Punkt (**Nur als Strom-Archiv behalten: die Daten aus der Strom-App
303
306
  speichern** oder die Installation des Agenten); `strom mode` zeigt den Zustand. Die App zeigt eine solche Forschung
304
307
  als **Archiv** ([S1.3](S1-connecting-app-and-research.md#S1.3)).
@@ -409,6 +409,8 @@ daraus und die Suche, die ihn gefunden hat.
409
409
  - eine Quelle aus einem Scan bekommt `--clip` (den Ausschnitt, in dem der Eintrag gelesen wurde), `--transcript`
410
410
  (die Worte des Eintrags zeilenweise, nicht Gelesenes `[?]`) und `--locator` (Folio, Seite, Nummer des Eintrags);
411
411
  ausführlich [R3.4](R3-verification-and-citation.md#R3.4);
412
+ - ein Eintrag in einer anderen Sprache oder Schrift als der Sprache der Forschung bekommt neben der wörtlichen
413
+ Abschrift auch eine Übersetzung in die Sprache der Forschung (`--translation`), ab Forschung 1.28.0;
412
414
  - in die Felder (`--date`, `--house`, `--age`, Name) kommt nur sicher Gelesenes. Unsicheres kommt mit `[?]` in die
413
415
  Abschrift und in die Notiz der Angabe („Haus 21 oder 27“). Was ein Leser als unleserlich gemeldet hat, bleibt
414
416
  unleserlich, bis der Agent es selbst liest. Eine leere Spalte ist leer; nichts wird nach dem Üblichen ergänzt;
@@ -426,7 +428,7 @@ daraus und die Suche, die ihn gefunden hat.
426
428
  ([A3.3](A3-evidence-in-the-app.md#A3.3)).
427
429
  - **Gilt seit:** Forschung 1.0.0; Ausschnitt 1.1.0
428
430
 
429
- <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ -->
431
+ <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ · překlad: recording.md "--translation", link.md krok 7 (od v1.28.0) -->
430
432
 
431
433
  <a id="R8.7"></a>
432
434
  ## R8.7 Sicherheit und Prüfung des Gelesenen