2.6 KiB
2.6 KiB
컴포넌트 기준
수정 범위
- 확인됨:
apps/sn내부 컴포넌트는 직접 수정 가능하다. 근거:apps/sn/AGENTS.md - 확인됨: 공통 비즈니스 컴포넌트는
packages/common/business_components만 직접 수정 가능하다. 근거:apps/sn/AGENTS.md - 확인됨:
packages/common/components,packages/common/auth,packages/common/network등은 직접 수정하지 않는다. 근거:apps/sn/AGENTS.md
컴포넌트 변경 원칙
- 확인됨:
sn요구사항을 만족하기 위한 최소 범위로 수정한다. 근거:apps/sn/AGENTS.md - 확인됨: 공통 컴포넌트 수정은
sn에 실제로 필요한 범위로 제한한다. 근거:apps/sn/AGENTS.md - 추정: 여러 화면에서 반복되는
sn전용 로직은 먼저apps/sn내부 공통화로 해결하고, 여러 업무 화면에서 공유되는 비즈니스 UI일 때만business_components를 검토하는 것이 안전하다. 근거:apps/sn/AGENTS.md
공통 유틸 재사용 기준
sn프론트엔드의 엑셀 다운로드 기능을 신규 개발하거나 수정할 때는apps/sn/src/shared/util/download-excel-workbook.ts의 재사용을 먼저 검토한다. 근거: 사용자 지시(2026-10-22).- 업무별 데이터 조회·가공·한글 항목 매핑은 각 기능에서 담당하고, 워크북 생성·시트 구성·파일 저장은 공통 유틸을 우선 사용한다. 시트 생성은
buildExcelWorkbook, 브라우저 다운로드는downloadExcelWorkbook을 검토한다. - 기존 다운로드 기능을 관련 없는 작업에서 일괄 전환하지 않는다. 변경 대상 기능의 요구사항과 기존 동작을 확인한 뒤 적용한다.
- 공통 유틸로 요구사항을 충족하기 어려우면 그 사유와 대안을 작업계획에 기록한다. 특수 서식이나 기존 템플릿 등 요구사항에 맞춰 적용 여부를 판단한다.
- 다운로드 대상 데이터의 범위·전체 건수·API 제한과 대량 자료의 서버 생성 기준은 별도로 확인한다. 공통 유틸 사용만으로 데이터 수집 범위가 보장되지는 않는다.
작업카드에 남길 항목
- 확인 필요: 신규 또는 수정 컴포넌트 경로
- 확인 필요: 호출하는 화면 경로
- 확인 필요: props 변경 여부
- 확인 필요: 기존 화면 영향 여부
- 확인 필요: 공통 컴포넌트 수정 필요 여부
- 확인 필요: 브라우저 확인 화면
외부 범위 이슈
- 확인됨: 권한 밖 공통 패키지 수정이 필요해 보이면 직접 고치지 않고 문제 원인, 수정 필요 경로,
sn영향 범위, 타 앱 영향 가능성을 문서화한다. 근거:apps/sn/AGENTS.md