Parnas 1972 정독 — 모듈을 나누는 기준

// ⚠️ 이 두 개가 "시스템 레벨 결정"이고, 네 모듈이 전부 안다.
var core: [UInt32] = []      // 문자를 한 워드에 4개씩 packing
var lineIndex: [Int] = []    // 각 줄의 시작 주소
var shiftIndex: [(line: Int, start: Int)] = []

enum Input {                                   // 모듈 1
    static func read(_ path: String) {
        for (i, ch) in bytes(of: path).enumerated() {
            let w = i / 4, slot = i % 4        // ← packing 규칙 ①
            core[w] |= UInt32(ch) << (24 - 8 * slot)
        }
    }
}

enum CircularShift {                           // 모듈 2
    static func setup() {
        for line in lineIndex.indices {
            var p = lineIndex[line]
            while p < end(of: line) {
                let byte = (core[p / 4] >> (24 - 8 * (p % 4))) & 0xFF   // ← packing 규칙 ②
                if byte == wordEndMarker { shiftIndex.append((line, p + 1)) }
                p += 1
            }
        }
    }
}

enum Alphabetizing {                           // 모듈 3
    static func run() {
        shiftIndex.sort { a, b in
            compareChars(at: a.start, and: b.start)   // ← packing 규칙 ③ (비교하려면 문자를 꺼내야 한다)
        }
    }
}

enum Output {                                  // 모듈 4
    static func print() {
        for s in shiftIndex {
            let byte = (core[s.start / 4] >> (24 - 8 * (s.start % 4))) & 0xFF  // ← packing 규칙 ④
            _ = byte
        }
    }
}

enum LineStorage {
    // 🔒 비밀: 줄을 어떻게 담아 두는지. 바깥에서 볼 수 없다.
    private static var core: [UInt32] = []
    private static var lineIndex: [Int] = []

    /// r번째 줄, w번째 단어, c번째 문자
    static func char(_ r: Int, _ w: Int, _ c: Int) -> UInt8 { ... }        // CHAR(r,w,c)
    static func setChar(_ r: Int, _ w: Int, _ c: Int, _ d: UInt8) { ... }  // SETCHAR(r,w,c,d)
    static func words(_ r: Int) -> Int { ... }                             // WORDS(r)

    // 논문이 명시한 추가 함수들
    static func lines() -> Int { ... }              // 현재 저장된 줄 수
    static func chars(_ r: Int, _ w: Int) -> Int { ... }  // 단어의 문자 수
    static func delLine(_ r: Int) { ... }           // DELINE
    static func delWord(_ r: Int, _ w: Int) { ... } // DELWRD
}

// 모듈 3: Circular Shifter
// 🔒 비밀: 시프트를 미리 다 만들어 두는가, 요청받을 때 계산하는가
enum CircularShifter {
    static func setup()                                            // CSSETUP
    static func char(_ l: Int, _ w: Int, _ c: Int) -> UInt8        // CSCHAR(l,w,c)
    // "모든 줄이 아니라 모든 순환 시프트를 담은 줄 보관소"라는 인상을 만든다
}

// 모듈 4: Alphabetizer
// 🔒 비밀: 한 번에 다 정렬하는가, 필요할 때마다 조금씩 하는가
enum Alphabetizer {
    static func alph()                       // ALPH — 다른 함수보다 먼저 호출되어야 한다
    static func ith(_ i: Int) -> Int         // ITH(i) — 알파벳순 i번째 시프트의 인덱스
}

// 모듈 2: Input · 모듈 5: Output · 모듈 6: Master Control

// (1) i < j 이면 i번 줄의 시프트들이 j번 줄의 시프트들보다 앞에 온다
// (2) 각 줄에서 첫 번째 시프트는 원본 줄이고,
//     두 번째 시프트는 첫 번째를 한 단어 회전시킨 것이다 ...
enum CircularShifter {
    static func setup()
    static func char(_ l: Int, _ w: Int, _ c: Int) -> UInt8
}

// (1) 정의상 존재해야 할 시프트가 표에 전부 있다
// (2) 그중 어떤 것도 두 번 들어가지 않는다
// (3) 시프트로부터 원본 줄을 알아낼 수 있는 함수가 있다
enum CircularShifter {
    static func setup()
    static func char(_ l: Int, _ w: Int, _ c: Int) -> UInt8
    static func originalLine(_ l: Int) -> Int      // ← 순서 약속 대신 이 함수
}

enum CircularShifter {
    static func setup() {
        // 시프트를 만들면서 곧바로 알파벳순으로 넣는다
    }
}

enum Alphabetizer {
    static func alph() { }                    // 할 일이 없다 — 빈 함수
    static func ith(_ i: Int) -> Int { i }    // 인자를 그대로 돌려준다
}
// 바깥 코드는 한 줄도 안 바뀐다. 정렬 비용만 사라진다.

// 예: 주문 시스템
// 1. 결제 PG사              — 바뀔 확률 높음 (계약·수수료)
// 2. 주문 상태 저장 포맷      — 바뀔 확률 높음 (스키마 진화)
// 3. 배송비 계산 규칙         — 바뀔 확률 매우 높음 (프로모션)
// 4. 알림 채널 (푸시/SMS/톡)  — 바뀔 확률 높음
// 5. 주문번호 채번 방식        — 바뀔 확률 중간
// 6. "주문은 결제 후 배송"     — 바뀔 확률 낮음 (도메인 규칙)

OrderValidator  →  PaymentProcessor  →  ShippingCalculator  →  Notifier
//   ↑ 넷 다 Order 구조체의 필드를 직접 읽고 쓴다.
//   → 주문 상태 저장 포맷(결정 2)이 바뀌면 넷 다 바뀐다.
//   → Parnas의 분해 1과 정확히 같은 구조다.

enum OrderStore {          // 🔒 결정 2: 저장 포맷
    static func status(_ id: OrderID) -> OrderStatus
    static func advance(_ id: OrderID, to: OrderStatus) throws
}
enum PaymentGateway {      // 🔒 결정 1: 어느 PG사인가
    static func charge(_ amount: Money, _ method: PayMethod) async throws -> Receipt
}
enum ShippingPolicy {      // 🔒 결정 3: 배송비 규칙
    static func fee(for order: OrderID) -> Money
}
enum Notifier {            // 🔒 결정 4: 어떤 채널로 보내는가
    static func orderPlaced(_ id: OrderID) async
}
// 결정 6(도메인 규칙)은 감출 대상이 아니다 — 안 바뀌니까 드러내는 게 낫다.