데모 계산기 — 배선 검증용

이 페이지는 무엇인가

이 페이지는 사이트의 뼈대가 제대로 동작하는지 확인하려고 만든 검증용 도구입니다. 위 계산기가 내놓는 숫자에는 아무 근거가 없습니다. 실제 수수료나 세금을 계산하는 데 쓰지 마세요.

확인하려는 것은 하나입니다. src/tools/{카테고리}/{슬러그}/ 폴더를 하나 만들고 빌드하면, 공통 파일을 한 줄도 고치지 않고도 다음이 전부 자동으로 붙는가.

• 도구 상세 주소 /{카테고리}/{슬러그}
• 홈 그리드와 카테고리 목록에 카드 추가
• sitemap.xml 에 URL 추가
• 같은 카테고리 도구 사이의 관련 도구 링크
• WebApplication, BreadcrumbList, FAQPage 구조화 데이터
• 브레드크럼, 기준일 배지, 면책 문구, 최종 수정일

도구 하나를 이루는 다섯 개 파일

새 도구를 추가할 때 만드는 파일은 다섯 개로 고정되어 있습니다.

| 파일 | 역할 | | --- | --- | | manifest.ts | 제목, 설명, 키워드, 기준일, 출처, 공개 여부 | | logic.ts | 계산식. 순수 함수만 넣는다 | | logic.test.ts | 일반 3개 + 경계값 2개 + 교차 검증 1개 이상 | | Widget.tsx | 입력 UI. 계산식은 넣지 않는다 | | content.mdx | 해설 본문. 지금 읽고 있는 이 글 |

계산식을 logic.ts 에만 두는 이유는 테스트 때문입니다. UI 컴포넌트 안에 계산식이 섞이면 값을 검증할 방법이 렌더링밖에 남지 않습니다. 세금 계산기에서 숫자가 틀리면 사이트 전체의 신뢰가 한 번에 무너지므로, 계산식은 반드시 단독으로 테스트할 수 있는 형태여야 합니다.

검수 전 도구를 다루는 방법

manifest.ts 의 status 를 'draft' 로 두면 홈 그리드, 카테고리 목록, 사이트맵에서 빠집니다. 대신 주소로 직접 들어가면 페이지는 정상적으로 열립니다. 해설 본문 초안을 써 두고 사람이 눈으로 확인한 뒤 'published' 로 바꾸는 순서를 지키기 위한 장치입니다.

검색엔진에는 noindex 로 표시되므로, 검수가 끝나지 않은 글이 색인되는 일도 없습니다.

이 도구를 지울 때

실제 부동산 계산기가 들어오면 src/tools/sandbox/ 폴더를 통째로 삭제하고 다시 빌드하면 됩니다. 홈, 카테고리 목록, 사이트맵, 헤더 내비게이션에서 함께 사라져야 정상입니다. 추가만큼이나 삭제도 폴더 하나로 끝나는지가 이 구조의 확인 항목입니다.