From 08a5a43d935be1380f2b109e29f88dace03b3f12 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Tue, 23 Dec 2025 19:25:52 +0900 Subject: [PATCH] =?UTF-8?q?=EC=9B=90=EC=B9=99=20=EB=AC=B8=EC=84=9C=20?= =?UTF-8?q?=EC=B2=B4=ED=81=AC=EB=A6=AC=EC=8A=A4=ED=8A=B8=20=EB=B3=B4?= =?UTF-8?q?=EC=99=84:=20=EB=B0=B0=ED=8F=AC=20=EC=A0=84/=ED=9B=84=20?= =?UTF-8?q?=ED=99=95=EC=9D=B8=20=ED=95=AD=EB=AA=A9=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- book/300_architecture/311_FastAPI_구조_원칙.md | 7 +++++++ book/300_architecture/313_React_구조_원칙.md | 8 ++++++++ 2 files changed, 15 insertions(+) diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md index f6cda6c..eef06cb 100644 --- a/book/300_architecture/311_FastAPI_구조_원칙.md +++ b/book/300_architecture/311_FastAPI_구조_원칙.md @@ -193,11 +193,18 @@ utils - [ ] 핵심 파일은 300줄 이하로 유지할 수 있는가? - [ ] 중복 코드는 utils/로 추출할 수 있는가? - [ ] DB 스키마 변경 시 ORM/DDL/Repository 동시 수정 확인 +- [ ] Supabase 쿼리에서 컬럼명과 예약어 충돌 시 Python 로직으로 처리했는가? - [ ] LLM 호출 횟수 계산 및 최적화 검토 - [ ] 애매한 케이스는 LLM 우선 접근 원칙 적용 확인 - [ ] 복잡한 워크플로우는 LangGraph 활용 검토 - [ ] 원칙 문서 확인 완료 (`311_FastAPI_구조_원칙.md`, `312_문서_작성_원칙.md`) +배포 전/후 확인: +- [ ] 코드 변경 후 `git status`로 커밋되지 않은 변경사항 확인 +- [ ] 프론트엔드/백엔드 모두 배포 완료 확인 +- [ ] 배포 후 실제 브라우저에서 동작 확인 (추측하지 말고 직접 확인) +- [ ] 백엔드 로그에서 에러 확인 (`docker logs` 또는 Supabase 로그) + ## 10. 예외 상황 ### 허용되는 예외 diff --git a/book/300_architecture/313_React_구조_원칙.md b/book/300_architecture/313_React_구조_원칙.md index 2ef6ce3..dfae0a3 100644 --- a/book/300_architecture/313_React_구조_원칙.md +++ b/book/300_architecture/313_React_구조_원칙.md @@ -181,8 +181,16 @@ src/ - [ ] Prop Drilling이 3단계 이상인가? (상태 관리 필요) - [ ] TypeScript 타입이 명확히 정의되었는가? - [ ] useEffect 의존성이 정확한가? +- [ ] Custom Hook 함수 반환 시 useCallback 사용했는가? +- [ ] React Router basename 사용 시 Link 컴포넌트 상대 경로만 사용했는가? - [ ] JS/CSS 파일 로드 시 버전 파라미터(`?v=YYYYMMDD`) 추가 확인 (캐싱 문제 방지) +배포 전/후 확인: +- [ ] 코드 변경 후 `git status`로 커밋되지 않은 변경사항 확인 +- [ ] 프론트엔드/백엔드 모두 배포 완료 확인 +- [ ] 배포 후 실제 브라우저에서 동작 확인 (추측하지 말고 직접 확인) +- [ ] 네트워크 탭에서 API 호출 상태 확인 (200/500 등) + ## 11. 라우팅 원칙 ### React Router basename 사용