SSH 환경의 SQLite 제약 해결, Bash 기반 TUI 워크벤치 구현 기록

Context

원격 서버 내 SQLite 데이터 확인을 위해 SSH 접속 후 CLI 기반의 원시 SQL 쿼리 수행 필요. 기존 GUI 툴은 로컬 연결 기반으로 원격 서버 내 파일 직접 접근 불가. 포트 포워딩이나 파일 전송 과정의 번거로움 발생.

Technical Solution

• Bash 전용 TUI 프레임워크인 shellframe를 기반으로 화면 관리와 키보드 라우팅, 컴포넌트 생명주기를 제어하는 구조
• xterm escape sequences를 활용하여 Bash 환경 내 마우스 클릭과 스크롤 기능을 구현한 인터페이스
• SQLite의 .schema 출력을 파싱하여 외부 도구 없이 스키마 브라우저를 구축한 설계
• 스키마 정보를 인식하는 폼 오버레이 방식으로 제약 조건과 컬럼 타입을 반영한 CRUD 레코드 에디터 구현
• 탭 관리 시스템을 통해 여러 테이블을 동시에 열람할 수 있는 포커스 모델 적용
• bash와 sqlite3만 설치된 모든 환경(Docker, CI, Production)에서 실행 가능한 무설치 지향 전략

Key Takeaway

특정 환경의 제약(SSH-only)을 극복하기 위해 런타임 의존성을 최소화하고 표준 터미널 프로토콜을 활용한 도구 설계의 효율성.