Resource 만들기
Workshop에 Note를 추가하고 한 테넌트에서 생성·조회·수정합니다.
Resource 만들기
빠른 시작에서 이미 Note를 만들었다면 생성 명령을 반복하지 말고 아래 확인 단계로 이동하세요. Workshop은 예제 앱 이름입니다. 기존 앱에서는 자신의 앱 이름·키·테이블 접두어로 바꿔 읽습니다.
Workshop에 Note를 추가합니다. App 저장소에서 실행하며
Core 소스나 Core artisan 명령은 필요하지 않습니다.
생성된 app.installed:workshop route guard를 유지하세요.
nexia make resource Note --record-owner legal_entity --label-ko 노트 --label-zh 笔记 --dry-run
nexia make resource Note --record-owner legal_entity --label-ko 노트 --label-zh 笔记생성 파일을 검토한 뒤 App을 해당 샌드박스 워크스페이스에 연결합니다. 테넌트 설치·migration·필수 초기화는 플랫폼이 관리합니다. App 설치만으로 현재 사용자에게 데이터 조회·수정 권한이 부여되지는 않습니다.
테넌트 Shell에서 확인
Developers sandbox에서는 프로젝트의 nexia dev가 변경된 선언을 준비한 뒤 워크스페이스 설정 → 자격 증명 및 접근에서 Note 조회·생성·수정과 대상 법인을 허용하세요. 새 리소스는 Workshop 내부에 생기므로 프로젝트 앱 목록에 별도 앱이 추가되지 않습니다. 권한 목록에도 Note가 없다면 CLI의 준비 결과부터 확인하세요.
실습 테넌트에 로그인해 Workshop → 운영 → 노트를 엽니다. 새 노트에서 허용된 Legal Entity를 선택하고 이름을 저장하세요. 목록 행의 Inspector, 상세, 편집 화면도 열어 봅니다. 기본 상태 필드는 생성하지 않습니다. 삭제 Route는 생성되지만 기본 Policy는 삭제를 거부합니다. 실제 보존·감사 규칙을 정한 뒤 구현하세요.
기능별 수정 위치
아래는 Workshop 루트 기준 경로입니다.
| 경로 | 역할 |
|---|---|
database/migrations/tenant/*_create_wsp_notes_table.php | 테넌트 테이블, UUID, 인덱스 |
src/Models/Note.php | 저장 필드, 목록 조건, 조회 범위 |
src/Http/Controllers/NoteController.php | 검증, 권한이 적용된 조회, 응답 |
src/Policies/NotePolicy.php | 동작 권한과 레코드 범위 |
src/Contribution/Resources/NoteModule.php | Descriptor, 권한, 메뉴, Shell 계약 |
resources/js/resources/notes/ | 공유 타입·queries, List/Record 화면, Inspector |
tests/Feature/NoteAuthorizationTest.php | 생성된 권한 선언 검사 |
생성기는 App Route, Manifest와 번역 파일도 갱신합니다. Route와 Manifest의 삽입용 marker를 유지하세요. 프런트엔드 진입점은 Resource Inspector·화면·계약 파일을 자동 발견하므로 삽입용 marker가 필요하지 않습니다. Overview의 내용은 App에서 직접 구성합니다.
기본 API 목록 경로는 /api/workshop/notes입니다. 목록은 legal_entity_public_ids[], 생성은 단일 legal_entity_public_id로 대상을 전달합니다. 상세·수정은 공개 UUID로 Note를 찾고 저장된 소유자를 복원합니다. Shell 전역 상태로 소유자를 결정하지 않습니다.
다른 Resource의 소유자 정하기
--record-owner | 대상 | 조직 선택 UI |
|---|---|---|
legal_entity (기본값) | 특정 Legal Entity가 소유한 기록 | 페이지 목록 범위와 생성 대상 선택 |
tenant | 테넌트 공통 기준정보 | 조직 선택기 없음 |
허용 값은 두 가지뿐입니다. 단일 설정이나 부모에 종속된 자식 행까지 모두 최상위 Resource로 만들 필요는 없습니다. 표준 프로필로 표현되지 않는 권한은 App에서 명시적으로 구현합니다.
Resource Module은 workshop.note 같은 고정 키, 공개 descriptor, 권한 계약과 메뉴를 선언합니다. publicForBuilder는 발견 참여 여부이며 접근 권한을 대신하지 않습니다. 내부 원장·시도 기록 등에는 false를 사용하세요. 전체 형식과 생성기 옵션은 Resource 계약에 있습니다.
첫 필드 추가하기
필드는 migration → 모델·Controller → 요청·응답 타입 → 폼·상세·목록 순서로 연결합니다. 칼럼 추가 예제를 따라 수정하세요. 기존 데이터와 적용된 migration은 보존합니다.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.