필드 단위 매핑과 추적
말단 필드를 연결하고 클릭해 출처·도착지·중간 경로와 변경 영향을 함께 확인합니다.
FieldWeft 소개
필드가 어디서 와서 어디로 가는지, 한눈에
FieldWeft는 이벤트·API·데이터베이스·DTO 사이의 데이터 흐름을 필드 단위로 그리는 도구입니다. 최종 응답의 값이 어느 시스템에서 왔는지, 그 사이에 어떤 가공이 있었는지를 하나의 그래프에 기록하고, 관련 노드는 도메인·시스템 같은 경계로 묶어 의미 영역을 표시합니다. 각 대상에는 설명·태그·typed metadata를 더해 화면에 보이는 흐름 밖의 문맥도 함께 보존할 수 있습니다.
해결하려는 문제
시스템 구성도만으로는 값의 출처를 알기 어렵습니다
하나의 응답은 Kafka 이벤트, 외부 API, 데이터베이스 조회 결과처럼 여러 소스의 일부 필드를 조합해 만들어지곤 합니다. 서비스와 테이블의 관계만 그린 구성도는 전체 구조를 보여주지만, 특정 값이 어디서 왔는지까지 답해주지는 못합니다.
문서나 스프레드시트에 매핑을 적을 수도 있지만 중첩 필드가 깊어지고 조건부 입력이 늘어나면 흐름을 따라가기 어려워집니다. FieldWeft는 엔터티를 표 형태 노드로, 필드 사이의 이동을 엣지로 표현해 이 간격을 메우려 합니다.
주요 기능
데이터 흐름을 설명하는 데 필요한 작은 도구들
값의 유지와 가공
그대로 전달하는 값과 변환하는 값을 매핑의 선 모양과 라벨로 구분합니다.
프로세스와 입력 변형
변환 과정을 블랙박스 노드로 표현하고, discriminator 값에 따라 달라지는 필드 구조를 기록해 변형별로 비교할 수 있습니다.
저장·공유·백업
브라우저에 자동 저장하고, 그래프를 담은 링크나 백업 파일로 필요한 사람에게 전달할 수 있습니다.
작성한 그래프는 브라우저에 저장됩니다
페이지와 그래프는 현재 브라우저의 IndexedDB에 저장되고, 마지막으로 열었던 페이지·언어 선택·캔버스 화면 설정 같은 가벼운 환경설정은 localStorage에 남습니다. 계정이나 별도 저장 서버 없이 사용할 수 있지만, 브라우저 데이터를 지우면 로컬 저장본도 사라질 수 있으므로 중요한 작업은 백업 파일로 내보내는 것이 좋습니다.
공유 링크에는 현재 페이지의 전체 FieldWeft 문서가 URL의 #g=d1.… fragment로 포함됩니다. stable node·field·boundary·relation ID와 명시적 노드 관계·필드 매핑, 모든 대상의 설명·태그·metadata, 정확한 위치· 접힘·경계 멤버십·크기를 보존합니다. 받은 쪽은 저장 없이 읽기 전용으로 탐색하고 새 페이지로 가져오기를 선택해 독립적인 사본을 저장합니다. 위키 iframe에서는 새 앱 탭으로 가져옵니다. 페이지 이름·다른 페이지·viewport는 포함하지 않으므로 여러 페이지나 매우 긴 그래프는 백업 파일로 전달하세요. fragment는 웹서버 요청과 일반적인 Referer에는 포함되지 않지만 전체 링크는 주소창·히스토리·클립보드와 메신저·문서에 남을 수 있습니다. FieldWeft v1은 format: "fieldweft", version: 1과 다섯 필수 배열을 사용합니다. 필드 이름·위치를 바꿀 때 ID는 유지하고 새 필드에만 새 ID를 발급해야 합니다. 어떤 방식이든 비밀번호·토큰·실제 고객 정보 같은 민감한 값은 입력하지 마세요.
이런 분께 잘 맞습니다
- 여러 API와 이벤트를 조합하는 백엔드 개발자
- 데이터 파이프라인의 필드 출처를 문서화하는 엔지니어
- DTO 변경 영향과 매핑 누락을 함께 검토하는 팀
- 레거시 시스템의 데이터 이동 경로를 분석하는 사람
현재 범위
FieldWeft는 코드를 자동 분석하거나 실시간 데이터 파이프라인을 감시하는 도구가 아닙니다. 사용자가 알고 있는 구조를 직접 그리거나 검증된 FieldWeft v1 JSON으로 입력해 공유하는 가벼운 문서화 도구에 가깝습니다. 서버 동기화와 동시 편집도 제공하지 않습니다. FieldWeft는 원본 SQL·실제 데이터 값이나 외부 lineage 저장소를 역복원하지 않으므로, 검토에 필요한 부분 그래프를 선택해 전달하는 방식을 권장합니다.
샘플 그래프에서 바로 시작해 보세요
보기 전용으로 둘러보고, 마음에 든 샘플은 독립 사본으로 편집하세요.