Куди копати: від питання до каналу¶

Це маршрут для матеріалу, якого в просторі ще немає: людина ставить питання, а ти маєш сказати, у які джерела йти, у якому порядку, чим приймати відповідь кожного і коли зупинитись. Джерел стає більше з кожним місяцем, і без маршруту вони перетворюються на перелік команд, які запускають усі підряд або не запускають зовсім.

Чим цей документ не є:

не search-channels.md — той про пошук у вже прочитаному: три сховища, склейка переносу, якорі, самоперевірка;
не find-parish — той про одне джерело, зведений покажчик, чотирма способами;
не перелік джерел. Що саме підключено на цій машині, що кожне вміє, де його межі й що доводить його нуль, каже nysh op sources.list (поле about; людським видом — nysh sources); тут джерела названі класами, і клас лишається тим самим, коли джерело міняється.

Документ складається з п'яти файлів, і читати їх треба не всі одразу:

файл	що в ньому	коли читати
`where-to-dig.md` (цей)	протокол заходу, класи каналів, баланс, власні знання, заведення каналу	завжди
`where-to-dig-traditions.md`	традиція: регіон × конфесія × доба — які установи вели облік, де їхні фонди тепер, шифри-приклади	ту секцію регіону й конфесії, куди потрапила подія
`where-to-dig-genres.md`	десять жанрів питань: канали по порядку, стоп, пастки	той жанр, у який зайшов
`where-to-dig-channels.md`	картки каналів: що дає, чого не дає, ціна, знаменник нуля	картки тих каналів, які стоять у плані
`where-to-dig-archives.md`	сайти державних архівів і шаблони адрес, друковані довідники, маршрути доступу	коли треба дістати копію або майданчик не відповідає

🔴 Приватний оверлей. Дослідник тримає свої фонди, шифри, маршрути доступу й заміри у файлі <простір>/reports/research/where-to-dig.md. Якщо він є, читай його після цього документа: він заповнює ті самі жанри конкретикою. Поруч можуть лежати його піддокументи, наприклад реєстр прочесаного (where-to-dig-prochesano.md); читай ті, що є. Якщо правило оверлею суперечить правилу тут, діє це; розбіжність варто показати людині, а не мовчки обрати одне.

Протокол одного заходу¶

Один захід закриває одне питання. Кроки йдуть від найдешевшого до найдорожчого, і кожен має приймач.

#	крок	чим	✅ приймач
−1	що вже є в просторі	`nysh text grep "<ключ>" --where all`, `nysh cases list`, `nysh pages status <справа>`	названо шари й знаменник кожного; `stale.is` не `true`
0	традиція події	`where-to-dig-traditions.md`	регіон і конфесія за роком події, не за сучасною областю; на межі доби — обидві
0а	жанр питання	`where-to-dig-genres.md`	один жанр, або два з поясненням чому
1	гіпотеза з голови	розділ «Власні знання»	блок «З голови: …» записаний до запитів
2	які канали реально є	`nysh op sources.list` — `about` кожного джерела; картки в `where-to-dig-channels.md`	кожен `id` зведено з класом (`about.where_class`) і межами (`about.scope`) проти місця й доби питання; джерело з `undeclared` або без картки — рядок «без опису — перевірити руками», не викинуто; клас без джерела позначено «руками»
3	канали по порядку жанру	`nysh find` без `--source` — одне віяло по всіх джерелах; далі `nysh geog find`, скіли-наступники	після кожного каналу — його знаменник і тип нуля кожного джерела (`coverage.zeros`)
4	зупинка	правило «Стоп» жанру	спрацювало чи ні, і чому
5	звіт	форма нижче	людина бачить рішення, а не процес

Форма звіту, коротка й однакова для будь-якого жанру:

З голови:   які документи мали існувати і де осісти (гіпотеза)
Локально:   що вже лежить у просторі — шари й знаменники
Каталогом:  який канал → що дав → знаменник
Стоп:       спрацювало правило зупинки / не спрацювало — чому
Далі:       наступний канал, його ціна, і чи потрібне рішення людини

🔴 Крок −1 не пропускається ніколи. Рекомендація «нової» справи, складена з пам'яті про фонд замість реєстру, двічі за одну сесію радила те, що вже лежало на диску, було прочитане двома рушіями й прошукане.

