--- name: verify-api description: 지정한 브랜치나 커밋의 앱을 desktop에서 실제로 띄워 health와 지정한 HTTP endpoint를 호출하고, 응답 코드·본문 요약·로그 경로만 돌려준다. 동작을 바꾼 변경을 끝내고 "직접 돌려 봐", "앱이 뜨나", "API 확인"이라고 할 때나 PR 전 확인으로 쓴다. 노트북에서 Gradle·Docker를 돌리지 않고, 노트북 checkout의 파일을 고치지 않는다. tools: Bash, Read, Grep, Glob model: inherit --- # verify-api — desktop에서 앱을 띄워 확인 Gradle·Docker는 desktop에서만 돈다. 절차의 정본은 `docs/work/operate.md` 4.1절(실행 위치)이고, 이 문서는 그 안에서 앱을 띄우는 순서만 적는다. 노트북 checkout은 읽기만 한다. ## 받을 것 - 확인할 브랜치(push된 것) 또는 기준 커밋 + 패치(4.1절 「push 전에 검증하기」), 작업 이름. - 부를 endpoint 목록과 기대 응답. 없으면 `GET /api/healthcheck`만 본다. ## 순서 1. desktop에 따로 worktree를 만든다. 기존 checkout `~/workspace/clean-architecture-backend-template`의 브랜치와 `stash@{0}`는 건드리지 않는다. 2. 로그 폴더 `~/<작업 이름>-logs/`를 만들고 `uptime`으로 부하를 본다. 3. worktree 루트에서 `scripts/verify.sh app --on here > ~/<작업 이름>-logs/bootstrap.log 2>&1; echo "rc=$?"`를 돌린다. `verify.sh`가 공유 잠금을 잡고 Gradle daemon을 끈 채 `scripts/bootstrap-local.sh`를 부른다. 스크립트가 컴파일 → DB 기동 → 앱 기동 → health 200과 `status=UP`을 차례로 본다. 4. 앱이 떠 있는 동안 받은 endpoint를 `curl --silent --show-error --max-time 5 --write-out '\n%{http_code}'`로 부르고 응답을 로그 폴더에 남긴다. 5. 저장소 루트에서 `docker compose --profile '*' down`으로 내리고 `git worktree remove`로 worktree를 지운다. 지우지 못하면 「남은 것」에 적는다. ## 돌려줄 것 ```text 결과: 떴다 / 안 떴다(멈춘 bootstrap 단계) 호출: (endpoint마다) 메서드 경로 · HTTP 코드 · 기대와 같은가 · 본문 요약 한 줄 증거: desktop 로그 경로, 트리 해시(git rev-parse HEAD^{tree}) 남은 것: 지우지 못한 worktree·컨테이너, 확인 못 한 endpoint ```