로그인브리핑 예약

챕터 2.24

맞춤형 산업군 팩 엔드투엔드 빌드

최초 기획안부터 모든 유닛에서 실행되는 릴리스까지, 지식 모델, 렌즈, 스킬, 풀서비스 플러그인 및 샘플 데이터를 갖춘 콜드체인 도메인 팩의 전체 빌드 과정을 살펴봅니다. 이어서 기존 팩을 확장하는 방법과 이미 배포된 팩에 렌즈를 추가하는 방법을 다룹니다.

이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

읽는 시간 19분

저는 Corrán Orbital의 개발자 Mateo Ruiz입니다. 한 주의 대부분은 저희 자체 페이로드 소프트웨어 작업에 쓰지만, 이 장은 저희가 고객을 위해 수행한 작업에 관한 것입니다. Larkfield & Vane은 화물 보험을 취급하며, 그 화물 중 점점 더 많은 비중이 냉장 컨테이너로 운송됩니다. 리퍼 컨테이너가 부두에서 육상 전원을 잃으면 온도가 올라가고, 화물이 상하며, 몇 주 뒤 보험금 청구가 뒤따릅니다. Larkfield는 직원들이 전원 장애부터 청구까지 이 연쇄를 Nexus에서 하나의 흐름으로 보되, 각 역할은 자기 부분만 보기를 원했습니다. 그것이 Cold chain 팩이 되었습니다.

이어지는 내용은 저희가 진행한 순서대로의 구축 과정이며, 화면, 파일, 명령을 함께 담았습니다. 실수도 그대로 남겨 두었습니다. 저희가 마주친 두 번의 거부가 순조로운 경로보다 플랫폼에 대해 더 많은 것을 알려 주었기 때문입니다. 참고 자료는 이 장 앞의 장들에 있으며, 반복하기보다는 해당 장을 안내합니다. 제가 가장 많이 참고한 것은 2.18장 확장 모델과 2.23장 도메인 팩이었고, 소프트웨어 개발 키트 자체에 대해서는 2.21장 Plugin SDK를 옆에 펼쳐 두었습니다.

왼쪽에서 오른쪽으로 이어지는 상자 여덟 개의 경로: "브리프", "골든 패스", "지식 모델", "렌즈", "스킬 및 플러그인", "샘플 데이터 및 미리 보기", "릴리스 검토", "승격". 마지막 상자 아래에는 화살표로 연결된 작은 상자 네 개의 두 번째 행이 승격 단계를 보여 줍니다: "개발 공간", "스테이징", "파일럿 단위(Rotterdam)", "모든 단위". 각 화살표에는 "게이트"라고 표시된 자물쇠 아이콘이 있습니다. "개발 공간"에서 "모든 단위"로 바로 이어지는 점선 화살표는 X 표시로 지워져 있으며 GATE_CANNOT_BE_SKIPPED라고 표시되어 있습니다.
Cold chain 구축: 요구사항 정리부터 모든 단위까지.

기획안 및 역할 분담

Larkfield는 프로젝트 기간 동안 자사 조직 내 개발자 좌석을 저에게 제공했습니다. 이는 중요합니다. 한 고객을 위한 비공개 팩은 해당 고객의 설치 환경 안에서, 그 고객의 개발 공간과 데이터 브랜치에서, 그 고객 직원들의 승인 아래 구축되기 때문입니다. 여러 고객을 위한 팩은 샘플 데이터만 있는 퍼블리셔 클러스터에서 다르게 구축되며, 그 경우는 2.25장 에디션별 구축에서 다룹니다.

요구사항은 한 페이지에 들어갔습니다.

  • 부두와 선박에 있는 리퍼 컨테이너: 그 전원, 온도 이탈, 그리고 그에 따른 청구.
  • 시작 시 두 가지 역할: 부두의 리퍼 기술자와 사무실의 콜드체인 관제 담당자.
  • 먼저 Rotterdam 단위에서 실행한 뒤 Felixstowe로 옮기는 파일럿.
  • 세 가지 규정에 대한 증빙: 부패하기 쉬운 식품에 관한 ATP 협정, 의약품에 관한 EU 우수 유통 관리 기준, HACCP(위해요소 분석 및 중요 관리점)에 따른 식품 안전 기록. Hague-Visby 규칙에 따른 청구도 동일한 이탈 기록을 사용하므로, 파일럿 이후 과제로 기록해 두었습니다.

도메인 팩은 Enterprise 기능입니다. Larkfield는 Enterprise를 사용하므로 도메인 팩 경로를 이용할 수 있었습니다. Community에서는 팩용 골든 패스가 아예 제공되지 않습니다.

골든 패스에서 시작하기

