문서 소유권과 아키텍처 경계
문서 소유자는 내용의 적용 범위로 판정합니다. 회사 전체가 함께 따르는 company-wide 공통 정의·표준·계약은 Leysys Docs, 특정 제품에만 적용되는 product-wide 업무 의미·구성·운영은 그 제품의 Docs가 소유합니다. Leyve Docs는 product-docs의 한 사례입니다. 두 사이트는 이 책임에 따라 유지하고, 같은 규칙을 두 곳에서 따로 확정하지 않습니다.
2026-10-01 KST에 공통 네이밍 정본을 Leysys Docs로 모으고 Leyve 공개 용어 문서의 편집 정본을 Leyve Docs로 정리했습니다. 이 변경은 문서와 참조 경계의 정리이며 제품 배포나 런타임 이행의 완료를 뜻하지 않습니다.
주제별 정본
| 주제 | 정본 | 다른 문서가 하는 일 |
|---|---|---|
| 공통 서비스·공통 모듈·업무 모듈·플랫폼·단독 브랜드·Core | 제품 구조와 용어 | 제품 문서는 해당 플랫폼의 모듈·구성을 설명합니다 |
| 저장소·호스트의 공통 문법, audience·접점 유형·전용 기기 | 저장소·호스트 네이밍 | 제품 문서는 실제 등록·배포·이행 상태를 기록합니다 |
| 회사 공통 웹 라이브러리 선택 기준 | 웹 라이브러리 선택 | 정확한 버전·구현 wrapper·제품 예외는 제품 저장소와 적용 문서가 소유합니다 |
| 회사 공통 자금이체·계좌 역할 명명 | 자금이체 계좌 역할 명명 | 실제 흐름의 기준점·권한·회계 처리는 제품이 설명합니다 |
| 회사 공통 직원 접근 역할과 권한 판정 | 접근 역할 체계 | 결정 기록과 접근 UX는 leysys-design이, 제품별 권한 표·채택·의도적 편차는 제품 저장소와 제품 Docs가 소유합니다 |
| 사용자·조직·현장·계약 당사자와 청구 관계 | 사용자·조직·현장과 계약·결제 | 결정 기록·접근 UX는 leysys-design, 세션·권한 표·불변 snapshot·제품 채택은 소유 제품이 관리합니다. 문서 승인과 운영 인증 이행은 구분합니다 |
| 회사 공통 레코드 식별 필드(고유코드·관리코드·등록번호·유형·상태·이름)와 삭제 규칙 | 레코드 식별 필드 | 결정 기록과 화면 표현은 leysys-design이, 제품별 레코드 종류·접두어·상태 흐름·채택·의도적 편차는 제품 저장소와 제품 Docs가 소유합니다 |
| 기록·로그·메시징의 업무 출처·전체 조회와 직원 발송 자격 | 업무 출처·전체 조회와 메시징 | 화면 패턴은 leysys-design, 제품의 원장·권한 표·채택은 소유 제품, 운영 발송은 승인된 연동 실행 주체가 소유합니다 |
| 공유소유 대표 소유자와 현장별 대표 유닛 | 대표 소유자와 대표 유닛 | 결정 기록·접근 UX는 leysys-design, 소유 관계·선정 모델·원장·제품 채택은 소유 제품이 관리합니다. 실제 행사자·계약 당사자·과금 수량은 각 업무 원본을 유지합니다 |
| 회사 공통 입력 정보(당사자·사업자·조직·연락처·주소 필드, 값 형식, 예시 값) | 공통 입력 정보와 다섯 분야 쪽 | 이 표준은 Leysys Docs가 정본이고, leysys-design 결정 기록이 근거·검토·현황을 가집니다. 입력 화면 구현은 leysys-design이, 제품별 채택·데이터 이행·의도적 편차는 제품 저장소가 소유합니다 |
회사 공통 공간 정보(프로퍼티·빌딩·층·유닛 필드, 면적, 타입·주용도, 유닛과 당사자의 관계·소유·사용 탭, 예시 값) | 공간 정보 | 이 표준은 Leysys Docs가 정본이고, leysys-design 결정 기록 SPACE-FIELDS-2026-10-17 · UNIT-OWNERSHIP-OCCUPANCY-TAB-2026-10-18이 근거·검토·현황을 가집니다. 대장 연동·관계 원장·청구 대상 계산·제품별 채택과 데이터 이행은 소유 제품이 관리합니다 |
| 기준정보 명부 가져오기(유닛·당사자·관계 파일의 템플릿 열·같은 대상 찾기·행 상태·오류 행 파일·서버 책임) | 기준정보 명부 가져오기 | 결정 기록 MASTER-DATA-ROSTER-IMPORT-2026-10-18과 작업 화면 합성은 leysys-design이, 관계 레코드의 같은 대상 찾기 코드 계약(findSameRecord)은 Zution 관계 코어 계약이, 서버 판정·원장·제품별 선택 열과 채택은 소유 제품이 관리합니다 |
| 공통 가격 계산과 조정 규칙 | 가격 규칙 | 플랫폼·브랜드 가격표와 제품 계약이 금액·적용 정책을 소유합니다 |
| 공통 청구 기간 유형·일할 기준·계약 참조 | 청구 기간 정책 · 계약 참조와 청구번호 | 제품은 채택 유형·예외·구현 상태를 소유하며 검토안을 자동 적용하지 않습니다 |
| 결제·연동의 공통 원칙과 기존 구현 참고 | 이 사이트의 아키텍처 경계 | 제품별 실행 주체·채택은 적용 범위가 명시된 제품 문서에서 결정합니다 |
| Billing Authority의 실행 schema와 상태 전이 | leysys-control-plane | 해당 구현을 채택한 제품에 적용합니다. 모든 제품의 결제 정본을 뜻하지 않습니다 |
| 제품 소유 결제의 실행 schema와 상태 전이 | 해당 제품·런타임 저장소 | 공통 원칙을 참조하고 자체 실행 구조·운영 상태를 기록합니다 |
| Integrations gateway의 schema·provider routing | leysys-integrations | 해당 구현의 소비 제품은 capability 계약을 따르며 gateway가 provider binding을 소유합니다 |
| 디자인 token·component·pattern·접근 UX | leysys-design | 제품은 게시된 패키지와 canonical registry item을 채택합니다 |
| 설계 원칙·디자인 시스템·제품 아키텍처의 해설 | Leysys 설계 핸드북 | 판 단위의 해설서입니다. 규칙과 값은 위 각 정본이 정하고, 핸드북은 다음 판에서 따라갑니다 |
| Leyve 용어 분류와 업무 모듈·내부 코어의 의미 | Leyve Terms (새 탭)와 제품·모듈·운영 (새 탭) | 공통 정의는 링크하고 Leyve의 업무별 소유권·현재 기술 식별자를 설명합니다 |
| Leyve 기능·운영 매뉴얼과 BE/FE 구현 안내 | Leyve Docs (새 탭) | 기능의 실제 상태는 소유 제품 저장소의 코드·테스트로 확인합니다 |
같은 단어의 계약을 구분합니다
- 판매 플랫폼은 Leyve·Arenity입니다. 네이밍 문법의
client-platform은 web·iOS 등의 실행 환경이고,shared-platform은 server·gateway 같은 공유 실행 기반입니다. - Core는 플랫폼의 필수 기본 항목입니다.
Billing Core,Document Core,Platform Core같은 내부 기술 코어는 재사용 구현 경계이며, 이름이 Core라는 이유로 개별 판매 항목이 되지 않습니다. - 업무 모듈은 플랫폼에서 조립하는 독립 업무 단위입니다. 코드·DB의
Product,ProductActivation, 결제의product_key같은 기존 식별자는 실행 계약을 확인한 뒤 별도 이행합니다. 문서 어휘를 맞춘다는 이유로 문자열을 일괄 치환하지 않습니다. - 업무 모듈과 repository·service는 N:M 관계일 수 있습니다. 업무 의미의 소유 경계와 코드·배포 경계를 나누어 설명하고 모듈마다 별도 저장소를 자동 생성하지 않습니다.
- 네이밍 수식의
product는 플랫폼·브랜드의 route namespace입니다. 모듈 키나 결제 catalog의 식별자와 자동으로 같은 값이 되지 않습니다. - Console·Center·Portal·Kiosk는 네이밍의 접점 유형입니다. Portal은 해당 사용자에게 허용된 전체 셀프서비스, Kiosk는 현장·공용 단말에서 최소 업무를 짧게 처리하는 접점입니다.
mobile / tablet / desktop전용 기기와 구분하며, 공통 업무 규칙을 재사용해도 각 접점의 화면 흐름·세션 수명은 별도로 소유합니다. - 고객 audience token은
customer로 통일합니다.consumer나end user의 일반적인 의미까지 대체하는 결정은 아닙니다. 계약 고객사와 해당 업무의 최종 고객의 관계·권한은 제품 문서가 명시합니다. - 공통 계정 기능의 구현을 재사용해도 단독 브랜드의 가입·계정 경계는 별도입니다. 같은 이메일이나 같은 사람이라는 이유로 브랜드 간 identity를 합치지 않습니다.
공개 문서와 제품 원본
Leyve Docs의 terms/ 분류 허브와 product-module-operations/ B 타입은 앞으로 Leyve Docs가 편집 정본을 소유합니다. Console에 남은 같은 문서는 과거 snapshot이며, 이를 공개 문서로 자동 재복사하지 않습니다. 제품은 최신 공개 정본을 참조하고 기술 식별자·구현 상태만 자체 문서에 기록합니다.
이 전환은 manual/, finance-accounting-tax/ A 타입·회계 문서, dev/backend/·dev/frontend/ handoff의 기존 원본·미러 계약을 바꾸지 않습니다. 이 문서는 Console 원본을 Leyve Docs가 게시하는 기존 경계를 유지하며, 변경할 때 해당 원본과 미러를 함께 갱신합니다. Console의 기존 지침·snapshot을 바꾸는 작업은 Console 저장소의 별도 채택 변경으로 검토합니다.
문서 변경과 런타임 채택
- 공통 정의를 이 사이트에서 확정하고 변경 이유·이행 범위를 기록합니다.
- Leyve 등 제품 문서는 공통 정의를 링크하고 제품 적용·의도적인 차이·현재 구현 상태를 구분합니다. 과거의 조직 기본료나 Product 명칭을 현재 판매 규칙으로 소개하지 않습니다.
- 실제 코드·DB·인증·계약 파일·repository·hostname 변경은 소유 저장소에서 migration과 검증을 진행합니다. 문서 개정만으로 그 채택을 완료했다고 표시하지 않습니다.
- 문서 Review는 내부 링크·생성된 페이지·관련 계약 검사를 확인합니다. 공개 배포와 runtime 이행 검증은 각각 별도로 기록합니다.