qcast-front/docs/HANDOVER_INDEX.md

3.7 KiB

인수인계 문서 인덱스

작성일: 2026-05-06 대상: 후임 AI 엔지니어 또는 개발 관리자 작업 브랜치: hotfix/dev_yscha


0. 이 폴더는 뭔가요?

Qcast Front 프로젝트의 트랙별 인수인계 문서가 모여 있습니다. 한 파일에 다 넣으면 너무 길어지고 영역이 섞여서 보기 어렵기 때문에 4개 트랙으로 분리했습니다.

읽는 순서: 위에서부터 차례로 읽으면 됩니다. SK 라인 트랙이 가장 위험하고 우선순위가 높습니다.


1. 트랙별 문서

SK_MOVEMENT_HANDOVER.md ★ 최우선

Straight Skeleton 라인 이동 트랙. 지붕 외곽선을 움직였을 때 내부 선이 깨지는 문제를 어떻게 풀어왔는지 정리. 이 프로젝트에서 가장 위험하고 손대기 까다로운 영역. 반드시 가장 먼저 읽으세요.

핵심 키워드: 외벽선 / 처마선 / 내부선 / SK 알고리즘 / 오버 이동 / clamp 정책 / 골짜기 판정 / phantom ridge / hip vs ridge


UI_MODAL_HANDOVER.md

모달 / 다이얼로그 / 라인 표시 트랙. 계산기 패드 토글 추가, 외벽선/평면도 확정 다이얼로그, 라인 라벨/색/인덱스 표시 정돈.

핵심 키워드: 계산기 토글 / 補助線 / 確定 다이얼로그 / Enter 키 / 라인 라벨 / 디버그 라벨 인라인


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

모듈 / 배치 / 회로 / 처마 / 가대 / 티켓 시리즈 트랙. 태양광 모듈 배치, 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. 사용자가 추가한 라인은 절대 사라지지 않게 하세요.

끝.