houseplan-card/docs/specs/279-near-orthogonal-junction.md

Issue #279 — сплошной почти ортогональный T-стык

• Дата: 2026-08-24
• Тип: regression bug · приоритет P1
• Issue: #279
• Ветка: issue/279-near-orthogonal-junction
• Статус ТЗ: одобрено self-review по решению владельца

Канонические документы: docs/SCOPE.md, docs/WALL-THICKNESS.md, docs/TESTING.md; связанные задачи #249, #270, #272 и #275.

1. Проблема и подтверждённая причина

В privacy-minimized фрагменте beta.8 endpoint-to-endpoint T-стык состоит из вертикальной стены и входящей стены с допустимым уклоном 0.181315°. Оси сходятся точно, но #275 защищает incident strips только при |dot| <= 1e-9. Поэтому оба сектора считаются диагональными и bounded bevel #249 вырезает из реальной кладки два белых треугольника.

Persisted-модель корректна. Optimize не должен выпрямлять или переписывать ось: исправляется единая вычисляемая masonry geometry.

2. Пользовательский результат

Почти ортогональный T-стык выглядит сплошным во всех режимах и structural consumers. Сохранённый уклон остаётся без изменений. Явно диагональный узел #249 сохраняет ограниченную фаску и не возвращает удалённый внешний клин.

3. Scope и контракт

Входит:

• единая классификация near-orthogonal pair для multi-wall protection;
• защита finite strips в Plan/View/kiosk/Static/hidden Iso, paper/floor и light/sun barriers через существующий canonical masonry result;
• exact fixture, boundary matrix, permutation/scale и regression #249;
• production-bundle smoke и exact local acceptance на C:\Temp\44.json.

Не входит: изменение persisted coordinates, schema/model version, Optimize, UI или коэффициента bounded bevel R.

Пара rays считается near-orthogonal, если нормализованный |dot| <= sin(0.25°). Это явный drafting tolerance, а не накопление scale-dependent экранных допусков. Порог:

• покрывает точный дефект 0.181315° и его зеркальное направление;
• одинаков для cell_cm: 1/5/30, winding, reversed endpoints и порядка;
• не классифицирует как T угол, превышающий 0.25°;
• не меняет non-orthogonal fixture #249.

Функция сохраняет optional parameter для изолированных boundary-тестов, а production default использует новый порог. Protected strips по-прежнему ограничены реальными finite supports; bevel за их пределами работает как #249.

4. Acceptance criteria

1. В минимальном fixture с точными координатами node (-0.354166667, 2.954166667) все три rays защищены; оба прежних cut-клина не удаляют area из incident strips, три arm area-connected.
2. Boundary matrix доказывает: 0°, 0.181315°, зеркальный уклон и ровно 0.25° защищены; значение выше порога не защищено.
3. Fixture #249 сохраняет пустой discardedWedgeProbe, прежний предел R и отсутствие protected rays.
4. Результат инвариантен к равным/смешанным толщинам, коротким supports, cell_cm: 1/5/30, permutation и reversed endpoints.
5. Browser smoke на production bundle проверяет semantic probes внутри обоих прежних клиньев; mutant со старым 1e-9 падает.
6. Полный приватный 44.json проходит raw/Optimize/reload без изменения оси и без белых вырезов.

5. Совместимость, риски и performance

Persisted schema, backend и security boundary не меняются. Классификация остаётся локальным pairwise проходом rays одного node и не добавляет глобальный O(E²) pass. Главный риск — ошибочно защитить настоящий диагональный клин; его закрывают строгая верхняя граница и обязательный regression #249.

6. Self-review ТЗ

• Scope ограничен renderer geometry и не маскирует дефект Optimize.
• Численный порог задан в физически понятных градусах и имеет обе границы.
• Позитивный exact fixture дополнен отрицательным #249, поэтому решение нельзя свести к безусловному заполнению всех multi-wall wedges.
• Все downstream consumers получают исправление из одного structural source.

Вердикт: approved. Внешнее spec-review пропущено по прямому решению владельца.