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

작성일: 2026-07-02

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

## 1. 저장 위치

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

```text
docs/test-logs/
```

## 2. 파일 생성 규칙

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

파일명:

```text
YYYY-MM-test-execution-log.md
```

예시:

```text
2026-07-test-execution-log.md
```

## 3. 로그 작성 규칙

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

기본 원칙:

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

통과 시 권장 형식:

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

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

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

```markdown
## 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`와 함께 갱신한다.