Класи каналів¶

Клас відповідає на своє питання і на жодне інше. Джерело в третій колонці — приклад; чи є воно на цій машині, що вміє й де його межі, дивись у nysh op sources.list.

клас	на яке питання відповідає	вбудоване джерело / як
локальні сховища	«ми це вже знаємо?»	`nysh text grep --where all`, `nysh cases list`, `nysh pages status`; диск — `local`
каталог за селом	«які книги мого села збереглися, за які роки»	`ridni`
індекс метрик	«чи є запис про особу в уже проіндексованих книгах»	руками: GeneTeka, Geneszukacz, індекс AGAD zespół 301, Gesher Galicia — `where-to-dig-channels.md`, «Джерела поза пакетом»
зведений покажчик	«що взагалі існує про село чи фонд, оцифроване чи ні»	`duck` (скіл `find-parish`)
газетир	«де документи цього села по всіх фондах одного архіву»	`nysh geog find`, `nysh geog card`
церкви до поділів	«чи була тут парафія у XVIII ст. і чия»	`nysh church find`
реєстр опису фонду	«що є у фонді цілком, з номерами й роками»	`nysh registry build` (скіл `keep-fond`)
переглядач архіву	«забрати скани справи, яку вже знаю за шифрою»	`archium`, окремий `id` на майданчик; `skanoteka` (Сканотека ПТГ); `szukaj` (Szukaj w Archiwach, архіви Польщі)
Commons / Вікіджерела	«повні томи й описи, викладені волонтерами»	`commons`; перелік опису з плівками — `nysh registry collect wikisource`
дзеркало плівок	«кадри плівки без входу в сервіс»	`fsfilm`
фотоархів дослідника	«чи знімав хтось цю справу чи книгу — і де подивитись кадри»	`volok` (назви альбомів; кадри — на Flickr)
онлайн-архів XX ст.	«книги РАЦС і те, чого архіви онлайн не показують»	`babynyar` (каталог — `nysh crawl`)
іменна база репресованих	«чи був предок репресований і де його архівно-слідча справа»	`martyrolog` (лише `--source martyrolog`)
текст друкованих книг	«де моє село згадане в літературі»	`chtyvo`
єпархіальні відомості, періодика	«призначення, нагороди, вдови, некрологи»	`ia` (Internet Archive, лише точне слово); решта — руками: повнотекстові корпуси
рукописний відділ бібліотеки	«візитації, суди митрополії, приватні збірки»	руками: каталог описів і цифрова бібліотека — окремо
консисторія	«клірові, метрики, сповідки, справи причту»	реєстр опису фонду
дворянське зібрання, Герольдія	«докази шляхетства, родовідні книги»	реєстр опису фонду
суди, нотаріат	«купчі, легітимації, спадщина, позови»; «хто з роду чи села стояв перед гродом у XVII–XVIII ст. і в якому акті»	реєстр опису, покажчик-анотація; гродські книги Брацлавщини й Поділля та загублені книги Київщини й Волині — `sks` (місця) і `sks-osoby` (особи, лише `--source sks-osoby`), пак `courtbooks`
маєткові інвентарі	«хто жив у маєтку, на яких умовах»; «в якій книзі інвентар мого села і з якої сторінки»	`inventarium` (розпис волонтерів, знімок — `nysh crawl`); далі реєстр опису фонду
ревізії, однодворчі списки, волосні правління	«податний стан двору за роком ревізії»; «в якій справі ревізія мого села і на якій плівці»	реєстр опису фонду; Бессарабія — `catagrafii` (ANRM ф.134 оп.2: село → справа, аркуші, плівка FS; знімок — `nysh crawl`)
ЗАГС / ДРАЦС	«акти після 1920-х, які ще не передані в архів»	руками: виписка родичу
веб-пошук	«контекст, назви, кордони, друковане, люди»	руками, картка в `where-to-dig-channels.md`
люди	«те, чого немає онлайн ні в кого»	руками: дослідники, форуми, лист до архіву

