WI-...-028~033 에 대응하는 FE-OC-027~032 owner 노트.
- 각 노트의 제외 범위에 'use case·domain model·business rule' 을 명시해
이 skeleton 이 port 와 adapter 계약까지임을 못박았다
- 근거 절에 '근거 등급 경계' 문단을 넣어 project-local default 와
외부 근거를 구분했다 (수집은 FE-Q-011~014 가 소유)
- 구현 가이드 절은 비워 두고 사유를 남겼다 — 근거 raw 없이 채우면
모든 cell 이 UNSUPPORTED_IMPL_DECISION 이 된다
- multi-protocol 노트는 '신규 port 0개' 를 제외 범위에 명시했다.
port 가 늘어나면 그 자체가 회귀 신호다
- WI-...-028~033 과 §20 branch 행. P4 = P1~P3 완료 후 착수하는 opt-in
capability 계층이며 미완이어도 MERGE_READY 는 FE-GATE-033 으로 성립
- §21 가져온 계약 표와 frontmatter imports 에 FE-OC-027~032 추가.
기존 FE-OC-002~025 와 같은 branch-owned 계약이므로 같은 규칙을 적용했다
(설계문서 §12.1 은 제외로 적었으나 일관성상 포함이 옳다)
- §23.1 체크리스트 8->9 registry, runbook 5->7종
- project_revision 2, last_reviewed 2026-07-28
- §0.5 out of scope 에 '6개 도메인의 use case/domain model/business rule'
을 명시. 이 skeleton 은 port 와 adapter 계약까지다.
- FE-RB-006 실시간 연결 장애 — 상한 소진 후 terminal 전이가 유지되는지
먼저 확인하고 backend 에 무제한 재시도를 보내지 않는다
- FE-RB-007 백그라운드 실행 장애 — skipWaiting 임의 강제 금지,
중복 write 방지가 지연 전송보다 우선
- FE-Q-009(service worker 필요한가)는 FE-D034 로 해소
capability 가 OFF 인 프로젝트에서 gate 를 PASS 라 하면 거짓말이고 FAIL
이라 하면 영원히 배포할 수 없다. NOT_APPLICABLE 을 도입하되 FE-GATE-033
이 번들 부재를 증명했을 때만 유효하게 묶었다.
FE-GATE-033 자신은 NOT_APPLICABLE 을 취할 수 없다 — capability 를 하나도
쓰지 않는 프로젝트도 '쓰지 않는다'를 증명해야 한다.
- 실시간은 reconnecting 과 disconnected 를 구분해야 한다. 전자를 terminal
로 보이면 불필요한 새로고침, 후자를 refreshing 으로 보이면 오지 않는
데이터를 기다린다.
- FILE_PICKER_DISMISSED 는 사용자 취소이므로 error surface 없음.
- sw-update-pending 은 자동 skipWaiting 금지 — 열린 탭이 release 를
갈아타면 FE-OC-016 coherence 가 깨진다.
- FE-NFR-020 은 capability 를 끄고도 번들이 늘어나는 경우를 막는다.
- §5.11 capability registry — envFlagKey 는 FE-REG-ENV 행 포인터이며
키의 타입·검증은 env registry 가 계속 소유(재진술 금지)
- FE-REG-API 에 protocol/transferMode/operationRef/eventSchema/
resumeStrategy. 실시간 구독은 별도 장부가 아니라 stream operation 이다.
stream 행의 timeoutMs 는 연결 수립 timeout 이지 스트림 수명이 아니다
- FE-REG-STORAGE 에 opfs/cacheStorage backend, payloadClass, evictionOrder.
UPLOAD_PART_STATE 는 correctness 값이라 quota fallback 없음
- error kind 26종. TRANSFER_ABORTED/SUBSCRIPTION_LEAKED/SW_UPDATE_PENDING
은 각각 기존 kind 재사용/gate 결함/surface state 라 제외
- 멀티프로토콜은 기존 ResourceQueryPort/ResourceCommandPort 를 재사용해
신규 port 0개. 프로토콜은 registry 데이터이지 타입이 아니다.
- Image CDN 은 I-O 가 없으므로 adapter 가 아니라 application 정책.
- boot 에 capability 해석 단계 삽입 — 실패하지 않고, 비활성 adapter 는
정적 import 하지 않는다(FE-NFR-020 방어).
- worker/SW 엔트리는 별도 실행 컨텍스트라 상위 layer 를 import 하지 않는다.
DongHyeonka