App 패키지 만들기
Workshop App을 생성하고 독립 저장소로 작업을 시작합니다.
App 패키지 만들기
빠른 시작에 따라 공개 도구를 설치하고 프로젝트 폴더를 연결한 상태에서 Workshop App을 만듭니다. 연결된 프로젝트 폴더에서 아래 명령을 실행하세요. Core·SDK 소스나 플랫폼 DB 접속 정보는 필요하지 않습니다.
nexia create app workshop --vendor acme --family other --name Workshop --key workshop --table-prefix wsp --dry-run
nexia create app workshop --vendor acme --family other --name Workshop --key workshop --table-prefix wsp
cd workshop
composer install --no-scripts
npm install생성 예정 목록을 검토한 뒤 실제 생성합니다. 기존 디렉터리는 덮어쓰지 않습니다. 등록 시 전역 App key·패키지·테이블 prefix·App namespace의 충돌을 검사합니다. 생성만으로 identity가 예약되거나 App이 설치되지는 않습니다. 개발자가 직접 브라우저에서 로그인을 승인하며 인증정보를 채팅이나 App 저장소에 넣지 않습니다.
PHP namespace는 Nexia\Apps\Acme\Workshop, Composer 패키지는 acme/workshop,
프론트 패키지는 @acme/workshop, PSR-4 소스 경로는 src/입니다.
manifest·provider·빈 기본 대시보드 선언·overview 호환 화면·route·번역 카탈로그와 설계 기록이 생성됩니다.
별도 App 개요 화면은 지원 중단 예정입니다. 생성된 경로는 현재 런타임 요구에 맞게 유지하고, 새 개요는 SDK의 리포트와 플랫폼 대시보드를 사용하세요.
Resource 만들기에서 업무 리소스를 추가하세요.
소스 경로와 CLI 명령은 App 저장소를 기준으로 합니다.
에디터·에이전트에서는 생성된 workshop 폴더를 여세요. 리소스 생성·검사는 이 앱 폴더에서 수행합니다. 실행은 프로젝트 폴더로 돌아가 nexia dev 하나로 시작하며, 이미 실행 중이라면 중복 시작하지 마세요. 앱을 자동 등록하고 준비하므로 별도 link·app register는 필요하지 않습니다. 상세 개발 순서는 AI와 함께 로컬 개발을 참고하세요.
실행 확인
프로젝트에서 nexia dev를 켜고 Console의 프로젝트 앱에 Workshop이 실행 준비 상태로 표시되는지 확인하세요. 다음으로 Resource 만들기를 따라 Note를 추가하고 테스트 권한을 부여해 저장합니다.
소스에 비밀값을 넣지 마세요. 전송 대상과 크기 제한은 Nexia CLI에서 확인할 수 있습니다.
제품 App의 이름 정하기
실제 제품에는 실습 이름을 그대로 쓰지 말고 업무 책임에 맞는 식별자를 정하세요.
| 항목 | 실습값 | 결정할 내용 |
|---|---|---|
app_key | workshop | Route·권한·Resource의 영구 식별자, lower kebab-case |
app_table_prefix | wsp | 소유 테이블의 접두어, lower snake_case |
app_family | other | 런처의 표시 그룹 |
| 표시 이름 | Workshop | 사용자에게 보이는 이름, --display-name으로 지정 |
core, host, platform, shell, tenant, process, apps는 예약된 키입니다. 배포 이후 키를 바꾸려면 연관 계약을 함께 변경해야 하고 테이블 접두어 변경에는 마이그레이션이 필요합니다. Family의 이름과 순서는 호스트가 관리합니다.
별도로 설치·배포할 업무 책임이 있을 때 App을 나눕니다. 기존 업무의 화면이나 레코드를 하나 더 만드는 일이라면 해당 App에 추가하면 됩니다. 다른 App의 레코드를 참조하는 것은 가능합니다. 두 App이 같은 트랜잭션으로 하나의 업무 규칙을 지켜야 한다면 소유 경계를 먼저 점검하세요.
--prerequisite=<app-key>는 여러 번 지정할 수 있으며 설치 순서를 정합니다. 데이터 접근 권한은 생기지 않습니다. 다른 앱의 소스나 테이블을 직접 사용하지 마세요.
생성 후 열어 볼 파일
| App 루트 기준 경로 | 수정할 내용 |
|---|---|
nexia.json | App 식별자, Core 호환 범위, 테스트 경로 |
composer.json | PHP 의존성, autoload |
src/WorkshopAppManifest.php | Contribution, 테넌트 마이그레이션, Overview |
src/WorkshopServiceProvider.php | 패키지 등록 |
resources/js/index.ts | 프런트엔드 등록 |
resources/lang/{en,ko,zh}.json | 화면 문구 |
docs/README.md, docs/DOMAIN-MODEL.md, docs/PAGES.md | 업무 책임, 데이터 모델, 메뉴 구성 |
Route와 프런트엔드 진입점의 generator marker는 남겨 두세요. Resource를 추가할 때 사용합니다. Resource가 존재한다고 반드시 메뉴에 노출해야 하는 것은 아닙니다. 의도한 진입점은 docs/PAGES.md에 기록합니다.
생성기 옵션은 Nexia CLI를 참고하세요.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.