집필 방식·패턴 가이드라인 및 편집 전략

초반의 절제된 지적 위트와 실물 계약 비유에서 출발하여, 후반부 수리 논리·합의 알고리즘·운영 공학·글로벌 금융 규제로 치밀하게 격상되는 7대 집필 표준

원문 마크다운 명세서: WRITING_STRATEGY_AND_STYLE_GUIDE.md 마크다운 원문 열기 → 디자인 시스템 →

1. 6부작 점진적 심화와 설계 패턴 곡선 (Progressive Rigor & Design-Pattern Curve)

이 책의 문체와 밀도는 처음부터 끝까지 단조롭게 유지되지 않습니다. 독자가 왜 이런 복잡한 분산 원장 프로토콜이 필요한지 납득하는 제1부에서는 건조하고 지적인 엔지니어링 유머(Dry Wit)와 실물 계약 사례로 진입 장벽을 낮추되, 제2부~제5부로 전진할수록 정형 수식, 합의 알고리즘, 데이터베이스 내부 구조, 금융 규제 법리로 농도를 높이고, 에필로그 이후 제6부 Daml 설계 패턴(Ch 27~34)에서는 실전 계약 패턴을 조립합니다.

파트 구분 핵심 질문과 기술 축 문체 톤 & 수식·코드 비중
Part 1 (Ch 01~05) 시장 미시구조, O(n²) 대사 비용, 결제 완결성, 가상 공유 원장의 필연성 절제된 위트(15~20%) + 그래프 수식 + 초기 Daml/TypeScript 대조 모델
Part 2 (Ch 06~10) 실물 법적 계약 ↔ Daml 구문 대수 ↔ TypeScript 대칭 학습, 권한 규칙과 타입 안전성 명쾌한 언어 대수 + 1:1 코드 대조(45%) + 추론 규칙 정식화
Part 3 (Ch 11~16) 블라인드 머클 뷰, 7단계 합의 프로토콜, 3중 카운터 락, 격자 준동형 해시 정통 분산 시스템·암호학 증명 톤 + 프로토콜 상태 전이도
Part 4 (Ch 17~21) PostgreSQL 스토리지 튜닝, 병렬 인덱서, HOCON 설정, 3중 격리 복구, 프루닝 시니어 SRE & 코어 아키텍트 실전 운영 매뉴얼 톤
Part 5 (Ch 22~26) Splice 토크노믹스, CIP 의회, Canton 재단·슈퍼 검증인(SV) 거버넌스, 토큰화 신탁·펀드 수익권 & 글로벌 규제 토크노믹스 수리 모델 + 제도권 법률·컴플라이언스 아키텍처 실증
Part 6 (Ch 27~34) Daml 설계 패턴 — 제안·수락, 다자 합의, 인가·위임, 잠금, 3계층 계좌, 다형성 DvP/PvP, 토큰화 수익권 조립 기관 업무 문제 → 당사자 권한표 → 완결 Daml 코드 & ACS 전이식

