BUILD NOTE 01 · COLUMN HARBOR
숫자로 바꾸기 전에,
원본을 한 번 더.
데이터를 대신 고치는 것보다, 무엇이 달라질 수 있는지 먼저 보여주는 일. CSV 점검기 Column Harbor가 원본을 다루는 방식과 그 경계를 소개합니다.
00123식별자로 남아야 하는 값123같은 숫자, 다른 상품 코드01 / THE PROBLEM
숫자처럼 보여도,
계산할 값은 아닐 수 있습니다.
상품 코드 00123은 숫자 123과 다른 식별자일 수 있습니다. CSV를 열면서 숫자로 해석하면 앞자리 0이 사라질 수 있고, 긴 ID는 숫자 정밀도의 영향을 받을 수 있습니다. Microsoft도 이런 값을 보존하기 위한 텍스트 가져오기 방식을 안내합니다. 공식 안내 읽기 (영문, 새 탭)
Column Harbor는 이 지점에서 출발하는 도구입니다. 파일이 이미 깨졌다고 단정하는 대신, 가져오기 전에 확인할 값과 위치를 보여줍니다. 경고의 의미는 ‘오류 확정’이 아니라 ‘이 값은 한 번 더 살펴보세요’에 가깝습니다.
02 / THE FLOW
파일을 선택해도,
서버로 올리지는 않습니다.
점검기는 선택한 파일이나 붙여 넣은 텍스트를 현재 브라우저에서 읽습니다. 내용을 서버에 보내 AI로 분석하는 방식이 아니라, 원본 문자열을 해석하고 정해진 규칙으로 위험 신호를 찾습니다.
- 원본 읽기UTF-8 텍스트를 읽고, 선택한 구분자로 레코드와 필드를 나눕니다.
- 값은 문자열로 유지상품 코드나 날짜처럼 보이는 값을 임의로 숫자·날짜로 바꾸지 않습니다.
- 위험과 위치 보여주기앞자리 0, 긴 숫자, 날짜 패턴, 열 개수 등 확인할 부분과 원본 값을 표시합니다.
점검 입력과 결과는 현재 페이지의 메모리에 머무릅니다. 다만 파일이 로컬에서 처리된다는 말이 웹사이트 접속 자체의 완전한 익명성을 뜻하지는 않습니다. 내려받은 점검 보고서에도 원본 값 일부가 들어갈 수 있으므로 공유 전에 확인해야 합니다. 파일 처리 안내 (영문, 새 탭)
03 / THE BOUNDARY
친절한 자동 수정이
항상 정답은 아니니까요.
03/04/2026이 3월 4일인지, 4월 3일인지는 모양만 보고 확정할 수 없습니다. 123의 원래 값이 00123이었는지도 이미 손실된 파일만으로는 알 수 없습니다. 그래서 점검기는 원본을 덮어쓰거나 복구를 약속하지 않습니다.
경고가 없다고 모든 가져오기가 안전한 것은 아닙니다. 목적지 프로그램의 규칙과 데이터의 의미는 별도로 확인해야 합니다.
브라우저에서 다루는 범위에도 제한을 둡니다. 확인 당시 점검기는 최대 5 MiB의 UTF-8 텍스트, 20,000개 데이터 레코드, 250,000개 셀을 다룹니다. 대용량 처리나 모든 업무 규칙의 검증을 대신하는 도구는 아닙니다.
04 / WHAT COMES NEXT
경고 다음에는,
다음 행동이 있어야 합니다.
위험 신호만 보여주고 끝나지 않도록, 점검 결과에서 관련 가이드로 이동할 수 있습니다. 앞자리 0은 텍스트로 가져오는 방법으로, 한 열에 몰린 값은 구분자와 가져오기 설정으로 이어집니다.
이 프로젝트가 맡는 역할은 작습니다. 원본이 어떻게 생겼는지 확인하고, 달라질 수 있는 부분을 찾고, 다음 행동을 고르는 것. 파일을 바꾸기 전에 한 번 멈춰 볼 수 있는 도구입니다.