프로퍼티 유닛 관리

선택한 Workspace(Workspace)의 실제 동·층·호와 면적을 추가·삭제하고, 세대 명부(유닛 · 소유자 · 사용자)를 CSV 파일 하나로 검증하는 화면입니다. ✅구현(가져오기 확정은 ⚠️시연)

Organization Owner는 Owner 이메일 로그인에서 이 Workspace가 사용할 Unit Seat 최대 수량과 가격을 계약합니다. 실제 유닛은 이 화면에서 관리하며 화면에는 현재 활성 Unit 수만 표시합니다.

2026-10-18 KST — 유닛 상세 「소유·사용」 탭

유닛 이름을 눌러 연 유닛 상세에 세 번째 탭 소유·사용이 생겼습니다(탭 순서 일반 · 속성 · 소유·사용). 이 유닛을 누가 소유하고 누가 쓰는지, 관리비를 누구에게 청구하는지를 기간별로 봅니다. ✅ 보기만 하는 탭입니다.

카드	보이는 것
「소유」	소유자 · 소유 지분(「1/2」 같은 분수) · 기간. 위 오른쪽에 「현재 n명」
「사용」	사용자 · 사용 유형(임차 · 본인 거주) · 기간. 등록된 공실 기간은 사용자 칸에 「공실」
「청구 대상」	기간 · 청구 대상 · 근거(지정 · 사용자 · 공실 소유자 · 확인 필요). 첫 줄이 지금 기간

• 기간은 「2026-03-01 ~ 2026-11-30」처럼 마지막 날까지 적고, 끝이 없으면 「2026-03-01 ~」입니다. 옆의 현재 · 예정 · 종료는 오늘 날짜로 계산한 표시입니다. 지난 기간도 지우지 않고 모두 보입니다.
• 따라하기 — 월중 승계(예시마을 3단지 101동 101호): 기준정보 → 유닛에서 「101동 101호」를 누르고 소유·사용 탭을 엽니다. 「소유」에 김철수(2026-12-16 ~, 현재)와 홍길동(2019-03-01 ~ 2026-12-15, 종료)이 보이고, 「청구 대상」도 두 줄로 나뉩니다.
• 202호(박민수 퇴거)는 「사용」에 「공실」이 보이고, 청구 대상은 근거 「공실 소유자」로 박민수입니다.
• 1101호(법인 사택)는 소유자가 등록되지 않아 「소유」가 확인 필요입니다. 임대차 기간(~2027-06-30)에는 사용자인 법인이 청구 대상이고, 그 뒤는 「확인 필요 · 사용 기록 없는 날짜」입니다. 소유자를 임차인으로 짐작하지 않습니다.
• 관계가 등록되지 않은 유닛(시연에서는 101동 7세대 밖의 유닛)은 「없음」이 아니라 확인 필요로 보입니다. 아직 아무도 등록하지 않았는지, 정말 없는지 모르기 때문입니다.
• 고치려면 카드 끝의 「관리서비스 관계에서 변경」을 누릅니다. 관리서비스 계약 화면이 이 유닛으로 걸러진 채 열립니다. 이 탭에는 [편집]이 없습니다.
• 관계를 볼 권한이 없으면 이 탭이 보이지 않습니다.
• ❌ 이름을 눌러 그 사람의 상세를 여는 기능은 아직 없습니다.

2026-10-18 KST — 세대 명부 가져오기(이전 「CSV 가져오기」)

목록 위 동작 줄 오른쪽의 [가져오기](생성 바로 앞)를 누르면 세대 명부 가져오기 시트가 열립니다. 유닛과 그 유닛의 소유자 · 사용자 · 공실을 파일 하나로 한 번에 넣습니다. 이전 「CSV 가져오기」(유닛만)는 이 화면으로 합쳤습니다.