모든 작업은 새로 시작하기 페이지에서 시작됩니다. 이 페이지는 플러그인, 도메인 팩, 렌즈, 플랫폼, 스킬, 워크플로의 여섯 가지 골든 패스를 제공합니다. 각 경로는 버전이 지정된 템플릿으로부터 저장소, 해당 항목에 필요한 것을 선언하는 매니페스트, 테스트, 개발 공간, 데이터 브랜치를 만듭니다. 동일한 경로를 콘솔, 명령줄, IDE(통합 개발 환경)에서 사용할 수 있으며, IDE에서는 Workbench 도구 nexus.create이(가) 먼저 확인하는 계획과 함께 같은 작업을 수행합니다.

새 항목 시작하기
새 항목 시작하기
여섯 가지 골든 패스와 각각이 만드는 것, 해당 nexus create 명령, 고정된 템플릿. 하단의 안내 문구를 확인하십시오. 매니페스트는 권고가 아니라 강제되며, 더 많은 권한을 요청하는 릴리스는 두 사람이 검토할 때까지 보류됩니다.

저희는 그 페이지에서 도메인 팩 경로를 선택하고, 팩 이름을 cold-chain, 첫 단위를 Rotterdam으로 지정했습니다. 결과 화면에는 고정된 템플릿 domain-pack@1.6.0이(가) 표시되고, 만들어진 항목이 나열됩니다. 저장소, 네 개의 스코프와 두 개의 저장소, 외부 주소 없음을 선언한 매니페스트, 템플릿에서 가져온 66개의 테스트, Rotterdam의 개발 공간, 세 개의 합성 데이터 브랜치, 그리고 Larkfield 자체 카탈로그에 저만 볼 수 있는 초안 항목입니다. 템플릿 버전은 고정되어 있으며, 나중에 업그레이드할 때도 다른 변경과 마찬가지로 검토된 변경으로 들어오므로, 템플릿이 바뀌었다는 이유로 누군가의 팩이 모르는 사이에 바뀌는 일은 없습니다. 그래도 첫 팩에는 콘솔 마법사를 사용했습니다. 무엇이든 만들기 전에 계획을 보여 주기 때문입니다.

1단계: 팩의 용도 정의

새 도메인 팩 마법사는 개요, 지식 모델, 검토 및 생성의 세 단계로 구성됩니다. 1단계에서는 이후의 모든 것을 좌우하는 몇 가지 사항을 묻습니다.

필드 입력한 내용 참고
이름 Cold chain 저장소와 카탈로그에 사용됨
용도 부두와 선박에 있는 리퍼 컨테이너: 전원, 온도 이탈, 그에 따른 청구
산업 물류 및 해운 Logistics and maritime 팩을 기반으로 함
소유자(Owner) 생성하는 사람 마법사에서 잠김
단위 Rotterdam (파일럿) 파일럿 이후 Felixstowe
템플릿 domain-pack@1.6.0 잠김. 업그레이드는 검토된 변경으로 제공됨
매핑하는 규정 ATP 협정, EU 우수 유통 관리 기준, 식품 안전 기록 각 규정은 팩의 증빙 맵에서 하나의 페이지가 됨

마지막 행은 도크의 어시스턴트가 제안했으며, 화물 청구가 동일한 이탈 기록을 재사용한다는 점도 포함되어 있었습니다. 페이지 하단의 안내 문구는 아직 아무것도 만들어지지 않았음을 알려 줍니다. 저장소, 개발 공간, 데이터 브랜치는 계획을 확인한 뒤 3단계에서 생성을 누를 때에만 만들어집니다. 초안을 저장하고 나중에 다시 돌아올 수 있습니다.

2단계: 지식 모델

지식 모델은 팩이 알고 있는 사물의 종류와 그들이 연결되는 방식의 집합입니다. Cold chain은 SDK에서 가져온 물류 기본 모델 logistics-base 4.2에서 시작했으며, 이를 통해 기반으로 삼을 다섯 가지 기본 종류(Vessel, Port, Container, Carrier, Shipment)를 얻었습니다. 기본 종류는 마법사에서 읽기 전용입니다. 변경이 필요하면 해당 종류를 소유한 팩에서 변경합니다.

저희는 자체적으로 다섯 가지 종류를 추가했습니다.

종류 설명 속성
리퍼 유닛 냉장 컨테이너 9
선박 기항 한 선석에 있는 한 척의 선박 6
이탈 한계를 벗어난 온도 8
전원 공급 육상 또는 선박 전원 포인트 4
소유권 등록(Claim) 상한 화물에 대해 요구하는 금액 7
새 도메인 팩: 지식 모델
새 도메인 팩: 지식 모델
다섯 가지 기본 종류와 다섯 가지 새 종류가 있는 지식 그래프. 오른쪽의 이탈 속성을 확인하십시오. 각 속성은 만들어질 때 분류가 지정되며, 안내 문구는 청구 금액이 상업 정보이므로 기술자 렌즈에서 표시할 수 없음을 알려 줍니다.

