72750cfc9d
- history/README.md: 변경 이력/인시던트 기록 규약 - history/2026-04-10-edge-cleanup.md: 오늘의 엣지 정리·인시던트·복구 전체 연대기 - infra/cloudflare.md: 연대기 주석/strikethrough/인시던트 서사 제거, 현재 사실만 - infra/crowdsec-safeline.md: 인시던트 bullet 제거, 과거 이력은 history/ 참조 - services/bunnycdn-security.md: sitekey 이력표 제거, 현재 위젯 정보만 - infra/nas-storage.md: reverse proxy 섹션의 날짜 주석 제거
34 lines
2.1 KiB
Markdown
34 lines
2.1 KiB
Markdown
---
|
|
title: History
|
|
tags: [history, changelog]
|
|
---
|
|
|
|
인프라·서비스 변경 이력과 인시던트 기록. Obsidian 정본 파일은 "지금 이게 맞다" 형태의 백서이고, 여기 `history/` 는 "무엇이 어떻게 변했는가" 를 남기는 별도 공간.
|
|
|
|
## 파일 규칙
|
|
|
|
- 파일명: `YYYY-MM-DD-<주제>.md` (예: `2026-04-10-edge-cleanup.md`)
|
|
- 하나의 이벤트 = 하나의 파일. 관련된 조치들이 하루에 연쇄로 일어난 경우 한 파일로 묶어도 됨.
|
|
- Frontmatter: `date`, `topic`, `areas` (관련 Obsidian 정본 파일 경로), `tags`
|
|
- 본문:
|
|
- `## 배경` — 왜 이 변경이 필요했는가
|
|
- `## 변경 사항` — 무엇을 어떻게 바꿨는가 (before → after)
|
|
- `## 영향 / 검증` — 사용자 영향, 실측 검증 결과
|
|
- `## 교훈 (있으면)` — 인시던트였다면 원인 + 재발 방지
|
|
- `## 참조` — Outline doc, OpenMemory id, 관련 정본 파일 링크
|
|
|
|
## 정본과의 관계
|
|
|
|
- 정본 (`infra/`, `services/`, `products/`, ...) 에는 **현재 사실만**. "2026-04-DD X→Y 변경" 같은 연대기 주석, `~~strikethrough~~` 로 남긴 제거 항목, 인시던트 서사 금지.
|
|
- 어떤 변경이든:
|
|
1. 정본 파일에서 "현재 사실" 을 새 값으로 덮어쓴다
|
|
2. `history/YYYY-MM-DD-<주제>.md` 에 상세 이력을 남긴다
|
|
3. 정본에서 history 파일을 참조 링크로 연결할 수는 있으나, 이력 본문을 정본에 복제하지 않는다
|
|
- git commit 히스토리는 정본 파일 변경을 자동으로 기록하므로 "이 줄이 왜 바뀌었는가" 는 `git blame` + 해당 commit 의 history 링크로 추적 가능하다.
|
|
|
|
## 왜 이렇게 분리하나
|
|
|
|
- 정본이 log 가 되면 "지금 상태" 파악이 어려워진다
|
|
- 변경 이력은 시간순이라 쌓이고, 정본은 시점 독립이라 덮어써진다 — 두 구조가 섞이면 안 됨
|
|
- OpenMemory 와 Outline 도 유사한 시간축 기록 공간이지만, OpenMemory 는 시멘틱 검색용 요약, Outline 은 에이전트 간 대화 로그. `history/` 는 인프라 변경의 정본 사본 (git 보관)
|