astrale-os/astrale-domain

Astrale 도메인

목표와 일치하는 참조에서 상세한 도메인 지식을 로드합니다.

커널 경계

• 스키마, 실행 가능한 증거 및 SDK의 도메인 린터를 가드레일로 사용합니다.
• 도메인 소스는 @astrale-os/sdk/* 하위 경로의 일치하는 의미 체계를 통해서만 코어 및 DSL 작성 값을 가져옵니다. @astrale-os/kernel-core 또는 @astrale-os/kernel-dsl을 직접 가져오지 말고 플랫 SDK 루트 배럴로 대체하지 마십시오.
• 권한 부여는 스키마 소유 정책 및 호출 가능한 auth 모드에 유지합니다. 핸들러는 허용된 호출만 실행하고 두 번째 권한 부여 모델을 정의하지 않습니다.
• 각 실존 정책 노드 범위를 신중하게 선택합니다. 토폴로지 소유 일치에는 node(), 다형성 Class 패밀리에는 node(Class), 정확한 ID에는 node.exact(Class)를 사용합니다.
• 설치된 SDK의 공개 내보내기와 현재 도메인 소스를 API 구문의 권위 있는 소스로 취급합니다.

의도 라우터

이 라우터를 사용하여 현재 작업에 속한 참조만 로드합니다. 새 도메인의 경우 아래 단계별 워크플로우도 사용합니다. 기존 공개 스캐폴드는 이미 기초 단계를 충족합니다.

• 도메인을 스캐폴드, 배포, 설치, 테스트 또는 TypeScript 구성: references/development.md를 읽으십시오.
• 스키마, 어휘, 속성, Class/Edge 선택을 작성하거나 스키마 검토: 먼저 references/schema.md를 읽으십시오. 스키마 작업에는 항상 읽으십시오.
• 핸들러, 호출 가능 바인딩, 커널 호출, 그래프 읽기/쓰기 또는 교차 도메인 호출 구현: references/runtime.md를 읽으십시오.
• 외부 API 래핑, Integration/Provider 정의, 웹훅 수신 또는 부작용/재시도 동작 설계: references/integrations.md를 읽으십시오.
• 기능을 직접 모델링하는 대신 네이티브 Astrale 도메인을 재사용/가져올지 결정: references/domains.md를 읽으십시오.
• 로그인 사용자 모델링, 기존 사용자 초대/등록 또는 Shell 그룹 할당: references/users.md를 읽으십시오.
• 도메인, 함수, 뷰, 클라이언트 호출, 공개 엔드포인트, ID, 위임, 인증 모드 또는 정책 보안: references/policies.md를 읽으십시오.
• 브라우저 뷰, 마운트된 UI, 뷰 액세스, 뷰 해석 또는 프론트엔드 디자인 구축/검토: references/views.md를 읽고 제품-인터페이스 레이아웃, 상호작용 및 카피를 위해 astrale-frontend-design을 적용하십시오.
• 설치된 스키마 개정, 데이터 전환 또는 백필 계획 또는 적격성 평가: references/migration.md를 읽으십시오.
• 그래프 액세스 최적화, 왕복 횟수 감소, 인덱스/쿼리 선택 또는 지연 시간을 위한 호출 패턴 검토: references/performance.md를 읽으십시오.
• 데모 데이터 작성 또는 업데이트 — Studio가 그리고 정책을 증명하는 tests/ 아래의 데이터셋: references/datasets.md를 읽으십시오.
• 테스트, 픽스처, 데모 플로우 또는 스모크 테스트 시나리오 작성: references/testing.md를 읽으십시오.
• 실패하는 라이브 도메인, 발급자/검색 혼동, 호출 라우팅 또는 런타임 드리프트 진단: references/debugging.md를 읽으십시오.

새 도메인 생성 워크플로우

도메인을 생성, 구축, 프로토타이핑 또는 POC를 만들라는 요청의 경우 해당 단계를 순서대로 따르고 단계가 시작될 때만 참조를 로드하십시오.

1. 기초: 먼저 작업 공간을 검사합니다. 공개 스캐폴드가 없으면 references/development.md를 읽으십시오. 네이티브 도메인을 재사용할지 결정할 때만 references/domains.md를 읽으십시오. 작업 공간에 이미 SDK, 배포 어댑터, 애플리케이션 및 런타임이 선언되어 있으면 해당 배관을 유지하고 스키마로 직접 이동합니다.
2. 스키마: 스키마를 작성하기 전에 references/schema.md를 읽으십시오. 로그인 사용자 및 그룹의 경우 ID나 온보딩 어휘를 직접 만들기 전에 references/users.md도 읽으십시오.
3. 호출 가능 항목: 호출 가능 항목을 구현하기 전에 references/runtime.md 및 references/policies.md를 읽으십시오. 외부 시스템이 관련된 경우 references/integrations.md도 읽으십시오.
4. 뷰: 도메인이 브라우저 표면을 소유하는 경우 뷰를 설계하거나 구현하기 전에 references/views.md를 읽으십시오. 뷰는 스키마 선언이며 SDK 도메인 정의의 필드가 아닙니다.
5. 데모 데이터: 의미 있는 샘플 그래프가 있는 도메인의 경우 astrale.config.ts에서 참조되는 tests/ 아래에 작은 데이터셋을 작성합니다. 먼저 references/datasets.md를 읽으십시오. API 전용 도메인을 위한 그래프 데이터를 만들거나 집중된 편집을 관련 없는 데모 작업으로 확장하지 마십시오.
6. 완료: references/testing.md를 읽으십시오. 제공된 공개 호출 가능 항목을 대표적인 성공 및 해당 거부 입력으로 실행한 다음 관련 테스트, 타입체크, 린트 및 빌드를 실행합니다. 소비 가능한 패키지를 제공할 때 패키징을 확인하고 배포 또는 통합 성공을 주장할 때 라이브 동작을 확인합니다.

도메인의 수명 주기 또는 현재 문제가 요구할 때만 references/migration.md, references/performance.md 및 references/debugging.md를 읽으십시오.

항상 켜짐 워크플로우

1. 메모리에서 API 구문을 신뢰하기 전에 현재 저장소 또는 스캐폴드를 검사합니다.
2. 라이브 동작의 경우 references/debugging.md를 사용하고 소스 편집을 효과적인 것으로 처리하기 전에 배포/설치/런타임 경로를 증명합니다.
3. 스키마 변경이 기존 데이터셋에 영향을 미치는 경우 동일한 변경에서 유효하고 대표성을 유지합니다. references/datasets.md를 읽으십시오. 예제는 모든 경우를 철저히 다루기보다 테스트를 보완합니다.