Leyve Docs

다크모드

저장소 네이밍 — 한눈에 보기 ​

결론: 사용자 접점은 leyve-{surface-id}-{client-platform}, 업무 백엔드는 leyve-{domain}-{backend-component}로 이름을 짓습니다. service는 백엔드 업무 서비스이며 full-stack을 뜻하지 않습니다.

최종 Surface 목록 ​

text
leyve-console-web

leyve-customer-portal-web
leyve-staff-portal-web

leyve-customer-kiosk-web
leyve-staff-kiosk-web

leyve-partner-center-web
leyve-ops-center-web

leyve-www-web
어휘경계
console고객사 관리자·실무자의 Leyve 핵심 업무 workspace
customer/staff-portal고객 또는 고객사 직원의 self-service
customer/staff-kiosk고객 또는 고객사 직원이 쓰는 공유 단말·짧은 터치 흐름
partner/ops-center파트너 또는 Leysys 본사의 운영 backoffice
www불특정 방문자를 위한 공개 홍보·정보 surface

customer는 개인·개인사업자·법인사업자를 모두 포함합니다. staff는 고객사 직원, partner는 총판·리셀러, ops는 Leysys 본사 운영자를 뜻합니다.

기본 문법 ​

text
# 사용자 접점
leyve-{surface-id}-{client-platform}

# 업무 백엔드
leyve-{domain}-{backend-component}

# 선택: 화면 크기별 앱이 실제로 별도 저장소·빌드·배포일 때
leyve-{surface-id}-{form-factor}-{client-platform}
  • 모든 이름은 영문 소문자 kebab-case를 사용합니다.
  • client platform은 web, ios, android를 사용합니다.
  • form factor는 mobile, tablet, desktop만 사용합니다.
  • 반응형·adaptive 앱에는 form factor를 붙이지 않습니다.

Component 선택 ​

대상기본 suffix예
사용자 접점web, ios, androidleyve-console-web, leyve-customer-portal-ios
한 surface 전용 백엔드bffleyve-console-bff
하나의 업무 영역service, api, workerleyve-billing-service, leyve-auth-api
여러 업무 영역의 공유 백엔드serverleyve-server
제품 전체의 공통 ingressgatewayleyve-gateway
surface 전체를 한 단위로 소유하는 full-stack 예외suffix 없음leyve-{surface-id}

web의 짝이 자동으로 service가 되는 것은 아닙니다. 화면 전용 조합 계층이면 bff, 업무 규칙이면 {domain}-service, 여러 domain을 이미 함께 제공하면 leyve-server입니다.

반드시 지킬 규칙 ​

  1. service를 full-stack 의미로 사용하지 않습니다.
  2. web은 정적 사이트라는 뜻이 아닙니다. SPA·SSR·SSG, 게시판, 폼, 메일 전송이 있어도 주 제공물이 웹이면 -web을 유지합니다.
  3. 특정 surface 전용 API 조합은 service나 api가 아니라 bff로 표현합니다.
  4. leyve-server가 이미 담당하는 기능을 같은 책임의 *-service로 중복 생성하지 않습니다.
  5. 태블릿에서 실행된다는 이유만으로 tablet을 붙이지 않습니다. 실제로 별도 저장소·빌드·배포일 때만 form factor를 붙입니다.
  6. ios·android는 운영체제이고 mobile·tablet은 form factor입니다. iphone·ipad 같은 제품명은 쓰지 않습니다.
  7. 신규 저장소에서 bare portal, kiosk, center와 consumer-*는 사용하지 않습니다.
  8. suffix 없는 full-stack surface와 iOS·Android 동시 산출 monorepo는 이름을 임의로 정하지 않고 ADR 승인을 받습니다.
  9. 예외와 기존 저장소의 물리적 rename은 ADR에서 경계·배포·전환 계획을 먼저 확정합니다.

정의, 호환 규칙, 생성 판단 순서는 상세 규칙에서 확인합니다.