관리비 탭 계층 — BE 참고

범위와 상태

2026-07-27의 탭 계층 정리는 관리비 목록·설정·콘솔의 탐색 표현과 접근성 마크업을 바꾼 FE 변경이다. API, 권한, 상태머신, 저장 데이터는 변경하지 않는다. 11개 회차 route unit은 유지하고 하나의 가로 업무 탭 레일에 투영한다.

서버 불변식

• 페이지 헤더와 콘텐츠 내부의 plane(기본값) 탭은 동일한 기존 라우트 또는 로컬 보기 상태를 소비한다. 시각 variant 변경은 서버 계약을 바꾸지 않는다.
• availability: 'planned'인 탭은 FE가 위치를 보존하되 disabled와 미구현 상태로 렌더한다. 서버 route나 빈 응답을 구현된 기능처럼 호출하지 않는다.
• 관리비 콘솔 탭의 노출은 기존 editions와 feature 게이트를 그대로 사용한다.
• 클러스터는 저장 상태나 workflow stage가 아니다. overview, assessment, billing-notice, receivables, reporting은 데스크톱 탭 사이 구분선을 결정하는 FE 탐색 분류일 뿐 기존 group·seg·서버 payload를 바꾸지 않는다.
• 목록의 미구현 고지서 빌더도 활성 API 계약이 생기기 전까지 서버 호출을 만들지 않는다.
• 좌측 메뉴는 정기 관리비, 중간정산, 사용량 입력, 설정 진입점처럼 업무 전환을 소유한다. 헤더는 현재 업무의 로컬 화면만 소유한다.
• 기본 설정의 general, surcharge, collecting route는 그대로 유지한다. 좌측에는 /setting/general 대표 진입점만 표시하고 세 route는 헤더의 일반·연체료·수납으로 전환한다.
• actual 부과의 assessment, allocation-unit, allocation-contract, allocation-member route는 청구의 contract, unit, member와 같은 독립 흰 pill 내비게이션 표면에서 전환한다. 실제 알림·도구·표 작업 카드는 그 아래 별도 표면을 사용한다. 이 분리는 각 route의 조회·저장 계약과 대상 축을 바꾸지 않는다.

후속 구현 계약

예정 탭을 활성화할 때는 route 존재 여부, entitlement, API 응답, 빈 상태와 오류 상태를 함께 제공한 뒤 availability: 'planned'를 제거한다. 탭의 색이나 모양만 활성화해 구현 완료로 표시하지 않는다.

검증

이 변경으로 목록 query, count, 정산회차 식별자, 부과·청구·수납 전이 payload가 달라지지 않아야 한다. 네트워크 검수에서는 탭 전환 전후 기존 요청만 발생하는지와 disabled 탭이 요청을 만들지 않는지를 확인한다.