샘플 앱 둘러보기
SQLly Embedded에 포함된 샘플 관리자 앱의 화면별 안내: 상태 및 라이선싱, 프로필과 연결, 레이블, 사용자, 그리고 SQLly 실행.
이 패키지에는 작은 관리자 앱(sample-app/, Node.js 20+, 의존성 없음)으로 SQLly Embedded가 할 수 있는 모든 것을 시험해 봅니다. 이 샘플 앱은 다음의 역할을 맡습니다 내 앱입니다. 프로필, 라벨, 사용자를 담당하는 관리자 쪽과, 사람들이 로그인해 SQLly를 열도록 하는 사용자 쪽이 있습니다. 아래의 모든 화면은 한두 개의 관리 API 호출들을 얇은 레이어로 감싼 것에 불과합니다. 각 스크린샷 아래에는 호출 이름이 표시되어 있어서 여러분 앱이 무엇을 호출하게 될지 바로 보입니다.
이 스크린샷들은 시험용 라이선스에 연결된 실제 브리지에서 가져온 것이며, 그 뒤에는 SQL Server Northwind 데이터베이스가 있습니다.
관리자 로그인
상태 및 라이선스
상태 입니다 GET /manage/status 페이지로 렌더링됩니다. 키나 라이선스 파일 없이 시작한 브리지는 라이선스 없음: 이미 프로필을 구축하고 테스트할 수 있지만 설치가 연결될 때까지 SQLly는 실행되지 않습니다.
sqlly.app에 연결 sqlly.app에 링크 코드를 요청합니다 (POST /api/embedded/links) 그리고 이를 표시합니다. 승인하려면 sqlly.app을 여세요 라이선스 소유자를 sqlly.app로 안내하고, 거기서 같은 코드를 확인한 뒤 라이선스를 고릅니다:
몇 초 뒤 관리 앱이 설치 키를 수집하고 브리지에 전달하며 PUT /manage/license, 그리고 상태는 라이선스를 보여줍니다:
프로필
프로필은 한 그룹의 사용자에게 보이는 연결 모음입니다. 목록에는 각 프로필의 연결과 할당된 사용자가 표시되며 실행 를 누르면 그 프로필로 본인 계정 그대로 SQLly가 열립니다.
연결 편집
연결 편집기는 선택한 엔진에 대해 자격 증명 형식이 지원하는 모든 필드를 제공합니다. 엔진 목록과 각 엔진의 로그인 유형은 GET /manage/engines. 테스트 폼에 입력된 내용을 저장 여부와 상관없이 그대로 검사하고 엔진의 실제 답변을 인라인으로 보여 줍니다:
라벨
클라이언트, 프로젝트 및 환경은 SQLly에서 연결을 색상별로 표시하고 그룹화하며 안전 규칙을 적용합니다. 샘플 앱은 하나의 공유 세트를 유지하며 모든 프로필과 함께 전송하므로 라벨 이름을 변경하면 해당 라벨을 사용하는 모든 연결이 업데이트됩니다.
사용자 및 좌석
샘플 앱의 사용자는 자체 계정이며 각각 프로필을 하나씩 배정받습니다. 실제 앱에서는 사용자와 접근 권한이 어떻게 되어 있든 그대로이면 됩니다. 이 페이지에서는 현재 좌석을 누가 쓰고 있는지도 보여줍니다(GET /manage/seats), 다음과 함께 좌석 해제 (DELETE /manage/seats/{user}).
사용자가 보는 화면
사용자는 /admin이 아닌 앱의 루트에서 로그인합니다:
SQLly가 열려 있는 동안 Status에는 사용 중인 좌석이 표시됩니다:
코드 읽기
| 파일 | 핵심 정리 |
|---|---|
lib/bridge.js | 모든 호출, 오류 처리, 타임아웃을 갖춘 완전한 관리 API 클라이언트입니다. 복사해 가거나 포팅하세요. |
lib/credentials.js | 폼 필드와 공유 라벨을 다음으로 변환: sqlly-credentials 문서로 변환합니다. |
lib/sqllyapp.js | 연결 과정의 sqlly.app 쪽: 링크를 만들고 키를 폴링합니다. |
server.js | 라우팅. GET /app/ 실행 경로입니다; /admin/* 관리자 측입니다; /admin/link* 링크입니다. |
views/pages.js | HTML 전체, 다음을 포함합니다: injectLaunch, 다음보다 먼저 두 전역 변수를 설정합니다 boot.js. |
test/ | node --test 앱을 가짜 브리지로 실행하는 테스트 스위트입니다. 자체 통합을 테스트할 때 좋은 모델이 됩니다. |
교체할 준비가 되셨나요? 직접 앱 만들기 이러한 작업 각각을 여러분의 스택에서 어떻게 처리하는지 하나씩 안내합니다.