docs: address Korean translation review feedback

This commit is contained in:
Affaan Mustafa
2026-03-13 00:17:54 -07:00
parent 526a9070e6
commit fb7b73a962
36 changed files with 383 additions and 132 deletions

View File

@@ -87,6 +87,15 @@ docs/CODEMAPS/
4. **실행 가능** — 실제로 작동하는 설정 커맨드 포함
5. **상호 참조** — 관련 문서 링크
## 품질 체크리스트
- [ ] 실제 코드에서 코드맵 생성
- [ ] 모든 파일 경로 존재 확인
- [ ] 코드 예제가 컴파일 또는 실행됨
- [ ] 링크 검증 완료
- [ ] 최신 타임스탬프 업데이트
- [ ] 오래된 참조 없음
## 업데이트 시점
**항상:** 새 주요 기능, API 라우트 변경, 의존성 추가/제거, 아키텍처 변경, 설정 프로세스 수정.

View File

@@ -71,7 +71,7 @@ npx playwright show-report # HTML 보고서 보기
- **시맨틱 로케이터 사용**: `[data-testid="..."]` > CSS 셀렉터 > XPath
- **시간이 아닌 조건 대기**: `waitForResponse()` > `waitForTimeout()`
- **자동 대기 내장**: `page.locator().click()`은 자동 대기; `page.click()`은 아님
- **자동 대기 내장**: `locator.click()` `page.click()` 모두 자동 대기를 제공하지만, 더 안정적인 `locator` 기반 API를 선호
- **테스트 격리**: 각 테스트는 독립적; 공유 상태 없음
- **빠른 실패**: 모든 핵심 단계에서 `expect()` 어설션 사용
- **재시도 시 트레이스**: 실패 디버깅을 위해 `trace: 'on-first-retry'` 설정

View File

@@ -21,10 +21,16 @@ model: sonnet
기대 동작을 설명하는 실패하는 테스트 작성.
### 2. 테스트 실행 -- 실패 확인
Node.js (npm):
```bash
npm test
```
언어 중립:
- 프로젝트의 기본 테스트 명령을 실행하세요.
- Python: `pytest`
- Go: `go test ./...`
### 3. 최소한의 구현 작성 (GREEN)
테스트를 통과하기에 충분한 코드만.
@@ -34,11 +40,17 @@ npm test
중복 제거, 이름 개선, 최적화 -- 테스트는 그린 유지.
### 6. 커버리지 확인
Node.js (npm):
```bash
npm run test:coverage
# 필수: branches, functions, lines, statements 80% 이상
```
언어 중립:
- 프로젝트의 기본 커버리지 명령을 실행하세요.
- Python: `pytest --cov`
- Go: `go test ./... -cover`
## 필수 테스트 유형
| 유형 | 테스트 대상 | 시점 |