모든 속성은 만들 때 분류가 지정됩니다. 이탈의 "보고자"는 개인 정보입니다. "위험에 처한 화물 가치"와 청구의 금액 및 정산은 상업 정보입니다. 첫날에는 서류 작업처럼 느껴졌지만, 나중에 두 번이나 도움이 되었습니다. 분류에 따라 렌즈가 표시할 수 있는 것, 마스킹된 사본이 대체하는 것, 로그 줄이 숨기는 것이 결정되기 때문입니다.

저희 관계 중 두 가지는 기본 모델까지 이어집니다. 리퍼 유닛은 전원 공급에 연결되고, 청구는 Shipment를 참조합니다. 기본 모델 자체는 변경되지 않습니다. 철회한 속성은 모델 버전 1.0에 남아 있다가 이후 버전에서만 제거되므로, 이전 기록에 해당하던 내용을 읽을 수 없게 되는 일은 없습니다.

3단계: 검토 및 생성

3단계는 계획입니다. 만들어질 항목, 매니페스트가 선언할 스코프, 데이터 브랜치, 개발 공간이 나열됩니다. 패스키로 계획을 확인하면 계획에 지문이 부여됩니다. 이후 생성은 그 계획을 정확히 따라 한 단계씩 진행되며, 어느 단계에서든 중단하고 이미 만들어진 것을 유지할 수 있습니다.

Cold chain의 계획은 네 개의 스코프를 선언했습니다.

스코프 팩에 필요한 이유
리퍼 원격 측정 읽기 전원 및 온도 측정값
이탈 쓰기 한계를 벗어나면 이탈을 기록함
선적 읽기 청구를 해당 선적에 연결함
청구 메모 초안 작성 초안만 작성하며, 발송은 사람이 함

저장소는 그래프와 레코드였습니다. 외부 주소는 없었고 Standard 샌드박스 프로필을 사용했습니다. 개발 공간은 4코어, 16 GiB 메모리, 50 GiB 스토리지, 매니페스트가 선언한 것 외에는 닫힌 네트워크, 서명된 이미지만 허용, 7일 동안 유휴 상태이면 종료되는 조건으로 제공되었습니다. 종료되어도 정의는 저장소에 남아 있으므로, 거기서 다시 만들 수 있습니다.

세 개의 데이터 브랜치는 합성 생성기에서 만들어졌습니다. 고객 데이터는 복사되지 않았습니다. Rotterdam의 마스킹된 사본에는 데이터 소유자의 동의가 필요하며, Larkfield에서는 Priya Natarajan이 데이터 소유자이고, 동의는 별도로 요청합니다.

팩 매니페스트

저장소에는 팩의 매니페스트 pack.json이(가) 있습니다. 매니페스트에는 팩의 이름, 버전, 상속하는 팩(있는 경우), 클러스터, 용어가 지정됩니다. 클러스터는 한 역할이 팩 안에서 보는 것인 렌즈이거나, 모든 렌즈에 걸쳐 실행되는 공유 클러스터입니다. 저희 매니페스트의 핵심은 다음과 같습니다.

{
  "id": "cold-chain",
  "name": "Cold chain",
  "version": "0.4.0",
  "clusters": [
    {
      "id": "CC01",
      "kind": "lens",
      "name": "Reefer technician",
      "seats": "Technicians on the quay",
      "purpose": "Which reefers have lost power or warmed up, and what to do next.",
      "lexicon": ["cold"],
      "menu": [],
      "screens": []
    },
    {
      "id": "CC02",
      "kind": "lens",
      "name": "Cold-chain controller",
      "seats": "Controllers in the operations office",
      "purpose": "Every excursion from first reading to closed claim, with its evidence.",
      "lexicon": ["cold"],
      "menu": [],
      "screens": []
    }
  ],
  "lexicon": {
    "core": [],
    "cold": [
      ["excursion", "a time when the temperature left its limits", ""],
      ["set point", "the temperature a reefer is told to hold", ""],
      ["shore power", "electricity from the quay rather than the ship", ""]
    ]
  }
}

용어집에는 팩 고유의 용어와 각각에 대한 쉬운 설명이 담기며, 휴대폰에서 읽을 수 있을 만큼 짧습니다.

매니페스트는 pack.json 외에도 팩이 접근할 수 있는 것, 즉 스코프, 저장소, 외부 주소, 샌드박스 프로필을 선언합니다. Nexus는 정확히 그만큼만 부여하고 그 이상은 부여하지 않습니다. 각 도구 호출은 선언된 스코프와 대조하여 확인되며, 외부 주소는 목록에 없으면 차단됩니다. 선언 내용과 지난 릴리스 대비 변경 사항은 팩의 매니페스트 및 권한 페이지에서 확인할 수 있습니다.

렌즈: 역할별 표시 화면

렌즈는 기반이 표시하는 것을 좁힐 수만 있으며, 이 하나의 규칙이 다른 어떤 것보다 저희 설계에 큰 영향을 주었습니다. 렌즈는 기반 렌즈가 표시하는 것의 일부를 표시하며, 권한은 여전히 역할에서 나옵니다. 렌즈는 역할이 팩에서 무엇을 보는지를 결정할 뿐, 무엇을 할 수 있는지를 결정하지 않습니다.