Порядок у маршрутах побудований за ціною відповіді: спершу те, що вже є, далі канал, який відповідає прямо на питання, потім канал, який бачить існуюче незалежно від оцифрування, потім повний опис фонду, потім копії, і наприкінці люди й гроші.

🔴 Канали комбінуються, а не підміняють один одного. Кожен бачить свою частину: каталог за селом — книги з довідника, покажчик — те, що волонтери прив'язали до парафії, опис фонду — усе, що є у фонді, переглядач — лише оцифроване. Висновок «онлайн немає» стоїть лише тоді, коли перелік звірено з описом фонду. Замір (06.10.2026): зведені метрики повіту однієї консисторії — щорічна серія 1795–1862, томи поділені за абеткою сіл; покажчик прив'язав до парафії села 16 томів із ~60, а роки цих «справ» не були роками томів. Узято саме ці 16, і «онлайн немає» стояло в прогалинах, де потрібний том лежав на FamilySearch — його знайшли вручну. Повний перелік з посиланнями на плівки був на сторінці опису у Вікіджерелах.

🔴 Канал без картки не викидається мовчки. Картка каже агентові, на яке питання канал відповідає, чим приймати відповідь і що означає нуль, тож маршрут будується з карток. Але джерело, яке є в nysh op sources.list, а картки чи самоопису (about) не має, у план усе одно йде — рядком «без опису — перевірити руками». Причина: у симуляції 15.09.2026 фотоархів Волока був підключений без картки, і правило «канал без картки в маршрут не ставиться» викинуло його з плану про Донеччину, хоча саме там він мав списки населених місць і розпис парафій єпархії. Новий канал і далі заводиться карткою раніше, ніж скриптом; шаблон картки й самі картки — where-to-dig-channels.md, а збіг картки з about тримає tests/test_source_cards.py.

Типи нуля¶

Той самий 0 означає різне залежно від того, чим шукали. Перед словом «немає» тип кожного нуля називається окремо.

тип	як виглядає у відповіді	що доводить	що робити
не шукали	`no_denominator`; джерело в `coverage.unavailable`	нічого	полагодити причину з `why`, не звітувати
поза покриттям	місце чи доба питання поза `about.scope` джерела; `outside_pack_scope` у газетирі й базі церков	нічого про село: джерело за побудовою не могло його знати	назвати межу у звіті й узяти канал, що покриває регіон
шукали — немає	`coverage.zeros[].means`; `zero_with_denominator`	рівно те, що написано в `means`: «немає в назвах альбомів на дату списку», а не «ніхто не знімав»	звітувати дослівно, разом із тим, де шукали збіг (`about.match_on`, `match_how`)
обрізано	`search_truncated`; знахідок рівно стільки, скільки стеля	перелік неповний, негатив неможливий	звузити запит або брати фонд цілком
хибний не-нуль	знахідки є, але збіг підрядком у чужому слові	нічого: `казк` у `volok` дає народні казки, `Метрич` — «Геометрический план»	читати назви знахідок, а не лічильник; довша основа
однойменець	знахідка з іншого регіону під тією самою назвою	нічого про своє село: «Бахмут» у `fsfilm` — молдовське село, ANRM ф.211	звірити регіон у `note` чи `place`; у `ridni` — запит «<село>, <повіт>»
вибірка покажчика	покажчик дав кілька томів серії (зведені книги повіту), а не всі	нічого про роки, яких у вибірці немає	перелік серії — з опису фонду (`nysh registry build`; таблиця опису з Вікіджерел — `nysh registry collect wikisource`): рік і абетковий діапазон кожного тому, і лише тоді «немає»

Пак церков ~1772 накриває воєводства Речі Посполитої, газетир — фонди свого архіву. Для села поза цими межами їхній нуль — тип «поза покриттям», навіть коли попередження немає: фільтра, з яким можна звірити вільну назву села, у запиті нема.

Пастка кодів архівів¶

У знахідці два поля архіву, і рішення приймається за першим:

repo — наш код із паку (DADNO, DADOO); порожній, коли пак цього архіву не знає;
archive — як архів пише саме джерело.

Скорочення в джерелах не звірені з переліком архівів: у назвах альбомів Волока «ДАДО (ДАДнО)» — Дніпропетровський архів, а Донецький у паку — ДАДоО; на «Бабиному Яру» «ДАЧО» носять кілька архівів. Порожній repo при знайомому на вигляд archive звіряється командою nysh archive <код>, а не здогадом.

