Repository navigation
TodayPick v1.10.0 테스트 안전망 구축
TodayPick v1.10.0
API route와 상태 로직이 있는 컴포넌트에 테스트 안전망을 만든 릴리스입니다. 이전에는 테스트 241개가 전부 순수 함수만 검증해서, 인증 분기나 화면 상태 전이가 깨져도 npm test가 통과했습니다.
안전망을 만드는 과정에서 실제 버그 두 개가 잡혔습니다. 그중 하나는 사용자가 비공개로 만든 글이 공개로 바뀔 수 있는 문제였습니다. 이번 릴리스의 가장 실질적인 성과입니다.
주요 변경 사항
비공개로 만든 글이 공개로 바뀌지 않습니다
피드나 프로필의 읽은 글에서 인용하여 글쓰기를 시작하면 초안이 비공개로 만들어집니다. 그런데 글쓰기 화면은 이 초안을 공개로 표시하고, 사용자가 아무것도 건드리지 않았는데도 변경된 상태로 취급했습니다. 공개 여부를 그대로 두고 저장하면 초안이 공개로 바뀌었습니다.
이제 저장된 공개 여부를 그대로 보여줍니다. 인용해서 시작한 초안은 비공개로 열리고, 손대지 않았다면 저장 버튼이 활성화되지 않습니다.
/write 주소에서 쓰이지 않던 newDraft 파라미터가 사라집니다. 예전 주소로 들어와도 동작은 같습니다.
글 저장이 실패하면 알려줍니다
이전에는 글 저장이 실패해도 저장 버튼이 저장 중...에서 원래대로 돌아오는 것 말고는 아무 변화가 없었습니다. 저장이 됐는지 실패했는지 알 수 없었습니다. 이제 실패 이유를 저장 버튼 아래에 보여줍니다. 입력한 내용은 그대로 남아 다시 저장할 수 있습니다.
오류 메시지에 내부 정보가 섞이지 않습니다
서버 오류가 났을 때 데이터베이스의 내부 오류 문구가 응답에 실려 나가는 경로가 있었습니다. 이제 정해진 안내 문구만 나가고 원인은 서버 로그에만 남습니다.
개선 사항
- 테스트 241개 → 468개. API route 11개와 상태 로직이 있는 컴포넌트 5개가 새로 덮였습니다.
- 테스트 환경 정비. 순수 함수와 API route는 node에서, 컴포넌트는 jsdom에서 돌도록 나눴습니다. Supabase 응답을 주입하는 공용 fake와 요청·렌더 헬퍼를 만들었습니다.
- API 오류 응답 통일. 오류 응답 84곳을 공용 헬퍼로 교체해 상태 코드와 문구 형식을 맞췄습니다. 한 곳만 영어였던 인증 문구도 통일했습니다.
- CI 정비.
actions/checkout과actions/setup-node를 v5로 올려 Node 20 지원 종료 경고를 없앴습니다. - 문서. 테스트 작성 기준을
docs/testing-guide.md에 정리하고,AGENTS.md에 API 오류 응답 규칙과 테스트 작성 규칙, 이슈 종료 시점 규칙을 추가했습니다.
버그 수정
- 인용으로 만든 비공개 초안이 저장 시 공개로 바뀔 수 있던 문제 (#161)
- 글 저장 실패가 화면에 드러나지 않던 문제 (#162)
- 서버 오류 응답에 데이터베이스 내부 문구가 섞여 나가던 문제 (#149)
- 명언 스크랩 여부 조회가 인증 실패 시 잘못된 값으로 표시되던 문제 (#149)
데이터베이스 및 운영 반영
- migration 없음. 스키마 변경이 없어 DB 작업 없이 배포했습니다.
- 환경 변수 변경 없음.
- 배포 설정 변경 없음. GitHub Actions의 action 버전만 올렸습니다.
API 변경
GET /api/quotes?quoteId=...의 응답이 true/false에서 { isScraped: boolean }으로 바뀝니다. 같은 앱 안에서만 쓰는 내부 API이고 호출하는 화면을 함께 고쳤습니다.
검증
| 항목 | 결과 |
|---|---|
npm run lint |
통과 |
npm run type-check |
통과 |
npm test |
42 files / 468 tests 통과 |
npm run build |
통과 |
GitHub Actions CI / verify |
각 이슈 PR과 릴리스 PR, master push 모두 통과 |
| Vercel Production | 배포 성공 |
- 오류 응답 상태 코드 분포를 변경 전후로 대조해 보존을 확인했습니다.
- 오류 경로마다 주입한 내부 문구가 응답에 없는지 테스트로 확인했습니다.
- CI 로그에서 Node 20 지원 종료 경고가 0건인지 확인했습니다.
확인하지 못한 사용자 흐름
- 프로필 읽은 글에서 글쓰기로 진입하는 흐름. 에디터가 비공개로 열리는지 화면에서 확인하지 못했습니다. 피드에서 시작하는 같은 흐름은 테스트로 덮었고, 변경은 두 곳 모두 링크 문자열 한 줄입니다.
- 저장 실패 문구의 화면 위치와 색. 저장 API가 실패하는 상황을 만들기 어려워 테스트로 대신했습니다.
알려진 제한 사항
- 권한 경계는 쿼리 조건 수준까지만 검증합니다. 테스트용 fake가 필터를 실제로 적용하지 않으므로 "소유자 조건이 쿼리에 들어갔는지"만 확인합니다. 실제 행 격리는 데이터베이스의 Row Level Security가 담당합니다.
- 표시 전용 컴포넌트는 테스트가 없습니다. 상태 전이가 있는 5개만 다뤘고 나머지 35개 남짓은 대상이 아닙니다.
- 글쓰기의 썸네일 업로드 경로(multipart)는 테스트로 덮지 못했습니다. JSON 경로만 검증합니다.
- 관심 분야 중복을 합치는 동작이 의도인지 확인하지 않고 현재 동작을 테스트로 고정했습니다. 중복을 거절하려던 것이었다면 이 테스트가 잘못된 동작을 굳힌 셈입니다.
- 새 글의 기본 공개 여부가 공개인 것이 의도인지 확인하지 않았습니다. 이번 릴리스에서 바꾸지 않았습니다.
npm audit이 보고하는 취약점 6건(brace-expansion,postcss,sharp,nanoid,js-yaml)이 이전부터 있습니다. 수정하면next가 함께 올라가므로 별도 작업으로 다뤄야 합니다.
관련 이슈
- #148 테스트 인프라와 공용 헬퍼를 구축한다
- #149 API 응답과 오류 규약을 통일한다
- #150 학습 기록 API route에 테스트를 추가한다
- #151 콘텐츠 API route에 테스트를 추가한다
- #152 글쓰기와 프로필 API route에 테스트를 추가한다
- #153 상태 로직이 무거운 컴포넌트에 테스트를 추가한다
- #156 GitHub Actions를 Node 20 기반 버전에서 올린다
- #161 WriteEditor의 startAsPublic이 새 글에서 무의미하고 저장된 비공개 설정을 덮어쓴다
- #162 WriteEditor에서 글 저장 실패가 화면에 드러나지 않는다
- #142 README에 CS 지식과 IT 용어사전을 반영한다
- #144 AGENTS.md에 README 갱신 규칙을 추가한다
- #146 문서 전용 이슈의 종료 시점을 AGENTS.md에 명문화한다
- #154 v1.10.0 테스트 안전망 구축 릴리스 (릴리스 관리)