샘플 앱 둘러보기

SQLly Embedded에 포함된 샘플 관리자 앱의 화면별 안내: 상태 및 라이선싱, 프로필과 연결, 레이블, 사용자, 그리고 SQLly 실행.

이 패키지에는 작은 관리자 앱(sample-app/, Node.js 20+, 의존성 없음)으로 SQLly Embedded가 할 수 있는 모든 것을 시험해 봅니다. 이 샘플 앱은 다음의 역할을 맡습니다 내 앱입니다. 프로필, 라벨, 사용자를 담당하는 관리자 쪽과, 사람들이 로그인해 SQLly를 열도록 하는 사용자 쪽이 있습니다. 아래의 모든 화면은 한두 개의 관리 API 호출들을 얇은 레이어로 감싼 것에 불과합니다. 각 스크린샷 아래에는 호출 이름이 표시되어 있어서 여러분 앱이 무엇을 호출하게 될지 바로 보입니다.

이 스크린샷들은 시험용 라이선스에 연결된 실제 브리지에서 가져온 것이며, 그 뒤에는 SQL Server Northwind 데이터베이스가 있습니다.

관리자 로그인

샘플 앱의 관리자 로그인 카드와 사용자 이름 및 비밀번호 입력 필드
관리자 화면은 /admin에 있습니다. 기본 계정은 sqlly-admin / GoodLittlePiggy이며, sample-app/config.json에서 바꾸기 전까지 앱은 루프백 밖에서의 수신을 거부합니다.

상태 및 라이선스

상태 입니다 GET /manage/status 페이지로 렌더링됩니다. 키나 라이선스 파일 없이 시작한 브리지는 라이선스 없음: 이미 프로필을 구축하고 테스트할 수 있지만 설치가 연결될 때까지 SQLly는 실행되지 않습니다.

브리지는 실행 중이지만 라이선스에 연결되지 않았다고 표시하는 브리지 상태 페이지로, sqlly.app에 연결 버튼이 있음
라이선스 없음: 이 설치를 sqlly.app에 연결 카드에서 연결 절차를 시작하세요.

sqlly.app에 연결 sqlly.app에 링크 코드를 요청합니다 (POST /api/embedded/links) 그리고 이를 표시합니다. 승인하려면 sqlly.app을 여세요 라이선스 소유자를 sqlly.app로 안내하고, 거기서 같은 코드를 확인한 뒤 라이선스를 고릅니다:

큰 연결 코드와 'sqlly.app 열어서 승인' 버튼을 보여주며 승인을 기다리는 샘플 앱
관리자 앱이 코드를 표시하고 백그라운드에서 sqlly.app를 폴링합니다(POST /api/embedded/links/token).
설치를 계정에 연결하는 sqlly.app 페이지로, 설치 이름, 일치하는 코드, 선택한 평가판 라이선스가 표시되고 승인 링크 및 거부 버튼이 있습니다
sqlly.app에서 소유자는 어떤 설치가 요청하는지 확인하고, 코드를 검토하며, 라이선스를 선택하고 승인합니다. 각 연결된 설치는 고유한 키를 가지며, 소유자의 Embedded 페이지에서 취소할 수 있습니다.

몇 초 뒤 관리 앱이 설치 키를 수집하고 브리지에 전달하며 PUT /manage/license, 그리고 상태는 라이선스를 보여줍니다:

연결된 설치의 브리지 상태 페이지: 연결 모드, 라이선스 상태 정상, SQLly Embedded 평가판 플랜, 시트 1개 중 0개 사용 중, 연결된 sqlly.app 계정, 라이선스 세부 정보
연결됨: 플랜, 사용 중인 좌석, 종료일, 연결된 계정(sqlly.app의 관리 및 연결 해제 버튼 포함), 그리고 브리지가 보고하는 세부 정보. sqlly.app 체크인은 이제 POST /manage/license/checkin을 호출합니다.

프로필

프로필은 한 그룹의 사용자에게 보이는 연결 모음입니다. 목록에는 각 프로필의 연결과 할당된 사용자가 표시되며 실행 를 누르면 그 프로필로 본인 계정 그대로 SQLly가 열립니다.

프로필 목록: 생성 행과 두 개의 프로필(Analysts – Northwind, Support – 읽기 전용), 각 프로필에 실행·편집·삭제 버튼
프로필 생성은 빈 자격 증명 문서와 함께 PUT /manage/profiles/{id}로 수행하며, 브리지는 이를 저장한 뒤 이후의 모든 변경 사항을 검증합니다.
Analysts – Northwind 프로필 페이지: 녹색 연결 테스트 결과와 두 개의 SQL Server 연결이 담긴 표. 각 연결은 Connected로 표시되어 있고 Test, Edit, Delete 버튼이 있습니다
프로필의 연결들. 각 연결을 그 자리에서 바로 테스트합니다. 테스트는 해당 연결만 담은 문서로 POST /manage/test-connection을 호출하고, 이 프로필로 SQLly 실행은 관리자용 토큰을 만들어 줍니다.

연결 편집

연결 편집기는 선택한 엔진에 대해 자격 증명 형식이 지원하는 모든 필드를 제공합니다. 엔진 목록과 각 엔진의 로그인 유형은 GET /manage/engines. 테스트 폼에 입력된 내용을 저장 여부와 상관없이 그대로 검사하고 엔진의 실제 답변을 인라인으로 보여 줍니다:

서버, 데이터베이스, 라벨, 마스킹된 비밀번호, 안전 및 TLS 옵션을 담은 SQL Server 연결 편집기와, 연결 저장, 테스트, 저장하고 테스트, 취소 버튼 위의 녹색 테스트 결과
서버, 라벨(환경, 클라이언트, 프로젝트), 인증, 안전 규칙 및 TLS. 비밀번호는 서버에 남아 있으며, 브리지에서 저장하고 브라우저는 비밀번호를 받지 않습니다.

