본사관리자 1차 MVP IA/기능 기획 v1

1. 목적

본 문서는 부동산 계약/고객/매물 관리 SaaS의 본사관리자 1차 MVP 범위를 메뉴 구조, 우선순위, 화면 흐름, 완료 기준으로 정리한다.

본사관리자는 사무소 운영을 직접 수행하는 사용자가 아니라 서비스 운영자다. 따라서 1차 MVP는 다음 업무가 끊기지 않도록 구성한다.

본사관리자 로그인
→ 본사 대시보드에서 전체 현황 확인
→ 부동산 사무소 등록
→ 오너 관리자 계정 생성
→ 과금 정책과 기능 권한 설정
→ 사용자/계약/고객/매물 운영 조회
→ 알림, 감사 로그, 운영 설정으로 문제 대응

2. 본사관리자 메뉴 구조

우선순위 기준:

3. 핵심 원칙

• 본사관리자는 headquarters_users 계정으로 로그인하며 office_users와 분리한다.
• 본사관리자는 전체 사무소 운영 데이터를 조회할 수 있으나, 개인정보 상세 조회와 내보내기는 감사 로그를 남긴다.
• 사무소 생성 시 오너 관리자 계정 생성, 과금 정책 생성, 기본 기능 권한 설정이 하나의 온보딩 흐름으로 연결되어야 한다.
• 과금 정책 변경은 과거 값을 덮어쓰지 않고 적용 기간과 변경 이력으로 남긴다.
• 기능 사용 여부는 사무소 단위 기능 플래그와 사용자 권한 그룹을 함께 통과해야 한다.
• 운영 조회 화면은 본사 지원 목적의 읽기 중심으로 시작하고, 계약/고객/매물 원본 수정은 1차 MVP에서 제외한다.

4. 메뉴별 기능 정의

4.1 본사 대시보드

목표:

• 전체 사무소, 사용자, 과금, 기능 사용, 알림 실패, 최근 변경 이력을 한 화면에서 확인한다.

주요 영역:

화면 흐름:

본사관리자 로그인
→ 본사 대시보드
→ 상태 카드 또는 최근 이벤트 선택
→ 관련 목록 화면으로 이동

완료 기준:

• 본사관리자만 접근할 수 있다.
• 주요 숫자는 사무소/사용자/과금/기능 데이터 기준으로 계산된다.
• 과금 변경, 기능 변경, 개인정보 상세 조회 이벤트는 최근 이벤트에 노출된다.
• 각 카드에서 관련 상세 목록으로 이동할 수 있다.

4.2 부동산 등록/관리

목표:

• 본사관리자가 부동산 사무소를 등록하고 상태, 기본 정보, 오너 관리자, 과금/기능 설정을 관리한다.

목록 필터:

부동산 등록 필수 입력:

화면 흐름:

부동산 관리
→ 부동산 등록
→ 사무소 기본 정보 입력
→ 오너 관리자 계정 생성
→ 기본 과금 정책 입력
→ 기본 기능 권한 확인
→ 저장
→ 부동산 상세

상세 탭:

완료 기준:

• 동일 사업자번호 사무소 중복 등록을 막거나 경고한다.
• 사무소 등록 후 오너 관리자 계정, 기본 과금 정책, 기본 기능 권한 상태가 확인 가능하다.
• 사무소 비활성/정지 시 해당 사무소 사용자의 로그인 가능 여부가 정책에 맞게 제한된다.
• 사무소 정보 변경은 감사 로그에 남는다.

4.3 오너 관리자 계정 생성

목표:

• 본사관리자가 각 부동산 사무소의 최초 OWNER_ADMIN 계정을 생성한다.

필수 입력:

화면 흐름:

부동산 상세
→ 오너 관리자 생성
→ 사용자 정보 입력
→ 로그인 ID 중복 확인
→ 초대 방식 선택
→ 저장
→ 계정 생성 및 감사 로그 기록

완료 기준:

• 오너 관리자는 반드시 특정 사무소에 속한다.
• 한 사무소에는 최소 1명의 활성 오너 관리자가 있어야 한다.
• 오너 관리자 생성 시 office_users.role = OWNER_ADMIN으로 저장된다.
• 생성, 비활성화, 권한 변경은 감사 로그에 남는다.

4.4 전체 사용자 관리

목표:

• 본사관리자가 본사 계정과 전체 사무소 사용자의 상태, 소속, 역할, 과금 포함 여부를 확인하고 지원 대응한다.

목록 컬럼:

허용 작업:

완료 기준:

