# 테스트 실행 방법 운영 서버·운영 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 과 같은 설정(확장·권한·부하)에서의 동시성은 로컬 단일 인스턴스 결과로 대신한다.