리퍼 기술자 렌즈는 Larkfield가 이미 물류 업무에 사용하는 기반 렌즈인 운영 관제 담당자를 좁힌 것입니다. 렌즈 빌더에서 렌즈가 표시할 카드, 필드, 작업을 선택합니다. 기반이 표시하지 않는 항목은 잠겨 있습니다.

구성 요소 리퍼 기술자에게 표시됨 제외됨
카드 부두의 리퍼 유닛, 미해결 이탈, 전원 포인트, 오늘의 선박 기항 청구에 관한 모든 것
필드 전원 상태, 설정값, 마지막 측정값, 최고 온도 청구 금액(기반 렌즈에 없음), 개인 정보 필드(기본적으로 꺼짐)
작업 이탈 원인 기록, 전원 점검 요청 설정값 변경 및 이탈 종료(관제 담당자 전용), 청구 메모 초안 작성
렌즈 빌더
렌즈 빌더
기반 렌즈를 기준으로 선택한 리퍼 기술자용 렌즈 빌더. 왼쪽 아래의 안내 문구는 청구 금액을 선택할 때 받는 거부입니다. 기반 렌즈가 표시하지 않으므로 이 렌즈도 표시할 수 없습니다.

한 기술자가 요청했기 때문에 저는 그래도 기술자 렌즈에 청구 금액을 추가해 보았습니다. 빌더는 LENS_CANNOT_WIDEN(으)로 거부하고 아무것도 저장하지 않았습니다. 렌즈 안에서는 우회 방법이 없습니다. 방법은 더 넓은 기반 위의 렌즈이며, 이는 조직 관리자가 결정하는 별도의 요청입니다. 저희는 이 항목을 제외했습니다.

렌즈에서 무언가를 숨긴다고 해서 Nexus에서 제거되는 것은 아닙니다. 해당 역할이 그것을 보지 않는다는 뜻입니다. 빌더는 파일럿에서 렌즈가 도달할 인원 수(저희의 경우 29명)를 표시하고, 모든 추가, 변경, 철회를 로그로 남깁니다. 렌즈는 조직에 대해 한 번 정의되고 단위별로 플랫폼 역할에 부여되므로, 동일한 리퍼 기술자 렌즈를 이번 달에는 Rotterdam의 기술자에게, 다음 달에는 Felixstowe의 기술자에게 부여할 수 있습니다.

청구 메모 초안 작성을 위한 스킬

관제 담당자들은 이탈 후 화주에게 보내는 메모의 초안을 원했습니다. 이는 언어 작업이므로 모델에서 실행되며, 문제는 그것을 어디에 둘 것인가였습니다.

Nexus에는 두 종류의 스킬이 있으며, 여기서는 그 차이가 중요합니다. 매니페스트 스킬은 플러그인의 skills[]에 있는 형식화된 행으로, 플랫폼이 디스패치합니다. Skills Engine 스킬은 조직의 스킬 라이브러리에 있는 SKILL.md 패키지로, 에이전트, AI(인공지능) 버튼, 워크플로, 개발자 도구가 모두 같은 방식으로 실행합니다. 2.20장 스킬에서 두 가지를 모두 다룹니다.

저희 플러그인의 신뢰 수준은 community이며, 커뮤니티 플러그인은 모델에 접근하지 않는 매니페스트 스킬(host_callback 및 plugin_queue)만 선언할 수 있습니다. AI Provider Router에 접근하는 두 등급인 tool_using와 llm_only에는 신뢰 수준 core 또는 verified이(가) 필요합니다. 그래서 청구 메모 초안 작성은 Skills Engine 스킬이 되었고, 라우터는 Larkfield 자체 풀에서 모델을 선택합니다.

---
name: draft-claim-note
description: Draft a note to a cargo owner about one reefer excursion, from the excursion record and its readings. Drafts only; a person reviews and sends.
allowed-tools: Read, Grep
triggers:
  - /draft-claim-note
capabilities:
  - name: draft_note
    description: Write a first draft for one excursion
version: 1.0.0
---

# Draft a claim note

Use this when a controller asks for a note about one excursion.

## Steps

1. Read the excursion: unit, start, length, highest temperature and cause.
2. Read the shipment it belongs to, for the cargo owner's name.
3. Write four short paragraphs: what happened, when, what the readings show, what happens next.
4. Never state a claim amount. Never send anything.

패키지는 저장소의 skills/draft-claim-note/에 있으며, 폴더 이름은 스킬 이름과 같습니다. 저희는 터미널에서 이를 검증하고 업로드했습니다.

npm run skill:validate skills/draft-claim-note
npm run skill:upload skills/draft-claim-note --dry-run
npm run skill:upload skills/draft-claim-note