• 본사관리자는 전체 사용자를 소속 사무소 기준으로 필터링할 수 있다.
• 오너 관리자 자기 자신 비활성화 등 사무소에 활성 오너 관리자가 0명이 되는 변경은 차단한다.
• 개인정보 상세 조회, 계정 상태 변경, 과금 포함 여부 변경은 감사 로그에 남는다.

4.5 과금 관리

목표:

• 무료 운영 중에도 사무소별 예상 과금액을 계산하고, 유료 전환 시 같은 설정으로 실제 청구 금액을 확정할 수 있게 한다.

메뉴 구성:

사무소별 정책 필수 항목:

화면 흐름:

과금 관리
→ 사무소 선택
→ 현재 활성 사용자 수와 추가 기능 금액 확인
→ 과금 정책 입력 또는 변경
→ 예상 과금액 미리보기
→ 저장
→ 기존 정책 종료 및 새 정책 생성
→ 감사 로그 기록

완료 기준:

• 과금 계산식은 기본료, 초과 사용자 금액, 기능 금액, 수동 보정을 포함한다.
• billingEnabled = false인 사무소는 예상 금액은 계산하되 실제 청구 금액은 0원으로 표시한다.
• 확정된 월별 과금 스냅샷은 자동 덮어쓰기를 막는다.
• 정책 변경은 과거 row를 덮어쓰지 않고 적용 기간 또는 이력으로 남긴다.

4.6 기능 권한 관리

목표:

• 본사관리자가 사무소별 기능 사용 가능 여부와 기능 과금 정보를 관리한다.

1차 기능 코드:

사무소별 기능 설정 항목:

화면 흐름:

기능 권한 관리
→ 사무소 선택
→ 기능 목록 확인
→ 기능 사용 여부와 과금 방식 설정
→ 저장
→ 사무소 사용자 메뉴/버튼 권한에 반영
→ 감사 로그 기록

완료 기준:

• 사무소 기능 플래그가 꺼져 있으면 사용자 권한 그룹이 허용해도 해당 기능을 사용할 수 없다.
• 기능 권한 변경은 과금 예상 금액에 반영된다.
• 기능 권한 변경 이력과 변경자가 감사 로그에 남는다.

4.7 계약/고객/매물 조회

목표:

• 본사관리자가 고객 지원과 운영 점검을 위해 전체 사무소의 계약, 고객, 매물 데이터를 조회한다.

공통 원칙:

• 1차 MVP에서는 본사관리자의 업무 데이터 수정/삭제를 제외한다.
• 상세 조회, 개인정보 조회, 엑셀 내보내기는 감사 로그 대상이다.
• 목록은 사무소, 담당자, 상태, 기간 기준 필터를 제공한다.

계약 조회:

고객 조회:

매물 조회:

완료 기준:

• 본사관리자는 전체 데이터를 조회할 수 있고 officeId 필터로 좁힐 수 있다.
• 개인정보 상세 조회와 내보내기는 audit_logs에 기록된다.
• 본사관리자 조회는 사무소 사용자 권한과 분리된 본사 세션으로 동작한다.

4.8 알림 관리

목표:

• 계약 만료 알림, 고객 예약 팝업, 운영 공지 등 발송/노출 상태를 본사에서 관리한다.

1차 범위:

화면 흐름:

알림 관리
→ 발송 예정/이력 확인
→ 실패 건 상세 확인
→ 필요 시 취소 또는 재처리
→ 감사 로그 기록

완료 기준:

• 알림 발송 상태가 예정, 성공, 실패, 취소로 구분된다.
• 알림 실패 건은 본사 대시보드에서 확인할 수 있다.
• 고객 대상 알림 상세 조회와 재처리는 감사 로그 대상이다.

4.9 감사 로그

목표:

• 본사관리자와 주요 운영자가 수행한 민감 작업을 추적한다.

로그 대상:

목록 컬럼:

완료 기준:

• P0 이벤트는 모두 감사 로그에 남는다.
• 로그 목록은 기간, 작업자, 작업 유형, 대상 사무소로 필터링할 수 있다.
• 감사 로그는 일반 수정 화면에서 삭제하거나 임의 변경할 수 없다.

4.10 운영 설정

목표:

• 본사 운영자가 서비스 전역 기본값과 공통 코드를 관리한다.

1차 범위:

완료 기준:

• 운영 설정 변경은 감사 로그에 남는다.
• 신규 사무소 등록 화면은 운영 설정의 기본값을 불러온다.
• 운영 설정 변경이 기존 사무소의 과거 정책을 임의 변경하지 않는다.

