Files
king c7cc94a09c fix: 2026-10-15 코드 검토 F01~F10 — 수집 실패 전파·트랜잭션 경계·저장 실패·공지 버전/확인 조건·테스트 체계
- F01 쿠팡: HTTP 200 비JSON·data 목록 없음은 수집 실패(기간 교체 안 함), 정상 빈 목록과 구분
- F02 회의록 [적용]: 업무 INSERT 와 줄 연결을 한 연결·한 트랜잭션(_insert_task), 확인은 잠그기 전·알림/메일은 커밋 뒤, 줄 바뀜 409
- F03 업무 등록 표: persist 실패 전파, 미저장이면 [적용] 중단, 초안 유지·다시 저장·이탈 경고
- F04 인증정보 변경 시 내부 토큰 삭제 + 네이버·토스 토큰을 발급 인증정보 지문(SHA-256)에 묶음, GS샵 방식 캐시도 키 지문 기준
- F05 쪽 수 상한·커서 반복 = 실패(쿠팡은 구간을 하루까지 나눠 재시도), 네이버·카카오·토스·GS샵 동일 기준
- F06 [중지] 확인과 저장 시작을 같은 잠금(begin_saving), 저장 시작 뒤 중지 불가
- F07/F08 긴급 공지: 내용 version·고친 공지 다시 그리기·확인에 version(409), 확인은 행 잠금 트랜잭션에서 수신자·표시 시각·취소 검증
- F09 쇼핑몰 연결 테스트도 clear 처리·저장 안 한 시험은 상태 유지(광고 테스트와 같은 계약)
- F10 DB 테스트 skip·가짜 app.main/time.sleep 파일 범위 fixture, 오래된 기대값 갱신, pytest.ini·requirements-dev·tests/js/package.json·docs/TESTING.md
- 결과·후속 과제: docs/CODE_REVIEW_2026-10-15_RESULT.md (마이그레이션·환경변수 변경 없음)

Python 440 passed/63 skipped(DB 없음), 503 passed(로컬 PostgreSQL), jsdom 7종·Edge 6종 통과

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 18:41:42 +09:00

69 lines
3.8 KiB
Markdown

# 테스트 실행 방법
운영 서버·운영 DB·실제 쇼핑몰은 쓰지 않는다. DB 통합 테스트는 **localhost 의 테스트용 PostgreSQL** 일 때만 돈다
(`*_TEST_DB_URL` 호스트가 localhost/127.0.0.1 이 아니면 건너뜀). 메일·쇼핑몰 API 는 가짜다.
## 1. Python (pytest)
```bash
python -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install -r requirements.txt -r requirements-dev.txt
python -m pytest -q # pytest.ini 의 testpaths 전부
```
- DB 가 없으면 `tests/test_project_module.py`·`tests/test_cafe24_db.py`·`tests/test_notice_db.py` 는 **skip** 으로 나온다
(실패가 아니다 — 2026-10-15 검토 F10 전에는 NameError 로 실패했다).
- 파일별 직접 실행도 그대로 된다: `python tests/test_project_module.py`, `python -m app.modules.cafe24.tests.test_cafe24`.
- `.env` 는 테스트에 필요 없다. `DATA_DIR` 을 저장소 밖 임시 폴더로 주면 사용자 JSON 등이 저장소에 생기지 않는다.
## 2. DB 통합 테스트(로컬 PostgreSQL)
저장소의 SQL 그대로 로컬 테스트 DB 를 만든다(운영 명령 아님).
```bash
# 예: 로컬 PostgreSQL 16 이 localhost:55432 에 postgres 사용자(trust)로 떠 있을 때
export PGCLIENTENCODING=UTF8
for db in project cafe24; do
psql -h localhost -p 55432 -U postgres -d postgres -v app_password=localtest -f scripts/sql/${db}_db_init.sql
for f in $(ls scripts/sql | grep "^${db}_db_0" | sort); do
psql -h localhost -p 55432 -U postgres -d ${db}_db -v ON_ERROR_STOP=1 -f scripts/sql/$f
done
done
PROJECT_TEST_DB_URL=postgresql://postgres@localhost:55432/project_db \
CAFE24_TEST_DB_URL=postgresql://postgres@localhost:55432/cafe24_db \
python -m pytest -q tests/test_project_module.py tests/test_cafe24_db.py tests/test_notice_db.py
```
- project_db 008 은 `pg_trgm`(contrib 확장)이 필요하다. 확장이 없는 휴대용 PostgreSQL 이면 008 의 trgm 확장·인덱스 줄만 빼고
적용해도 테스트 동작은 같다(검색 속도용 인덱스뿐 — 앱 쿼리는 ILIKE).
- 같은 DB 로 여러 번 돌려도 된다(테스트마다 새 이름·번호). 깨끗하게 하려면 위 스크립트로 DB 를 다시 만든다.
- 여기서 실제로 검증하는 것: 트랜잭션 롤백(회의록 [적용] 연결 실패 시 업무도 롤백 — 테스트 전용 트리거), 동시 [적용] 4건,
풀 연결 1개로 [적용], 공지 확인과 동시 취소(행 잠금 대기), 카페24 lease·쓰기 잠금 등.
## 3. 화면(jsdom) 테스트
```bash
cd tests/js && npm install && cd ../.. # jsdom·playwright-core(package.json 고정 버전)
python tests/js/render_project.py # 템플릿 → tests/js/.out/*.html
python tests/js/render_goals.py
python tests/js/render_performance.py
python tests/js/render_help.py
for t in project_ui goals_meeting_ui goal_nav_ui overdue_ui notice_ui perf_manual help_ui; do node tests/js/$t.test.js; done
```
마지막 줄 `ALL PASS` 면 통과. 서버 응답은 테스트 안의 가짜 fetch 다.
## 4. 실제 브라우저 테스트(Playwright)
```bash
PJ_TEST_BROWSER="C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe" node tests/js/image_copy.browser.test.js
```
`*.browser.test.js` — 설치된 Chrome/Edge 경로를 `PJ_TEST_BROWSER` 로 준다(playwright-core 는 브라우저를 내려받지 않음).
렌더된 `.out` 페이지와 테스트 안의 가짜 서버를 쓴다.
## 5. 남은 한계
- 실제 쇼핑몰·Google Ads·SMTP 와의 통신은 테스트하지 않는다(가짜 응답). 응답 형식 가정이 바뀌면 운영에서 확인이 필요하다.
- 운영 PostgreSQL 과 같은 설정(확장·권한·부하)에서의 동시성은 로컬 단일 인스턴스 결과로 대신한다.