# 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. 로그 작성 규칙

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

권장 형식:

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

- 목적:
- 실행 명령:
- 결과:
- 주요 출력:
- 후속 조치:
```

## 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/tdc114plus-testing-policy-2026-07-02.md`와 함께 갱신한다.