12–13.07.2026 · внедрение в прод · приёмка закрыта

Дентал · RECON-PASS-1 — внедрение спайка реконструкции в прод (12.07.2026)

Заплатки Яруса 1 (Лиепа), десневидная юбка, детектор неполноты, разбор A-09; маска synthetic и инварианты add-only.

Исполнитель: CC Fable 5. Основание: спайк result-dental-recon-spike-2026-07-12.md, принят Артуром; канон честности — в редакции задачи RECON-PASS-1 (старые формулировки не применять).

Живой кабинет

https://dental.zaslart.website/cabinet/ (basic_auth artur). Публичная версия отчёта + галерея приёмочных скринов: https://dental.zaslart.website/reports/recon-pass1/ (тот же basic_auth, скрины с ?v=<mtime>).

Этап 0 — полиш-пасс

Был завершён ДО этой задачи (отчёт result-dental-polish-2026-07-12.md, git b45b5a4, в проде): ровный ободок, строгание линии среза, доудаление лоскутов, «крышка» A-09 — closure 20/20, accept GO. Юбка Яруса 2 строится от этой чистой линии среза.

Этап 1 — маска synthetic + инварианты + UI врача ✅

Маска происхождения на каждой вершине (app/refine.py::_SynthTracker): 0=скан, 1=fill (заплата десневой дыры, канон смыкания), 2=patch (Ярус 1), 3=base (основание). Маска проезжает весь пайплайн через два шва — _compact (все срезы) и точки добавления; рассинхрон длины = RuntimeError (пайплайн падает, артефакт не пишется).
Инвариант «только добавление» (_recon_guard) на каждой операции реконструкции (fill_holes / заплатка Лиепы / build_base / build_socle): исходные вершины байт-в-байт, исходные грани не переписаны, классы существующих вершин не изменены, добавленных ЗУБНЫХ вершин нет. Нарушение роняет пайплайн автоматически.
В артефакте дорисованное отличимо от сканированного СТРУКТУРНО — отдельные узлы GLB: gingiva/tooth_<fdi> (только скан, зуб bit-exact к сегментации), synthetic_fill, synthetic_patch, synthetic_zip (лента-камень), synthetic_skirt (та же лента в цвете десны), synthetic_base. Плюс полная бухгалтерия в teeth.json (synthetic, doctored, invariants).
Кабинет врача: бейдж «Доработано · заплат на зубах: N» + одна кнопка «Показать оригинал» / «Вернуть доработанный вид» — мгновенное переключение слоёв, без пересборки. Дефолт врача — «доработано».

Этап 2 — заплатка Яруса 1 (своя триангуляция Лиепы) ✅

Своя реализация опубликованного алгоритма P. Liepa «Filling Holes in Meshes» (SGP 2003): минимально-весовая триангуляция контура (вес = (макс. двугранный угол, площадь), лексикографически, DP O(n³) с numpy-векторизацией по k) + refinement (вставка центроидов до плотности окружения σ по статье, дельоне-флипы, релаксация ТОЛЬКО новых вершин). НЕ MeshFix и не его код (GPL-3 в продукт не идёт) — чистая лицензия.
Область применения — ровно та, что оставлял открытым прежний гейт зуба: замкнутые дыры, касающиеся зубной поверхности. Защита кромки — по-компонентно: крупнейшая петля компоненты без основания (внешний край скана или край спасённого фрагмента) не латается никогда; «окна смыкания» (петли с вершинами основания) не латаются — там десны в скане нет.
Качество на A-05 upper (кейс спайка): все 4 дыры (6.23/2.25/1.58/0.50 мм² — байт-в-байт площади переписи) залатаны, макс. отклонение двугранного угла на заплатах 52.9°, складок (>90°) — 0 (у старой концентрической заплаты спайк мерил 56 складок).
Заплата помечена SYNTH_PATCH, классы её вершин = 0 → сабмеш зуба байт-цел; материал во вьювере — эмалевый; в «оригинале» заплатки скрыты, дыры честно открыты.

Этап 3 — юбка Яруса 2 ✅

Десневидная юбка = детерминированный лофт между реальной граничной кромкой скана и линией среза (кольцом основания): геометрически это ТА ЖЕ зип-лента смыкания (обе границы замкнуты, лофт _zip_rings детерминированный), в GLB — два визуальных узла: synthetic_skirt (вершины кольца перекрашены в медианный тон реальной десны скана; верх ленты несёт живой цвет кромки → визуальный стык с десной) и synthetic_zip (нейтральный камень — прежний канон). Меш/АО/чек смыкания считаются на ОДНОЙ ленте — дублируется только узел GLB.
Это оформительский элемент, НЕ анатомия пациента: в данных полностью помечен synthetic. Честные «окна смыкания» юбка сохраняет (это те же грани ленты).
Вид — по канону рендера (PBR, без socle, контактная тень). Откат тем же тумблером — к нейтральному основанию.
Дефолт вида — предложение: «доработано» (юбка) у врача, «оригинал» у пациента; решение о дефолте — за Артуром на приёмке (переключение = одна строка).