1. 파일 — [템플릿 받기 CSV]로 머리글만 든 빈 템플릿을 받습니다. 한 행에 유닛 하나와 그 유닛의 관계(소유 · 사용 · 공실) 하나를 적습니다. 파일을 끌어다 놓거나 「파일 선택」으로 고르고 [검증]을 누릅니다.
   • 시연: [예시 명부로 보기]를 누르면 101동 샘플로 만든 8행 예시 파일이 골라집니다.
2. 검증 — 맨 위에 「신규 n · 갱신 n · 변경 없음 n · 오류 n」이 보이고, 오류가 있으면 표가 오류 행만 고른 채 열립니다. 「행 상태」 조건을 비우면 모든 행이 보입니다. 각 행의 「내용」 칸에 무엇이 생기고 바뀌는지(예: 「유닛 그대로 · 당사자 신규 · 소유 신규」)나 오류 이유가 적혀 있습니다.
   • [오류 행 내려받기 CSV]: 오류 행만 담고 맨 끝에 「오류 사유」 열을 더한 파일입니다. 그 파일을 고쳐서 그대로 다시 가져오면 됩니다(비워 둔 유닛 · 사람 칸은 처음 나온 행의 값으로 채워 줍니다).
3. 가져오기 — [가져오기]를 누르면 「세대 명부를 가져올까요?」에 반영할 행 수와 오류 행 수, 청구 대상을 정할 수 없는 유닛 수가 다시 나옵니다. [가져오기]를 누르면 결과에 유닛 · 당사자 · 관계별 생성 · 갱신 건수가 보입니다.

⚠️ 지금은 시연입니다. [가져오기]를 눌러도 아무것도 저장되지 않고 「서버 연결 후 반영합니다」가 보입니다(유닛만 든 파일도 같습니다).

템플릿 열

동,층,호,타입,전유면적,주거공용면적,기타공용면적,지분,등록코드,주용도,이름,당사자 유형,휴대전화번호,사업자등록번호,법인등록번호,관계,사용 유형,소유 지분,시작일,마지막 적용일,청구 대상,청구 대상 근거,근거 참조,유닛 관리코드,당사자 관리코드

• 동 · 층 · 호 머리글은 프로퍼티에서 정한 표시 이름을 따릅니다(빌딩 · 층 · 유닛이라고 적어도 됩니다). 쓰지 않는 단계는 열이 없습니다.
• 새 유닛은 전유면적이 필요합니다. 이미 있는 유닛의 위치 · 면적 · 주용도는 건축물대장 값이라 가져오기로 바꾸지 않습니다(다르면 오류). 가져오기로 바꿀 수 있는 유닛 값은 타입 · 지분이고, 등록코드는 비어 있을 때 한 번만 채웁니다.
• 관계가 있는 행(공실 제외)은 이름과 함께 휴대전화번호 · 사업자등록번호 · 법인등록번호 · 당사자 관리코드 중 하나 이상을 적습니다. 이름만으로는 같은 사람인지 알 수 없어 합치지 않습니다.
• 관계는 「소유」 · 「사용」 · 「공실」, 사용 유형은 「임차」 · 「본인 거주」, 소유 지분은 「1/2」 같은 분수, 날짜는 YYYY-MM-DD입니다.
• 「청구 대상」에 「예」를 적으면 그 기간 이 사람을 청구 대상으로 지정합니다. 그때 「청구 대상 근거」(관리서비스 계약 · 약정)와 「근거 참조」가 꼭 필요합니다.
• 주민등록번호 · 외국인등록번호는 받지 않습니다. 파일은 CSV(UTF-8, EUC-KR도 읽음) · 최대 5MB · 데이터 5,000행입니다. XLSX는 CSV로 저장해서 올립니다.
• 이전 서식(등록코드,동명,층명,호명,용도,전용면적,…,공급면적,계약면적)으로 만든 파일도 당분간 그대로 읽습니다.

같은 대상 찾기와 오류

