@simplysm/sd-claude 14.0.94 → 14.0.96

package/claude/skills/sd-spec/references/format-design.md

@@ -1,248 +0,0 @@
-# sd-spec 설계 작성법 (§4·§5·§6)
-
-설계 배치(`workflow-design.js`)와 부분 수정(§4~6 편집)이 따르는 §별 작성법.
-
-- **입력**: spec.md 의 확정된 §1~3 (설계는 이 분석 결과에서 §4~6 을 도출).
-- **§7·§8·§9 작성법**(설계가 보강할 때)은 `format-analyze.md` 참조.
-- **공유 형식**(섹션 구조·신뢰도 표기·본문 내 참조·sub-section 헤더 레벨)·**골격**·**§10** 은 `SKILL.md` 참조.
-
-## §4 화면
-
-**작성 단위**: §4.x 1개당 "§4.x 표준 구조" 절의 단위로 위→아래 순서로 작성:
-
-1. 기능 개요.
-2. 와이어프레임.
-3. 항목 — 다단으로 분할:
-   - 1차 분할: 영역 (좌/우 등) 단위 — 와이어프레임의 영역 라벨 기준.
-   - 2차 분할: 영역 내부의 하위 요소 (필터·시트 컬럼·입력 폼·상세 폼) 단위.
-   - 작성 단위 = (영역, 하위 요소) 쌍 — 예: `좌측 영역 — 필터`, `좌측 영역 — 시트 컬럼` 은 별건.
-4. 동작.
-5. 시각 규칙 (해당 시).
-6. 도메인 규칙·로직 (해당 시) — 규칙별.
-7. 자유 추가 sub-section (해당 시) — sub-section 별 (예: 업로드 양식·다운로드 양식 각각). 복잡 양식 내부의 sub-단위 (시트 등) 는 sub-단위별.
-
-(헤더 인덱스 = Actor + 관련 섹션 으로 구성되며, 둘 다 자동 누적 — 별도 작성 단위 아님).
-
-신규 작성·정정·골격 신설 어느 경우든 동일하게 적용.
-
-**모범** (와이어 패턴별):
-
-- 시트 화면: example-spec.md §4.1·§4.2·§4.4.
-- PDA: §4.3.
-- 폼 모달: §4.1·§4.2 의 중첩 "등록·편집 (모달)" sub-section.
-
-### 설계 분할 절차 (§4/§5/§6 공통)
-
-설계 배치에서 §4/§5/§6 헤더를 §2/§3 본문 (+ §8 마스터 엔티티) 에서 도출. 절차:
-
-1. **§4 화면 도출**:
-   - §2 BPMN 의 최종 사용자 액션 노드 + §3 의 사용자 직접 요구 → 트랜잭션 화면 또는 조회 화면.
-   - §8 의 마스터 엔티티 → 마스터 화면.
-   - 도메인 묶음 또는 장치별로 그룹화 → 화면 목록 표.
-2. **§5 자동 처리 도출** — §2/§3 의 시스템 백그라운드 처리 (스케줄·이벤트 트리거·외부 자료 수집·적재) 를 추출.
-3. **§6 공통·기반 기능 도출** — §4 화면·§5 자동 처리에 속하지 않는 모든 개발 단위를 추출: 부수효과로 발동되는 동작 + 앱 전역 정적 골격(앱 구조[메뉴·권한·모듈]·로깅·부트스트랩 초기화). §3 의 "시스템 기반" 류 요구가 주 도출원. 프레임워크 기본 기능(매뉴얼 존재)은 매뉴얼 참조로, 앱 고유 부수효과는 인라인으로 명세.
-
-워크플로 reduce 단계가 화면 목록 표·모달/시트 재활용 교차참조를 정합. 도출 근거가 없는 항목은 [OPEN].
-
-### 화면 목록 표 (§4 첫머리)
-
-5컬럼 구조: `§ | 분류 | 화면 | 유형 | 장치`.
-
-- 분류: 도메인 묶음·메뉴 그룹의 자유 명칭 (예: `기준정보`·`입고`·`재고`).
-- 유형: 마스터 / 트랜잭션 / 조회 중 택1.
-- 장치: PC / PDA / 기타 중 택1.
-- 화면이 추가·제거되면 표도 함께 갱신. 같은 분류끼리 인접 배치.
-
-### 화면 정의 (§4.x 표준 구조)
-
-화면 헤더에 (장치) 표기를 유지: `### N.N 화면명 (PC)` 또는 `(PDA)`.
-
-sub-section 헤더 레벨은 `## spec.md 형식` 의 "sub-section 헤더 레벨" 표 참조.
-
-**평문 sub-section** (§4.x 헤더 바로 아래에 위→아래 순서로 작성):
-
-- **헤더 인덱스** (한 줄씩 작성, 자동 누적 — 별도 작성 단위 아님):
-  - `Actor: <역할>` — §2 BPMN 의 swim lane 또는 §3 의 사용자 직접 요구에서 자연 도출.
-  - `관련 섹션:` "본문 내 참조" 절 룰 따름 — 모달 호출·시트 영역 재활용 등 화면 간 의존 포함.
-- **기능 개요**: `기능 개요:` 라벨 다음에 bullet 로 화면 기능을 설명.
-
-**h4 sub-section** (평문 아래, 고정 순서, 위→아래):
-
-#### 와이어프레임 (텍스트)
-
-**형식 일탈 금지**:
-
-- example-spec.md 의 가장 가까운 화면 패턴 라인을 형식 모범으로 직접 참조(매핑은 본 §4 작성법 첫머리 "모범 (와이어 패턴별)" 참조).
-- ASCII 박스 (┌─┐ │ └┘) ·영역 추상화 표기 (`<필터>`·`<시트>`·`<폼>` 등) ·액션 버튼 텍스트 표기를 임의로 변형 금지.
-
-**원칙**: 영역 배치·구획만 표현. 디테일 (필드·시트 컬럼·실제 값·아이콘 placeholder·fixed 경계·비활성 행 등 시각 표현) 은 와이어에 두지 않음 — 항목 표·동작 절·도메인 규칙 절이 단일 출처.
-
-- 데이터 영역: 영역 타입 + 짧은 라벨로 추상화 — `<필터>`·`<폼>`·`<시트>`·`<목록>`·`<PO 목록>`·`<라인 시트 - 작성영역>` 등. 영역 종류가 한눈에 잡히지 않으면 라벨을 보강.
-- 액션 버튼: 텍스트를 유지 (`[조회]`·`[저장]`·`[등록]`) — 버튼 위치 자체가 와이어가 전달하는 정보. 아이콘만 있는 버튼도 텍스트로 표기.
-- 영역 (좌/우 분할·탭·상단 command 바·시트 상단 버튼바) 으로 나뉠 경우 박스 라인으로 구획.
-- 상태 (작성중·확정 등) 에 따라 영역 구획이 크게 달라지면 상태별로 분리. 제목 형식: `와이어프레임 (<상태명>):` (예: `와이어프레임 (확정 전):`).
-
-#### 항목
-
-데이터 항목만 작성 (필터·시트 컬럼·입력 폼·상세 폼). 액션 버튼은 "동작" 절에 작성.
-
-- **표 제목 = 와이어의 영역 라벨과 동일 명칭** 을 굵게 표기 — 와이어의 `<필터>` → `**필터**`, `<품목 목록 시트>` → `**품목 목록 시트**`, `<스캔 입력 폼>` → `**스캔 입력 폼**`.
-- 한 영역에 종류가 다른 표가 여러 개 있을 경우 종류를 부기 — `**<영역 라벨> — <필터|시트 컬럼|입력 폼>**` (예: `**헤더 목록 — 필터**`, `**BOA 시트 — 시트 컬럼**`).
-- 시트 화면의 기본 구성: 상단 command 바의 `<필터>` + 시트 영역 (시트 컬럼) 총 2 그룹.
-
-**표 형식** — 도메인 매핑은 별도 컬럼으로 (필터는 시트 컬럼과 중복되므로 도메인 매핑 컬럼 없음):
-
-- 입력 폼: `항목 | 종류 | 필수 | 도메인 매핑 | 비고`.
-- 시트 컬럼: `컬럼 | 종류 | 필수 | 도메인 매핑 | 비고`.
-- 필터: `항목 | 종류 | 필수 | 비고`.
-
-- 필수 컬럼: 의미가 없는 경우 (조회 시트 컬럼 등) 는 `-`.
-- 도메인 매핑: `[모델.X.Y]` 형식 (양식 매핑과 일관). 매핑이 없는 항목 (선택 체크박스 등) 은 `-`.
-- 비고: 표시 내용 (이름과 도메인만으로 자명하지 않을 때 어떤 값이 표시되는지) / 편집 방법 (편집 가능 항목 — 예: 클릭 시 모달, 인라인 편집) / 비자명 항목의 근거 (`(근거: 출처)`) / 기타 자유 설명.
-
-**시트 컬럼 그룹핑** (해당 시): 컬럼들이 도메인적으로 묶일 경우 표 안에 그룹 표시.
-
-- 그룹 헤더 행을 1줄 (`**그룹명**` 표시, 다른 셀은 빈 칸).
-- 자식 컬럼은 `└ ` 들여쓰기 prefix 부착.
-- 표의 컬럼 수는 유지.
-
-#### 동작
-
-bullet 을 `- <트리거>: 처리 내용` 형식으로 작성.
-
-- 트리거 예시: `` `[버튼]` 클릭 ``, `박스 바코드 스캔`, `Enter 키`.
-- 처리 내용: 동사구 + 대상 (예: `[화면.X] 을 모달로 띄움`, `검색 필터 조건으로 목록 갱신`).
-
-#### 시각 규칙 (해당 시)
-
-행 단위·조건부 시각 표현 (비활성 행 취소선·상태별 강조 색·아이콘 등) 을 작성. 컬럼 단위 표현은 항목 표의 비고에 작성하므로 여기에는 작성하지 않음.
-
-#### 도메인 규칙·로직 (해당 시)
-
-표준 sub-section 으로 담기지 않는, 화면 고유의 도메인 요구를 작성. 자유 명칭의 절을 필요한 만큼 추가. 누락 없이 적는 것이 핵심.
-
-**자유 추가 sub-section** (`#### 도메인 규칙·로직` 아래, 화면별 필요 시 h4 자유 추가):
-
-- **양식 입출력** (예: `#### 업로드 양식`·`#### 다운로드 양식`) — 양식별로 별도 sub-section 작성.
-  - 단순 양식: 내부에 단순 표 — 컬럼은 `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`. §7.x 에 명세된 양식이면 컬럼명을 일치시키고, 일회성 양식이면 sub-section 내부에서 직접 명세.
-  - 복잡 양식 (다중 시트·구조 분할): 내부의 sub-단위 (시트 등) 는 h5 (`##### <시트>` 등) 로 작성. sub-단위 내부에 진행 방법 NOTE 작성 가능 (`## spec.md 형식` 의 "진행 방법 누적" 절 참조).
-- **기타 화면 고유 정보** — sub-section 이름은 자유. 표준 sub-section 으로 담기지 않는 화면 고유 정보의 누락 방지 목적.
-
-### 마스터 화면 표준
-
-화면 목록 표에서 유형이 "마스터" 인 §4.x 에 적용. 화면 정의 sub-header (와이어프레임·항목·동작) 와 함께 작성.
-
-- ID 컬럼은 편집 버튼 (`[E N]`) 으로 표현.
-- 첫 컬럼은 선택 체크박스 (`[ ]`).
-- 시트 상단 버튼바: `[등록] [선택 삭제] [선택 복구] [엑셀 업로드] [엑셀 다운로드]`.
-- ID 정렬은 역방향 (내림차순).
-
-### 상단 command 바
-
-화면 정의 sub-header 의 와이어프레임·동작과 함께 작성. 페이지 제목 바로 아래, 시트·폼 영역 위에 배치. 페이지 전체 또는 현재 레코드 단위의 액션 바.
-
-- 좌측: 필터 입력 + 조회 (list 화면) / 진입 컨텍스트 표시 (detail 화면).
-- 우측: 페이지 단위·레코드 단위 액션 (있는 경우에만).
-- 좌·우 사이에 `│` 세로 구분선.
-
-**우측 버튼 그룹 순서** (좌→우):
-
-1. 기본 CRUD (저장 / 삭제 / 복구).
-2. 워크플로 상태 전환 (확정 / 취소 / 승인 / 반려).
-3. 유틸리티 (원본 다운로드 / 프린트 / PDF).
-
-list 화면과 detail 화면 모두 동일. 새 버튼은 해당 그룹의 끝에 추가. 시트 상단 버튼바도 동일한 그룹 순서를 따름 (마스터 화면 표준은 그 구체 인스턴스).
-
-### 모달 처리
-
-호출하는 쪽 §4.x 의 동작 sub-header 와 호출되는 쪽 §4.x 양쪽 모두에 적용.
-
-- 모달 화면도 별도의 §4.x. 호출하는 쪽의 동작에 "→ [화면.X] 을 모달로 띄움" 을 명시.
-- 화면명에 "(모달)" 등의 사용 맥락 표기 금지 — 같은 화면이 다른 곳에서는 다른 방식으로 호출될 수 있음.
-- 화면의 일부 영역 (시트·탭) 이 다른 화면에서 모달로 재활용되는 경우, 별도 §4.x 로 분리하지 않음. 대신 그 화면의 동작 절 끝에 "영역별로 모달 호출 시 제약" (편집 가능 여부 / 선택 전용 / multiselect) 을 한 줄씩 명시. 호출하는 쪽의 동작은 "→ [화면.X] 의 <영역> 을 모달로 띄움" 으로 표기.
-
-## §5 자동 처리
-
-**작성 단위**: §5.x 1개당 위→아래 순서로:
-
-1. 목적 / 트리거 (한 묶음).
-2. 처리.
-3. 예외 처리.
-4. 자유 추가 sub-section (해당 시) — sub-section 별 (예: 읽기 양식·쓰기 양식 각각). 복잡 양식 내부의 sub-단위 (시트 등) 는 sub-단위별.
-
-**모범**: example-spec.md §5.1.
-
-### 정의
-
-스케줄러 또는 이벤트 트리거로 동작하는 시스템 백그라운드 처리. 표준 프로토콜·채널을 통한 외부 자료 수집·적재 (메일 폴링 + 첨부 적재, FTP 자료 수집 등) 도 §5 에 포함 — 시스템별 협상이 필요 없는 표준 인터페이싱은 §9 가 아님.
-
-§6 공통·기반 기능과의 차이: §5 = 스케줄·이벤트로 명시적인 트리거가 있음. §6 = 명시적 트리거가 없는 것 (부수효과로 발동되거나 전역에 상시 구성되는 것).
-
-### 본문 구조
-
-sub-section 헤더 레벨은 `## spec.md 형식` 의 "sub-section 헤더 레벨" 표 참조.
-
-**평문 sub-section** (§5.x 헤더 바로 아래에 "라벨 + 본문" 형식으로 작성):
-
-- `목적:` 도메인 목적을 한 줄로.
-- `트리거:` 스케줄·이벤트 명시.
-- `관련 섹션:` "본문 내 참조" 절 룰 따름.
-
-**h4 sub-section** (평문 아래에 고정 순서로 위→아래 작성):
-
-#### 처리
-
-처리 단계 작성.
-
-#### 예외 처리
-
-실패 케이스별 위험·대처·재시도 한계 작성.
-
-**자유 추가 sub-section** (`#### 예외 처리` 아래에, §5.x 별로 필요 시 h4 자유 추가):
-
-- **양식 입출력** (예: `#### 읽기 양식`·`#### 쓰기 양식`) — §4 의 "양식 입출력" sub-section 룰과 동일. 방향은 읽기·쓰기. 일회성 양식이면 sub-section 안에서 직접 명세.
-- **기타 자동 처리 고유 정보** — sub-section 이름은 자유.
-
-## §6 공통·기반 기능
-
-화면(§4)도 명시적 트리거 자동 처리(§5)도 아닌, 시스템을 떠받치는 공통·기반 개발 단위 전부 (캐치올). §4·§5 에 속하지 않는 개발 entry 는 전부 여기로 모임 — 갈 곳 없는 항목을 §7(공통 정의) 등 명세 섹션으로 올리지 말 것.
-
-포괄 대상 (두 성격이 한 섹션에 섞임. 항목을 어느 한쪽으로 미리 분류하지 않음 — 애매하거나 두 성격을 겸하는 항목도 그대로 수용):
-
-- 부수효과로 발동되는 동작 — DataLog 기록·권한 체크·캐시 무효화·알림 발송·감사 로그.
-- 전역에 상시 구성되는 정적 골격 — 앱 구조(메뉴·권한·모듈)·로깅 정책·부트스트랩 초기화.
-
-**작성 단위**: §6.x 1개당 위→아래 순서로:
-
-1. 목적 / 트리거·적용 범위 (한 묶음).
-2. 참조 매뉴얼 (프레임워크 기본 기능) 또는 본문 자유 서술 (bespoke).
-3. 자유 추가 sub-section (bespoke 가 실제로 요구할 때만) — sub-section 별.
-
-**모범**: example-spec.md §6.1·§6.2.
-
-### 정의
-
-§4 화면·§5 자동 처리에 속하지 않는 모든 개발 단위. §3 기타 요구사항의 시스템 전반 자동 룰을 설계 차원에서 풀이하는 것도 포함. 부수효과로 발동되는 동작과 전역 상시 골격을 모두 포괄하되, 두 성격이 한 항목에 섞일 수 있으므로 미리 가르지 않음.
-
-§5 자동 처리와의 차이: §5 = 스케줄·이벤트로 명시적 트리거 (예: 매일 자정·메일 도착). §6 = 명시적 트리거가 없는 것 — 부수효과로 발동되거나 전역에 상시 존재.
-
-### 본문 구조
-
-§6 은 항목 성격이 제각각인 캐치올이라 §4/§5 같은 고정 sub-section 구조가 없음. 항목은 두 갈래로 작성:
-
-- **프레임워크 기본 기능** (앱 구조·로깅·부트스트랩·데이터 변경 이력 등 — 매뉴얼이 존재) → 매뉴얼 참조 stub. 평문 라벨 + `참조 매뉴얼:` 한 줄. 처리·구성·예외 detail 은 매뉴얼로 위임하고 spec 에 적지 않음.
-- **bespoke** (앱 고유 부수효과 — 매뉴얼 없음) → 평문 라벨 + 본문 한두 줄 자유 서술.
-
-sub-section 헤더 레벨은 `## spec.md 형식` 의 "sub-section 헤더 레벨" 표 참조.
-
-**평문 sub-section** (§6.x 헤더 바로 아래에 "라벨 + 본문" 형식, 위→아래):
-
-- `목적:` 도메인 목적 (필수).
-- `트리거·적용 범위:` (해당 시) 어떤 동작의 부수로 발동되는지 / 어디에 상시 적용되는지 + 적용 시점. (예: "모든 엔티티 update 시 / 전체", "앱 부팅 시 / 전체 클라이언트").
-- `관련 섹션:` "본문 내 참조" 절 룰 따름.
-- `참조 매뉴얼:` (프레임워크 기본 기능인 경우) 구현 매뉴얼 파일명 (`.claude/references/sd-simplysm14/manuals/` 기준). 이 줄이 있으면 처리·구성·예외 detail 은 적지 않음.
-
-**본문** (bespoke 항목만, 평문 아래에 작성):
-
-- 설계 내용을 한두 줄로 자유 서술 — 설계 고도까지만 (구현 디테일은 sd-impl).
-- 처리 절차·모델 매핑·예외 처리 같은 고정 sub-section 은 두지 않음. 양식·매핑 등 정말 필요한 정보만 h4 자유 추가 (이름 자유).