동일한 내용을 두 번 업로드하면 새 버전 대신 기존 버전이 반환되므로(CONTENT_HASH_ALREADY_PUBLISHED), 업로드를 다시 실행해도 안전합니다. 버전이 배포되기 전에 Skills Engine은 테스트 케이스, 과거 작업에 대한 섀도 모드 시험 실행, 다른 회사 모델의 블라인드 검토를 실행하며, 각 실행의 소요 시간과 비용도 함께 제공합니다.

풀서비스 플러그인

팩에는 상시 실행되는 코드도 필요했습니다. 리퍼 원격 측정 피드를 읽는 리더와, 측정값이 한계를 벗어나면 이탈 레코드를 여는 라이터입니다. 이런 코드는 전체 서비스 플러그인에 속하며, 저희는 SDK 자체 명령으로 스캐폴딩했습니다. 이 명령은 이름을 치환하여 전체 참조 트리를 작성합니다.

npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin scaffold cold-chain --tier full-service
cd cold-chain
npm install
npm ci
npm run typecheck && npm test && npm run build
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

SDK는 Adverant 계정의 풀 토큰 및 설치 명령 페이지에 있는 풀 토큰을 사용하여 https://registry.adverant.ai/npm/에서 설치합니다. 첫 설치 시 작성되는 package-lock.json을(를) 커밋하십시오. 이미지 빌드는 npm ci을(를) 실행하며, 이 파일이 없으면 거부합니다.

다음은 저희 nexus.manifest.json 중 템플릿과 다른 부분입니다. 파일 전체가 아닙니다. 스캐폴드의 description, author, license, runtime, backend 및 frontend 블록은 그대로 유지되며, 검증기는 이 블록이 없는 전체 서비스 매니페스트를 거부합니다. 세 개의 architecture 문장은 모든 플러그인이 다시 명시하는 규칙이며, 검증기가 그 문구를 확인합니다. 첫 번째 문장의 UNO는 워크플로 엔진입니다.

{
  "manifestVersion": "2",
  "name": "cold-chain",
  "displayName": "Cold chain",
  "version": "0.4.0",
  "tier": "full-service",
  "trust": "community",
  "architecture": {
    "compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
    "ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
    "deploy": "Deploy is through the installation's release channels only."
  },
  "api": {
    "version": "1",
    "basePath": "/",
    "endpoints": [
      { "method": "GET", "path": "/health", "summary": "Liveness", "auth": "public", "allowAnonymous": true },
      { "method": "GET", "path": "/api/excursions", "summary": "List the unit's excursions", "auth": "scope", "right": "excursion.read", "needsUnit": true },
      { "method": "POST", "path": "/api/excursions", "summary": "Record an excursion", "auth": "scope", "right": "excursion.create", "needsUnit": true },
      { "method": "POST", "path": "/internal/skills/excursion_open", "summary": "host_callback receiver the platform POSTs to", "auth": "internal" }
    ]
  },
  "rights": {
    "excursion.read": { "summary": "Read the unit's excursions.", "roles": ["owner", "admin", "member", "viewer"] },
    "excursion.create": { "summary": "Record an excursion.", "roles": ["owner", "admin", "member"] }
  },
  "skills": [
    {
      "id": "excursion_open",
      "displayName": "Open an excursion",
      "description": "Open an excursion record when a reading breaks its set point limits. No model; runs in the plugin's own backend.",
      "tier": "host_callback",
      "classification": "tenant",
      "dataResidency": "eu",
      "inputSchema": { "type": "object", "properties": { "readingId": { "type": "string" } }, "required": ["readingId"] },
      "outputSchema": { "type": "object", "properties": { "opened": { "type": "boolean" } }, "required": ["opened"] },
      "hostCallback": {
        "service": "cold-chain",
        "port": 8080,
        "path": "/internal/skills/excursion_open",
        "maxRequestBytes": 65536,
        "maxResponseBytes": 16384,
        "tenantHeader": "X-Organization-ID"
      },
      "timeoutMs": 10000
    }
  ],
  "changePolicy": {
    "enabled": true,
    "classes": ["website", "bff", "migration"],
    "approvals": { "website": 1, "bff": 1, "migration": 2 }
  }
}

excursion_open은(는) host_callback 등급의 매니페스트 스킬입니다. 플랫폼은 입력을 당사 네임스페이스 안에 있는 당사 자체 Service로 전송하며, 당사가 지정한 호스트로는 절대 전송하지 않습니다. 수신 경로는 auth: internal(으)로 선언되며, SDK의 serviceMiddleware로 보호됩니다. 이는 가드의 Express 형식으로, 다른 플러그인, 조직, 스킬 또는 경로용으로 발급된 호출 토큰을 거부합니다. 이 스킬의 classification은(는) tenant이며, 이는 커뮤니티 플러그인의 상한입니다. 2.27장 빌드 시나리오에서는 host_callback 스킬만을 단독으로 자세히 설명합니다.

