# Arpelier 핵심 개념 [색인](/llms.txt) · [공정](/docs/agents/processes.md) · [자동화](/docs/agents/api.md) Arpelier는 공정을 순서대로 계산해 재료별 3D 구조를 만듭니다. 화면에서 보이는 그럴듯한 모양만으로 전기적 연결이나 실제 제조 가능성을 확정하지 마세요. 목적에 맞는 중간 단계와 단면을 함께 확인해야 합니다. ## 도메인과 단위 `domain.LX`, `domain.LY`는 X/Y 크기, `domain.dx`, `domain.dy`는 입력 격자 간격입니다. 모두 nm입니다. `x`, `y`를 도메인 크기의 별칭으로 사용하지 마세요. 화면의 표시 단위가 바뀌어도 저장된 길이는 nm입니다. `dxn`, `dyn`은 해상도를 반영한 계산 간격입니다. X/Y 크기는 대응하는 입력 격자로 나누어떨어져야 합니다. 앱의 도메인 정규화가 유효한 간격을 만들 수 있으므로 정규화된 결과를 다시 읽으세요. Z는 공정에 따라 생기는 재료 구간으로 표현됩니다. [메모리 설명](/docs/agents/performance.md)을 참고하세요. ## 프로젝트 문서, 공정, 마스크 프로젝트 문서의 주요 데이터는 `domain`, `processes`, `mask`, `matset`, `visualSetting`, `snapshot`입니다. 저장용 코덱은 `schemaVersion: 3`과 압축된 재료·마스크 표현을 사용합니다. 저장 JSON, 편집 중 문서, 실행 취소 스냅샷은 같은 객체 형식이 아닙니다. 서로의 필드를 임의로 섞지 말고 지원되는 읽기·수정 경로를 사용하세요. - `processes`: 순서가 있는 공정 배열. 각 공정은 고유 `id`와 정확한 `kind`를 가집니다. - `mask`: 마스크 배열. 공정의 `mask` 값은 마스크 이름이 아니라 마스크 ID를 참조합니다. `"-"`는 직접 선택한 마스크가 없다는 뜻입니다. - `matset`: 재료 정의. 저장 코덱에서는 기본 카탈로그와 `materialOverrides`, `customMaterials`로 압축될 수 있습니다. - `visualSetting`: 카메라·단면·표현·해상도. 해상도는 실제 계산 격자에도 영향을 줍니다. - `snapshot`: 선택 단계와 편집 상태를 복원하는 보조 데이터. 계산된 모든 단계의 영구 보관을 뜻하지 않습니다. 공정 기본값은 빈 편집 초안입니다. 예를 들어 `DEPO`의 `material: "-"`는 사용자가 재료를 선택해야 한다는 뜻이고, `CMP`의 기본 두께 0은 유효한 제거 작업이 아닙니다. 기본값만 복사한 뒤 성공한 레시피라고 간주하지 마세요. ## 자동화용 Flow 1.0 [Flow 1.0 스키마](/schema/flow-1.0.json)는 저장 코덱과 별도의 작성 입력 계약입니다. 최상위 `schema` 값은 `https://arpelier.com/schema/flow-1.0.json`이며, `domain`, `processes`, 선택적인 `materials`, `masks`, `gridResolution`, `displayUnits`, `name`, `note`를 사용합니다. 여기서는 마스크 배열이 `masks`, 재료 배열이 `materials`입니다. 원시 저장 문서의 `mask`, `matset`, `snapshot`을 그대로 넣지 마세요. `gridResolution` 기본값은 2이며 저장 길이는 nm입니다. JSON Schema는 데이터 모양을 설명합니다. 실제 입력은 `FlowDocument.validateFlowDocument`의 정준 검증을 통과해야 합니다. 이 검증은 도메인 격자, 지원 공정과 필드, 고유 ID, 마스크·재료 참조, 그룹 구조와 현재 모델 제약을 함께 확인합니다. 스키마 검사 성공만으로 공정 실행 성공이나 원하는 구조를 보장하지 않습니다. 성공 결과의 정규화된 `flow`를 다음 작업에 사용하세요. v1은 BONDING, PARTICLE, 호환용 ALD_NEW를 지원하지 않습니다. 앱 전체 공정 목록과 자동화 계약의 지원 범위는 다릅니다. 미지원 공정을 삭제해 입력을 억지로 통과시키지 마세요. [Oxide window 예제](/docs/agents/examples/oxide-window.flow.json)는 80 × 80 nm의 작은 기하학 예제이며, 프로젝트명·메모를 보존하는 작성 시작점으로 사용할 수 있습니다. ### Flow 1.1의 `view` [Flow 1.1](/schema/flow-1.1.json)은 1.0에 선택 필드 `view` 하나를 더한 형식입니다. `view`는 구조를 어떻게 보여 줄지(투명·숨김 재료와 불투명도, 잘라 낼 상자 `cutaway`, 카메라, 표면, 조명, 바닥 그리드·좌표축·눈금자)를 `setView`와 같은 필드로 적습니다. `highlightMaterialIds`는 프로젝트에 저장되지 않으므로 받지 않습니다. 계산·측정과 계산 상태 재사용은 `view`를 읽지 않습니다. - `view`가 있으면 `schema`는 `https://arpelier.com/schema/flow-1.1.json`입니다. 1.0 문서에 `view`가 있으면 `$.view` 오류입니다. 검사 도구는 두 버전을 모두 읽습니다. - 정규화된 `flow`는 `view`를 적은 그대로 담고, `view`가 없으면 1.0으로 씁니다. - 저장된 프로젝트를 Flow로 읽으면(`arpelier_open_my_project`) 보기 설정 중 기본값과 다른 것이 `view`로 따라옵니다. 카메라는 방향과 시야각만 담습니다. 브라우저 API의 `getFlow()`는 공정만 돌려주고 보기는 `getView()`가 돌려줍니다. - 어디에 어떻게 쓰이는지는 [Flow로 넘길 때](/docs/agents/tasks/real-structures.md#flow로-넘길-때)에 있습니다. ## 그룹과 반복 그룹은 같은 `processes` 배열 안의 `GROUPSTART`와 `GROUPEND` 쌍으로 나타납니다. 두 마커도 서로 다른 고유 ID를 가져야 하며, 중첩 순서가 올바르게 닫혀야 합니다. `GROUPSTART`의 `cycleCount`는 반복 수이고 기본값은 1입니다. 마커를 실제 증착·식각 단계로 세지 마세요. 접힌 그룹의 화면 번호와 내부 공정 배열의 인덱스도 다를 수 있습니다. 임의로 `isModule`을 켜거나 마커 ID를 재사용하지 마세요. 그룹/반복 편집은 구조 검증과 선택 단계 복원까지 함께 처리하는 경로를 사용해야 합니다. ## 이름과 메모 AI가 새로 쓰는 공정에는 `GROUPEND`를 뺀 모든 단계에 `name`(제목)과 `note`(메모)를 사용자 언어로 씁니다. 앱은 `name`을 공정 카드의 제목으로 보여 주고(없으면 공정 종류가 대신 보입니다), `note`는 사용자가 공정을 펼쳤을 때 보여 줍니다. - 제목은 그 단계가 하는 일의 핵심만 씁니다. 예: `패드 산화막`, `활성 영역 패턴`, `STI 트렌치 식각`, `PR 제거`. 공정 종류·재료·두께는 카드에 이미 보이므로 되풀이하지 않고, 수치·출처·설명은 메모에 씁니다. `GROUPSTART`의 제목은 모듈이 하는 일입니다. - 메모에는 공정 설명(왜 이 자리에 있는지, 끝나면 구조가 어떻게 되는지), 치수와 출처(찾은 자료는 링크, 정한 값은 이유, 자료가 없으면 가정이라고), 엔지니어 코멘트(이 구조에서 어려운 점, 잘못되면 생기는 불량, 모델이 실제와 다르게 표현한 부분)를 이어지는 문장으로 씁니다. 길이는 공정의 무게에 맞춥니다. 자세한 기준과 예는 [공정 메모](/docs/agents/tasks/real-structures.md#공정-메모)에 있습니다. - `validate`(커넥터의 `arpelier_validate_flow`)는 제목이나 메모가 없는 단계를 `namesAndNotes`로 알려 줍니다. 오류가 아니라 안내입니다. 공정의 `name`, `note`와 프로젝트 제목·설명은 사용자가 작성한 내용입니다. 자동 수정 중에도 그대로 보존하세요. 프로젝트 저장 레코드의 `note`/설명과 실행 취소 스냅샷의 `flow.prjnote`, `projectMeta.projectNote`는 서로 다른 계층의 표현입니다. 스냅샷 필드 한 곳만 수정하면 화면·저장본이 어긋날 수 있습니다. 프로젝트 정보 편집과 저장을 함께 지원하는 경로를 사용하세요. ## 계산과 저장 계산은 공정에서 구조를 만드는 작업이고 저장은 프로젝트 문서를 보존하는 작업입니다. 정보 창을 닫거나 계산이 끝나는 것만으로 계정 저장을 확인할 수 없습니다. 저장 버튼 또는 Ctrl+S를 사용하고 성공/실패 표시를 확인하세요. 로그인 여부, 소유권, 네트워크와 프로젝트 종류에 따라 저장 경로가 다릅니다. 게스트 데이터는 해당 브라우저 프로필의 로컬 저장소에 의존합니다. `/p/...` 주소만 전달한다고 다른 브라우저에서 같은 로컬 문서를 열 수 있는 것은 아닙니다. 공유가 목적이면 계정에 저장하고 실제 공유 권한을 확인하세요. 자동 복구본과 계산 캐시도 공유 링크를 대신하지 않습니다. 현재 웹앱의 `body[data-save-state]`는 `empty`, `saving`, `saved`, `unsaved`를, `data-save-scope`는 `none`, `account`, `local`을 표시합니다. 계정 프로젝트도 수정 후에는 account 범위의 unsaved 상태일 수 있습니다. API의 `status()`에서도 같은 저장 상태를 관측할 수 있습니다. 프로젝트 정보의 확인은 현재 이름·메모에 적용하며, 계정 저장을 별도로 실행해야 합니다. 저장 요청 후 추가로 편집한 내용은 현재 작업에 남고 `unsaved`로 표시됩니다. 저장이 끝나기 전에 다른 프로젝트로 이동한 경우 늦은 응답으로 현재 프로젝트를 바꾸지 않습니다. 저장된 버전과 현재 작업이 같은지까지 확인하세요. ## 안정된 단계 선택과 링크 타임닷에는 authored ID인 `data-step-id`, `data-process-kind`, 실제 실행 대상인 `data-compute-target-id`와 접근 가능한 이름이 있습니다. 실행 가능한 타임닷은 Enter 또는 Space로 선택할 수 있습니다. 화면 순번이나 CSS 클래스만으로 단계를 추정하지 마세요. 그룹의 authored ID와 펼쳐진 실행 대상 ID도 구분해야 합니다. `/p/?step=` 링크는 숫자가 아닌 정확한 authored ID를 지원합니다. 숫자 step 값은 기존 인덱스 의미를 유지하므로 새 단계 ID에는 의미 있는 문자열을 사용하세요. 없는 ID를 다른 단계 인덱스로 대신 열지 않습니다. 프로젝트를 열 수 없으면 해당 주소를 유지한 채 다시 시도·홈 이동과 오류 안내를 제공합니다. 링크가 열리지 않는 사실만으로 게스트 로컬 프로젝트인지 확정할 수 없습니다. 숫자로만 된 기존 authored ID를 직접 지정할 때는 `?embedStep=`를 사용합니다. 단계 링크는 해당 프로젝트에만 적용되며 같은 프로젝트의 단계 간 뒤로 가기에서도 ID를 유지합니다. ## 문서 근거와 변경 관리 이 안내서는 현재 코드의 `ProjectDocumentCodec`, `ProjectGridDomain`, `ProcessflowModel`, `ProcessflowBlockUtils`, `ProjectHistoryManager`를 기준으로 작성했습니다. 관찰로 발견한 내부 변수 이름을 공개 API로 승격하지 않습니다. 공개 자동화 계약의 버전·지원 기능은 [자동화 안내](/docs/agents/api.md)에서 확인하세요.