backend/tests/README.md

백엔드 단위테스트

강사 피드백(2026-04-28) 대응: "단위테스트 끝나고 통합테스트 할 때 합의된 기준/절차에 의해 merge"
→ PR이 권한 검증·다국어 사전 로딩을 깨지 않는다는 자동 증빙 레이어.

구성

파일	검증 대상
test_auth_routes.py	X-User-Id 헤더 인증, 역할(teacher/parent) 권한, 발송→수신 통합 흐름
test_glossary.py	다국어 용어사전(8개) 컬럼 동적 로딩, find_glossary_hits 언어별 동작

실행

도커 컨테이너에서

docker compose exec backend pip install -r /app/../backend/requirements-dev.txt
# 또는: docker compose exec backend pip install pytest httpx
docker compose exec backend pytest /app/../backend/tests -v

CI (GitHub Actions)에서

PR 시 자동 실행 — .github/workflows/backend-tests.yml 참조.

추가 테스트 가이드

• 모델 호출(KoELECTRA / NLLB / Edge-TTS)은 무거우므로 직접 호출 X. 필요 시 monkey-patch로 가짜 응답 사용.
• 새 라우트 추가 시 권한 검증 케이스(teacher/parent/anonymous) 3종 모두 작성.
• 테스트는 빠르게 (총 실행시간 30초 이내 목표).