라기라기의 공개 작업실 만들기

왜 만드는가

유튜브는 사람을 만나기 좋은 곳이지만, 프로젝트의 조건과 코드, 실패와 변경 기록을 오래 쌓기에는 부족합니다. 반대로 사이트가 영상의 요약이나 서비스 홍보만 반복하면 굳이 다시 찾을 이유가 없습니다.

그래서 ragiragi.com은 무엇을 만들었는지보다 왜 만들었고 어디까지 쓸 수 있는지를 남기는 공개 작업실로 정했습니다.

첫 버전의 결정

첫 버전은 Astro로 정적 HTML을 만들고, 글은 저장소 안의 Markdown 파일로 관리합니다. 검증한 빌드를 Cloudflare Pages에 직접 배포합니다.

이 구조를 택한 이유는 세 가지입니다.

1. 한 사람이 쓰는 동안 가장 적은 구성으로 운영할 수 있습니다.
2. 콘텐츠와 사이트 변경 이력이 Git에 함께 남습니다.
3. 필요해질 때 폼, 알림, 데이터베이스를 Worker API로 단계적으로 붙일 수 있습니다.

처음에 대시보드를 만들지 않은 이유

대시보드는 편집 화면만 만드는 일이 아닙니다. 로그인, 권한, 이미지 저장, 미리보기, 복구와 보안까지 운영할 것이 늘어납니다. 아직 작성자가 한 명이고 발행 빈도가 높지 않은 지금은 글을 쓰는 문제보다 대시보드를 돌보는 문제가 더 커질 수 있습니다.

다만 다음 중 하나가 실제로 생기면 다시 검토합니다.

• 여러 명이 글을 편집해야 할 때
• 휴대전화에서 수시로 발행해야 할 때
• 예약 발행과 승인 흐름이 필요할 때
• 주 2~3회 이상 발행하며 이미지 관리가 병목이 될 때

실제 조건이 생긴 뒤 Studio를 분리했다

Mac이 없는 때에도 글을 시작하고 이어 써야 한다는 요구가 구체적으로 생겼습니다. 그래서 공개 사이트에 관리자 기능을 넣는 대신 입력만 담당하는 ragiragi studio를 별도 Worker로 만들었습니다.

• D1은 초안과 수정 이력을 저장합니다.
• R2는 공개 전 이미지를 비공개로 보관합니다.
• 리치 편집기의 원장은 HTML이나 전용 JSON이 아니라 Markdown입니다.
• 발행할 때 Astro Content Collection과 같은 규칙으로 다시 검증합니다.
• 이미지와 Markdown은 GitHub에 기록된 뒤 기존 정적 배포 흐름을 탑니다.
• 인증이 준비되지 않은 production은 잠긴 상태로 유지합니다.

로컬 통합 테스트에서는 새 글 생성, 자동 저장, 충돌 감지, 이미지 업로드와 범위 응답, 발행 잠금까지 확인했습니다. Cloudflare Access와 GitHub App을 실제 운영 계정에 연결하기 전까지 공개 배포는 하지 않습니다.

검색과 AI 검색에 대한 원칙

별도의 ‘GEO 꼼수’를 넣지 않습니다. 제목과 결론을 분명히 쓰고, 실제 경험과 검증 날짜, 출처, 실패 조건을 화면에 공개합니다. 검색봇이 읽을 수 있는 정적 HTML, 고유한 설명, canonical, sitemap과 구조화 데이터 같은 기본을 정확히 지킵니다.

아직 확인할 것

• 실제 배포 후 모바일·데스크톱 가독성
• Cloudflare에서 검색 크롤러가 차단되지 않는지
• Studio로 장소가 달라져도 글을 실제로 이어 쓰게 되는지
• 영상에서 사이트로 온 사람이 제작 기록을 끝까지 읽는지