2. 7대 필수 집필 불변식 (7 Editorial Invariants)

  1. 메커니즘 중심 표제화(Mechanisms-First Headings): 목차나 소제목만 읽어도 동기화기(Synchronizer), 서명자(Signatory), 2단계 커밋(Two-Phase Commit, 2PC) 같은 핵심 기술 대상이 즉시 드러나야 합니다.
  2. 최초 등장 외래 용어·기관명 영문 괄호 병기: 각 문서에서 외래 전문 용어나 고유명사가 처음 등장할 때 반드시 표준 영어 명칭을 괄호 안에 병기합니다.
  3. 「실물 계약 조항 ↔ TypeScript 모델 ↔ Daml 구문」 3단 연결: 하스켈(Haskell) 계열 함수형 문법의 낯섦을 없애기 위해, 현실 계약서의 날인·의무 조항을 먼저 짚고 익숙한 TypeScript 코드의 한계를 보인 뒤 Daml 템플릿으로 완성합니다.
  4. 버전 비종속성 및 내부 구현 파일 비노출: 독자용 HTML 본문에는 내부 스칼라(Scala) 소스 코드 파일명, 로컬 파일 경로, 라인 번호, 역공학 암시 문구를 일절 노출하지 않습니다. 시대가 지나도 유효한 서브시스템 명칭과 수학적 불변식, 순수 Daml/SQL 원리만 서술합니다.
  5. 명시적 수식 및 상태 전이 정식화: 핵심 보장은 반드시 독립된 수식 카드(.math-card)로 정식화합니다.
  6. 뉴트로 1960~80년대 미국 추상 스팟 만화 & 프롬프트 슬롯: 75% 여백의 빈티지 뉴스프린트 위에 투박한 흑색 딥펜 선과 거친 회색 망점(Zip-A-Tone)으로 그린 추상 스팟 만화를 삽입하고, 바로 아래 접이식 드로어에 프롬프트 원문을 수록합니다.
  7. HTML 본문 내 마크다운 문법(**강조** 등) 직접 노출 절대 금지: 독자용 HTML 본문에서는 반드시 <strong> 등의 정규 HTML 태그만을 사용해야 하며, 문장 내에 원시 마크다운 별표 기호가 리터럴로 렌더링되어서는 안 됩니다.
  8. 비즈니스 표준 용어 준수: 컴파일러 AST 및 문법 변환 서술 시 기계적 직역 표현은 일절 금지하며, 업계 표준 소프트웨어 공학 및 비즈니스 용어인 '구문 전개(디슈거링, Desugaring)'로 통일합니다.
  9. 연결어미 뒤 쉼표: 영어 For A, B를 ~려면, ~한다로 옮기지 않습니다. 짧은 조건·이유 절 뒤에는 쉼표를 두지 않고, 이웃한 두 문장이 같은 연결어미로 시작하면 둘째 문장의 뼈대를 바꿉니다. 절이 길거나 주어가 바뀌면 쉼표를 남기거나 문장을 나눕니다. 사실, 수치, 고유명사, 합니다체, 첫 영어 병기는 유지합니다.

3. 정규 챕터 6단계 골격 및 제6부 패턴 표준

본편(Ch 01~26): 1단계(메타 헤더 5%) → 2단계(실물 균열 훅 & 스팟 삽화 #1, 15%) → 3단계(수학적·구조적 문제 정식화, 20%) → 4단계(TypeScript 대조 기반 Daml/Canton 핵심 메커니즘 & 스팟 삽화 #2, 35%) → 5단계(제도권 현실 적용 & 시그니처 콜아웃, 15%) → 6단계(핵심 불변식 체크리스트 & 다음 장 교량, 10%). 제6부 Daml 설계 패턴(Ch 27~34): 각 패턴마다 문제 → 당사자와 권한 → 계약 설계 → 코드(Daml + Script 테스트) → 상태 전이 → 실패 양상 → 변형과 조합(→ 규제 대응, 선택) 순서를 따릅니다.

4. 기준 버전 · 글로벌 독자 · 문체 규칙

이 책의 기준 버전

Canton 3.7.3(안정 프로토콜 버전 36·37), Daml SDK 3.7 계열, 패키지 매니저 dpm. 버전은 표지와 이 가이드에서만 한 번 밝히고, 본문·제목·캡션에는 규격식 버전 표기를 쓰지 않습니다. 코드 예제의 SDK 버전 값은 그대로 두고 "본서 기준 버전 — 머리말 참조" 주석을 붙입니다.

  • 사실 근거: 프로토콜 동작·기본값·오류 코드·수식은 기준 버전의 Canton·Splice 소스와 일치해야 합니다. 설명용 모형과 예시 수치는 그렇다고 밝힙니다.
  • 글로벌 독자: 특정 국가를 기준으로 서술하지 않습니다. 사례는 국가 중립적으로 쓰거나 국제 금융 맥락(미국·영국·EU 등)을 씁니다. 금액은 USD/EUR/GBP, 시각은 UTC로 적고, 글로벌 독자가 알기 어려운 생활 소재는 쓰지 않습니다.
  • 문체: 제6부와 특별 부록은 엔지니어링 레퍼런스 문체를 씁니다. 은유는 문단 안 한 문장까지만 허용하고 제목·절 이름·캡션·코드 식별자에는 쓰지 않습니다.
  • 자동 점검: python3 scripts/check_book.py가 버전 표기, 국가 특정 표현, 문체 어휘, 알려진 오류 문구, 태그 균형, KaTeX 컴파일을 검사합니다. 원고를 고친 뒤 항상 실행합니다.