qcast-front/.claude/memory/project_low_pitch_warning.md
2026-05-06 16:46:06 +09:00

29 lines
1.7 KiB
Markdown

---
name: 저구배+특정기와 안내 alert
description: 6종 기와(和瓦A/B, 平板瓦C/D, S瓦, セメント瓦) + 寸 2~2.5 미만 저장 시 시공 매뉴얼 안내 alert (OK 만)
type: project
---
저구배(2 ≤ pitch < 2.5 OR 11.31 angle < 14.04°) 에서 6종 기와 사용 저장 직전에 안내 alert 띄움 (OK , 중단 흐름 없음). (도입 커밋 `[TBD-CODE]`)
대상 6종 (`getRoofMaterialList` 응답 기준):
- `ROOF_ID_WA_53A`, `ROOF_ID_WA_53B`
- `ROOF_ID_HIRA_C`, `ROOF_ID_HIRA_D`, `ROOF_ID_HIRA_S`, `ROOF_ID_HIRA_SEME`
트리거 3 곳:
- `PlacementShapeSetting.handleSaveBtn` (배치면 초기설정 저장)
- `useRoofAllocationSetting.handleSave` (屋根面の割り当て)
- `useRoofAllocationSetting.handleSaveContext` (屋根材変更 할당)
판정/confirm 헬퍼: `src/util/roof-pitch-warning.js`
i18n 키: `modal.roof.material.low.pitch.warning`
**Why:** 저구배에서 6종 기와 제품군은 적용 가능한 부속/구조물에 제한이 있어, 사용자에게 시공 매뉴얼 사전 확인을 강제할 필요. 일본어 메시지 "2寸以上2.5寸未満の瓦を使用する場合…" 그대로 번역 사용.
**How to apply:**
- 6종 변경 `LOW_PITCH_RESTRICTED_ROOF_IDS` Set 수정 (3 트리거 핸들러는 수정 불필요)
- 임계값 변경 `PITCH_LOW_INCLUSIVE` / `PITCH_HIGH_EXCLUSIVE` / `ANGLE_*` 상수 수정
- / OR 조건 `roofAngleSet` `'slope'` pitch , `'flat'` 이면 angle 갱신될 있어서. 한쪽만 검사하면 빠뜨림.
- 등록된 지붕재마다 순차 alert. OK 있고 중단 흐름 없음 OK 누르면 저장 진행.
- 세션 캐시 없음, 매번 표시.