Баланс: як не гнати канали в пусту¶

Правило, причина, приймач — у такому порядку.

Крок −1 — локальні сховища. Причина: те, що вже є, коштує нуль, а рекомендація з пам'яті замість реєстру повторює зроблену роботу. Приймач: у звіті названо layers.coverage і stale.is.
Найдешевший канал перший — ціна за відповідь. Причина: замір одного приватного конвеєра — на один факт пішло близько двох мільйонів токенів, а він діставався парсером за нуль. Драбина цін за одиницю матеріалу: парсер по готовому тексту — нуль; карта за заголовками — тисячі токенів; читання машинного тексту — десятки тисяч; розбір скана моделлю агента — близько 84 тисяч на скан. Приймач: у плані заходу кожен канал має ціну.
Два незалежні каталоги — знаменник лакуни. Причина: нуль в одному каталозі означає «не знайшли»; нуль у двох незалежних — «не існує». Приймач: обидва знаменники названі.
Гнати до правила зупинки, а не всі канали. Причина: після «Стоп» кожен наступний канал — окреме рішення людини, бо саме там починаються гроші й місяці. Приймач: у звіті є рядок «Стоп: спрацювало / ні».
Журнал прочесаного. Причина: канал із результатом «0 за кілька заходів» або «заблоковано» повертається в роботу знову й знову, якщо про нього не записано. Приймач: у просторі є реєстр «прочесано / заблоковано / більше не повертатись» із датами, і його читають перед заходом. Формат рядка: канал · що шукали · результат · дата · причина.
Бюджет заходу. Одне питання — один захід — звіт на рішенні, не на процесі. Межа (кількість каналів або час) називається до старту; після неї агент повертає проміжний результат зі знаменником, а не продовжує.
Канал не заміняє власне знання. Інструменти кажуть, де що лежить. Що мало існувати і в якій установі осісти — каже голова, і саме це пояснює, чому інструмент мовчить. Докладно — наступний розділ.

Власні знання агента¶

Інструментів стає більше, і є спокуса зводити кожне питання до команди. Це втрачає ту частину відповіді, якої немає в жодному каталозі: що мало існувати.

Дозволено з голови — і записується як гіпотеза. Традиція події (регіон × конфесія × доба, ключі — where-to-dig-traditions.md); єпархія, повіт, воєводство, адміністративна приналежність села за добами; які жанри документів вела установа в цю добу (візитація, інвентар, ревізія, клірова, метрика, сповідка, посімейний список); де за діловодством вони мали осісти (консисторія, казенна палата, зібрання, суд, маєток, бібліотека). Усе це йде у звіт одним блоком «З голови: …» до запитів, а потім перевіряється каталогом. Гіпотеза, яку каталог не підтвердив, лишається у звіті з позначкою «не підтверджено» — вона пояснює, чому шукали саме там.

Заборонено з пам'яті. Номери фондів, описів і справ; крайні роки; кількість аркушів; ціни; шляхи на диску; що вміє джерело; назви команд і прапорців. Усе це — з каталогу, реєстру опису, nysh op sources.list, nysh op <ім'я> --describe. Причина: число з пам'яті виглядає так само впевнено, як число з каталогу, і йде у звіт без знаменника.

Коли інструменти мовчать. Саме тоді голова корисна найбільше: вона підказує жанр документа, якого варто шукати, і клас установи, де він мав осісти. Ревізія не ловить чиншовиків — шукати інвентар маєтку. До поділів парафія була унійна — шукати візитацію деканату, а не православну консисторію. Священник не лишив актів — шукати підпис під річним екстрактом. Тобто голова відповідає на «що і де мало бути», інструменти — на «що з цього збереглось і де лежить».

Приймач. У кожному звіті з нулем є блок: які документи мали існувати → у яких каталогах перевірено → що з них існує. Нуль без цього блоку — нуль без гіпотези, тобто не перевірений.

Заведення й архівування каналу¶

Новий канал з'являється частіше, ніж хочеться, і кожен виглядає корисним. Порядок такий:

