drawNET Bug Report - 2026-03-22 🐞

이 문서는 2026년 03월 22일 발생한 설계 취약점 보완 및 그에 따른 조치 사항을 기록합니다.

현상: 연결선 데이터 자체에 레이어 정보가 없어, 특정 연결선이 크로스 레이어인지 판단하려면 반드시 소스/타겟 노드를 그래프에서 검색해야 함. 이는 외부 도구(LLM 등) 연동 시 데이터 독립성을 저하시키고, 대규모 도면에서 필터링 성능 저하를 유발함.
원인: 초기 설계 시 "노드 ID가 있으니 나중에 조회하면 된다"는 유추 방식에 의존함. 데이터 아키텍처 관점에서 객체 단독으로는 자신의 상태(Cross-layer 여부 등)를 완벽히 설명하지 못하는 불완전한 상태였음.
조치:
1. static/js/modules/graph/interactions/edges.js: edge:connected 이벤트 발생 시 소스/타겟 노드의 layerId를 직접 조회하여 연결선 데이터(source_layer, target_layer, is_cross_layer)에 명시적으로 기록하도록 수정.
2. static/js/modules/graph/io/json_handler.js: 기존 도면(Legacy data) 로드 시 누락된 레이어 메타데이터를 자동으로 계산하여 보정하는 자가 치유(Self-healing) 로직 추가.
3. 6개월 뒤의 나를 위해 각 관련 파일에 작업 배경 및 이유를 주석으로 명시.
관련 이전 이슈: 없음.

모든 항목은 압축하지 말고, 이전 리포트들보다 더 자세하거나 최소한 동일한 상세도로 작성할 것. 절대 요약·생략·간략화하지 마. 각 항목에 구체적인 코드 조각, 이벤트 이름, 함수명, 속성명 등을 최대한 포함.