이 단계에서 따라 할 만한 습관이 두 가지 있습니다. 모든 테이블은 첫 번째 마이그레이션부터 organization_id, owner_user_id 및 business_unit_id을(를) 포함합니다. 나중에 축을 추가하면 운영 중인 행에 대한 마이그레이션이 되기 때문입니다. 또한 저희는 푸시하기 전마다 로컬에서 nexus-gates을(를) 실행했습니다. 파이프라인이 실행하는 것과 동일한 명령이기 때문입니다. 아무것도 검사하지 않은 실행은 2로 종료되며 그 사실을 알려 줍니다. 2.19장 모든 확장 기능이 상속하는 규칙에서 게이트 목록을 확인할 수 있습니다.

테스트용 샘플 데이터

테스트용 샘플 데이터 페이지에서는 세 가지 종류의 브랜치를 제공합니다.

종류 포함 내용 동의 주체
합성 사용자가 설정한 개수와 형태로 생성된 데이터이며, 실제 단위에서 가져온 데이터는 없습니다 없음. 사용자 본인의 데이터입니다
마스킹된 사본 개인, 민감 및 상업 필드가 대체된 단위의 사본 데이터 소유자(Rotterdam의 경우 Priya Natarajan)
스키마만 행 없이 저장소의 형태만 없음. 마이그레이션용입니다

저희는 바쁜 한 주를 생성했습니다. 냉장 컨테이너 100개당 약 7건의 이탈로, 이는 Rotterdam의 바쁜 8월 모습과 같습니다. 양보다 특이한 사례가 더 중요했습니다. 저희는 하역 중 전원 손실, 열린 채로 방치된 문, 센서 공백, 한 건의 이탈에 대한 두 건의 청구를 요청했습니다. 이 페이지는 지식 모델의 이탈 원인에서 특이한 사례를 제안할 수 있으며, 실제 기록에서는 절대 제안하지 않습니다.

각 개수 및 형태 세트는 cold-chain-busy-01과(와) 같은 시드로 지문과 함께 저장됩니다. 동일한 시드는 동일한 데이터를 생성하므로, 모든 브랜치의 모든 테스트 실행에서 같은 한 주를 보게 됩니다. 이것이 저희 66개 테스트를 반복 가능하게 만든 요인입니다.

브랜치는 기본적으로 72시간, 최대 14일 동안 유지됩니다. 긴 검토 기간 동안 바쁜 브랜치를 30일간 유지해 달라고 요청했더니, 페이지가 BRANCH_LIFE_EXCEEDED으로 거부했습니다. 해결 방법은 안내 문구가 제안하는 대로입니다. 시드를 보관해 두었다가 필요할 때 그 시드로 새 브랜치를 만드십시오. 마스킹된 사본도 같은 제한을 따르며, 해당 요청에는 사유와 최대 14일의 기간이 포함됩니다.

특정 사용자 관점에서 렌즈 미리보기

Rotterdam의 누구도 Cold chain을 보기 전에, 저희는 그들이 보게 될 방식대로 살펴보았습니다. 사용자 관점에서 렌즈 미리 보기는 선택한 역할이 보는 그대로 팩을 데이터 브랜치에서 점선 미리 보기 프레임 안에 렌더링합니다.

사용자 관점에서 렌즈 미리 보기
특정 사용자 관점에서 렌즈 미리보기
합성 브랜치에서 Rotterdam 냉장 컨테이너 기술자가 보는 Cold chain입니다. 열려 있는 각 이탈 건에서 "렌즈에 의해 숨김"으로 표시된 청구 열과, 이 렌즈가 무엇을 왜 숨기는지 알려 주는 측면 패널에 주목하십시오.

세 가지 규칙 덕분에 미리 보기를 자유롭게 안전하게 사용할 수 있습니다. 미리 보기는 데이터 브랜치를 사용하며, 운영 중인 단위는 절대 사용하지 않습니다. 사용자 본인의 권한이 미리 보기에 유출되지 않으므로, 사용자가 볼 수 있는 것이 아니라 해당 역할이 보는 것을 보게 됩니다. 그리고 미리 보기는 30분 후에 종료됩니다. 운영 중인 단위를 대상으로 미리 보기를 지정하면 CONNECTION_SCOPE_EXCEEDED으로 거부됩니다. 실제 형태가 필요하면 데이터 소유자에게 마스킹된 사본을 요청하고 그 사본에서 미리 보십시오.

저희는 미리 보기에서 실제 실수를 발견했습니다. 기술자 화면의 온도 차트에 설정점이 표시되었는데, 설정점 편집은 컨트롤러 전용이어야 했습니다. 차트 자체는 문제가 없었지만, 그 아래의 편집 버튼이 문제였습니다. 버전 0.3.2에서 기술자에게 설정점 편집을 숨겼으며, 이 문제를 발견한 곳이 바로 미리 보기였습니다.

