정적 route, 동적 parameter, query 상태를 사용해 예측 가능한 URL 구조를 만듭니다.
정적 route는 문서, 가격, 테마처럼 주소 자체가 기능을 설명하는 화면에 적합합니다. 메뉴와 footer에서 반복적으로 연결되는 route는 이름을 짧게 유지하고 변경 가능성을 낮추는 편이 좋습니다.
- 대표 route는 통합 테스트에 넣습니다.
- 슬래시 유무를 일관되게 처리합니다.
- 메뉴 label과 title을 함께 점검합니다.
상세 화면은 slug나 id를 URL에 담아 직접 접근 가능해야 합니다. 존재하지 않는 값이 들어왔을 때 기본 문서로 보내는지, 404를 보여주는지 정책을 정해야 사용자와 검색 엔진 모두 예측 가능합니다.
- slug는 사람이 읽을 수 있게 둡니다.
- id 기반 route는 권한 확인을 반드시 포함합니다.
- 없는 리소스 처리는 화면별로 통일합니다.
검색어, 필터, 정렬, 페이지 번호는 URL에 남기면 공유와 복원이 쉬워집니다. 다만 너무 많은 상태를 담으면 URL이 불안정해지므로 사용자가 다시 돌아왔을 때 가치 있는 값만 선택합니다.
- 기본 필터는 query에서 생략합니다.
- 숫자와 enum 값은 파싱 실패를 방어합니다.
- 검색 입력과 URL 갱신 타이밍을 정합니다.
문서 URL은 외부에 공유되기 때문에 바꾸기 전에 redirect를 고려해야 합니다. 특히 섹션 anchor는 작은 변경도 기존 링크를 깨뜨릴 수 있으므로 제목과 별개로 안정적인 id를 유지합니다.
- 삭제 route는 대체 route를 둡니다.
- anchor id는 제목 번역과 독립시킵니다.
- redirect 결과를 테스트로 확인합니다.
Java 중심 UI 시스템으로 제품 수준의 웹 앱을 더 빠르게 구축합니다. 공통 컴포넌트와 레이아웃을 기반으로 사이트를 일관되게 확장할 수 있습니다.