문서 제목을 입력한다

문서 가이드: 예시 작성 규칙

• 예시는 반드시 구체 상황(컴포넌트명, 모듈명, 실패 조건)을 포함한다.
• 개념 설명만 쓰지 말고 before/after 코드 또는 최소 실행 코드 조각을 함께 넣는다.
• 테스트 가능한 항목이면 테스트 코드 예시(mock/spy/assert)를 같이 넣는다.
• 관련된 기존 문서가 있으면 문서 링크를 연결해 학습 경로를 만든다.
• 모든 문서에는 `Q` 섹션을 두고, 대화에서 나온 질문뿐 아니라 새로운 개발 지식과 시니어 관점 포인트를 반드시 추가한다.
• 사용자와 주고받은 문답은 생략하지 말고 핵심 문맥/조건/예외까지 구체적으로 모두 포함한다.
• Q/A는 요약만 두지 말고, 혼동이 컸던 문답은 원문형에 가깝게 재구성해 추론 과정을 보존한다.
• 가독성을 위해 주제별 FAQ, 결론, 예시 코드, 체크리스트를 분리해 배치한다.
• Q/A 섹션은 기본을 카드형 레이아웃으로 작성한다(데스크탑 2열, 모바일 1열).
• 각 카드에는 `Q`와 `A`를 시각적으로 분리해 빠르게 스캔 가능하게 구성한다.
• 프로젝트 코드 작업 문서에는 모든 Swift 파일의 설명 주석 유지 규칙을 명시한다.
• 함수/로직 흐름 주석 표기 규칙은 //1., //2., //3. 형식으로 통일한다고 명시한다.
• 신규 파일 추가/기존 파일 수정 시에도 동일 주석 규칙을 반드시 적용한다고 명시한다.
• 시퀀스 다이어그램은 Mermaid로 작성하고, 독자가 크게 볼 수 있도록 확대 버튼(전체화면 또는 모달)을 반드시 제공한다.

Flowchart