Этап 4 — детектор неполноты (Ярус 3) ✅

Реконструкция крупной утраты НЕ строится (кейса в данных нет — спайк). Вместо неё refine.completeness_census на стадии переписи спайка («перед fill_holes»): дыры > 14 ИЛИ площадь дыр > 50 мм² ИЛИ кромка > 3800 вершин (~1.4×медианы) ИЛИ баланс зубной поверхности Л/П < 60%.
Порог по числу дыр скорректирован против буквы спайка («>10») по его же принципу «порог в ПУСТОМ промежутке»: перепись даёт 17 (A-09 lower) против 12 (следующий, A-06 lower) — «>10» ловил бы здоровый A-06 (проверено делом на регене: A-06 lower с 12 мелкими дырами получал плашку). Середина промежутка = 14.
Срабатывание → врачу плашка «Скан неполный — рекомендуется пересканирование» (внизу вьюпорта, с причинами в tooltip). Сработал ровно на A-09, обе челюсти: upper — площадь дыр 151.4 мм², баланс Л/П 50%; lower — 17 дыр, 85.2 мм², кромка 4092 вершины. Все остальные 18 сканов — чисто.
⚠️ Калибровка — заготовка: пороги выставлены по ОДНОМУ выбросу (A-09) на ОДНОМ сканере (перепись 20 сканов 12.07); rim_verts зависит от плотности меша сканера. Для боевой калибровки нужны: корпус нескольких сканеров, клиническая разметка «полный/неполный» врачом, повторная перепись. До этого — индикатор, не диагноз.

Этап 5 — разбор бага A-09 (перекос 3.3×) ✅ диагноз + фикс

Диагноз (по-стадийный замер): перекос создаёт ЦЕЛИКОМ trim_beyond_arch (баланс 56.5% → 30.1%; apron/demote/shelf/sail дают 0.0 п.п.). Механизм: воротник честно срезает waxup-лоскут, на котором СТОИТ настоящая коронка 22 (объёмное тело 12 892 грани, λ3/λ1=0.40); коронка отсоединяется, и _keep_body выбрасывает её как «остров». Та же граблина уже чинилась в close_shell (_keep_body_teeth_safe), но в trim фикс не дошёл.
Фикс (структурный, той же меркой, что весь канон): _keep_body больше никогда не выбрасывает компоненту, несущую ОБЪЁМНОЕ зубное тело (λ3/λ1 ≥ 0.28 и ≥ 800 граней). Плоские хлопья с ложной зубной меткой (все лоскуты 0.06..0.26) защиту не получают — на здоровых сканах поведение байт-идентично (коронки прикреплены к телу).
Результат: коронка 22 (12.9k solid) и 24 (1.6k solid) выживают; баланс после trim 30.1% → 49.6%. Остаток до сырого 57% — потеря геометрии, которой в скане структурно не за что держаться (солид-фрагменты <800 граней: зуб 23 = 114 граней — ровно «почти не размеченный зуб 23» из спайка). Это хвост РАЗМЕТКИ, не пайплайна: подтверждает вывод спайка «fine-tune сегментации важнее дорисовки».
A-09 upper остаётся под плашкой неполноты (площадь дыр 151 мм², баланс 50%) — детектор делает ровно то, что должен.

Юридические гейты (соблюдены)

Никакого обучения и никакого использования Teeth3DS в этой задаче (только наши сканы).
GPL-код не встраивался: заделка — своя реализация опубликованного алгоритма Лиепы по статье; MeshFix/pymeshfix в продукте не появляются ни в каком виде.
Всё локально: CPU, без внешних API, без ML.

Что видно кому (явный список)

Что	Врач	Пациент	Никто (только данные/логи)
Заплаты Яруса 1 (доработанный вид)	✅ дефолт, с бейджем «Доработано»	❌
Кнопка отката к оригиналу	✅	❌ (переключателей нет вовсе)
Десневидная юбка Яруса 2	✅ в «доработано»	❌ (нейтральное основание)
Плашка «скан неполный — пересканирование»	✅	❌
Маска synthetic по вершинам, инварианты, слои			✅ teeth.json + узлы GLB
Бухгалтерия заплат (площади, FDI)	✅ (счётчик в бейдже)	❌	✅ полная в teeth.json
Пациенту НИЧЕГО нового не уходит: patient.js создаёт вьювер `refined:false` — заплатки
скрыты, вместо юбки нейтральное основание, пометок и переключателей нет. Включение
доработанного вида пациенту — только отдельным решением Артура.

