본문으로 건너뛰기

Core

Composition·Billing·Resource Reference 변경

0.6.4

Composition 날짜·시간 정규화, Billing·Agent 가격 변경과 유효기간 Resource Reference 페이지 조회를 기록합니다.

수정

  • 서식 있는 본문을 일반 텍스트로 변환할 때 줄을 나누면서 다중 바이트 문자를 손상시키던 문제를 수정했습니다. 한국어 문서의 UTF-8 저장 오류를 방지합니다.

  • 에이전트 집계 도구에 필드 지정 형식, 숫자 집계의 빈 값 처리·결과 자료형, 정렬 옵션을 명시합니다. 잘못된 숫자 집계는 수정할 항목을 정확히 반환하며, 거절된 집계 요청을 시스템 오류 대신 요청 실패로 표시합니다.

  • 선예약을 꺼도 USD 과금 환율이 없으면 제공자 호출 전에 차단합니다. 기존 환율 누락 보류 건은 nexia-agent:resolve-credit의 --actual-cost, --currency=USD, --usd-to-krw로 원래 비용을 보존하며 복구할 수 있습니다. 관리자·사유·근거와 실행 종료 확인이 필요하며, 환율은 자동으로 선택하지 않습니다.

  • Composition 카탈로그가 App provider의 date-time 필드를 Core 표준 datetime 타입으로 정규화하여 선언된 일·월·분기·연 bucket을 사용할 수 있게 합니다.

