본문으로 건너뛰기

Core

독립 SDK 채택과 App 호환성

0.5.0

독립 Laravel·React SDK 패키지를 채택하고 Core 0.5.0의 App 호환성, 로컬 개발, 리포트, 온보딩과 탐색을 개선합니다.

변경

  • Core는 독립 App SDK artifact인 PHP amuzcorp/nexia-app-sdk-laravel 0.5.0과 React @amuzcorp/nexia-app-sdk-react 0.5.0을 사용합니다. 이전 통합 SDK 패키지와 legacy namespace는 Core에서 더 이상 지원하지 않습니다.
  • 게시된 App은 독립 버전을 유지하며 이미 두 SDK artifact에 ^0.5.0을 요구합니다. Core 0.5.0을 적용하기 전에 extra.nexia.core_version에 ^0.5.0을 선언한 App 릴리스를 게시하고, 해당 릴리스 artifact로 Composer·pnpm lock을 다시 생성하세요.
  • 로컬 setup·rebuild는 Composer가 Laravel을 부팅하기 전에 없는 application key를 준비하고, ignore된 auth.json 또는 승인된 호스트 인증 fallback으로 private Composer·npm 인증을 복원합니다. 로컬 PAT를 교체한 뒤에는 task apps:auth REPLACE=1을 사용하세요.
  • 로컬 React SDK 소스를 선택하면 Vite는 Core 개발 서버보다 먼저 SDK 빌드 감시를 시작합니다. SDK 소스를 수정하면 개발 lock이 .pnpm-local에 있어도 의존성을 다시 설치하지 않고 연결된 distribution을 다시 만듭니다.
  • 리포트 작성자는 기준·연결 데이터를 함께 선택하고 결과 구성, 조건, 계산과 정렬을 설정할 수 있습니다. 데모 리포트 시딩은 사용자가 수정한 정의를 바꾸지 않고 업무 데이터 예제를 추가합니다.
  • 온보딩은 사용자별 private 도우미 대화를 다시 열 수 있고, 조직도 가져오기 또는 운영 조직 직접 등록을 지원합니다. 기존 일반 Agent 대화는 자동으로 다시 분류하지 않습니다.
  • 일반 탐색은 현재 작업 탭을 유지합니다. 지원되는 링크는 새 내부 작업 탭에서 명시적으로 열 수 있으며, 작업 영역 이동·병합과 파괴적인 닫기는 사용자가 분명히 선택해야 합니다.

수정

  • 로컬 패키지 갱신은 실제 Composer 패키지 변경 전일 때만 이전 contribution manifest를 지워 오래된 설치 패키지 metadata를 방지합니다.
  • 조직 가져오기 검토에서 하위 조직을 상위 조직으로 선택하거나 열 연결을 중복으로 선택하지 못하게 했습니다. 원본 데이터가 바뀌면 오래된 미리보기와 수정값을 지우고, 검증 중에는 편집 동작을 사용할 수 없습니다.
  • 저장한 대시보드 행을 탐색 링크로 열어도 컨텍스트 메뉴에서 즐겨찾기와 기본 대시보드 설정을 계속 사용할 수 있습니다.
  • 온보딩 진행 단계는 표준 버튼을 사용해 포커스와 비활성화 상태를 일관되게 표시합니다.

업그레이드 필요

  • nullable Agent 대화 목적과 사용자별 private 온보딩 대화 한 개를 추가하는 테넌트 마이그레이션을 실행하세요. 이전 일반 대화는 유지하며 자동으로 변환하지 않습니다.
  • 함께 제공하는 Payroll 0.3.3 테넌트 마이그레이션은 기존 표준 세금·보험 요소 카테고리를 바로잡습니다. 업그레이드 시 일반 테넌트 마이그레이션을 실행하면 되며 별도 데이터 보정 작업은 필요하지 않습니다. 이미 올바른 테넌트 행이 바뀌지 않도록 down 마이그레이션은 이 보정을 되돌리지 않습니다.
  • 폐기한 SDK 패키지를 0.5.0 SDK artifact 둘 중 어느 하나와도 함께 설치하지 마세요. Core ^0.5.0과 호환되는 App 릴리스 및 게시된 SDK artifact로 Composer·pnpm lock을 다시 생성하고 배포 전에 커밋하세요.