설계로그 목록
ADR-0016 공통 설계중

이 기록을 만든 방법과 그 과정에서 틀린 것들

작성 2026-07-25 · 최종 갱신 2026-07-29

앞선 열다섯 건이 어떤 절차로 작성됐고 그 과정에서 무엇이 틀렸는지를 남긴다. 결론만 있는 기록은 얼마나 믿어야 할지 알려 주지 않는다. 인용의 검증 등급을 세 단계로 구분해 표기했고, 작성 중 발견된 오류 여섯 건을 그대로 적는다.

이 문서는 연구·설계 기록이며, 현재 제공 중인 서비스가 아닙니다. 각 항목의 상태 표기를 함께 확인해 주세요.

맥락

설계로그는 결정을 남기지만 그 결정이 어떻게 만들어졌는지는 남기지 않는다. 읽는 쪽에서는 이 기록을 얼마나 믿어야 할지 판단할 근거가 없다.

특히 이 로그는 상호참조가 조밀하다. 뒤의 기록이 앞의 기록을 근거로 삼는 구조에서 앞의 기록이 틀렸다면 그 오류는 조용히 번진다. 실제로 그런 일이 있었다.

이 기록의 목적은 자기소개가 아니라 신뢰 수준의 공개다. 무엇을 원문까지 확인했고 무엇을 서지사항만 보고 인용했는지, 어디서 틀렸고 어떻게 잡혔는지를 적는다.

검토한 대안

대안 A기각

작성 과정을 기록하지 않고 결정만 남긴다.

결론만 있으면 독자는 검증 수준을 알 수 없다. 원문까지 확인한 인용과 제목만 보고 붙인 인용이 같은 무게로 읽히면, 강한 근거가 약한 근거의 신뢰까지 떠안는다.

대안 B기각

방법론만 적고 오류는 적지 않는다.

오류를 뺀 방법론은 방법론이 잘 작동했다는 주장이 된다. 실제로 무엇이 빠져나갔는지가 그 절차의 실효를 보여 주는 유일한 증거다.

대안 C채택

검증 등급과 오류 이력을 함께 공개한다.

이 프로젝트가 답변에 검증 블록을 붙이는 것과 같은 이유다. 근거의 강도를 표시하지 않은 근거는 근거로 쓰기 어렵다.

결정

  1. 인용의 검증 등급을 네 단계로 구분해 각 항목의 verification 필드에 적고 화면에도 함께 표시한다. 원문대조(본문을 직접 내려받아 문장을 확인), 초록확인(권위 데이터베이스의 초록 또는 발행처 공식 설명으로 주장을 확인), 서지사항(초록을 얻지 못해 제목·저자·출처만 확인), 자체자료(이 프로젝트 자신의 산출물·데이터). 서지사항 등급의 자료로는 그 문헌의 결론을 인용하지 않는다.
  2. 법령·판례는 예외 없이 DRF 본문으로 실증한 것만 부착한다. 조문 번호를 기억이나 추정으로 적지 않는다.
  3. 작성 중 발견된 오류를 삭제하지 않고 이 기록에 남긴다. 수정 커밋을 조용히 덮는 방식으로 처리하지 않는다.
  4. 결정을 바꾸는 개정은 무엇을 왜 바꿨는지 개정 이력에 남긴다(ADR-0010 결정 1). 근거만 보강한 경우에도 결정이 불변임을 명시한다.
  5. 이 기록이 이 로그 자신에 대해 말하는 수치는 본문에 적지 않고 렌더 시점에 원본 데이터에서 계산해 채운다. 사람이 센 값을 본문에 박아 두면 엔트리가 늘 때마다 반드시 틀리며, 틀린 자기집계는 이 기록의 목적인 신뢰 수준 공개를 정면으로 무너뜨린다.
  6. 참고문헌의 식별자도 실제로 해석되는지 확인한 것만 부착한다. 결정 2 는 법령·판례를 DRF 본문으로 실증하도록 했으나 참고문헌의 DOI·문서번호는 그 대상이 아니었다. 식별자는 형식이 맞으면 그럴듯해 보이므로 육안으로 걸러지지 않는다. 열어서 그 문헌이 나오는 것을 확인하지 못한 식별자는 적지 않고, 해석되는 다른 권위 레코드(기관 리포지터리·공공 서지 데이터베이스)로 대체한다.
  7. 새 사례 조사는 기존 결정 중 하나를 실제로 무너뜨릴 가능성이 있을 때만 착수한다. 사례를 하나 조사할 때마다 결정을 하나씩 만들어야 한다는 압력이 생기고, 그 압력은 사례가 설계를 끌고 가는 방향으로 작동한다. 조사 결과가 기존 결정의 비어 있던 내용을 채우는 데 그치면 새 기록을 만들지 않고 그 결정을 개정한다.

근거

이 결정이 만드는 한계

폐기 조건

근거자료

인용 법령

인용한 법령이 없습니다.

참고자료

산출물·측정 기록

개정 이력

담당 리더

마디 리더

마디L60

시스템 총괄 · Master API Gateway

사람의 자격이나 직위에 대응하지 않는 시스템 역할 표기다. 이 로그의 설계 결정은 사람이 작성하고 사람이 책임진다(ADR-0004·ADR-0016).

설계로그는 특정 법률 분야가 아니라 시스템 전체의 설계 결정을 다룬다. 개별 도메인 리더가 아니라 60명 리더 시스템의 운영·품질을 총괄하는 리더가 담당한다.

리더 프로필 보기

관련 기록

ADR-0009ADR-0010ADR-0012ADR-0013ADR-0014ADR-0017ADR-0018ADR-0019ADR-0027ADR-0028ADR-0029ADR-0030ADR-0031ADR-0032ADR-0002ADR-0035ADR-0033