• 유닛은 유닛 관리코드, 없으면 동 + 호로 찾습니다. 사람은 당사자 관리코드 → 등록번호 → 이름 + 휴대전화번호 순서로 찾습니다. 이름 · 휴대전화번호로 찾은 행은 「내용」에 「이름 · 휴대전화번호로 찾음」이 보이니 맞는지 확인하세요.
• 공동 소유자(또는 공동 사용자) 중 한 행이 오류이면 같은 묶음의 다른 행도 반영하지 않습니다. 일부 소유자만 들어가 잘못 청구되지 않게 하기 위해서입니다.
• 관리코드와 사업자등록번호가 서로 다른 사람을 가리키면 오류입니다(「식별 정보가 서로 다른 당사자를 가리킵니다」).
• 이미 있는 관계의 기간 · 소유 지분 · 사용 유형을 바꾸려 하면 오류입니다. 관리서비스 계약 화면에서 바꿉니다.

2026-10-17 KST — 타입 · 지분 · 유닛 상세

• 목록에 타입과 지분 · 지분율 열이 생겼습니다. 위치 열 이름은 프로퍼티에서 정한 표시 이름(예: 동 · 층 · 호)을 따르고, 쓰지 않는 단계의 열은 보이지 않습니다. 주거공용 · 기타공용면적은 유닛 상세에서 봅니다.
• 검색 칸 아래 타입 조건으로 원하는 타입만 볼 수 있습니다(여러 개 고를 수 있음). 타입은 기준정보 → 프로퍼티 → 속성의 「타입」에서 만들고 이름을 바꿉니다.
• 지분은 의결권과 공용부분 관리비의 기준입니다. 따로 정하지 않으면 전유면적과 같고(「(전유면적)」 표시), 규약이 달리 정하면 유닛 상세에서 그 값을 넣습니다. 지분율은 이 프로퍼티 유닛 전체의 지분 합으로 나눈 값입니다.
• 유닛 이름을 누르면 유닛 상세가 열립니다. 일반 탭에 기본 정보 · 위치 정보 · 건축 정보, 속성 탭에 분류 정보(타입 · 주용도)가 있고, 고칠 카드 아래의 [편집]으로 그 카드만 고칩니다. 동 · 층 · 호와 주용도는 건축물대장 값이라 고칠 수 없습니다(ⓘ에 이유). ⚠️ 바꾼 값은 이 브라우저의 메모리에만 남고 새로고침하면 데모 값으로 돌아옵니다.

2026-10-17 KST — 전유면적 · 데모 유닛 · 유닛 이름

• 면적 이름이 전유면적으로 바뀌었습니다(공통 공간 정보 표준). 분양 공고의 (주거)전용면적과 같은 값이며, 유닛 추가 화면의 라벨 옆 ⓘ에도 적혀 있습니다. CSV 서식의 머리글도 「전유면적」이고, 예전 서식(「전용면적」)으로 만든 파일도 그대로 가져올 수 있습니다.
• 유닛 이름은 「{동} {호}」입니다(예: 「101동 1004호」). 층은 목록의 층 칸에 따로 보입니다.
• 데모 현장은 유닛이 미리 들어 있습니다: 예시마을 3단지 256호(101–104동 · 1–16층 · 층마다 4호), 예시마을 4단지 120호 (401–402동 · 1–15층). 84형(라인 1·4)과 59형(라인 2·3) 두 가지이며 실제 단지의 대장 값이 아닙니다. 가져오기는 이 목록을 갱신하는 흐름으로 시연합니다.

따라하기

1. 화면 상단에서 작업할 Workspace를 선택합니다.
2. 기준정보 > 유닛 또는 조직관리 > 워크스페이스 > 프로퍼티 > 유닛으로 이동합니다. 두 경로는 같은 유닛 원장을 엽니다.
3. 한 건을 등록하려면 추가를 누르고 호 이름과 필요한 면적을 입력한 뒤 추가를 누릅니다.
4. 여러 건을 넣으려면 가져오기를 누르고 위 「세대 명부 가져오기」를 따릅니다.