5. 1차 MVP 화면 흐름

5.1 신규 사무소 온보딩

본사관리자 로그인
→ 본사 대시보드
→ 부동산 관리
→ 부동산 등록
→ 사무소 기본 정보 입력
→ 오너 관리자 계정 생성
→ 과금 정책 입력
→ 기능 권한 기본값 확인
→ 저장
→ 부동산 상세에서 생성 결과 확인

완료 기준:

• 저장 후 사무소, 오너 관리자, 과금 정책, 기능 권한 상태가 한 번에 확인된다.
• 실패 시 어느 단계에서 실패했는지 명확히 표시된다.
• 부분 생성 실패가 발생하면 재시도 또는 운영자가 확인할 수 있는 상태로 남긴다.

5.2 사무소 과금 정책 변경

과금 관리
→ 사무소 검색
→ 현재 과금 정책과 월 예상 금액 확인
→ 새 정책 입력
→ 예상 금액 미리보기
→ 저장
→ 기존 정책 종료 및 새 정책 시작
→ 감사 로그 기록

완료 기준:

• 변경 전/후 값이 저장 전에 확인된다.
• 과거 확정 월의 과금 스냅샷은 변경되지 않는다.
• 변경 사항은 본사 대시보드 최근 이벤트와 감사 로그에 반영된다.

5.3 기능 권한 변경

기능 권한 관리
→ 사무소 검색
→ 기능 목록 확인
→ 사용 여부/과금 방식/금액 변경
→ 예상 과금 영향 확인
→ 저장
→ 사무소 사용자 기능 접근에 반영
→ 감사 로그 기록

완료 기준:

• 기능 플래그 변경 후 사용자 메뉴/버튼 노출 정책과 과금 계산이 같은 값으로 동작한다.
• 기능 권한 변경자는 감사 로그에서 확인 가능하다.

5.4 고객 지원용 운영 조회

전체 사용자 관리 또는 부동산 상세
→ 대상 사무소 확인
→ 계약/고객/매물 조회 화면 이동
→ 필터로 대상 데이터 검색
→ 상세 조회
→ 개인정보 또는 민감 정보 조회 감사 로그 기록

완료 기준:

• 본사관리자의 조회는 대상 사무소와 작업자가 로그에 남는다.
• 목록 기본값은 필요한 범위에서 마스킹하거나 최소 정보만 표시한다.

6. 권한과 역할 기준

본사관리자 역할별 1차 권한:

권한 원칙:

• 과금 변경은 SUPER_ADMIN 또는 BILLING_MANAGER만 허용한다.
• 기능 권한 변경은 SUPER_ADMIN 또는 ADMIN만 허용한다.
• 본사관리자 계정 생성과 역할 변경은 SUPER_ADMIN만 허용한다.
• 개인정보 상세 조회는 역할과 무관하게 감사 로그를 남긴다.

7. 1차 MVP 포함/제외 범위

포함:

• 본사 대시보드
• 부동산 등록/관리
• 오너 관리자 계정 생성
• 전체 사용자 관리
• 과금 관리
• 기능 권한 관리
• 계약/고객/매물 조회
• 알림 관리
• 감사 로그
• 운영 설정

제외:

• 카드 결제 자동 승인
• 세금계산서 자동 발행
• 미납 자동 정지
• 본사관리자의 계약/고객/매물 원본 수정
• 복잡한 일할 계산
• 기능별 건별 과금 확정 자동화
• 고급 BI 리포트
• 대량 마이그레이션 도구

8. 전체 완료 기준

1차 MVP 완료 기준:

• 본사관리자가 전용 로그인 후 본사 메뉴에만 접근할 수 있다.
• 신규 부동산 사무소를 등록하고 오너 관리자 계정을 생성할 수 있다.
• 사무소별 과금 정책과 기능 권한을 설정하고 변경 이력을 확인할 수 있다.
• 전체 사용자와 사무소별 사용자 상태를 조회하고 필요한 상태 변경을 할 수 있다.
• 본사관리자가 계약, 고객, 매물 데이터를 사무소 기준으로 조회할 수 있다.
• 개인정보 조회, 내보내기, 과금 변경, 기능 권한 변경, 사용자 변경은 감사 로그에 기록된다.
• 본사 대시보드에서 운영상 중요한 숫자와 최근 이벤트를 확인할 수 있다.
• 알림 발송 예정/성공/실패 상태를 조회할 수 있다.
• 운영 설정의 기본값이 신규 사무소 등록 흐름에 반영된다.