altair823
f9714aa5cb
마지막 commit. 모든 .md 안의 `kb` 단어 일괄 갱신. - 19 개 crate 이름 (`kb-core`, `kb-app`, …) → `kebab-*` (Rust 모듈 path 표기 `kb_*` → `kebab_*` 포함). - 미래 component (`kb-tui`, `kb-desktop`, `kb-asr-whisper`, `kb-ocr`, `kb-mcp`, `kb-vlm`, `kb-rerank`, `kb-vision-ocr`, `kb-index`, `kb-smoke`, `kb-architecture`) → `kebab-*` (P6+ 가 시작될 때 같은 prefix 사용). - CLI 명령 예제: `kb ingest` / `kb search` / `kb ask` / `kb init` / `kb doctor` / `kb inspect` / `kb list` / `kb eval` → `kebab <verb>`. fenced code block + 인라인 backtick 모두. - XDG paths + env vars + binary 경로 (`target/release/kb` → `target/release/kebab`) 동기화. - design doc / 최초 보고서 / SMOKE / HOTFIXES / phase epic / task spec 모든 reference 통일. - task-decomposition.md 의 `git -c user.name=kb` 는 과거 git history 기록용 author 정보라 그대로 유지 (실제 git history 의 author 는 변경 불가). - `tasks/phase-5-evaluation.md` 의 `status: planned` → `completed` 도 같이 (P5-1 + P5-2 PR 머지 후 미반영분). ## 검증 - `grep -rEn "\bkb-[a-z]|\bkb_[a-z]|\.config/kb\b|kb\.sqlite|\bKB_[A-Z]" --include="*.md"` 0 hits (task-decomposition.md 의 git author 제외). - 모든 file path reference 살아있음 (renamed file 들 모두 새 path 로 update). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
121 lines
3.7 KiB
Markdown
121 lines
3.7 KiB
Markdown
---
|
|
phase: P9
|
|
title: "TUI + desktop app"
|
|
status: planned
|
|
depends_on: [P5]
|
|
source: kebab_local_rust_report.md §16, §17 Phase 9
|
|
---
|
|
|
|
# P9 — TUI + desktop app
|
|
|
|
## 목표
|
|
|
|
CLI 위에 사용성 레이어 추가. domain/검색/RAG 가 안정된 뒤 마지막에 붙임.
|
|
|
|
## 순서
|
|
|
|
```text
|
|
kebab-tui (먼저) → kebab-desktop (나중)
|
|
```
|
|
|
|
이유: TUI 는 domain 변화에 빠르게 적응 가능. desktop 은 packaging/배포 비용 큼.
|
|
|
|
---
|
|
|
|
## P9.A — kebab-tui (Ratatui)
|
|
|
|
### 산출 crate
|
|
|
|
- `kebab-tui` — Ratatui + crossterm 기반 terminal UI.
|
|
|
|
### 화면 구성
|
|
|
|
| 화면 | 내용 |
|
|
|------|------|
|
|
| Library | document 목록, tag/lang 필터, indexing 상태 |
|
|
| Search | 검색창 + 결과 list + preview pane (citation 포함) |
|
|
| Ask | RAG 질문창 + 답변 + citation 토글 |
|
|
| Inspect | document/chunk 상세 (heading path, source span, provenance) |
|
|
| Jobs | indexing/embedding/transcription 진행 |
|
|
|
|
### 키바인딩 1차
|
|
|
|
```text
|
|
Tab : 화면 전환
|
|
/ : 검색 모드
|
|
? : ask 모드
|
|
Enter : 결과 열기
|
|
g : citation 으로 점프 (외부 editor: $EDITOR +line file)
|
|
q : 종료
|
|
```
|
|
|
|
### 의존성 경계
|
|
|
|
- `kebab-tui` → `kebab-app` 만. parser/store/LLM 직접 호출 금지.
|
|
- 비동기 I/O (검색/ask) 는 `kebab-app` 비동기 wrapper 또는 thread + channel.
|
|
|
|
### 완료 조건
|
|
|
|
- [ ] document list / search / ask / inspect 4개 화면 동작
|
|
- [ ] 검색 결과 → editor 점프 (citation line 정확히)
|
|
- [ ] indexing job 진행률 표시
|
|
- [ ] CLI 와 동일 facade 호출 (기능 누락 0)
|
|
|
|
---
|
|
|
|
## P9.B — kebab-desktop
|
|
|
|
### 후보 비교
|
|
|
|
| 후보 | 장점 | 단점 |
|
|
|------|------|------|
|
|
| Tauri | Rust backend + web frontend. native webview, 작은 binary | web frontend 별도 stack (TS/JS) |
|
|
| egui/eframe | 순수 Rust, immediate-mode | 디자인 자유도/접근성 한계 |
|
|
|
|
추천: Tauri 1차. 기존 `kebab-app` facade 그대로 backend 로 노출. frontend 는 가볍게 (svelte/solid/vanilla).
|
|
|
|
### 산출 crate / 구조
|
|
|
|
- `kebab-desktop` (Tauri app crate)
|
|
- `kebab-desktop-frontend/` (web 자산)
|
|
|
|
Tauri command 는 `kebab-app` 함수 1:1 wrap. 신규 비즈니스 로직 추가 금지.
|
|
|
|
### 화면 구성 (1차)
|
|
|
|
| 패널 | 내용 |
|
|
|------|------|
|
|
| Library | document grid, multimodal 썸네일 (이미지/PDF/audio waveform) |
|
|
| Search | hybrid search + filter + citation preview |
|
|
| Ask | RAG chat. citation 클릭 시 source pane 동기화 |
|
|
| Source viewer | Markdown 렌더, PDF page viewer, image viewer (region overlay), audio player (segment seek) |
|
|
| Settings | model 선택, indexing 옵션, 경로 |
|
|
|
|
### Citation 클릭 동작
|
|
|
|
- Markdown: 내장 viewer 의 해당 line range scroll + highlight.
|
|
- PDF: page jump + (선택) span highlight.
|
|
- Image: region bounding box overlay.
|
|
- Audio: segment 시작 시각으로 seek + 재생.
|
|
|
|
### 의존성 경계
|
|
|
|
- frontend 는 Tauri command (= `kebab-app` wrapper) 만 호출. SQLite/LanceDB 직접 접근 금지.
|
|
- 모델 다운로드/실행은 backend 책임.
|
|
|
|
### 완료 조건
|
|
|
|
- [ ] document, image, PDF, audio citation 모두 viewer 에서 점프 동작
|
|
- [ ] hybrid search + RAG chat 동작
|
|
- [ ] indexing/embedding/transcription job UI 표시
|
|
- [ ] macOS dmg 배포 가능 (M4 기준 동작 확인)
|
|
|
|
---
|
|
|
|
## 공통 리스크 / 주의
|
|
|
|
- UI 부터 만들면 domain 흔들릴 때 비용 폭주. P5 까지 안정시킨 뒤 진입 (§16.3).
|
|
- TUI 와 desktop 모두 facade 만 호출. UI 안에 비즈니스 로직 들어가면 P10 같은 신규 phase 마다 양쪽 다시 손봐야 함.
|
|
- desktop packaging (코드 서명, notarization) 은 별도 작업. 1차 릴리스는 unsigned dev build OK.
|
|
- Tauri 채택 시 web stack 이 "최소"여야 함. 프레임워크 선택은 1주일 안에 결론.
|