개발용 테스트 데이터 만들기
앱이 소유한 fixture를 선언하고 CLI로 실행한 뒤 재실행 결과를 확인합니다.
개발용 테스트 데이터 만들기
테스트 데이터는 개발자가 선택해서 실행합니다. 앱 설치마다 넣는 필수 초기값과 구분하세요. App 패키지 만들기의 Workshop과 활성 개발 샌드박스가 필요합니다.
새 샌드박스 준비가 워크스페이스 DB migration 단계에서 중단된 경우, 관련 수정이 환경에 적용된 뒤 샌드박스 화면에서 다시 준비를 사용하세요. 기존 데이터를 초기화할 필요는 없습니다.
테스트할 리소스 준비
앱 폴더에서 테넌트 공통 리소스를 만듭니다. 이미 같은 리소스가 있다면 다시 생성하지 않습니다.
nexia make resource Example --record-owner tenant --label-ko 예제이 예제는 법인 소유가 아닙니다. 현재 샌드박스 fixture context의 legalEntities()와 subjects()는 빈 배열입니다. 기본 법인이나 사용자 계정을 임의 생성하거나 운영 DB에서 가져오지 마세요. 법인별 데이터가 필요하면 앱이 지원하는 조직 해석·권한 조건을 별도로 구현해야 합니다.
fixture 선언
src/Contribution/WorkshopFixtures.php를 만듭니다. 다른 앱에서는 namespace·앱 키·모델을 바꾸세요. 생성된 Manifest가 이 경로를 이미 발견합니다. 앱당 fixture contribution 하나에서 여러 키를 처리할 수 있습니다.
<?php
declare(strict_types=1);
namespace Nexia\Apps\Acme\Workshop\Contribution;
use InvalidArgumentException;
use Nexia\Apps\Acme\Workshop\Models\Example;
use Nexia\Fixture\Contracts\FixtureContribution;
use Nexia\Fixture\FixtureContext;
final class WorkshopFixtures implements FixtureContribution
{
public function appKey(): string { return 'workshop'; }
public function fixtureKeys(): array { return ['sample']; }
public function seed(FixtureContext $context): void
{
if ($context->fixtureKey !== 'sample') {
throw new InvalidArgumentException('Unsupported fixture.');
}
Example::firstOrCreate(
['name' => 'Sample example'],
);
}
}ID와 public_id는 모델이 자동 생성합니다. 이 예제는 이름으로 중복을 찾으므로 이름을 바꾼 뒤 실행하면 새 샘플이 만들어집니다. 편집 이후에도 같은 샘플을 유지하려면 앱이 소유한 별도의 고유 코드로 찾도록 설계하세요. FixtureContext의 실행자 정보는 플랫폼이 복원하며 앱 코드에서 토큰·DB 인증정보를 준비하지 않습니다. fixture는 실제 고객 정보나 비밀값을 포함하지 않아야 합니다.
Fixture 권한 확인
대응하는 Core와 Manager 런타임 업데이트를 적용하면 fixture에서도 자기 앱의 PermissionAuthorizer::allowsPermission()과 legalEntityKeysForPermission()으로 법인 한정 보호 권한을 확인할 수 있습니다. 플랫폼이 검증한 실행자를 복원하므로 FixtureContext::actorUserId로 ActorDirectory에서 실행자를 조회하세요. 필요한 권한은 seed 전에 부여해야 하며, 회수되거나 만료된 권한은 거부됩니다. AuthorizationContext::run()은 확인 대상을 선택할 뿐 권한을 부여하지 않습니다. 앱의 레코드 정책과 거부 시 롤백 처리는 유지하세요.
Core를 먼저 배포하고 호환 Manager 런타임 이미지를 적용한 뒤 개발 실행 환경을 다시 준비하고 fixture를 재실행하세요. 새 SDK API나 CLI 옵션은 필요하지 않습니다. 적용 상태는 fixture 권한 확인 이슈를 참고하세요. 문서 반영만으로 배포 완료를 의미하지 않습니다.
이번 Core 수정으로 새 CLI fixture 실행에서 일반 Gate 권한 판단 전에 HTTP 409가 발생하던 문제를 해결합니다. 기존 권한은 그대로 적용되므로 정책을 우회하거나 데이터를 초기화하지 마세요. 호환 fixture 런타임이 이미 적용됐다면 앱이나 CLI 업데이트는 필요하지 않습니다. Core 수정 적용 후 이전 결과를 확인하고 원하는 fixture만 명시적으로 재실행하세요. 관련 이슈 #24를 참고하세요.
실행하고 확인하기
nexia dev에서 리소스·fixture 동기화와 준비 완료를 기다립니다.- Ctrl+C로 개발 감시를 종료합니다. 앱 폴더에서 실행하세요.
nexia db seed sample
nexia db statuscompleted를 확인한 뒤nexia dev를 다시 실행합니다.- 워크스페이스의 설정 → 자격 증명 및 접근에서 Example 조회·수정 권한을 역할에 담고 사용자에게 부여합니다. 앱의 예제 목록에 한 건이 보이는지 확인합니다.
- 같은 절차로 다시 실행했을 때 같은 이름의 샘플이 중복되지 않는지 확인합니다.
접수·대기 상태는 성공이 아닙니다. 키가 안 보이면 contribution 경로·appKey()·준비된 소스 버전을 확인하세요. 실패하면 파일·예외를 확인하고 수정한 뒤 명령을 다시 실행합니다. 개발 재시도에 관리자 승인은 필요하지 않습니다. 결과가 미확정이면 요청 ID로 상태를 먼저 확인합니다. 이 절차는 소스에 근거한 예제이며 각 앱의 실제 실행 결과는 별도로 확인해야 합니다.
필수 초기값과 구분
업무가 성립하는 데 반드시 필요한 코드·기본값은 필수 설치 콘텐츠를 사용합니다. 샘플 레코드는 초기화기에 넣지 않습니다. App 테스트하기의 로컬 테스트 fixture와 유지되는 원격 샌드박스 데이터도 구분하세요.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.
시딩 실패 확인
nexia db seed <key> --app <앱키>가 실패하면 CLI와 Console의 해당 실행 상세에서 단계·파일·예외를 확인합니다. seed는 런타임 준비 이후 fixture 실행 단계입니다. 선행 데이터나 fixture 코드를 수정하고 같은 명령을 명시적으로 다시 실행하세요. 데이터 초기화나 migration 이력 삭제는 필요하지 않습니다. 전송 중단으로 결과가 불명확하면 기존 요청 ID로 먼저 결과를 확인하고, fixture는 재실행해도 중복되지 않게 작성하세요.
코드를 저장할 때
호환 개발 환경에서 PHP 코드를 저장해도 같은 실행 환경과 DB 연결을 유지합니다. 적용 검사에 실패하면 이전 코드를 유지하고, 화면은 입력값을 보존하며 갱신됩니다. Core 0.8.156, Manager 0.1.0-alpha.77의 호환 런타임과 CLI 0.2.0-alpha.43을 함께 적용하세요. 기존 환경은 호환 런타임으로 준비한 후 사용할 수 있습니다. 마이그레이션과 시딩은 명시적인 nexia db 명령으로 실행합니다. CLI 0.2.0-alpha.43 업데이트 노트 · 변경 PR #166 · 개발 실행을 유지하는 소스 갱신
Core 0.11.27은 개발 중 소스 버전이 잠시 일치하지 않을 때 다시 확인합니다. 불일치가 지속되면 오류와 재시도 버튼이 표시됩니다. CLI 0.2.0-alpha.58은 변경을 적용하는 동안 마지막으로 확인된 실행 상태를 표시하며, 유휴 상태에서 다른 요청으로 발생한 PHP 로그는 최대 30초 늦게 표시될 수 있습니다. CLI 업데이트 후 nexia dev를 다시 실행하세요. CLI 0.2.0-alpha.58 업데이트 노트 · CLI 변경 사항