문서
Nexia 문서
App 개발 순서를 따라가거나, 필요한 SDK 기능과 작업별 상세 설명을 찾아보세요.
빠른 시작에서 개발자 프로젝트와 클라우드 샌드박스를 만들고, 공개 CLI를 연결해 내 앱을 Nexia 작업 탭에서 실행하세요. Core는 개발자에게 배포하지 않는 비공개 서버 소프트웨어입니다.
AI와 함께 개발에서 내 앱 폴더 안의 작업을 이어갈 수 있습니다. CLI 알파는 정적 앱 미리보기와 심사 제출을 지원합니다. SDK 패키지 레퍼런스는 별도 연동 계약이며 비공개 저장소 접근 권한을 제공하지 않습니다.
App 개발 시작하기
업무 기능은 App Package에서 만듭니다. PHP와 React에서 필요한 공용 기능은 SDK로 사용하고, Core는 테넌트 컨텍스트·권한·Shell 실행을 맡습니다. Resource 하나를 완성한 다음 필요한 기능을 붙여 나가세요.
| 순서 | 완료할 작업 |
|---|---|
| 빠른 시작 | 로컬 호스트 실행과 테넌트 로그인 |
| App 패키지 만들기 | App 패키지, 고유 식별자, 진입 화면 생성 |
| Resource 만들기 | Note 모델·보호된 API·화면 생성 |
| 데이터 모델과 마이그레이션 | 필드를 저장하고 Resource에 반영 |
| App 화면 만들기 | 폼·상세·목록 구성 |
| App 테스트하기 | 기능과 접근 제어 동작 확인 |
| App 릴리스하기 | 호스트가 설치·업데이트할 수 있는 버전 출시 |
각 가이드 위쪽에는 바로 실행할 절차가 있고, 선택 사항과 원리는 아래에 있습니다. 이미 환경이 준비되어 있다면 App 개발 환경 준비에서 수정할 App을 선택하세요.
필요한 기능 찾기
| 하려는 작업 | 읽을 문서 |
|---|---|
| 내 App이 실행되는 전체 흐름 이해 | Nexia 시스템 개요 |
| SDK 서비스·컴포넌트·훅 찾기 | App SDK 사용하기 |
| 업무 동작 추가와 권한 검사 | 보호된 API 추가하기 |
| 검색·필터·폼 필드 추가 | App 화면 만들기 |
| 메뉴·위젯 등 플랫폼 기능 공개 | 확장 모델 |
| 다른 App의 데이터 참조·변경 수신 | App 간 연동 방식 선택하기 |
| 프로세스·결재·서명 연결 | 업무 프로세스, 전자 결재, 전자 서명 |
| Resource 가져오기·내보내기 | Resource Transfer |
| App이나 화면이 보이지 않는 원인 확인 | Contribution 발견 문제 해결 |
역할 구분하기
App은 업무 데이터와 입력 검증, Policy, 화면을 소유합니다. SDK는 App이 사용할 Core 서비스와 확장 지점을 공개합니다. Core는 테넌트 격리와 호스트 서비스 구현, 제품 화면 조합을 담당합니다.
접근 제어나 비동기 작업을 바꾸기 전에는 테넌트와 컨텍스트, 권한과 역할을 확인하세요. App을 설치하는 것만으로 업무 권한이 부여되지는 않습니다.
심화 작업
호스트 수정, 개발 명령, 배포 설정은 아래 문서에서 확인하세요.
- Core 및 SDK 개발 — 호스트나 SDK 자체를 수정할 때.
- Task 명령어 — 개발 명령을 찾을 때.
- 환경변수 — 배포 환경이나 선택 서비스를 설정할 때.
섹션으로 둘러보기
다음에 할 일을 찾으세요.
공통 설치
모든 개발자가 먼저 로컬 호스트와 저장소 접근을 준비합니다.
App 개발자
App checkout과 실제 Resource를 따라가며 패키지 작업 환경을 검증합니다.
Platform·SDK 개발자
Platform, SDK, App 경계를 함께 바꾸는 플랫폼 작업 흐름을 준비합니다.
개발 도구
Task와 Artisan 명령을 목적과 영향 범위로 찾아봅니다.
App Package
기능이 독립 App을 가져야 하는지 판단한 뒤 만듭니다.
도메인과 데이터
Resource와 데이터 모델, 마이그레이션을 만듭니다.
동작 보호
SDK 권한 계약을 Policy와 API, 테스트에 적용합니다.
화면
Frontend SDK로 App 화면을 만들고 로컬라이즈합니다.
App 간 연동
직접 의존 없이 다른 App의 사실과 변경을 다룹니다.
테스트와 출시
지원 하네스에서 검증하고 독립 버전을 출시합니다.
App 정체성과 라이프사이클
App 정체성과 설치 콘텐츠, 테넌트 소유 사본을 다룹니다.
Shell과 내비게이션
App Menu 목적지와 Command Palette 동작을 공개합니다.
App 화면 확장
App 설정 화면과 Dashboard Widget, Slot Widget을 공개합니다.
권한 확장
관리자가 채택할 Role Preset으로 App 권한 묶음을 제안합니다.
Resource 연동
Catalog와 참조, 통제된 데이터 이동으로 Resource를 연결합니다.
Workbench 확장
업무 프로세스, 전자결재, 전자 서명에 App descriptor와 업무 문서를 공개합니다.
SDK 개요
공개 경계와 플랫폼 용어를 이해합니다.
App Package
Composer 메타데이터와 App Manifest 계약.
PHP SDK
App이 import할 수 있는 PHP 계약.
Frontend SDK
Shell과 App 화면 사이의 프런트엔드 계약.
Contribution 계약
Resource와 설치 콘텐츠를 공개하는 계약.
업무 프로세스·전자결재·전자 서명 계약
업무 프로세스, 전자결재, 전자 서명 descriptor와 host 계약.
전체 시스템
브라우저와 Agent, Central과 Tenant, App이 만나는 런타임 지도.
Platform·SDK·App 경계
세 소유 영역과 허용되는 의존 방향.
테넌시와 보안
Tenant·Actor 컨텍스트와 Permission·Role·Grant 모델.
확장 모델
Contribution과 Catalog, Preset, Template, Descriptor.
설정 모델
배포·플랫폼·App 설정의 소유 위치를 구분합니다.
Web과 Shell
Tenant SPA와 Shell이 Route, 화면, App contribution을 조합하는 런타임.
백엔드 런타임
Laravel, Octane, FrankenPHP와 장기 실행 작업의 생명주기.
Search 런타임
후보 검색과 테넌트·권한 재검증이 분리되는 실행 구조.
콘텐츠
Information 화면을 이루는 Knowledge·Document Library·Communications Platform 기능.
플랫폼 설정
Site Configuration과 Search 실행 프로필을 선택하고 설정합니다.
선택적 서비스
필요한 작업에 맞춰 Agent Gateway 같은 선택적 서비스를 실행합니다.
설치와 환경
Docker와 데이터베이스, 초기 설정 실패를 진단합니다.
발견
App과 Contribution이 나타나지 않는 원인을 찾습니다.
경계
Platform·SDK·App import와 소유권 위반을 고칩니다.
컨텍스트와 테스트
Tenant·Actor 컨텍스트와 테스트 하네스를 진단합니다.
업무 프로세스·전자결재
업무 프로세스와 전자결재 계약 및 실행 실패를 진단합니다.