Приёмка

Реген 20 сканов (qa/regen_real.py, бэкап app/artifacts.bak-cclaude-flap-20260712-215928): 20/20 без ошибок, 41–129 с/скан; present-наборы всех 20 идентичны прежним (14 зубов везде, находки не тронуты). A-06 lower и A-09 lower перегнаны повторно после коррекции порога детектора (артефакты консистентны финальному коду).
Closure-чек на свежем QA-кэше (кэш пересобран v2_facts.py с DENTAL_RECON_PATCH=0 — прежняя семантика чека): 20/20 сомкнуты, 0 несмыканий/немногообразий/нетрассированных, teeth_bitexact 20/20 — фикс _keep_body смыкание не сломал.
Инварианты (qa/recon_invariants.py → qa/recon-invariants.log): 20/20 ✅ PASS — add_only=pass, маска синхронна, synthetic-зубных вершин 0 у всех. Заплат Яруса 1 всего 17 на 8 сканах (A-01l ×1, A-04u ×1, A-04l ×1, A-05u ×4, A-06u ×2, A-06l ×3, A-09u ×2, A-09l ×3; площади 0.07–18.8 мм²); кромок фрагментов защищено: 2 (A-09u).
md5 оригиналов «до»: 123/123 OK — ни один байт data/uploads не изменён (базлайн qa/recon-md5-originals-before.txt, снят до регена).
Кэш без ручного бампа: версия артефакта = mtime файла (?v=<mtime>), подтверждено скрин-скриптом по живым запросам GLB (0 запросов со статичным v=d4).
e2e_stage1: 6/6 PASS, 0 console-errors (после рестарта сервиса на новом коде).
Скрины с публичного URL (чистая браузерная сессия, basic_auth, qa/recon_shots_public.py): все 20 сканов × 8 канонных ракурсов × 2 состояния (REF «доработано» / ORIG «оригинал после отката»), 320 скринов, консоль чистая на всех 10 кейсах, бейдж «Доработано» виден на каждом. Локально qa/shots/recon-accept/, копия — Drive Дентист/qa-shots/recon-accept-20260713/. 8 ракурсов = дедуп углов слайда Артура (front/occl/bottom/implants/debris/cutline/level/outside). Пары состояний сверены пиксельным диффом (каждая пара различается ровно зоной доработки) + визуально (юбка↔камень на фронтах A-01/A-09, изоляция челюсти корректна). ⚠️ Грабля повторена и снята: после регена capturePreviews страницы гоняет isolate — скрин-скрипт теперь ждёт готовности превью (фикс в qa/recon_shots_public.py).
Качество заплат Лиепы (A-05u, кейс спайка): 4/4 дыры закрыты (площади байт-в-байт с переписью), макс. отклонение двугранного угла 52.9°, складок (>90°) 0 — против 56 складок у прежней концентрической заплаты (замер спайка).

Откат

Код: git revert d5fa53e c1f6190 (изменения изолированы). Git: d5fa53e (ядро), c1f6190 (порог детектора + QA), c36df09 (скрины/отчёт); запушено в github+gitea.
Артефакты: app/artifacts.bak-cclaude-flap-20260712-215928 (до регена) + update scans set preview=NULL.
Выключить только заплатки Яруса 1: DENTAL_RECON_PATCH=0 в юните + реген.

⚠️ Хендофф: параллельная сессия POLISH-PASS-2 (13.07)

Поверх этой работы в том же дереве живёт АКТИВНАЯ сессия POLISH-PASS-2 (коммиты 5e045d0…28cadec, 13.07 12:00–14:19): она уже нашла и закрыла два хвоста моего кода — немногообразия от дельоне-флипов Лиепы (nm 62/23 на A-01l/A-10l → 0, живой счётчик рёбер) и сироту пилинга (A-04u) — и на момент закрытия этой сессии перегенерировала артефакты своим кодом (A-09 GLB записан 14:50). Следствия: - приёмочные числа/скрины выше — валидный снимок НА МОЁМ коде и моих артефактах (инварианты и md5 прогнаны на них); финальное состояние прода определит POLISH-PASS-2 — её приёмка/скрины будут свежее; - скрины a-09/a-10 из recon-accept сняты в окно её регена — пересъёмка на её стороне; - на Drive доехало 296/320: параллельная сессия очистила локальную папку скринов до конца выгрузки — потеряны 24 кадра кейса A-10 (upper весь + половина lower). Доснимать нечестно (артефакты A-10 уже перегенерированы её кодом, 14:54) — A-10 целиком покроет приёмка POLISH-PASS-2. Остальные 19 сканов — полные пары. Ничего из её работы не откатывать этим отчётом: она НАДСТРОЙКА над recon-pass-1.