# 인수인계 문서 인덱스 > 작성일: 2026-05-06 > 대상: 후임 AI 엔지니어 또는 개발 관리자 > 작업 브랜치: `hotfix/dev_yscha` --- ## 0. 이 폴더는 뭔가요? Qcast Front 프로젝트의 **트랙별 인수인계 문서**가 모여 있습니다. 한 파일에 다 넣으면 너무 길어지고 영역이 섞여서 보기 어렵기 때문에 4개 트랙으로 분리했습니다. **읽는 순서**: 위에서부터 차례로 읽으면 됩니다. SK 라인 트랙이 가장 위험하고 우선순위가 높습니다. --- ## 1. 트랙별 문서 ### [SK_MOVEMENT_HANDOVER.md](./SK_MOVEMENT_HANDOVER.md) ★ 최우선 **Straight Skeleton 라인 이동 트랙.** 지붕 외곽선을 움직였을 때 내부 선이 깨지는 문제를 어떻게 풀어왔는지 정리. 이 프로젝트에서 가장 위험하고 손대기 까다로운 영역. **반드시 가장 먼저 읽으세요.** 핵심 키워드: 외벽선 / 처마선 / 내부선 / SK 알고리즘 / 오버 이동 / clamp 정책 / 골짜기 판정 / phantom ridge / hip vs ridge --- ### [UI_MODAL_HANDOVER.md](./UI_MODAL_HANDOVER.md) **모달 / 다이얼로그 / 라인 표시 트랙.** 계산기 패드 토글 추가, 외벽선/평면도 확정 다이얼로그, 라인 라벨/색/인덱스 표시 정돈. 핵심 키워드: 계산기 토글 / 補助線 / 確定 다이얼로그 / Enter 키 / 라인 라벨 / 디버그 라벨 인라인 --- ### [API_STABILITY_HANDOVER.md](./API_STABILITY_HANDOVER.md) **백엔드 API 안정화 / 인증 / 세션 / 로컬 개발 환경 트랙.** 동시 UPDATE 데드락 방어, 에러 저장, 재시도, stale closure, 자동 로그인/로그아웃 추적, dev 스크립트. 핵심 키워드: abort+latest / X-Idempotency-Key / 직렬화 / errSave / 10회 재시도 / Recoil stale closure / 자동 로그인 추적 / dev:local-api --- ### [MODULE_CIRCUIT_HANDOVER.md](./MODULE_CIRCUIT_HANDOVER.md) **모듈 / 배치 / 회로 / 처마 / 가대 / 티켓 시리즈 트랙.** 태양광 모듈 배치, PCS·접속함 회로, 처마 커버, 가대 표시 등의 도메인 특화 작업과 [1xxx] 티켓 시리즈. 핵심 키워드: PCS / 접속함 / Cross Mix / 모듈 배치 / 거치대 / 처마 커버 / 팔작지붕 / 사의 각도 / [1xxx] 티켓 --- ## 2. 같이 봐야 하는 자료 ### 메모리 인덱스 - 위치: `~/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-front/memory/MEMORY.md` - 모든 정책 결정·임계값·"왜 이렇게 했는지" 가 항목별로 들어 있습니다. - **작업 시작 전에 반드시 한 번 통독하세요.** ### 기존 문서 (참고 자료) - `docs/Qcast coding convention.pdf` - `docs/Qcast development guilde.pdf` - `docs/git commit message Convention.pdf` - `docs/메세지 처리 가이드.pdf` - `docs/Canvas Status.md` - `docs/dictionary.txt` - `docs/2025-02-XX_Qcell_회의.txt` (회의록 시리즈) --- ## 3. 인수받은 직후 추천 절차 1. **이 인덱스 통독** (5분). 2. **메모리 `MEMORY.md` 인덱스 통독** — 9개 원칙 + 각 트랙 메모리 항목 (10~15분). 3. **`SK_MOVEMENT_HANDOVER.md` 통독** — 가장 위험한 영역 먼저 (30~60분). 4. 나머지 3개 트랙 문서는 **필요할 때 펼쳐 보는 레퍼런스** 로 사용. 5. **회귀 체크리스트** (`SK_MOVEMENT_HANDOVER.md §8.10`) 5 시나리오 직접 실행해 현재 동작 확인. --- ## 4. 핵심 원칙 3줄 요약 이 프로젝트에서 일을 한다면 적어도 이 3개는 머리에 두세요. (자세한 9개 원칙은 `SK_MOVEMENT_HANDOVER.md §6` 참조) 1. **잘 되는 코드는 건들지 말 것.** 새 함수로 추가하세요. 2. **오버 이동은 평행 위치까지만** (clamp 정책). 3. **사용자가 추가한 라인은 절대 사라지지 않게** 하세요. --- 끝.