다크모드
기준정보 개요 백엔드 참고
범위
기준정보 개요는 기존 마스터 화면을 분류하고 연결하는 읽기 전용 내비게이션 변경이다. 이번 변경은 데이터베이스 스키마, 저장 API, 권한 모델 또는 테넌트 경계를 변경하지 않는다.
도메인 분류
- 공간: 프로퍼티, 유닛
- 사람·거래처: 멤버, 거래처
- 운영 자산: 차량
- 수납 정보: 가상계좌, 자동이체
소유·점유는 기준정보와 연결되지만 계약 도메인이 소유한다. 기준정보 개요의 링크는 계약 화면으로 이동할 뿐 소유권이나 API 경계를 기준정보로 이전하지 않는다.
사업자등록 프로필·현금영수증 발급정보·관계자는 목표 모델에서 Party 하위 연결 정보다. 이번 작업은 목표 소유권을 문서화하고 중복된 최상위 내비게이션을 줄이지만, 기존 저장 테이블이나 API를 즉시 합치지 않는다.
집계 계약
현재 개요에서 표시하는 수치는 유닛 등록 건수뿐이다. 프로토타입은 기존 프로퍼티·유닛 읽기 모델의 유닛 배열 길이를 사용한다.
실서비스에서 건수를 제공할 때는 다음 조건을 지켜야 한다.
- 현재 인증 주체가 접근할 수 있는 Workspace 범위로 집계한다.
- 삭제·비활성 항목 포함 여부를 API 계약에 명시한다.
- 페이지네이션된 목록의 현재 페이지 길이를 전체 건수로 사용하지 않는다.
- 권한이 없는 마스터의 존재 여부를 집계 값으로 노출하지 않는다.
- 여러 카드의 집계를 제공한다면 개요용 집계 API 또는 일관된 읽기 모델을 사용한다.
집계 계약이 없는 카드는 건수를 표시하지 않는다. 샘플 수치나 클라이언트 추정치를 채우지 않는다.
권한과 테넌시
- 기존 Workspace 접근 권한과 각 마스터 화면의 인가를 그대로 적용한다.
- 개요 카드가 보인다는 사실만으로 대상 API 접근을 허용하지 않는다.
- 링크 이동 후에도 서버는 대상 리소스와 현재 Workspace의 귀속을 검증해야 한다.
- 소유·점유 링크는 계약 도메인의 인가 정책을 따른다.
변경 영향
새 엔드포인트와 마이그레이션은 없다. 향후 카드별 실시간 건수 또는 상태 요약을 추가할 때만 별도 집계 계약을 설계한다.