라벨

클라이언트, 프로젝트 및 환경은 SQLly에서 연결을 색상별로 표시하고 그룹화하며 안전 규칙을 적용합니다. 샘플 앱은 하나의 공유 세트를 유지하며 모든 프로필과 함께 전송하므로 라벨 이름을 변경하면 해당 라벨을 사용하는 모든 연결이 업데이트됩니다.

클라이언트 탭의 라벨 페이지에서 색상, 이모지 또는 이미지 아이콘과 안전 플래그가 있는 클라이언트를 추가하는 폼과 아이콘 및 연결 수가 표시된 두 개의 클라이언트 목록
클라이언트와 프로젝트는 색상, 아이콘(이모지는 이미지로 저장되거나 업로드 가능), 선택적 안전 플래그를 갖습니다.
환경 탭의 라벨 페이지로, Dev, Test, Staging, Production이 나열되어 있고 Production에는 '프로덕션으로 취급' 표시가 붙어 있음
SQLly의 네 가지 환경. Production은 프로덕션 환경으로 표시되므로 SQLly가 읽기 전용 바를 보여 주고 변경 전에 확인을 요청합니다.
이름, 색상, 이모지 아이콘과 전체 안전 플래그 체크박스 목록이 있는 Northwind Traders 클라이언트 편집 폼
자격 증명 형식이 지원하는 모든 안전 플래그, 예를 들어 SELECT만 허용하거나 데이터 변경을 확인하는 것들이, 그 라벨로 프로필을 여는 모든 사람에게 SQLly에서 강제됩니다.

사용자 및 좌석

샘플 앱의 사용자는 자체 계정이며 각각 프로필을 하나씩 배정받습니다. 실제 앱에서는 사용자와 접근 권한이 어떻게 되어 있든 그대로이면 됩니다. 이 페이지에서는 현재 좌석을 누가 쓰고 있는지도 보여줍니다(GET /manage/seats), 다음과 함께 좌석 해제 (DELETE /manage/seats/{user}).

사용 중인 좌석 1개 중 1개를 표시하는 사용자 페이지, 두 사용자가 1좌석 체험판 한도를 초과했다는 경고, 생성 행, 그리고 두 명의 사용자(그중 한 명은 좌석 해제 버튼이 있는 좌석을 보유함)
SQLly가 열려 있는 동안에는 평가판의 유일한 좌석을 dana.analyst가 차지하고, 좌석이 비기 전까지 sam.support는 seat_limit으로 거부됩니다. 사용자로 실행을 누르면 그 사용자에게 보이는 그대로 SQLly가 열립니다.
사용자 이름, 새 비밀번호, 프로필 필드가 있는 dana.analyst 사용자 편집 폼
사용자는 사용자 이름과 비밀번호(sample-app/data에 scrypt 해시로 저장), 프로필로 이루어집니다.

사용자가 보는 화면

사용자는 /admin이 아닌 앱의 루트에서 로그인합니다:

최종 사용자 SQLly 로그인 카드
샘플 앱의 사용자 쪽 화면입니다. 실제 제품에서는 기존에 쓰시던 로그인이 이 역할을 합니다.
Analysts – Northwind 프로필과 Open SQLly 버튼이 표시된 dana.analyst 환영 페이지
Open SQLly는 /app/로 이동해서 실행 토큰(POST /manage/tokens)을 발급하고, 그 토큰으로 SQLly를 내보냅니다. SQLly 탭을 닫으면 좌석이 해제됩니다.
브리지를 통해 브라우저에서 실행되는 SQLly: 탐색기에는 Northwind 프로덕션 및 스테이징 연결이 표시되고, Orders와 Customers에 대한 SELECT 쿼리가 PRODUCTION 읽기 전용 바 아래 편집기에 있으며, 결과 그리드에는 25개의 행이 표시됩니다
브리지를 통해 SQL Server와 통신하는 브라우저에서 SQLly. 프로필의 라벨이 상태 표시줄에 나타나고, Production 환경의 안전 규칙이 적용됩니다: 편집기는 잠금 해제 전까지 읽기 전용입니다.

SQLly가 열려 있는 동안 Status에는 사용 중인 좌석이 표시됩니다:

시트 1개 중 1개가 사용 중이고 활성 세션이 1개인 브리지 상태 페이지
좌석은 동시 사용 기준입니다: dana.analyst가 탭을 닫고 토큰이 만료되는 순간 이 좌석은 바로 해제됩니다.

코드 읽기

파일핵심 정리
lib/bridge.js모든 호출, 오류 처리, 타임아웃을 갖춘 완전한 관리 API 클라이언트입니다. 복사해 가거나 포팅하세요.
lib/credentials.js폼 필드와 공유 라벨을 다음으로 변환: sqlly-credentials 문서로 변환합니다.
lib/sqllyapp.js연결 과정의 sqlly.app 쪽: 링크를 만들고 키를 폴링합니다.
server.js라우팅. GET /app/ 실행 경로입니다; /admin/* 관리자 측입니다; /admin/link* 링크입니다.
views/pages.jsHTML 전체, 다음을 포함합니다: injectLaunch, 다음보다 먼저 두 전역 변수를 설정합니다 boot.js.
test/node --test 앱을 가짜 브리지로 실행하는 테스트 스위트입니다. 자체 통합을 테스트할 때 좋은 모델이 됩니다.

교체할 준비가 되셨나요? 직접 앱 만들기 이러한 작업 각각을 여러분의 스택에서 어떻게 처리하는지 하나씩 안내합니다.