89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# 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`와 함께 갱신한다.
|