서비스 라이브러리 학습 순서

메일을 보내거나 파일을 저장하는 프로그램은 호출 결과와 실제 서비스의 상태를 함께 확인해야 합니다. 이 장은 Unibase 표준 라이브러리로 업무를 작성하고, 목표 플랫폼의 코드로 변환하며, Market에서 진입한 SaaS 미리보기에서 동작을 확인하는 흐름을 배우기 위한 안내입니다.

먼저 전체 흐름을 이해하기

2026-10-07 08:19 UTC의 승인 설계에서 Market은 상품 revision·artifact 검증 정보와 새 탭 미리보기의 진입점, SaaS는 앱·SQLite DB·세션 runtime·provider의 실행 환경, Unibase는 host에 종속되지 않는 export·generator·SDK를 맡습니다. 연결 계약은 조율 중이며, 미리보기는 가상 메일·모의 과금·세션 임시 저장을 사용하고 실제 거래를 하지 않습니다. 역할과 미완료 범위를 먼저 확인하세요.

업무 목표를 정한 뒤, 공통 라이브러리 메타데이터에서 사용할 기능과 타입을 찾습니다. 목표 플랫폼과 provider의 지원 상태를 확인하고, 그 계약에 맞는 모델·코드를 작성합니다. 변환과 빌드를 확인한 다음, 미리보기에서 실제 관측한 결과와 기대를 비교합니다. 운영 연결은 미리보기와 별도로 확인해야 합니다.

사람이 읽는 API 안내와 AI가 MCP로 조회하는 능력·타입·예제는 같은 생산자 메타데이터를 기준으로 제공하는 것이 승인된 목표입니다. 현재 문서에 독자적인 메서드 목록을 만들어 compiler의 지원 목록과 분리하지 않습니다.

어떤 작업을 배우려는지 정하기

메일은 첫 계약의 실제 타입·제약·생성 예제를 읽을 수 있습니다. 다음 표의 다른 과제는 미구현이며 지금 실행할 수 있는 예제나 API 이름 목록은 아닙니다.

작업 목표	학습할 내용	확인할 결과
메일로 알림 전달	메시지의 타입, 수신 대상, provider 선택, 실패 상태	어떤 메시지를 어느 환경에서 처리했는지
자료 저장·조회	저장 위치와 객체의 식별, 내용 타입, 접근 범위	저장한 내용과 읽은 내용이 일치하는지
파일 전송	전송 대상, 크기·내용 조건, 완료와 실패	수신한 파일의 내용·크기와 완료 상태
사용자 인증	인증 결과, 사용자 식별, 권한 확인의 차이	인증된 사용자와 허용된 작업의 범위
결제 처리	금액·통화·거래 상태의 타입, provider와 환경	시뮬레이션 결과 또는 실제 거래 상태의 근거

메일 목록은 실제 compiler가 반환한 공통 메타데이터를 사용합니다. 미구현 영역의 namespace·메서드·provider를 추측해서 추가하지 않습니다. 기존 Standard 선언 목록과 새 서비스의 지원 범위도 구분합니다.

순서대로 배우기

프로그램 구조와 타입 및 변수와 제어 흐름에서 메서드 호출·반환값·조건을 익힙니다.
타입·provider·오류 확인에서 필요한 입력과 결과, 지원 대상과 실패 처리를 확인합니다. Mail 첫 계약 읽기에서 이 기준을 실제 선언과 생성 fixture에 적용해 봅니다.
미리보기와 운영 연결에서 시뮬레이션으로 확인한 것과 실제 서비스에서 확인해야 할 것을 구분합니다.
안전한 예제와 확인 범위에서 원본·등록 ID·hash·실제 실행 결과를 읽는 순서를 익힙니다.
AI와 공통 메타데이터에서 능력 검색부터 모델 작성·검증 피드백까지의 목표 흐름을 확인합니다.

준비 상태 읽기

단계	이 초안에서의 상태
학습 순서와 확인 기준	작성됨
mail typed API·provider·플랫폼 계약	compiler 반환 정의와 MCP 조회, profile schema 소비 확인
다른 서비스 영역	NOT_IMPLEMENTED
mail 생성 입력과 SDK 원본	원본·hash·공통 메타데이터 연결 확인, 앱 실행 미검증
새 서비스 예제의 실제 UI 실행	미검증
기존 문자열 예제 UI	과거 P1 결과 표시 수정 반영. 성공·실패·언어 탭 회귀로 확인하며 운영 배포는 별도
새 기능의 main 병합·서비스 배포·QA	이 문서에서 완료로 판정하지 않음

학습 안내가 작성된 상태와 실행 가능한 예제가 검증된 상태는 다릅니다. 처음에는 API 목록보다 자신의 작업 목표, 필요한 값, 결과를 확인할 환경을 먼저 정하세요.