배포 후 지식 모델 변경

버전 0.4.0에 이르러 저희는 운행 전 점검을 위한 Inspection 종류가 필요해졌고, "Excursion caused Claim" 관계는 "Excursion led to Claim"으로 표현하는 편이 더 자연스러웠습니다. 모델을 1.3에서 1.4로 올리는 것은 지식 모델 변경이며, 지식 모델 변경 페이지에는 변경 차이, 영향을 받을 대상, 그리고 진행 단계가 표시됩니다.

이 변경은 그래프 변경 요청으로 전달됩니다. 해당 시험 실행은 Rotterdam의 마스킹된 사본에서 영향을 받을 대상을 개수로 집계합니다. 저희의 경우 이름이 변경된 링크 1,284개, 삭제된 항목은 없었습니다. 두 명의 검토자가 승인하면 파이프라인이 이를 스테이징에, 이어서 파일럿에 적용합니다. 누구도 공유 그래프에 직접 쓰지 않으며, 시도하면 거부되고 기록됩니다. 저장된 질문 세 개가 "caused"라는 단어를 사용하고 있었는데, 변경에는 각 질문에 대한 자동 재작성이 포함되어 있었고 페이지에 그 목록이 표시되었습니다. 두 렌즈 모두 여전히 범위를 좁히기만 했기 때문에 렌즈 필터는 변경되지 않았습니다.

프로덕션으로 승격

모든 릴리스는 하나의 경로를 따라 이동합니다. 개발 공간, 스테이징, 파일럿 단위, 그리고 모든 단위 순입니다. 각 단계에는 게이트가 있으며, 어떤 것도 이를 건너뛰지 않습니다.

대상 게이트
스테이징 모든 테스트 통과, 품질 검사, 매니페스트 변경 없음 또는 확장 승인, 서명된 이미지
파일럿(Rotterdam) 마스킹된 사본에서 오류 없는 모델 변경 시험 실행, 렌즈 및 범위 규칙에 대한 정책 검사, 작성자가 아닌 검토자 두 명(그중 한 명은 데이터 소유자)
모든 단위 파일럿 14일, 파일럿에서 집계한 오류 1,000건당 1건 미만, 각 단위 관리자가 자신의 단위에 대해 동의, 작성자가 아닌 검토자 두 명
환경 및 프로모션
환경 및 프로모션
파일럿 게이트에서 두 번째 검토자를 기다리고 있는 Cold chain 0.3.2입니다. 오른쪽의 안내 문구는 개발 공간에서 모든 단위로 바로 승격하려 할 때 표시되는 거부 메시지입니다.

저는 어느 금요일, 한 줄짜리 수정을 위해 지름길을 한 번 시도했습니다. 0.4.0-dev를 제 개발 공간에서 모든 단위로 승격하려 한 것입니다. 이는 GATE_CANNOT_BE_SKIPPED으로 거부되었고, 아무것도 승격되지 않았습니다. 안내 문구는 대신 다음 단계로 승격하라고 알려 주며, 그것이 유일한 방법입니다.

릴리스 검토 자체, 두 번째 검토자가 읽는 증거, 단위가 선택하는 채널은 2.28장 확장 기능 릴리스에서 다룹니다. 그중 두 가지 사실은 버티컬 계획 방식에 영향을 주므로 여기에서 언급합니다. 작성자는 절대 검토자로 집계되지 않으므로, 2인 팀은 모든 릴리스마다 세 번째 사람이 필요합니다. 또한 각 환경은 이전 버전을 30일간 보관하므로, 롤백은 파이프라인이 약 1분 만에 수행하는 검토된 변경입니다.

기존 팩 확장하기

모든 버티컬이 처음부터 시작하는 것은 아닙니다. 팩은 다른 팩을 상속하고 다른 부분만 추가할 수 있습니다. Larchmont Bank가 운영하는 은행 및 결제 팩이 카탈로그에서 가장 명확한 예입니다. 이 팩의 매니페스트는 다음과 같이 시작합니다.

{
  "id": "fintech",
  "name": "Banking and payments",
  "version": "0.1",
  "inherits": "insurance",
  "clusters": [
    {
      "id": "FL01",
      "kind": "lens",
      "name": "Lending decisions",
      "seats": "Credit analysts, underwriters of loans, credit committee",
      "purpose": "Whether to lend, how much, at what price, and writing down why.",
      "lexicon": ["fin"],
      "menu": [],
      "screens": []
    }
  ],
  "lexicon": {
    "core": [],
    "fin": [
      ["APR", "the yearly cost of borrowing, fees included", "exact"],
      ["mandate", "the most one person may lend alone", ""]
    ]
  }
}

inherits은(는) 기반이 되는 팩을 지정합니다. 은행 및 결제 팩은 보험 팩의 형태, 공유 대화 클러스터, 핵심 용어를 유지하고, 자체 렌즈 세 개(대출 결정, 카드 분쟁, 내 계정)를 추가합니다. 각 용어집 항목의 세 번째 요소는 APR(annual percentage rate)처럼 바꿔 표현하지 않고 쓰인 그대로 표시해야 하는 용어에 대한 exact입니다.