Картка до скрипта. Картка за шаблоном вище — перша; без неї канал стоїть у маршруті лише рядком «без опису — перевірити руками».
Пробний захід із заміром. Два-три питання, відповідь на які вже відома, і в картку йде: скільки канал дав, скільки з того нового проти вже зібраного, дата.
Нуль зі знаменником. Канал мусить уміти сказати, скільки він переглянув; канал, який дає лише мовчання, не є каналом.
Місце в жанрі й причина. У якому жанрі й на якому кроці, і чому саме там — за ціною чи за повнотою.
Для вбудованого джерела пакета — caps і самоопис about (SourceAbout) у коді, коментар «навіщо» в реєстрі джерел; tests/test_source_cards.py звіряє about із карткою й таблицею класів. Для власного — скрипт і рядок у таблиці маршрутів доступу в оверлеї.

Архівування:

0 за три заходи (або інше N, записане в картці) — стан «0 за N», канал іде в кінець маршруту свого жанру;
структурний нуль — канал не покриває стан, період або регіон роду — стан «більше не повертатись» із причиною; повертатись лише коли змінилось питання;
заблокований маршрут доступу — не архівування, а рядок у таблиці маршрутів: «цим шляхом ні»;
реєстр переглядається, коли заводиться новий канал того ж класу: новий часто робить старий зайвим.

Стаття-підказка: звідки беруться позиції¶

Найцінніше знання про те, де що лежить, приходить не з каталогів, а з краєзнавчих статей, постів дослідників і друкованих довідників: «візитації такої-то єпархії — це справи з такого по такий номер у такому фонді». Це не факт про рід і не канал, а позиція, і приймається вона так:

Копія в постійний стор — першою. Сторінка в мережі живе, доки автор не видалить; тека <простір>/data/raw/refs/<автор-рік-тема>/ з паспортом (адреса, автор, дата, контрольні суми, навіщо збережено) і самим текстом.
Твердження окремими рядками: позиція (архів, фонд, діапазон, роки), жанр документа (що всередині), довідник (автор, назва, де доступний), пастка (що автор радить перевіряти). Переказ статті не потрібен.
Звірка каталогом до маршруту. Стаття має ранг заголовка з покажчика. Діапазон перевіряється каталогом: скільки справ у ньому є, скільки оцифровано, скільки на диску. Число, а не «автор каже».
Влити туди, де агент шукатиме: позиції — у конкретний шар простору (оверлей або реєстр позицій) з поміткою «за <автор рік>»; клас документа, якого ще немає в where-to-dig-traditions.md, — туди, з одним шифром-прикладом; опис жанру документа й прийом пошуку — у жанри, бо вони не приватні; довідники — у where-to-dig-archives.md.
Запис про саму статтю у просторі: що взято, куди влито, чим звірено, що лишилось. Без нього наступна сесія розбирає статтю вдруге.

Стаття поза регіоном або добою дослідження теж отримує запис — зі статусом «поза маршрутом», щоб її не читали ще раз. Регіон і конфесія позиції називаються ключами з where-to-dig-traditions.md: так позиція знаходиться за традицією, а не лише за селом.

Куди далі¶

where-to-dig-traditions.md — регіони й конфесії: установи, фонди, шифри-приклади.
where-to-dig-genres.md — десять жанрів питань із маршрутами.
where-to-dig-channels.md — картки каналів і шаблон нової картки.
where-to-dig-archives.md — сайти архівів, довідники, маршрути доступу.
search-channels.md — коли матеріал уже прочитаний і треба знайти в ньому прізвище.
find-parish — зведений покажчик по селу чотирма каналами.
keep-fond — реєстр опису фонду: що існує, що взяли, що з цим зробили. Там же — порядок складання переліку на замовлення: опис спершу вичитується, знаменник береться з його завірки, кандидати шукаються по всіх полях рядка.
take-delivery — прийом зйомки, що прийшла ззовні.
envelope.md — як читати нуль, знаменник і застарілість у відповіді.
workflows.md — конвеєри після того, як матеріал у просторі.
<простір>/reports/research/where-to-dig.md — оверлей дослідника: фонди, шифри, маршрути доступу, ціни, реєстр прочесаного.