단건 추가는 상품 신청 여부와 무관한 Workspace 공간 관리 기능입니다. [가져오기]는 유닛을 바꿀 권한이 있고 관리비관리를 이용하는 Workspace에서만 보입니다. 유닛 원장을 불러오는 중에는 눌리지 않습니다(버튼에 마우스를 올리면 이유가 보입니다).

Unit Seat 한도

• 사용에는 현재 활성 상태인 실제 Unit 수만 표시합니다.
• 구매 수량·잔여 수량·구독 상태·계약 revision·가격은 Organization Owner 이메일 로그인에서만 확인하고 변경합니다.
• 한도를 초과하면 추가·복원이 저장되지 않습니다. 계약 상세는 이 화면에 표시하지 않으며 Organization Owner에게 문의하라는 안내가 나옵니다.

유닛 삭제

1. 목록 왼쪽에서 삭제할 유닛을 선택합니다.
2. 삭제를 누르고 대상 수를 확인합니다.
3. 다시 삭제를 누르면 활성 목록에서 제외됩니다.

삭제해도 과거 계약·부과·수납 기록과 유닛 식별자는 지워지지 않습니다. 삭제한 수만큼 Unit Seat를 다시 사용할 수 있습니다.

이전 유닛 CSV(2026-10-17까지 — 이행 기간에만 읽음)

2026-10-18 KST 전 서식입니다. 세대 명부 가져오기가 이 머리글도 읽습니다. 공급면적 · 계약면적은 합계만 확인하고 저장하지 않습니다.

등록코드,동명,층명,호명,용도,전용면적,주거공용면적,기타공용면적,공급면적,계약면적

• 등록코드는 고객이 확인하는 안정 코드입니다. 비워 둘 수 있고 중복도 허용하지만, 한 번 등록한 값을 다른 값으로 바꾸려면 정정 절차가 필요합니다.
• 시스템 관리코드는 자동으로 부여되며 CSV와 목록에는 노출하지 않습니다.
• 면적은 0 이상의 숫자로 입력합니다. 공급면적과 계약면적은 구성 면적 합계와 맞아야 합니다.
• 파일은 UTF-8 CSV, 최대 5MB, 데이터 최대 5,000행입니다. 따옴표로 감싼 쉼표와 큰따옴표 이스케이프를 지원합니다.

기존 유닛과 합쳐지는 방식(서버 연결 후)

• CSV에 있는 유닛은 같은 Workspace의 동명 + 호명 조합으로 기존 유닛을 찾아 추가하거나 갱신합니다. 시스템 관리코드는 처음 만든 뒤 유지됩니다.
• CSV에 없는 기존 유닛은 삭제하거나 비활성화하지 않습니다. 삭제는 목록의 선택 삭제로만 실행합니다.
• 같은 파일을 다시 보내면 중복 생성하지 않고 동일 결과를 돌려줍니다.
• 다른 사용자가 먼저 원장을 바꿔 버전이 달라지면 저장하지 않습니다. 목록을 새로 불러온 뒤 다시 확인하세요.
• Workspace의 기존 공공데이터 스냅샷은 덮어쓰지 않습니다. 공용 공간 식별자와 면적 프로필, 관리비 가져오기 이력만 갱신합니다.

오류 처리

머리글 · 인코딩 · 한도 · 따옴표처럼 파일 전체가 잘못되면 파일 단계에 오류 하나가 보이고 다음 단계로 가지 않습니다. 행 오류는 그 행만 빼고 나머지를 반영합니다(서버 연결 후). 오류 행은 [오류 행 내려받기]로 받아 고친 뒤 다시 가져오세요. 이미 반영한 행을 다시 올리면 「변경 없음」입니다.