2026-08-16 · DEVELOPMENT RECORD

짧은 재료 팁을 8개 가이드로 확장하기

앱 안의 팁은 메뉴 선택을 돕기에 충분했지만, 재료를 찾으러 온 사람에게는 맥락과 근거가 부족했다. 콘텐츠를 늘리되 React 화면과 API에 섞지 않고, 갱신 가능한 정적 문서로 분리했다.

작성 PPStudio 운영자게시 2026-08-16검토 2026-08-16

짧은 팁과 독립 콘텐츠의 역할이 달랐다

앱의 재료 팁은 추천 화면에서 빠르게 읽고 관련 메뉴를 여는 보조 정보다. 하지만 선택, 손질, 보관, 조리처럼 재료 자체를 이해하려는 방문자에게는 정보량과 출처 표시가 부족했다.

그렇다고 기존 팁을 그대로 길게 복사하면 같은 문장이 두 곳에서 관리되고, 앱 기능과 검색용 문서가 한 코드 경로에 묶인다. 두 콘텐츠의 목적을 분리해야 했다.

앱 팁은 짧게 유지하고 재료를 자세히 읽을 수 있는 별도 페이지를 만들었다. 각 글의 URL, 날짜, 출처와 관련 메뉴를 본문과 같은 원본에 넣었다. 목록과 본문, 사이트맵을 따로 고치다 연결이 어긋나는 일을 줄이기 위한 구조다.

8개 재료 글을 JSON 원본으로 두고 정적 목록, 상세 페이지, sitemap을 생성했다. 기존 팁은 짧은 요약으로 유지하고 심층 글과 상호 연결해 같은 주제를 반복 게시하지 않도록 했다.

새 글은 URL-safe ID, 실제 ISO 날짜, HTTPS 공식 출처, 유효한 관련 메뉴 ID를 모두 통과해야 생성된다. 형식이 맞지 않는 준비 중 글은 공개 폴더나 링크에 나타나지 않는다.

공통 공개 페이지 템플릿과 블로그 생성기를 만들고, 각 글에 선택·손질·보관·조리·관련 메뉴·참고 자료를 넣었다. 개발 서버 경로와 sitemap도 같은 원본에서 파생되도록 했다.

생성기 테스트와 공개 페이지 테스트를 추가해 링크, 경로, 출처 형식과 Vite 정적 라우팅을 점검했다. 8월 16일에는 이 생성 흐름과 검수 규칙이 문서에서도 같은 사실을 설명하도록 정리했다.

새 글을 추가하면 본문과 함께 목록, 사이트맵, 관련 메뉴 링크를 생성한다. 필수 정보가 빠졌을 때 생성 단계에서 멈추므로 제목만 있는 페이지나 연결되지 않는 메뉴를 공개 전에 찾을 수 있다.

생성기가 확인하는 것은 날짜와 링크 등의 형식이다. 출처의 설명을 잘못 옮겼거나 앱 팁을 되풀이한 문장은 통과할 수 있다. 식품 정보의 적용 조건과 원문의 갱신 시점은 글을 검토할 때 따로 확인해야 한다.

출처 URL과 날짜가 유효하다고 글의 식품 정보가 자동으로 최신이 되는 것은 아니다. 원문을 복제하지 않고 독립적으로 작성했는지, 권장 표현이 과도하지 않은지도 계속 검토해야 한다.

생성기에서 빈 링크와 형식 오류를 거른 뒤에도 본문 검토는 남는다. 출처가 실제로 뒷받침하는 내용인지, 보관·조리 조건을 빠뜨리지 않았는지는 원본 글에서 확인한다.