법적 문서 중앙화로 운영 일관성 확보하기

privacy, cookies, policy 같은 법적 문서들을 전부 legal.hedvion.com 으로 옮기면서 기존의 분산된 on-site 예외를 폐기했다. 작은 구조 변경으로 보이지만, 팀이 문서를 관리하는 방식과 사용자가 접근하는 흐름을 깔끔하게 정리한 작업이었다.

분산 관리의 불편함

기존엔 법적 문서들이 여러 곳에 산재했다. 어떤 건 각 서비스의 on-site에, 어떤 건 wiki에, 어떤 건 별도 문서화 시스템에. 버전을 올릴 때마다 몇 가지 문제가 반복됐다:

• 업데이트 누락: 한 곳은 최신, 한 곳은 옛날 버전 → 사용자/법무팀이 어느 게 정본인지 헷갈림
• 일관성 부재: 같은 정책이라도 표현, 레이아웃, 용어가 제각각
• 접근성 낮음: 찾기 위해 서비스마다 뒤져야 함
• 코드 리뷰 비용: 수정이 필요할 때 어떤 파일들을 건드려야 하는지 파악이 느림

팀이 빠르게 성장하면서 이 문제는 더 커졌다. 새로운 서비스가 나올 때마다 "privacy policy는 또 어디에 둘까?" 같은 질문이 반복되고, 누군가는 옛날 버전을 참고해서 실수하곤 했다.

중앙 저장소로 정리하기

legal.hedvion.com 을 정본 저장소로 삼고, 모든 법적 문서를 한 곳에서 관리하기로 결정했다.

실제 문서 구조는 대략 이렇게 정리했다:

legal.hedvion.com/
  ├── privacy-policy
  ├── cookies-policy
  ├── terms-of-service
  └── data-processing-agreement

각 서비스의 footer나 settings에는 이 URL로 직접 링크만 걸면 되고, 정책을 갱신할 때는 legal.hedvion.com 에서만 수정하면 모든 서비스가 자동으로 최신 버전을 가리킨다.

on-site 예외를 폐기하기로

가장 고민되던 부분이 바로 "on-site 예외"였다. 기존엔 특정 서비스에서만 써야 하는 정책 변형이 있어서, on-site 에 배포된 별도 버전을 관리했었다. 예를 들어 국내/해외 서비스의 법적 요구사항이 다를 수 있고, 그걸 on-site 각각에서 커스터마이징하는 식이었다.

하지만 이 예외는:

• 버전 관리의 복잡성: 어떤 버전에 어떤 변형이 있는지 추적하기 어려움
• 리뷰 부담: 코드리뷰할 때 "이건 기본 정책인가, 변형인가?" 계속 확인해야 함
• 유지보수 악순환: 시간 지나면 왜 이 변형이 있는지 아는 사람도 없어짐

결국 이 예외를 폐기하고, 서비스별 특수 요구사항이 있으면 legal.hedvion.com 에서 한 곳에서 모두 관리하기로 했다. 각 서비스는 자신의 컨텍스트에 맞는 정책 버전만 가리키면 된다.

팀 관점에서의 영향

이런 구조 변경이 왜 중요한가는 팀 성장 단계에서 더 명확해진다:

• 온보딩: 새로 들어온 팀원이 "법적 문서는 어디서 관리하나요?"라고 물었을 때 "legal.hedvion.com" 한 마디로 끝남
• 협업: 법무팀이나 컴플라이언스팀과 소통할 때 버전 혼동으로 인한 재작업 줄어듦
• 스케일링: 서비스가 10개든 20개든, 정책 변경은 여전히 한 곳에서만
• 감시: git 히스토리로 정책 변이를 쉽게 추적 가능 (언제, 누가, 왜 바꿨는지)

특히 docs/hedvion-CLAUDE.md 를 수정했다는 건, 팀 전체의 문서화 규칙도 이에 맞춰 정리했다는 뜻이다. 앞으로 이런 유형의 작업에서 팀원들이 같은 기준을 따를 수 있게 하는 거다.

회고: 작은 결정이 모여 큰 효과

분산이 문제라는 걸 아는 것과, 그걸 실제로 정리하는 건 별개다. 이 과정에서 배운 건:

• 중앙화의 유혹: 항상 정답은 아니다. 하지만 법적 문서처럼 "정본이 무엇인가"가 명확해야 하는 영역에선 필수다
• 예외를 먼저 죽이기: on-site 예외가 남아있으면 결국 운영 복잡도가 줄어들지 않는다. 중앙화 혜택은 모든 예외를 정리했을 때 나타난다
• 문서화는 코드: CLAUDE.md 같은 팀 규칙 문서도 함께 갱신해야 다음번엔 실수하지 않는다

끝.

🛒 이 글과 어울리는 추천 상품

• 사무의자 쿠팡에서 보기 →
• 모니터암 쿠팡에서 보기 →
• 기계식키보드 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.