상속으로 할 수 없는 일도 있습니다. 팩은 셸, 구성 요소 또는 작성 규칙을 절대 변경하지 않으므로, 하위 팩은 콘솔의 스타일을 바꿀 수 없습니다. 여러 팩에 필요한 규제 체계는 각 팩에 사본을 두는 대신 하나의 공유 렌즈로 제공됩니다. 아웃소싱 기술 등록부는 보험 팩과 은행 및 결제 팩 모두에 사용됩니다. 하위 팩에 필요한 렌즈가 이미 공유 렌즈로 존재한다면, 직접 만들지 말고 그 렌즈를 사용하십시오.

라이선스는 상속 관계를 따릅니다. 팩은 Enterprise 위에 라이선스되며 추가 기능이 필요할 수 있고, 라이선스 문서에 이러한 종속성이 명시됩니다. 보험 팩에는 의사결정 룸과 봉인된 기록이 필요하므로, 이를 상속하는 팩의 라이선스를 받는 고객도 해당 추가 기능이 필요하며, 콘솔은 이를 빠뜨린 라이선스의 발급을 거부합니다. 팩의 모바일 화면에는 모바일 앱 추가 기능도 필요합니다. 고객에게 일정을 약속하기 전에 요구 사항의 연쇄를 확인하십시오.

배포된 팩에 렌즈 추가하기

가장 작은 버티컬 작업은 직접 작성하지 않은 팩에 새 렌즈를 추가하는 것입니다. 파일럿 6개월 차에 Larkfield의 해상 청구 팀은 Cold chain 안에 자체 렌즈를 원했습니다. 이탈과 청구는 포함하고, 전원 지점과 설정점은 제외하는 렌즈였습니다. 저희는 팩의 코드를 건드리지 않았습니다. 렌즈는 조직의 렌즈 레지스트리에 있는 하나의 행이며 팩이 소유하므로, 새로 시작하기의 렌즈 골든 패스에서 시작하여 Cold-chain 컨트롤러 렌즈를 기반으로 렌즈 빌더에서 구성했습니다. 이전과 동일한 규칙이 적용됩니다. 새 렌즈는 기반 렌즈가 보여 주는 것을 숨길 수는 있지만 더 많이 보여 줄 수는 없습니다. 렌즈는 조직에 대해 한 번 정의되고 각 단위의 플랫폼 역할에 부여됩니다. 부여는 철회될 뿐 삭제되지 않으며, 렌즈를 다시 부여하면 새로운 부여가 생성되므로 누가 언제 어떤 렌즈를 보유했는지 계속 확인할 수 있습니다. 레지스트리는 매월 렌즈를 보유한 사람의 수를 집계하며, 누구인지는 절대 기록하지 않습니다.

렌즈 및 조회 대상 페이지에는 그 결과가 렌즈별 단위 및 역할의 매트릭스로 표시되며, 각 셀에 추가, 변경, 철회가 있습니다. 부여하기 전에 위와 똑같이 사용자 관점에서 새 렌즈를 미리 보십시오.

실제 소요 비용

팩은 고객의 기록을 다루므로 플랫폼은 일부 작업을 의도적으로 느리게 만들며, 첫날부터 이를 고려하여 계획해야 합니다.

  1. 마스킹된 사본에는 매번 데이터 소유자의 동의가 필요합니다. 저희의 경우 처음에는 Priya가 지식 모델을 먼저 읽고 싶어 해서 하루가 걸렸습니다. 합성 데이터로 시작하고 일찍 요청하십시오.
  2. 작성자는 자신의 릴리스를 승인할 수 없으며, 요청은 3일 후 만료됩니다. 검토자가 바쁘면 릴리스는 대기하게 됩니다.
  3. 메일 발송이나 외부 주소 하나처럼 이전 릴리스보다 더 많은 것을 요구하는 릴리스는 두 명의 검토자가 확장된 매니페스트를 승인할 때까지 보류됩니다. 2.28장 확장 기능 릴리스에서는 요청하기 전에 이를 알려 주는 매니페스트 및 권한 페이지를 보여 줍니다.
  4. 렌즈는 기반 렌즈가 숨기는 것을 보여 줄 수 없습니다. 어떤 역할에 정말로 더 많은 것이 필요하다면, 그것은 설정이 아니라 조직 관리자와 논의할 사항입니다.

이 중 어느 것도 저희를 두 번 가로막지는 않았습니다. Cold chain의 두 번째 릴리스는 첫 커밋부터 Rotterdam 파일럿까지 일주일이 걸렸으며, 그 대부분은 66개 테스트가 세 개의 브랜치에서 실행되고 두 사람이 증거를 읽는 시간이었습니다.