본문으로 건너뛰기
가이드

Resource 만들기

Workshop에 Note를 추가하고 한 테넌트에서 생성·조회·수정합니다.

Resource 만들기

빠른 시작에서 이미 Note를 만들었다면 생성 명령을 반복하지 말고 아래 확인 단계로 이동하세요. Workshop은 예제 앱 이름입니다. 기존 앱에서는 자신의 앱 이름·키·테이블 접두어로 바꿔 읽습니다.

Workshop에 Note를 추가합니다. App 저장소에서 실행하며 Core 소스나 Core artisan 명령은 필요하지 않습니다. 생성된 app.installed:workshop route guard를 유지하세요.

코드 예시
Shell
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.phpDescriptor, 권한, 메뉴, 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 문서에서도 확인할 수 있습니다.

원본 위치: docs/developers/content/ko/building-apps/create-a-resource.md