ttipo
6306160dda
- 슬래시 커맨드(nestjs/vue3/flutter)를 정식 스킬(.claude/skills)로 전환하고 docker 스킬을 신설(루트 command.md 이관) - 공통 규칙을 .claude/rules 로 모듈화(coding-common·response-format·error-codes· git-convention·security·env-structure·testing·checklist)하고 CLAUDE.md 에서 @import - 파일·식별자 네이밍 규약, 테스트 규칙 추가 - .claude/settings.json(권한·환경) 추가 - CLAUDE.md·README.md 참조 갱신, 단독 실행(non-Docker) 안내 정리 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
name, description
| name | description |
|---|---|
| testing | 세 스택 공통 테스트 규칙 — 테스트 위치/네이밍, 무엇을 테스트할지, 커밋 전 실행. backend Jest, frontend Vitest, flutter flutter_test 기준. |
테스트 규칙
템플릿은 각 스택에 테스트 러너가 준비되어 있다 — backend
jest, frontendvitest, flutterflutter_test. 새 로직을 추가하면 최소한의 테스트를 함께 작성한다.
공통 원칙
- 무엇을 테스트하나: 순수 함수(utils), 서비스/비즈니스 로직, 에러 코드 매핑 분기를 우선한다. 프레임워크 기본 동작은 테스트하지 않는다.
- 테스트는 결정적(deterministic) 으로 — 외부 네트워크/시간/랜덤에 의존하지 않도록 모킹한다.
- 커밋 전 실행 — 변경 영역의 테스트가 통과해야 한다. (checklist)
- 테스트 설명(it/test 제목)은 한국어로 "무엇을 검증하는지" 명확히 작성한다.
스택별 위치·실행
| 스택 | 러너 | 위치·네이밍 | 실행 |
|---|---|---|---|
| backend | Jest | 단위 *.spec.ts (소스 옆), e2e test/*.e2e-spec.ts |
npm run test, npm run test:e2e |
| frontend | Vitest | *.spec.ts / *.test.ts (대상 옆 또는 __tests__/) |
npm run test:unit |
| flutter | flutter_test | test/ 하위, *_test.dart |
flutter test |
예시 (backend 순수 유틸)
// shared/utils/format.spec.ts
import { formatSomething } from './format';
describe('formatSomething', () => {
it('빈 입력이면 빈 문자열을 반환한다', () => {
expect(formatSomething('')).toBe('');
});
});
API 응답 래퍼/에러 코드는 세 플랫폼 공유 계약이므로(response-format · error-codes), 매핑 로직을 변경하면 해당 분기 테스트를 추가/갱신한다.