변경

  • 링크 우클릭 메뉴에서 새 분할 영역·새 스페이스로 열거나 링크에 대한 에이전트 질문 초안을 준비할 수 있습니다. 질문은 자동 전송하지 않습니다. 공통 메뉴는 단축키를 포함한 가장 긴 항목에 폭을 맞추고 화면 너비를 넘는 문구는 줄바꿈합니다.

  • Public Event 목록 조회에서 컴파일한 불변 정의를 재사용하고 등록된 정의가 바뀌면 갱신합니다. 테넌트 권한을 캐시하지 않으면서 대량 이관의 반복 처리를 줄입니다.

  • MYTEC 시드 묶음에 과거 Core 콘텐츠와 총계정원장 전표를 포함할 수 있습니다. 콘텐츠는 접근이 제한된 초안으로, 전표는 기능통화 금액을 보존한 과거 기록으로 이관하며 원천 업무 효과를 재실행하지 않습니다. 새 MYTEC 테넌트는 기능통화를 KRW로 초기화합니다. 기존 테넌트의 통화는 자동 변경하지 않으며, 확장된 매출채권·매입채무 이관에는 원본 기반 총계정원장 시드와 KRW 기능통화가 필요합니다.

  • MYTEC 시딩에 People·근태/휴가·급여·채용·인재관리의 샘플 데이터를 함께 포함합니다. 기존 가상 인물을 연결해 휴가 잔액, KRW 급여 결과, 지원자와 자격 정보를 채우며 법인·운영조직을 추가하거나 실제 지급을 실행하지 않습니다.

  • 결제 개요에 최근 30일 크레딧 차트, 등록 원본 파일 용량과 실제 DB 크기 및 구독 제공량을 표시합니다. 저장공간 측정은 참고용이며 추가 과금이나 과거 용량 추이를 제공하지 않습니다. 최초 기본 요금제는 시딩 시 공개하며, 운영자가 종료한 버전은 일반 재시딩에서 보존합니다. 명시적인 기본값 교체는 새 공개 버전을 만듭니다. 가격 표시는 금액 뒤에 VAT 별도를 명시합니다.

  • 관리자·테넌트 크레딧 내역은 같은 사용자 요청의 호출별 차감을 한 행으로 합산합니다. 모델별 상세는 관리자에게만 제공하고 테넌트 API에서는 제외합니다. 실제 원장과 총 차감액은 변경하지 않습니다.

  • 크레딧 관리에서 관리자가 테넌트·수량·만료일·사유를 지정해 추가 지급할 수 있습니다. 구독 없이도 지급 가능하며 관리자와 지급 사유를 보존하고 동일 요청의 중복 지급을 방지합니다. 추가 지급은 기존 미정산 사용액에 먼저 사용될 수 있습니다. 신규 Central 마이그레이션이 필요합니다.

  • nexia-platform:replace-defaults --apply로 기본 요금제·청구 정책·Agent 카탈로그·일반 설정을 교체할 수 있습니다. 청구 정책의 테넌트 예외와 예약 변경은 취소하며 기존 구독·원장은 보존합니다. 청구 작업은 첫 기존 관리자 계정에 시스템 CLI 작업으로 기록됩니다. Agent만 교체하려면 nexia-agent:replace-catalog --apply를 사용합니다. 두 명령 모두 --apply를 생략하면 미리보기이며 관리자 ID·사유 입력은 필요 없습니다. 제공자 키와 테넌트 업무 데이터는 교체하지 않습니다.

  • 모델의 캐시·장문맥 단가를 항상 표시하고 통화와 청구 항목을 가격 영역 맨 위에 배치합니다. 시딩에는 2026-09-18 공식 표준 단가를 확인한 18개 모델의 가격을 포함하며, 미확정 모델 3개는 비워둡니다. 재시딩은 관리자 변경 이력이 없고 단가가 모두 비어 있는 USD 모델만 채우며, Router가 없으면 Claude Sonnet 5와 GPT-5.6 Terra를 기본 후보로 지정합니다. 기존 가격·제공자 키·등급 배정·Router 설정은 유지하며 실시간 가격 동기화는 아닙니다.

  • Central Agent 메뉴를 제공자 키, 모델, 등급, 역할, 설정, 사용량, 분석 실행 순서로 정렬합니다.

  • Resource Reference 제공자는 권한 범위 전체를 누락 없이 처리해야 하는 서버 작업을 위해 유효기간 모집단 페이지 검색을 제공할 수 있습니다.

  • 데모 테넌트 시딩에 결제 완료된 연간 구독, 정산 내역, 월별 크레딧 지급 데이터를 추가하며 결제사를 호출하지 않습니다. 데모 테넌트를 초기화하면 해당 테넌트의 Billing 기록도 제거하고 시연 데이터를 다시 생성합니다.

  • Agent 사용자별 사용량에 실제 차감된 전체·이번 달 크레딧과 정산 보류 상태를 표시합니다. 사용량·운영 화면의 토큰 수치는 임시로 숨기고, 에이전트 도구 설정 메뉴와 직접 URL을 비활성화합니다. Agent의 도구 실행 기능은 유지합니다. 구독 안내에서는 내부 구현 용어인 '로컬'을 제거합니다.

  • 작업에 고정된 고객 환산율과 크레딧 단가로 누적 0.1크레딧 단위로 차감합니다. 플랫폼 호출마다 Central에서 한 번만 실행을 승인합니다. 기본적으로 사전 예약 없이 잔액이 양수이면 호출하고 실제 사용량을 차감하며, 초과분은 음수 가용 잔액으로 남겨 이후 지급분에서 상계합니다. 선택적으로 예약 모드를 켜면 기존 상한 검증과 금액 확보를 적용합니다. 사용량 불명 건은 명시적으로 복구하며 Gateway HTTP·테넌트 DB 연결은 제한된 풀에서 재사용합니다.

  • 사용료 관리 메뉴에 정책 변경 이력·예약 적용·테넌트별 예외를 추가합니다. 청구 당시 조건은 보존하며 미완료 구독 적용과 크레딧 지급은 자동·수동 재시도할 수 있습니다. 청구서 발행, 적용 지연·완료, 만료 예정 안내를 기존 알림·이메일 경로로 연결합니다. 테스트 모드는 이메일을 발송하지 않습니다. 환불 공제율 설정은 보존하지만 환불 실행은 후속 작업입니다.

  • Central 운영자가 결제사 연결 없이 원화 요금제 가격과 제공량을 버전별로 작성·공개할 수 있습니다. 공개한 조건은 보존합니다. 고객은 월·연 구독을 신청하고 청구서·수납 상태·PDF를 확인할 수 있으며, 운영자는 세금과 발행자를 확인해 발행하고 수동 입금을 기록할 수 있습니다. 전액 수납 후 구독을 적용하며 실패한 적용은 재처리합니다. 기본값은 접수 중지이고 테스트 결제는 개발·테스트 환경으로 제한합니다. 초기 구독만 지원하며 갱신·환불은 후속 작업입니다.

  • 구독 크레딧을 매월 지급하고 만료시키는 별도 원장과 고객·운영자 조회 화면을 추가합니다. 연간 결제도 월별 지급하며 남은 포함 크레딧은 이월하지 않습니다. 사용료 정책에 최초 지급 대상 시각을 명시해야 하며(초기 기본값은 BILLING_CREDIT_GRANTS_START_AT), 중복·지연 처리를 복구할 수 있습니다.

  • Central에서 운영 보고용 월별 환율을 수기로 기록할 수 있습니다. 정정은 새 버전으로 보존하며 고객 크레딧이나 청구액을 변경하지 않습니다. 손익 보고서 계산은 후속 작업입니다.

  • Agent 실행 모델은 운영자가 과금 토큰 항목과 가격을 확인해야 선택됩니다. 무료 항목도 가격 0을 명시해야 합니다. 기존 모델은 마이그레이션 후 미확인 상태로 남으며 가격 확인 전에는 새 요청에 사용되지 않습니다. 테넌트 BYOK 선택·관리는 비활성화하되 저장된 키와 과거 사용 내역의 귀속 정보는 보존합니다.

  • Gateway 원가 계산부터 Central 집계까지 가격 스냅샷과 비용의 소수 정밀도를 보존합니다. Gateway 변경을 적용하기 전에 호환되는 Core 스키마·수집 경로를 반영하고 모델 가격을 확인해야 합니다. 기존 숫자형 사용량 전달은 복구할 수 있습니다. 비토큰 원가 전체 집계는 포함하지 않습니다.

호환성

  • Central·Tenant 과금 마이그레이션을 적용한 뒤 Core와 Gateway를 함께 전환해야 합니다. 과금 전용 Redis나 신규 의존성은 필요하지 않습니다. BILLING_CREDIT_RESERVATION_ENABLED 기본값은 false이며 관리자 호출당 예약 한도는 숨기고 적용하지 않되 저장값은 보존합니다. 기존 작업은 시작 시 적용된 방식을 유지합니다. 신규 실사용 차감 작업에는 예약용 모델·입력 상한 검증을 적용하지 않으며, 가격 검증과 기존 Provider 지원 범위는 유지합니다. 모델 가격 변경에는 관리자 변경 사유가 필요합니다.
  • 기존 provider 선언은 그대로 사용할 수 있으며 App 수정은 필요하지 않습니다.
  • 영향을 받는 provider 필드를 선택한 저장 보고서와 widget은 필드 fingerprint가 다시 계산될 때 미리보기를 갱신하고 재저장해야 할 수 있습니다.