WhoAmI — 공부 기록을 발행 가능한 형태로 좁힌 파이프라인

2026-09-25 정정 — 오탈자 수정 여부를 자동으로 판별하는 것이 아니라, 편집자가 수정일 자동 갱신을 끄는 방식임을 명확히 했다.

2026-09-05 정정 — 작성 경로가 하나뿐이라는 설명, 저장 차단의 예외, 검증 범위와 이미지 후처리를 현재 코드에 맞춰 정정했다. 과거 집계 수치는 제거했다.

먼저 볼 사례: 원고를 저장하는 곳과 공개하는 곳

실습 노트를 옮길 때 토큰 형태의 값이 본문에 섞여 있으면, 관리자와 반입기의 기본 저장 경로는 파일 기록을 멈춘다. 허용된 더미 값으로 원고를 고친 뒤 다시 저장할 수 있다. 명시적 저장 예외가 있으므로 모든 입력의 안전성을 보장하는 기능은 아니다.

저장에 성공해도 바뀌는 것은 로컬 작업 트리다. 관리자 코드는 공개 산출물에 들어가지 않고, 배포 전에는 회귀 테스트·콘텐츠·자격증명·공개 범위 검사를 별도로 실행한다. 편집 화면을 분리한 구조는 관리자 개발 기록, 산출물에서 확인하는 경계는 공개 범위 검사 기록에서 이어 볼 수 있다.

이 프로젝트는 AI와 함께 만들었다

설계, 구현, 문서 작성 대부분을 LLM과 함께 했다. 무엇을 얼마나 썼는지는 AI 활용 기록에 남아 있는 로그·화면 기록의 수치로 정리해 두었다. 수집은 명시적으로 실행할 때만 하며, 그 수치만으로 기능별 기여나 검증 범위를 증명하지는 않는다.

그래서 아래 개발일지에는 같은 형태의 기록이 반복해서 나온다. 함께 만든 문서나 설정이 실제 동작과 어긋나 있는 것을 나중에 확인하다 발견하고, 그것을 어떻게 처리했는가. 만든 과정을 적지 않으면 그 검토가 왜 필요했는지도 설명되지 않는다.

왜 정적 사이트로 두었나

관리자 화면이 필요했지만 그 때문에 사이트를 서버 렌더링으로 바꾸지는 않았다. 관리자는 scripts/ 안의 독립 Node 서버라 빌드 결과물에 들어가지 않고, 기본은 이 PC에서만 열린다. ’편집 편의’와 ’공개 표면’을 맞바꾸지 않는 쪽을 골랐고, 버린 선택지와 아직 남은 문제는 관리자 화면이 필요했는데 사이트를 서버 렌더링으로 바꾸지 않았다에 적었다.

자격증명 검사를 경고가 아니라 중단으로 둔 이유

처음에는 경고만 띄우고 저장은 되게 할 생각이었다. 바꾼 이유는 단순하다. 경고는 급할 때 지나친다. 그리고 한 번 커밋된 토큰은 파일을 고쳐도 git 이력에 남는다. 그래서 원고를 저장할 때부터 자격증명을 검사하도록 했다.

현재 구현에는 관리자 allowSecrets와 반입기 --allow-secrets 예외가 있다. 따라서 저장 차단은 기본 동작의 범위다. 막혔을 때는 원본을 더미 값으로 고치고 다시 검사하는 절차를 사용한다. 배포 전 자격증명 검사는 별도로 남아 있다.

운영 중인 처리와 남은 과제

• CI에 SAST·SCA를 붙이는 것. 현재 CI에는 회귀 테스트·타입·콘텐츠·자격증명·빌드·공개 범위 검사가 있다.
• 반입 때 400KB 이상 이미지는 경고한다. 빌드 후처리는 치수·지연 로딩과 무손실 WebP 대안을 자동으로 만들며, 원본도 보존한다.
• 저장소가 비공개다. 이력 데이터가 저장소 안에 있는 한 공개로 돌릴 수 없고, 그 데이터를 밖으로 빼는 것이 공개 전환의 선행 조건이다.