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

1.7 KiB

name description type
저구배+특정기와 안내 alert 6종 기와(和瓦A/B, 平板瓦C/D, S瓦, セメント瓦) + 寸 2~2.5 미만 저장 시 시공 매뉴얼 안내 alert (OK 만) project

저구배(2 ≤ pitch < 2.5 寸 OR 11.31 ≤ angle < 14.04°) 에서 6종 기와 사용 시 저장 직전에 안내 alert 띄움 (OK 만, 중단 흐름 없음). (도입 커밋 a5d2964e)

대상 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 누르면 저장 진행.
  • 세션 캐시 없음, 매번 표시.