⟨/⟩ 40_Arch/ADR/ADR_005_FieldValueSourceBinding.cs

57 строк · в начало

using System;
using Ban.Sdaid.Notation.Documents;

namespace Ban.Sdaid.Icd.Arch.Adr
{
    /// <summary>Решение: источник значения хранится как «вид изображения + координаты области», а не как порядковый номер кадра.</summary>
    public class ADR_005_FieldValueSourceBinding : IAdrDocument
    {
        public static string _refName = "ADR-005 «Привязка значения к странице формы и области»";

        public string Name => "ADR-005. Привязка распознанного значения к странице формы и области";

        public string Description =>
            @"Как хранится связь распознанного значения с изображением, из которого оно получено.";

        public string Version => "0.1";
        public string Status => "proposed";
        public string[] Comments => new string[0];
        public Type? Supersedes => null;

        public static string S1_Decision = """
            ## Решение

            Для каждого распознанного значения сохраняется источник: **страница формы** и **координаты области**
            на ней. При выборе поля на проверке карты интерфейс показывает кадр этой страницы и подсвечивает
            фрагмент.
            """;

        public static string S2_Rationale = """
            ## Обоснование

            Привязка к порядковому номеру кадра ломается при первой же правке состава пакета: пользователь удаляет
            негодный кадр или доснимает пропущенную страницу — и подсветка съезжает на чужое изображение, причём
            молча. Страница формы к таким изменениям устойчива: она задана составом опознанной формы, а не тем,
            в каком порядке снимали.

            Прежде источник привязывался к виду изображения из перечисления ролей. Ролей не стало вместе с планом
            ввода, и их место заняла страница формы — привязка стала точнее: «страница 3 формы на рукопись» вместо
            абстрактного «оборотная сторона».

            Требование распространяется на распознаватель: он обязан возвращать не только значение и уверенность, но и
            координаты области-источника.
            """;

        public static string S3_Consequences = """
            ## Следствия

            - Странице соответствует не более одного кадра, поэтому источник указывает на кадр однозначно —
              прежняя неопределённость «кадров одного вида несколько» снимается.
            - Значение, полученное с кадра, который потом сняли со страницы, теряет источник: подсветить
              его нечем, хотя само значение остаётся.
            - На проверке карты переключатель «оригинал / обработанное» не показывается: там работают
              с результатом. Обе версии доступны в окне просмотра кадра на вкладке «Пакет ввода».
            """;
    }
}