📖 용어사전

접근성 점검 요청

키보드·스크린리더·명암 대비까지 초보 기준으로 확인해 달라고 시키는 일

빈 상태 화면

아직 글·알림·자료가 하나도 없을 때 보여주는 안내 화면

로딩 상태

데이터를 불러오는 동안 화면이 멈춘 것처럼 보이지 않게 하는 표시

에러 상태 화면

실패했을 때 영어 스택 대신 다음에 무엇을 하면 되는지 알려 주는 화면

권한 없는 화면

로그인하지 않았거나 권한이 없을 때 숨기거나 안내하는 처리

출력 형식 지정

답변을 표, 체크리스트, 패치만 등 정해진 모양으로 내라고 못 박는 지시

패치만 보여줘

파일 전체를 다시 쓰지 말고 바뀐 줄만 보여 달라고 하는 요청

영향 범위

이번 변경이 건드릴 수 있는 화면·데이터·배포의 넓이

의존성 추가 금지

이번 일에 새 npm/Composer 패키지를 넣지 말라는 규칙

기존 컴포넌트 재사용

새 버튼·모달을 만들지 말고 프로젝트에 있는 UI를 다시 쓰라는 지시

TODO 남기지 않기

나중에 하겠다며 TODO·FIXME를 코드에 남기지 말라는 규칙

시크릿 스캔

커밋·채팅·로그에 API 키·비밀번호가 섞였는지 찾아 보는 검사

빌드 산출물 커밋 금지

`node_modules`, `public/hot`, 캐시처럼 다시 만들 수 있는 파일을 저장소에 넣지 말라는 규칙

레이스 컨디션

두 요청이 거의 동시에 들어와 데이터가 꼬이는 상황

회귀 확인

새 기능을 넣은 뒤 예전에 되던 것이 깨지지 않았는지 다시 보는 확인

스테이징 확인

운영에 올리기 전에 비슷한 서버에서 한 번 더 눌러 보는 절차

.env 예시 파일

실제 비밀 값 없이 어떤 키가 필요한지만 적어 둔 환경 변수 견본

왜 바꿨는지

무엇을 바꿨는지보다 왜 필요했는지를 먼저 말하게 하는 리뷰 습관

예시 입력

원하는 결과를 말로만 하지 않고 구체적인 입력 예시를 함께 주는 방법

확인 대화상자

지우기·강퇴처럼 되돌리기 어려운 버튼 앞에 한 번 더 묻는 창

일관성 유지

버튼 말투, 색, 간격, 에러 문구를 사이트 전체와 같게 맞추는 일

하드코딩 금지

주소·권한·문구를 코드 한가운데에 박아 넣지 말고 설정·번역·상수를 쓰라는 규칙

주석으로 의도

코드가 ‘무엇을’이 아니라 ‘왜 이렇게 예외를 뒀는지’를 짧게 남기는 주석

공개 계약 변경

라우트 이름, JSON 필드, 웹훅처럼 바깥에서 이미 쓰는 약속을 바꾸는 일

마이그레이션 주의

DB 구조를 바꾸는 작업은 되돌리기 어려우니 따로 검토하라는 경고

브라우저 지원 범위

어느 브라우저·버전까지 동작해야 하는지 미리 정해 두는 기준

스크린샷 전후

고치기 전과 후의 화면을 같이 붙여 원하는 차이를 분명히 하는 방법

반응형 확인 요청

같은 화면을 좁은 폭과 넓은 폭에서 모두 확인하라고 시키는 일

한글 줄바꿈

긴 한글 제목·버튼이 어색한 위치에서 끊기지 않게 맞추는 일

유지보수 모드

배포하는 동안 손님에게 점검 중 페이지를 보여 주는 상태