tdc114plus 테스트 실행 로그 관리 규칙

작성일: 2026-07-02

목적: tdc114plus 개발 중 실행한 테스트, 검증, scaffold 점검 결과를 월 단위 md 파일에 누적 기록한다.

1. 저장 위치

테스트 실행 로그는 아래 경로에 저장한다.

docs/test-logs/

2. 파일 생성 규칙

파일은 매 실행마다 새로 만들지 않고, 년월 단위로 누적한다.

파일명:

YYYY-MM-test-execution-log.md

예시:

2026-07-test-execution-log.md

3. 로그 작성 규칙

각 실행 결과는 년월일시까지 남긴다.

기본 원칙:

결과가 [통과]인 경우에는 목적과 결과만 컴팩트하게 기록한다.
테스트 진행 중 실패가 발생한 경우에만 목적, 명령, 주요 출력, 후속 조치를 기록한다.
반복된 Docker dependency download 출력이나 전체 로그를 붙이지 않는다.
실패 없이 통과한 항목에는 명령 목록, 주요 출력, 후속 조치를 길게 남기지 않는다.

통과 시 권장 형식:

## YYYY-MM-DD HH:mm KST - 작업명

- 결과: [통과]
- 목적: 무엇을 확인했는지 1문장

실패 후 수정하여 통과한 경우 권장 형식:

## YYYY-MM-DD HH:mm KST - 작업명

- 결과: [실패 후 통과]
- 목적: 무엇을 확인했는지 1문장
- 명령:
  - `실패 또는 재검증에 사용한 핵심 명령`
- 주요 출력:
  - 실패 원인, 수정 내용, 최종 통과 결과
- 후속 조치:
  - 필요한 경우만 작성

4. 기록 대상

아래 작업은 테스트 실행 로그에 남긴다.

./scripts/format-dart.sh
./scripts/quality-gate.sh
./scripts/perf_smoke.sh
./scripts/mock-server.sh status
./scripts/integration_tests.sh
./scripts/save-snapshots.sh
./scripts/generate-release-report.sh
Android/iOS 빌드 검증
주요 수동 검증 결과
실패한 테스트와 후속 조치

5. 운영 원칙

성공 결과뿐 아니라 실패 결과도 남긴다.
실패 로그는 원인, 재현 명령, 후속 조치를 함께 적는다.
성공 로그는 목적과 [통과] 결과만 남긴다.
비슷한 성격의 테스트는 같은 월별 로그 파일에 계속 누적한다.
월이 바뀌면 새 월별 로그 파일을 만든다.
테스트 정책 변경이 있으면 docs/00_policy_tdc114plus_testing_2026-07-02.md와 함께 갱신한다.