docs(adr)!: 알림 결정 기록을 docs/adr로 옮긴다

결정 기록이 두 폴더(docs/adr/, docs/notification/adr/)에 나뉘어 있다.
문서 지도, 수명 표, 머리 블록 절, 문서 검사의 결정 기록 폴더 목록이
모두 두 폴더를 따로 적어야 하고, 루트 README의 「왜 이렇게 정했는지
보기」도 두 곳을 가리킨다.

NOTIF-ADR-001~005를 이름 그대로 docs/adr/로 옮긴다(git mv, 본문·머리
블록 그대로). 가리키던 곳을 함께 고친다.
- 루트 README 문서 지도 행, docs/README.md 지도·수명 표·머리 블록 절
- scripts/check-docs.py의 RECORD_KINDS·DECISION_PREFIXES와 설명
- NotificationReleaseGateTest: ADR 넷의 존재를 docs/adr/에서 본다
- docs/upgrade/2026-11-docs-records.md: 옮긴 경로 표와 찾는 명령

파일 이름 앞머리(NOTIF-ADR-)는 바꾸지 않았다. 설계서·리뷰·모듈 문서가
NOTIF-ADR-005처럼 번호로 부르고 있어, 이름을 ADR-NOTIF-로 바꾸면
기록 본문의 부름이 맞지 않게 된다.

위험: 이 ADR을 가리키던 문서·주석을 가진 파생 서비스는 경로를 바꿔야
한다(upgrade 안내 3절). notification-platform.yml의 pull_request 경로
필터 docs/notification/**는 이제 이 ADR을 보지 않는다. ADR 존재 시험
(NotificationReleaseGateTest)은 PR의 ci(:adapter:outbound:notification:
check)에서 계속 돈다. workflow는 이 변경에서 고치지 않았다.

이 ADR을 예외로 둔 줄은 없었다(합친 트리의 예외 목록이 이미 비어 있다).

검증(노트북): check-docs.py OK(language·head·reference·number·map·
readme 걸림 0), 자기 시험 65 OK, check-work-docs.py OK,
check-repo-layout.py OK, 살아 있는 문서에서 notification/adr 참조 0.

BREAKING CHANGE: docs/notification/adr/NOTIF-ADR-*.md가 docs/adr/로
옮겨졌다. 파생 서비스 문서·주석의 옛 경로를 docs/adr/NOTIF-ADR-*.md로
바꾼다.
This commit is contained in:
DongHyeonka
2026-11-07 18:10:33 +09:00
parent a1d75a924c
commit 39d4f24803
10 changed files with 15 additions and 14 deletions
@@ -17,6 +17,7 @@ import org.junit.jupiter.api.Test;
class NotificationReleaseGateTest {
private static final Path DOCS = Path.of("..", "..", "..", "..", "docs", "notification");
private static final Path ADRS = Path.of("..", "..", "..", "..", "docs", "adr");
@Test
void requiredDocumentationAndAdrsExist() {
@@ -29,10 +30,10 @@ class NotificationReleaseGateTest {
assertThat(DOCS.resolve("configuration-reference.md")).exists();
assertThat(DOCS.resolve("migration-guide.md")).exists();
assertThat(DOCS.resolve("module-mapping.md")).exists();
assertThat(DOCS.resolve("adr/NOTIF-ADR-001-durable-acceptance.md")).exists();
assertThat(DOCS.resolve("adr/NOTIF-ADR-002-event-ledger-projection.md")).exists();
assertThat(DOCS.resolve("adr/NOTIF-ADR-003-ambiguous-submission.md")).exists();
assertThat(DOCS.resolve("adr/NOTIF-ADR-004-fcm-fid-primary.md")).exists();
assertThat(ADRS.resolve("NOTIF-ADR-001-durable-acceptance.md")).exists();
assertThat(ADRS.resolve("NOTIF-ADR-002-event-ledger-projection.md")).exists();
assertThat(ADRS.resolve("NOTIF-ADR-003-ambiguous-submission.md")).exists();
assertThat(ADRS.resolve("NOTIF-ADR-004-fcm-fid-primary.md")).exists();
}
@Test