using Ban.Sdaid.Notation.Documents;
namespace Ban.Sdaid.Icd.Domain.Cards
{
/// <summary>
/// Реестр образцов бумажных информационных карт, переданных заказчиком. Первичный материал
/// для восстановления состава полей ИК: сами изображения лежат в <c>Samples/</c> и копируются
/// генератором в сайт как есть.
/// </summary>
public class CardSamples : ISdaidDocument
{
public static string _refName = "образцы бумажных ИК";
public string Name => "Образцы бумажных информационных карт";
public string Description =>
@"Изображения заполненных и незаполненных бумажных ИК на издания и рукописи из фондов БАН.
Служат источником для восстановления состава полей, типов значений и примеров заполнения.";
public string Version => "0.3";
public string Status => "draft";
public string[] Comments => new[]
{
"2026-08-11. Образцы ИК на книги: три документа, 11 изображений.",
"2026-08-11. Добавлены образцы ИК на рукопись (5 листов), ещё книжные карты и незаполненные бланки.",
"2026-08-26. Вторая передача («ИК для ЯНДЕКС 2»): 20 документов, 40 изображений, все — форма на издание, "
+ "редакция «Издания из фондов БАН XVII–XX вв.». Заведён каталог материалов и сводный список форм ИК.",
};
public static string S1_Purpose = """
## Назначение
Документ фиксирует переданные заказчиком образцы бумажных информационных карт **как есть** —
без интерпретации и обобщения. Всё, что дальше будет сказано о составе полей ИК, о типах
значений и о структуре данных, должно быть выводимо из этих изображений; ссылка на
конкретный образец — способ обосновать каждое утверждение.
Изображения лежат в подпапке `Samples/` рядом с этим документом и переносятся в сайт
генератором без изменений.
""";
public static string S2_Forms = """
## Формы информационных карт, встреченные в образцах
Форма — это конкретный бумажный бланк: свой заголовок, своё число листов, свой состав
подписанных полей. Вид документа задаёт, **какая** форма применяется, а редакция — **какая
версия** этого бланка была напечатана. Ниже — всё, что удалось увидеть в переданных
материалах; список закрытым не считается, недостающие виды перечислены в открытых вопросах.
| Форма | Листов | Редакция бланка (печатный заголовок) | Где в образцах |
|---|---|---|---|
| ИК на издание (книгу) | 2 | «Издания из фондов БАН XVII–XX вв.» | `Книги`, `Разные карты_книги` (`915001`), все 20 папок второй передачи |
| ИК на издание (книгу) | 2 | «Издания из фондов БАН» | `7487`, `76487`, `Разные карты_книги` (`768001`–`768002`) |
| ИК на издание (книгу) | 2 | «Фазовая консервация. Книги XVII–XX вв.» | `76463`, `Разные карты_книги` (`768003`–`768004`) |
| ИК на рукопись | 5 | заголовок листа свой на каждом листе, роль-владелец указана там же | `Рукописи` |
| ИК на графику | не установлено | — | `Графика` — только `.docx`, изображений нет |
Внутри одной формы встречаются **разные вёрстки одного и того же листа**: лист сохранности
в `768002.jpg` содержит «Общ. загрязн.» и явные отметки «Нет микробиологических повреждений»,
а эксперт там записывается одной строкой вместо таблицы. Это по-прежнему форма на издание,
но печатался бланк с другого оригинал-макета.
Образцов на остальные виды документов (листовой документ, свиток, вложение) заказчик пока
не передавал.
""";
public static string S3_Catalog = """
## Каталог предоставленных материалов
Ниже — всё, что лежит в `Samples/`, по папкам, с указанием формы карты и листа. Каталог
ведётся как опись: одна строка — один переданный файл, ничего не сводится и не обобщается.
Комментарий заказчика к первым образцам (дословно):
> В данной папке информационные карты из фонда ОФО БАН.
> Это книги, информационная карта для книг из двух страниц (1 лист):
> первая (библиогр. описание, мероприятия по сохранению), вторая (материальная основа).
> Номер папки совпадает с инв. номером документа.
> В папках описания книг по ИК, то что обозначено как вар.2 — означает, что описание документа
> делали повторно, например с целью обучения, т. е. один и тот же документ описан несколько раз
> разными сотрудниками.
### Первая передача. Карты на книги, описанные по нескольку раз
Три экземпляра фонда; на каждый — несколько независимых описаний. Дают пары «одно и то же поле
разными почерками» и годятся для проверки распознавания рукописного текста. Форма — на издание;
редакция «Издания из фондов БАН» в папках `7487` и `76487`, «Фазовая консервация. Книги
XVII–XX вв.» в папке `76463`.
| Папка | Файл | Лист формы | Описание |
|---|---|---|---|
| 7487 | `7487- первая стр..jpg` | 1 | описание специалистов |
| 7487 | `7487-первая стр, вар.2.jpg` | 1 | учебное описание |
| 7487 | `7487- оборот, спец.jpg` | 2 | описание специалистов НОКиРФ |
| 7487 | `7487- оборот,вар. 2.jpg` | 2 | повторное описание |
| 7487 | `7487- оборот вар.3.jpg` | 2 | описание в третий раз |
| 76463 | `76463 - первая стр..jpg` | 1 | описание специалистов |
| 76463 | `76463- первая стр.вар.2.jpg` | 1 | повторное описание |
| 76463 | `76463- оборот, спец..jpg` | 2 | описание специалистов |
| 76463 | `76463- оборот.вар.2.jpg` | 2 | повторное описание |
| 76487 | `76487-первая стр..jpg` | 1 | описание специалистов |
| 76487 | `76487- оборот, вар.2.jpg` | 2 | повторное описание |
### Первая передача. Другие карты на книги
Форма во всех случаях на издание, редакция указана в последней колонке.
| Папка | Файл | Лист формы | Что на образце |
|---|---|---|---|
| Книги | `10001.jpg` | 1 | заполненная карта, редакция «Издания из фондов БАН XVII–XX вв.» |
| Книги | `10002.jpg` | 2 | сохранность: переплёт, блок, мониторинг, эксперты, комментарий |
| Разные карты_книги | `768001.jpg` | 1 | редакция «Издания из фондов БАН», заполнены только шифр и инв. номер |
| Разные карты_книги | `768002.jpg` | 2 | **иная вёрстка листа сохранности**: «Общ. загрязн.», «Нет микробиологических повреждений», эксперт одной строкой |
| Разные карты_книги | `768003.jpg` | 1 | редакция «Фазовая консервация. Книги XVII–XX вв.», заполнена полностью |
| Разные карты_книги | `768004.jpg` | 2 | лист сохранности к предыдущей карте |
| Разные карты_книги | `915001.jpg` | 1 | незаполненный бланк, редакция «Издания из фондов БАН XVII–XX вв.» |
| Разные карты_книги | `915002.jpg` … `915004.jpg` | 1–2 | ещё описания того же документа |
### Первая передача. Карта на рукопись
Пять листов незаполненного бланка — эталон состава полей формы на рукопись.
| Папка | Файл | Лист формы | Заголовок листа |
|---|---|---|---|
| Рукописи | `30001.jpg` | 1 | Библиографическое описание. Хранитель (л. 1) |
| Рукописи | `30002.jpg` | 2 | Библиографическое описание. Хранитель (л. 2) |
| Рукописи | `30003.jpg` | 3 | Материальная основа. Хранитель–Консерватор (л. 3) |
| Рукописи | `30004.jpg` | 4 | Сохранность. Консерватор (л. 4) |
| Рукописи | `30005.jpg` | 5 | Задание по консервации. Консерватор (л. 5) |
### Первая передача. Карта на графику
| Папка | Файл | Примечание |
|---|---|---|
| Графика | `Инф. карта. Графика.docx` | форма ИК на графику в текстовом формате; **на сайт не переносится** — генератор копирует только изображения, `.docx` не в списке переносимых расширений |
### Вторая передача («ИК для ЯНДЕКС 2»)
Двадцать документов из того же фонда, по два кадра на документ: лист 1 — описание
документального памятника и консервация, лист 2 — сохранность. Имя папки совпадает
с инвентарным номером, и на этот раз совпадает и с номером, вписанным в саму карту.
Все сорок изображений — **одна и та же форма на издание, редакция «Издания из фондов
БАН XVII–XX вв.»**; новых форм и новых вёрсток листа партия не приносит.
Ценность партии в другом: это первый большой массив **заполненных** карт, снятых
фотоаппаратом со стола, а не сканером, — с разворотом бумаги, тенью, неровным светом
и заметной геометрией. Карты заполнены одной командой в июле 2026 года, почерк
повторяется от карты к карте, много иностранных заглавий латиницей.
Автор и год ниже прочитаны с рукописного заполнения и приведены для опознания
документа — это не выверенное библиографическое описание.
| Папка / инв. номер | Файлы (лист 1, лист 2) | Автор, год издания (как прочитано) |
|---|---|---|
| 34361 | `DSC06990.JPG`, `DSC06991.JPG` | без автора, 1866, белорус. |
| 34455 | `DSC06944.JPG`, `DSC06945.JPG` | Stern J., 1840 |
| 34458 | `DSC06950.JPG`, `DSC06951.JPG` | Вельтман А. Ф., 1852, болг. |
| 34754 | `DSC06948.JPG`, `DSC06949.JPG` | Muczkowski J., 1836, польск. |
| 34808 | `DSC06954.JPG`, `DSC06955.JPG` | автор неразборчиво, 1828, рус. |
| 34848 | `DSC06996.JPG`, `DSC06997.JPG` | сост. M. S. Stulc, 1837, чеш. |
| 34861 | `DSC06952.JPG`, `DSC06953.JPG` | Winaricky K., 1836, чеш. |
| 34983 | `DSC06946.JPG`, `DSC06947.JPG` | Лазич(?), 1836, серб. |
| 34984 | `DSC07000.JPG`, `DSC07001.JPG` | Alexi J., 1826, латин. |
| 34985 | `DSC06998.JPG`, `DSC06999.JPG` | Vilagosvary T., 1841, нем. |
| 35045 | `DSC06970.JPG`, `DSC06971.JPG` | Новакович С., 1871, серб. |
| 35046 | `DSC06968.JPG`, `DSC06969.JPG` | Maloch A., 1859, нем. |
| 35047 | `DSC06966.JPG`, `DSC06967.JPG` | Closs R. von, год не указан, нем. |
| 35064 | `DSC06985.JPG`, `DSC06986.JPG` | Караджич В., 1843, серб. |
| 35065 | `DSC06987.JPG`, `DSC06988.JPG` | без автора, 1842, серб. |
| 35073 | `DSC06981.JPG`, `DSC06982.JPG` | Jezbery F. J., 1861, чеш. |
| 35075 | `DSC06962.JPG`, `DSC06963.JPG` | без автора, 1840, нем. |
| 35076 | `DSC06960.JPG`, `DSC06961.JPG` | Stoosz P., год не указан, хорват. |
| 35077 | `DSC06994.JPG`, `DSC06995.JPG` | Papłonsky J., 1869, польск. |
| 35078 | `DSC06992.JPG`, `DSC06993.JPG` | Sembera V. K., 1863, чеш. |
### Служебные файлы
| Файл | Что это |
|---|---|
| `комментарий к картам.txt` | пояснение заказчика к первой передаче; его текст приведён выше дословно |
| `ИК для ЯНДЕКС 2.zip` | исходный архив второй передачи; распакован в папки `34361`…`35078`, лежит рядом как первоисточник |
Ни `.txt`, ни `.zip` на сайт не переносятся — генератор копирует только изображения
и схемы.
""";
public static string S4_EditionForm = """
## Форма ИК на издание
Два листа. Первый — блок **«Описание документального памятника»** (библиографическое описание,
подписи полей напечатаны, значения вписаны от руки) и матрица **«Консервация»** с отметками
«Задано / Выполнено» по разделам «Книга», «Переплёт», «Блок», «Условия хранения».
<img src="/sources/50_Domain/Cards/Samples/7487/7487-%20первая%20стр..jpg" alt="ИК книги, лист 1, инв. 74870 — редакция «Издания из фондов БАН»" title="ИК книги, лист 1, инв. 74870 — редакция «Издания из фондов БАН»" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
<img src="/sources/50_Domain/Cards/Samples/76463/76463%20-%20первая%20стр..jpg" alt="ИК книги, лист 1, инв. 76463 — редакция «Фазовая консервация. Книги XVII–XX вв.»" title="ИК книги, лист 1, инв. 76463 — редакция «Фазовая консервация. Книги XVII–XX вв.»" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
Так же выглядит лист 1 в редакции «Издания из фондов БАН XVII–XX вв.» — но снятый фотоаппаратом,
как приходит вся вторая передача:
<img src="/sources/50_Domain/Cards/Samples/34361/DSC06990.JPG" alt="ИК книги, лист 1, инв. 34361 — редакция «Издания из фондов БАН XVII–XX вв.», фотосъёмка" title="ИК книги, лист 1, инв. 34361 — редакция «Издания из фондов БАН XVII–XX вв.», фотосъёмка" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
Второй лист — раздел **«Сохранность»**: габариты, параллельно устроенные описания переплёта и
блока (состояние, состав, материалы, декор, повреждения физико-механические и биологические,
степень повреждения), **«Мониторинг»** (биотест и текущая биологическая экспертиза), таблица
экспертов (роль, дата экспертизы, ФИО, подпись, результат) и рукописный комментарий.
<img src="/sources/50_Domain/Cards/Samples/7487/7487-%20оборот,%20спец.jpg" alt="ИК книги, лист 2, инв. 74870" title="ИК книги, лист 2, инв. 74870" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
""";
public static string S5_ManuscriptForm = """
## Форма ИК на рукопись
Пять листов, у каждого свой заголовок и своя роль-владелец: листы 1–2 заполняет хранитель,
лист 3 — хранитель и консерватор совместно, листы 4–5 — консерватор. Общего с формой на издание
почти нет: совпадают только шифр, дата и ФИО составителя.
Лист 1 — библиографическое описание рукописи: тип знаковой информации, рукописная книга или
рукописный документ, авторы и переписчик с основанием атрибуции, заглавие в трёх видах
(унифицированное, полное, перевод), содержание с incipit и finit, время создания точное либо
приблизительным периодом в веках, место создания вплоть до монастыря, филиграни, состав листов.
<img src="/sources/50_Domain/Cards/Samples/Рукописи/30001.jpg" alt="ИК рукописи, лист 1 — библиографическое описание" title="ИК рукописи, лист 1 — библиографическое описание" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
Лист 3 — материальная основа: переплёт-обложка и футляр, материалы основы и покрытия, декор,
блок и форзацы, текст и иллюстрации с материалами письма и красок. Почти целиком состоит
из клеток-отметок.
<img src="/sources/50_Domain/Cards/Samples/Рукописи/30003.jpg" alt="ИК рукописи, лист 3 — материальная основа" title="ИК рукописи, лист 3 — материальная основа" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
Лист 4 — сохранность: физические, химические и биологические повреждения по трём объектам
(переплёт, листы, текст и рисунки) со степенью повреждения для каждого и таблица замеров pH
с указанием листа и места замера.
<img src="/sources/50_Domain/Cards/Samples/Рукописи/30004.jpg" alt="ИК рукописи, лист 4 — сохранность" title="ИК рукописи, лист 4 — сохранность" style="max-width:820px;width:100%;height:auto;display:block;margin:12px 0;border:1px solid var(--border);border-radius:4px;">
""";
public static string S6_Observations = """
## Что видно из образцов
Наблюдения зафиксированы здесь, потому что влияют на модель данных; решения по ним
принимаются отдельно.
**Формы разных видов ИК не пересекаются по составу полей.** У книги два листа, у рукописи
пять. В форме на рукопись есть «Переписчик рукописи», «Основание атрибуции», «Время создания»
с приблизительным периодом, «Филиграни», «Владельческие пометы», «Задание по хранению»
с пагинацией и частотой копирования — ничего этого нет у книги. Обратно: «Конволют»,
«Камерный каталог», «Первоначальный академический штамп» есть только у книги. Общая часть —
шифр, дата, ФИО составителя, вид документа.
**У одного вида ИК несколько редакций бланка.** По книгам их видно три: «Издания из фондов
БАН», «Фазовая консервация. Книги XVII–XX вв.», «Издания из фондов БАН XVII–XX вв.». Состав
полей у них практически совпадает, различаются заголовок и подписи: `Кол-во стр.` против
`Количество страниц`, `Ил. в тексте` против `Иллюстрации в тексте`; `Конволют` есть не везде.
Лист сохранности тоже существует в разных вёрстках — в `768002.jpg` добавлены «Общ. загрязн.»
и явные отметки «Нет микробиологических повреждений», а эксперт записывается одной строкой
вместо таблицы. То есть редакция — это версия формы, а не отдельный вид ИК.
**Бланк печатался под конкретную партию документов.** В редакции «Издания из фондов БАН»
в клетке «Описание экслибриса» уже впечатан текст «Овальный штамп сажевый гербовый: орёл
с саблей под графской короной».
**Большинство полей — отметки, а не текст.** «Задано / Выполнено», «Дерево / Картон / Бумага»,
«Слепое / Золотое тиснение», степень повреждения по шкале. На листе 3 формы на рукопись таких
клеток сотни. Распознавание отметки — задача определения заполненности клетки, а не OCR,
и тип поля это должен различать.
**Отметки проставляются по-разному** — крестик, галочка, косая черта, иногда в пределах одной
карты. Значим факт заполненности, а не начертание знака.
**Значения выходят за пределы клетки.** В образце 7487 в поле «Величина pH» вписано
`5,83 перед форзац`; в `10002.jpg` — `3,77 (HI 99171)` и приписка ниже строки. Рядом со шкалой
степени повреждения от руки дописано «нет». Свободный рукописный текст не укладывается
в формальный тип поля.
**Многие поля пустые.** В образце 7487 заполнены только шифр и инвентарный номер,
библиографическое описание не внесено вовсе; `768001.jpg` — то же самое. Пустое поле —
норма, а не ошибка ввода.
**Карты приходят фотографиями, а не сканами.** Вся вторая передача снята фотоаппаратом
со стола: лист лежит с разворотом бумаги, освещение неровное, края уходят в тень,
попадает поверхность стола, встречается поворот и трапеция. Нормализация кадра —
не украшение, а условие распознавания.
**Одна партия — одна форма и один почерк.** Двадцать карт второй передачи заполнены одной
командой за две недели июля 2026 года по одному и тому же бланку. Для обучения и проверки
это удобный однородный материал, но выводить из него разнообразие форм нельзя: обе редакции
бланка на издание, кроме «Издания из фондов БАН XVII–XX вв.», в этой партии не встречаются.
**Заглавия — не только кириллица.** В партии преобладают иностранные издания: заглавия
и авторы вписаны от руки латиницей с диакритикой (чешские, польские, немецкие,
хорватские), рядом в той же карте кириллические подписи полей и русские комментарии.
**Расхождение в именовании папок.** Заказчик указал, что номер папки совпадает с
инвентарным номером документа. Фактически в папках `7487` и `76487` лежат карты
с инвентарным номером `74870` (шифр «105 д»), в папке `76463` — карта с инвентарным
номером `76463` (шифр «III 099»). Требуется уточнение: опечатка в именах папок либо
карты действительно относятся к разным документам.
""";
public static string S7_OpenQuestions = """
## Открытые вопросы
| № | Вопрос |
|---|---|
| OQ-CS-1 | Сколько редакций бланка в обращении по каждому виду ИК и нужно ли Сервису различать их при распознавании, или достаточно объединённого состава полей на вид |
| OQ-CS-2 | Инвентарные номера на картах не совпадают с именами папок `7487` и `76487` — опечатка или разные документы |
| OQ-CS-3 | Нужны образцы ИК на остальные виды документов (листовой документ, свиток, вложение); форма на графику передана в `.docx` и требует изображений |
| OQ-CS-4 | Требуется ли сохранять в электронной ИК рукописные комментарии дословно, либо достаточно распознанного текста без привязки к изображению |
| OQ-CS-5 | Как в модели различать отметку в клетке и текстовое значение: одним типом «значение поля» или разными типами полей в шаблоне вида ИК |
| OQ-CS-6 | Список форм считается открытым: подтвердить, что кроме форм на издание, рукопись и графику других бланков в обращении нет, и передать образцы недостающих |
| OQ-CS-7 | Все ли редакции бланка на издание остаются в обращении, или новые карты заполняются только по редакции «Издания из фондов БАН XVII–XX вв.», как во второй передаче |
""";
}
}