32 KiB
D3RO Voice — Feature & Infrastructure Map (Index)
Status: ACTIVE Last full audit: 2026-09-13 Last update: 2026-11-14 — 전 표면 프로덕션
v1.17.1배포 완결. 데스크톱(v1.17.1, 커밋6c6875b, 서명 매니페스트1.17.1/latest.yml·.sig및latest/latest.yml, 런타임runtime-1.17.1/runtime-latest, 포터블portable-1.17.1/portable-latest모두 Forgejo HTTP200, 태그v1.17.1canonical/mirror 푸시; Human Release #339 ~91MB 바이너리 첨부만 Cloudflare HTTP 524/ECONNRESETGAP-REL-16예외), Supabase 운영 DB(db push --remote, 전체 74개 마이그레이션 일치) 및 Edge Functions 24종(--import-map deno.json --use-api) 재배포, 랜딩 사이트(site/→ Cloudflare Pagesd3ro,https://d3ro.chanpaca.net/release-identity.json=1.17.1/6c6875b&assetlinks.json검증 GREEN), Cloudflare Worker(d3ro-voice-api--keep-vars, Version IDfe6d9532-0052-48f5-b62c-45c86f6aaaa5), NAS Docker 스택(d3ro_voice_apiv1.17.1/health200,d3ro_voice_admin:3001/d3ro-admin.chanpaca.net/login200,d3ro_voice_web:3002/app/login·d3ro.chanpaca.net/app/login200) 반영 완료.Previous update: 2026-11-14 — 전 표면 코드 위생 · 최적화 · 버그 헌팅 완결(Wave 6, WS1–WS4 병렬). (1) Desktop Main & Sidecar (
WS1):ipc/renderer-broadcast.ts(safeSendToRenderer/broadcastToAllWindows) 9개 파일 단일화,OnlineLLMService스트림 abort/401/예외 래핑,UnifiedSearchServiceFTS5→LIKE런타임 폴백·집계·정렬·인덱스(started_at/created_at) 보강,rag/chunk-store.ts캐시 무효화·중복embeddingJSON 제거·손상 Float32 방어,disk-wav-audio-sink.tsuint32 오버플로·헤더 write 실패 fd 정리,AdMediationEngine/AudioCaptureService/LocalLLMService/WindowManager타이머·팝업 레이스 수정,sidecar/main.pyUploadFile.close()·PCM 바이트 경계·/shutdown스레드 join 완료. (2) Shared Packages & Desktop Renderer (WS2):@d3ro/i18nshared.ts및 지연 로드/언마운트 레이스 차단(25/25),@d3ro/corePII 플레이스홀더·CSV BOM/CR·타임스탬프·검색 경계값(626/626),@d3ro/uiwave-math.ts+ 캔버스LinearGradient캐싱(7/7),@d3ro/ui-native/api-client경계 가드, 렌더러utils/error-message.ts·훅/컴포넌트 언마운트·타이머 정리 및 Vanilla JS 팝업 6종beforeunload/DOM 안전화 완료. (3) Mobile RN (WS3):features/shared/{service-guards,owned-cache-files}.ts,features/import/abort-guard.ts,lib/locale-speech.ts(12개 로케일),features/meetings/meeting-error-message.ts로 26+ 파일 중복 가드·오류·포맷 통합,FreeTierBanner슬롯 전환 시 높이 고착 수정·내구성 큐 조기 폐기 경합 차단·녹음 리스 누수·언마운트 재생/로케일 레이스 해결(Jest98 suites / 625 tests PASS). (4) Web · Admin · Site · Edge · Worker · .NET (WS4): Edge 20개 엔드포인트_shared/json-response.ts(스트리밍 바이트 상한 포함readJsonBody·jsonResponse) 통합 및account-delete/llm-proxy/payple/realtime-tokenfail-closed 강화(Deno270/270),.NETSttProxyServiceBase64 상한 +CancellationToken전파(xUnit32/32), Cloudflare WorkerresolveBackendTargetUrlSSRF·타임아웃·/worker-health정보 노출 차단(Deno9/9), 웹MarkdownPreviewDOM XSS/레이스·WebPush재진입·team-clientfail-closed(42/42), 어드민request-security.ts/detail-row.tsx·CSRF/ADMIN_UUID_PATTERN/비용 검증, 사이트AppLoopDemo/rel="noopener noreferrer"보강 완료. 상세:REFACTOR_WAVE6_REPORT.md.Previous update: 2026-11-13 — 전 표면 성능 최적화 · 코드 위생 완결(Wave 5) · 백로그 일괄 구현 · TDD v2.0 게이트 완성. (1) 소스·패키징 위생: 루트 중복
resources/sox/(5.21 MB) 및apps/desktop/resources/sox/불필요 바이너리 10종 제거 +electron-builder.yml필터 적용, 데스크톱 미구현 광고 어댑터 9종 단일화(UNAVAILABLE_AD_NETWORK_SPECS),scripts/local/109개 및 미참조 루트 스크립트 16개 삭제 +npm run clean:deep(scripts/ci/clean-deep.mjs),apps/mobile-rn루트 순환 의존성(d3ro-voice-monorepo)·NTFS 정션 제거,.NETSttController무호출 중복 라우트(GET /providers,POST /test) 삭제. (2) 번들·코드 스플리팅 & 대형 모듈 분리:@d3ro/i18n을 렌더러/웹 동적 로케일 청크(index.tsx), 무-React 동기 로더(@d3ro/i18n/main), 모바일 지연 엔트리(index.native.tsx, MetroinlineRequires)로 3분할하고, 데스크톱AppLayout.tsx(7페이지·6모달React.lazy), 모바일App.tsx(getComponent), 웹MarkdownPreview(next/dynamic+ 조건부mermaid) 스플리팅으로 데스크톱 초기 부팅 JS를8.79 MB→3.62 MB(-58.8%)로 축소했으며,SettingsModal.tsx(951→349줄, 탭 4종 +settings-model-helpers.ts)와SuggestionService.ts(suggestion-policy-helpers.ts) 순수 모듈 분리를 완료했다. (3) 데스크톱 SQLite · 프로세스 · 오디오 디스크 스트리밍: SQLite WAL PRAGMA(synchronous=NORMAL,mmap_size=64MB,cache_size=-16000), FTS5 trigram 전문 검색, RAGembedding_blob(Float32Array) +WeakMap캐시,PersonalGraphService단일 트랜잭션, WindowskoffiSendInput일원화, 기본 모드mousemove/wheel훅 차단, 백그라운드 팝업 지연 생성,LocalSTTService주 Whisper 모델 유휴/클라우드 언로드, 회의 녹음 PCM 디스크 스트리밍(DiskWavAudioSink, 메모리 상주O(N)→O(1))을 적용했다. (4) Wave 5 계약·보안 & 기능 백로그 해소:@d3ro/core에guards/csv/format/unified-search/admin-roles/ports6개 SSOT 모듈을 추출해 앱 간 중복을 제거하고, 클라우드 LLM·고객지원redactPII/rehydrateText및 녹음 폐기 시secureWipeAudioChunks/secureZeroBuffer를 실배선했으며, 고아 키 253개를 정리한2,500키 × 12개 언어를 데스크톱·웹(LocaleSwitcher)·모바일(온보딩/설정/계정 + AndroidlocaleFilters12개, R8/shrinkResources) 전 표면에 노출했다. 또한site/정적·빌드 CI 게이트(typecheck:site/lint:site), 웹teams실 멤버 수 집계(team-client.ts), 모바일>=600dp태블릿/폴더블 반응형 레이아웃(@d3ro/ui-native/responsive, 10개 화면 +FreeTierBanner90dp슬롯 예약),meeting_memos.revision불변 CAS(마이그레이션 #7420261113000001), 사이드카POST /diarize+ 데스크톱·웹·모바일 화자 배지·필터 바(MTG-08)를 완성했다. (5) TDD v2.0 Phase 2~5 자동화 게이트:check:i18n,check:ds-contract(SegmentControlARIAtablist/tab+@d3ro/ui테스트),test:affected,release:installer:smoke(verify-desktop-installer-smoke.mjs: PE64·blockmap·SHA-512·app-update.yml·ASAR Pickle·Ed25519.sig)를verify:all및.forgejo/workflows/{ci,release}.yml에 연결했다. 상세:REFACTOR_WAVE5_REPORT.md.Previous update: 2026-11-04 — 테스트 위생 재편. 버그헌팅 E2E(red-team cycle) 스펙과 중복·죽은 스펙 11개를 삭제하고, 데스크톱 E2E 를 공용 Electron 픽스처 + 5개 보호 여정으로 통합했다. 루트
tests/e2e와 일회성 Playwright 러너 7개도 제거. 새 게이트npm run test:hygiene(+:test)를 CI 두 파이프라인에 넣어.only/이유 없는 skip/가짜 단정/머신 경로/waitForTimeout/.e2e.test.ts를 막는다. 정본:docs/tdd-red/06-repo-application.md.Previous update: 2026-11-04 — Wave 4 모노레포 위생 점검. 사용되지 않는 chart/recharts·feature gate·내부 선언·Turbo/pnpm 잔여를 제거하고, mobile navigation 타입/로깅, push·quota 계약, embedding quota SSOT, updater dialog i18n, CI web build·migration metadata gate,
audio-purge함수 설정을 정합화했다. Web Push production call site, 12-locale 표면 노출, meeting memo ABA conflict, audio-purge 배포/pg_cron은 완료로 올리지 않고11에 남겼다. 제품 버전은 1.16.1 그대로이며 커밋·푸시·배포·릴리스는 수행하지 않았다. 상세:REFACTOR_WAVE4_REPORT.md.Previous update: 2026-11-04 — Windows v1.16.1 패치 배포. 빠른 한영 자판 교정이 다음 키 입력과 백스페이스 배치 사이에서 경합하지 않도록 140ms 입력 간격 게이트와 유휴 후 현재 영역 일괄 교정을 적용했다. 데스크톱 2,773개 테스트·typecheck·프로덕션 빌드·변경 범위 lint가 GREEN이며, 설치본과 서명된 업데이트 메타데이터를 Forgejo에 게시하고 공개 피드와 설치 파일 HTTP 200을 확인했다. 1.16.1 설치 후 Latin 대조군 GUI와 물리 키보드·Chromium/terminal 검증은 남아 있다.
Previous update: 2026-11-02 — Windows 1.16.0 실GUI에서 회의 파일 선택→전사→로컬 요약 생성을 확인했다. 네이티브 한글 IME는 100% CPU 및
gemma4:e4b콜드 로딩 중 7/7 정확히 통과했다. 한영 자판 교정 대조군은 다음 키가 백스페이스에 섞이는 결함을 재현했고, 소스에서는 140ms 입력 간격 게이트와 유휴 후 현재 영역 일괄 교정으로 수정했다. 데스크톱 2,773개 테스트·빌드는 GREEN이지만 수정본 설치 GUI와 모바일 운영 배포는 남아 있다. 상세 증거: 2026-11-02 verification.Previous update: 2026-11-01 — 기존 녹음 파일을 회의로 가져오기(
MTG-13). 데스크톱은 기존 ffmpeg 파일 전사를 재사용해 타임스탬프 전사와 재생용 WAV를 회의에 저장하고 일반 기록 중복을 피하며, 모바일은 회의 생성 후 기존 durable meeting import queue로 연결한다. 데스크톱 2,768개·모바일 599개·core 572개 테스트와 실제 MP3/M4A 변환 2개가 GREEN이다. 실제 Electron GUI와 인증 모바일 기기 E2E는 남아 있어 두 표면 모두[~]다 (04,06,11GAP-MTG-03).Previous update: 2026-11-01 — 모바일 신규 사용자 온볼드 라우팅 및 Build Tools 37 APK 검증 복구. 인증 목적지를 온볼드 persistence 전에 준비하도록 바꾸고 Fold6에서 fresh auth/signup/invite/small-screen 4/4를 검증했다. 모바일 Jest 87 suites/597 tests·lint·typecheck와 Build Tools 37 APK artifact verifier가 GREEN이다 (
06,02§8,11O-001).Previous update: 2026-10-31 — 데스크톱 테스트 녹색 기준선 복구 및 제안 파이프라인 구조화. 기본
npm test는 오프라인 단위·서비스 테스트 2,764개가 전부 통과하고,test:all은 2,788개 통과·10개 환경 의존 테스트 skip·0 실패다.test:unit·test:service·test:integration·test:eval을 하나의 Vitest 설정으로 분리하고, 제안 첫 후보 준비·stale 검증·후속 후보 게시 책임을 분리했다 (GAP-QA-03,02§3,04입력 인텔리전스).Previous update: 2026-10-31 — v1.15.2 릴리스 +
Ctrl+Alt+Enter제안 수락 불발 근본 해결 + 터미널·xterm.js 한글 씹힘 및 UIA·LLM 캐시 최적화(INPUT-04,INPUT-06,INPUT-19,GAP-INPUT-08,GAP-INPUT-11). (1)Ctrl+Alt+Enter제안 수락 근본 해결: ①classifyKeyStroke가 수정자 VK(0x10..0x12,0x5b..0x5c,0xa0..0xa5)보다 수정자 플래그를 먼저 검사해Ctrl/Alt를 누르는 순간'shortcut'(key=shortcut+C+A)으로 분류되어TerminalKeystrokeTracker버퍼가prefixLen=0으로 초기화되고Enter를 누르기 전에 제안 창이 닫히던 버그 수정, ②ChordStateMachine.keyUp에서Ctrl또는RightAlt를 먼저 놓았을 때command(Ctrl+RightAlt)만 해제하고break/return으로 빠져나가suggestion-accept(Ctrl+Alt+Enter)가_isDown에 영구 고착되어 이후 입력이 auto-repeat으로 무시되던 버그 수정, ③KeyBindingService에UiohookKey.NumpadEnter매핑 및 OSglobalShortcut캡처 25ms 폴백 트리거 추가, ④"생성 중..."또는 첫 후보 스트리밍 중Ctrl+Alt+Enter를 누르면 무시하지 않고 첫 후보 완성(최대 2.5s) 즉시 수락(_waitForFirstCandidate)하도록 개선, ⑤ 터미널(terminalMode/isTerminalApp) 수락 시 클립보드Ctrl+V경합 대신KEYEVENTF_UNICODE직접 주입 및 백그라운드 채우기 루프 즉시 중단. (2) UIA·Ollama 최적화: 비타이핑 키 및 짧은 입력에서 780ms 중복_settleTimer스냅샷을 취소하고,TypoCorrectionService.propose가 이미 검사 완료된 구간(_isRegionChecked)에 대해 336토큰 오타 LLM 호출을 중복 실행해 제안 KV 캐시를 밀어내던 문제를 제거했다. (3) 직전v1.15.1: 터미널WM_IME_CONTROL키다운 호출 제거 및uia_bridge.pyxterm-helper-textarea고속 경로 적용.Previous update: 2026-10-30 — 백로그 26건 일괄 해소 (
GAP-INPUT-03,GAP-LLM-01,GAP-UX-01/02/03/05/06/07,GAP-I18N-01,GAP-REL-11/14/15,GAP-INFRA-01/02/04/06,GAP-OPS-01,GAP-QA-02,GAP-KEY-01/03,GAP-ADS-02,GAP-ID-01/02,GAP-TEAM-02,GAP-SHELL-01,GAP-PUSH-03,GAP-MTG-01,DOC-01) + 입력 누락 검증 인프라 및 서비스 결함 재현(INPUT-04/19,INFRA-20,GAP-INPUT-11). (1) 백로그 26건 해소: CJK 무공백 어절 집계(countWords), 12개 번역 대상 언어 설정(targetLanguage), 12개 로케일 2,716개 키 100% 동기화(sync-i18n-locales.mjs), 데스크톱 strict 타입체크 0 에러(tsconfig.node.json+tsconfig.web.json), Forgejo 릴리스 태그 푸시 순서·SHA 고정(GAP-REL-14), 포터블 워크플로 매니페스트 검증(GAP-REL-11), 네이티브 ABI 스위처(rebuild:app/rebuild:test), Supabase 마이그레이션 정합성 검사기(check:migrations), NAS 배포 런북(nas-deploy-runbook.md), 오프라인 격리 테스트 하네스(GAP-QA-02),KeyBindingService단위 테스트·command전용 액션 핸들러, 데스크톱 광고 보상 쿼터 연동(grantRewardQuota), 회의 종료 후 메모 추가·노트패드 동기화, 이력 SQLite 커서 페이지네이션·인라인 편집·전체 내보내기, 회의 요약[MM:SS]타임스탬프 인용·클릭 시크 연동(데스크톱·웹·모바일),resolveEntitlement정본 통일, 통합 검색(UnifiedSearchService) 취소·세그먼트 검색·페이로드 경량화, 웹 팀 초대 수락(/app/accept-invite), 관리자 고객지원 콘솔(/support), Web Push 서비스워커(sw.js)·iOS APNs 토큰 등록을 완료했다. (2) 입력 누락 검증 인프라(GAP-INPUT-11):typing-race-proof.mjs가 체크아웃을 바꾸지 않고 3개 서비스만 HEADf49acf0와 수정본으로 바꿔 같은 현재 의존성·시험에서 비교했다: HEAD 1/17, 수정본 17/17. 3개 문자열 손상 사례와 13개 스냅샷·메타데이터·조회 병합 계약 실패를 구분했고, 정상 교정 대조군은 양쪽 모두 통과했다.typing-fixture(scan-code·IME·CPU 부하)와typing-runtime(별도 로컬 프로필·실제 제품 번들)을 준비했으며, 실제 GUI·IME·CPU·모델 cold/warm 시험은 아직 미실행이다. 증거:test-results/typing-load/race-proof-2026-10-30T00-50-32-284Z/report.json; 실행 명령은02§3, 검증 경계는04§6과11GAP-INPUT-11.Previous update: 2026-10-29 — v1.14.0 릴리스 + 포커스 전환 직후 첫 단어(
pc/ㅔㅊ/ㅖㅊ/내ㅔㅊ) 한영 자동 전환(INPUT-04,INPUT-19) + 받아쓰기 구어·추임새·중복·동음이의어 후처리 정리 고도화(AI-03,AI-05). (1) 포커스 클릭 직후 첫 단어(pc등) 자동 전환:InputTelemetryService에서 마우스 클릭(_rebaseFocusText)·창 전환 직후 첫 스냅샷(40~680 ms)이 찍히기 전에 사용자가 곧바로 친 첫 단어(ㅔㅊ,ㅖㅊ등)가_textAtFocus기준선에 삼켜져editedSinceFocus = false가 되던 문제를_typedInCurrentFocus·_lastTypedHwnd추적 및 첫 글자 키 입력 시 포그라운드 창 즉시 샘플링으로 해결하고,@d3ro/core/typo-correction에 대소문자 2글자 영문 약어(ㅔㅊ/ㅖㅊ→PC,ㅐㄴ/ㅒㄴ→OS,ㅔㄱ/ㅖㄱ→PR,ㅊㅑ→CI,ㅍㅡ→VM,ㅔㅡ/ㅖㅡ→PM,ㅔㅐ/ㅖㅐ→PO,ㅗㄱ→HR,ㅑㄱ→IR,ㅇㅡ→DM,ㅡㅇ→MD,ㅔㅇ/ㅖㅇ→PD,ㅍㅔ/ㅍㅖ→VP,ㅠㅡ→BM,ㅆㅍ→TV,ㅑㅖ→IP) 및 한글 접두+낱자모 합성어(내ㅔㅊ→내PC,회사ㅔㅊ에서→회사PC에서,한글로ㅔㅊ라고→한글로PC라고,윈도우ㅐㄴ→윈도우OS,새ㅁㅔㅑ를→새API를)를 추가했다. (2) 받아쓰기 구어·추임새·말바꾸기·중복·STT 동음이의어 정리:@d3ro/core/dictation-cleaner(cleanDictatedText)를 신설해VoiceModeService._transcribe직후 지연 0 ms로 단독 추임새(어,음,그 쓸데없는등 — 단 인용된어라든가,아라든가보존), 발화 중 말바꾸기(검색 아니 검색이 아니라 타이핑을→타이핑을), 상투적 중복(쓸데없는 의미없는→불필요한,정리해 가지고 해 주는 거→정리해 주는 기능), 구어 잉여 어미(예를 들자면은→예를 들어,보면은→보면), 문맥상 명백한 STT 동음이의어(스시가 영어로 변경되지→PC가 영어로 변경되지,그 길을 쓸 이유가→그 기능을 쓸 이유가)를 즉시 정리하고,BASE_SYSTEM_PROMPTS.refine(llm-prompts.ts),MeetingModeService.polishTranscript, 신규 내장 프리셋builtin-clean-speech(구어·추임새·중복 정리,CustomInstructionService.ts)가 화자의 원래 어투(반말/해요체/합쇼체)를 바꾸지 않고 추임새·말바꾸기·중복·비문만 자연스럽게 다듬도록 업그레이드했다.Previous update: 2026-10-29 — v1.13.0 릴리스 + 그래프 관계성 기반 극한 개인화(
INPUT-06,INPUT-20) + 한영 형태론·전방 구문 감지 및 단일-시스콜 초고속 인플레이스 수정(INPUT-19,INPUT-22) + 전 표면 디자인파카(designpaca) 순회 감사(SHELL-11,SHELL-15). (1) 그래프 관계성 & 극한 개인화:@d3ro/core/personal-graph및PersonalGraphService에 앱별 연속 단문 메시지 간 세션follows체이닝(_lastIndexedByScope), 엔터 전송 직후 비워진 채팅창 문맥 복원(recentWrites), 증분shares_terms엣지 연결, 조사 차이 무관 어간 연속 이어쓰기(stemContinuationsFrom), 2-홉 그래프 경로 랭킹(rankTwoHopGraphTargets), 개인 그래프·어투 일치 기반 LLM 후보 재정렬(scoreCandidatePersonalization), 어간 바이그램 폴백 및 빈도 가중 개인 n-gram(PersonalNgramModel)을 추가했다(제안 노출 빈도는 그대로 유지). (2) 영어 감지 강화 & 초고속 타이핑 중 무경합 교정:@d3ro/core/typo-correction에 확장 영어 어간(EXTENDED_ENGLISH_STEMS,kubernetes/microsoft등)과 생산적 접두·접미 파생 형태론(matchesInflectedOrDerivedEnglish), 전방 영어 구문 호응(새 ㅠㄷ→to be,새 애 this→to do this,랙 솓→for thevs오늘 새 API를 만들었어보존), 영어 축약형·약어(ㅊ무ㅅ/ㅊ무'ㅅ/ㅊ무ㅜ'ㅅ→can't,츤를→CMS를,눈를→SNS를등)를 추가하고,sendWin32UnicodeReplacement(utils/win32-unicode-input.ts)로(선택 Space) + N × VK_BACK + M × KEYEVENTF_UNICODE를 **단일SendInput시스템콜(< 0.5 ms, 대기0 ms)**로 원자적 주입하며, 타이핑 중 추가 입력된 꼬리 글자를 보존하는 델타 리베이싱(rebaseTypoReplacementPlan)을 구현했다. (3)packages/ui,apps/web,apps/admin,apps/desktop/src/renderer(메인·팝업 6종),site/,apps/mobile-rn6개 표면을 전수 순회해design.md계약 위반을 모두 해소했다 (npm run check:design0건).Previous update: 2026-10-27 — v1.11.0 릴리스 + Araso 방식 한영 자동 변환·터미널/Vim/xterm.js 지원 완성 (
INPUT-19,GAP-INPUT-08).nyttastudio/araso를 분석해@d3ro/core/araso-layout및@d3ro/core/typo-correction을 대폭 업그레이드하고 터미널·Vim·xterm.js(Agent Switchboard)까지 확장했다: 영어·약어·CamelCase+한국어 조사/단어 혼합어 분리(githubdp→github에,PDFvkdlf/ㅖㅇㄹ파일→PDF파일,Reactzjavhsjsxm→React컴포넌트,dhsmfdmsgoogledptj→오늘은google에서,1:1ansdml→1:1문의, 2글자 약어 받침 호응TMdms→TM은vsTMsms→쓰는), 쌍자음 잔여 Shift 정규화(djEJs→어떤,qkRNjTdj→바꿨어), 한글 자판 상태 영어/혼합어 역변환(ㅗ디ㅣㅐ 재깅→hello world,내ㅡㄷ샤ㅡㄷ→sometime,ㅎ샤ㅗㅕㅠ에→github에,ㅠㅕㅎ가→bug가, 알파벳+조사ㄴ가→s가,ㄴ은→s은), 문장 문맥 한영 전환(Stay hungry, stay foolishsms wkqtmdml akfdlek.), URL·경로·이메일 보호(isUrlOrPathRun), 터미널·Vim 명령(:ㅈㅂ→:wq,:ㅂ!→:q!,퍄ㅡ→vim, Vim 노멀 모드 교정 억제),SendInput(KEYEVENTF_UNICODE)직접 유니코드 타이핑(클립보드 무접촉), 단어 경계(25ms)와 어절 내부(650ms) 유휴 분리 및 완성형 음절([가-힣]) 한정commitComposition으로 고속 타이핑 시 글자 삼킴·유령 공백·앞글자 중복을 완전히 해소했다. 통계 수집 동의(inputTelemetryEnabled)가 꺼져 있어도 기본 기능(typoAutoCorrectEnabled: true)으로 즉시 동작한다.Previous update: 2026-09-27 — v1.7.0·v1.8.0·v1.9.0 릴리스 + 기기 간 동기화 재작성 + 운영 DB 정렬. 데스크톱↔모바일·웹 동기화를 outbox·서버시각 커서·삭제 기록(
sync_tombstones)·실시간(ws) 엔진으로 다시 만들고, 이력·사전·회의·메모 태그·명령·템플릿·지식베이스·녹음·공통 설정·기기 등록까지 넓혔다(MEM-13, ACC-08/09, MEM-05). 운영 Supabase가0028에 멈춰 있던 것을 발견해0029–0035를 적용하고 함수 23개를 재배포했다(GAP-OPS-01 — 사용자가 자기 tier를 올릴 수 있던 권한 구멍 포함). 모바일 기기 목록·데이터 내보내기 결함도 고쳤다(GAP-SYNC-03/04). 무서명 로컬 게시 예외(GAP-REL-06) 유지.Previous update: 2026-09-24 — v1.6.0 릴리스. 버전 SSOT를 1.6.0(android/iOS 1060000)으로 올렸다. 다음 문장 제안을 1개씩 순차 생성해 최대 12개·3개씩 페이지로 보여 주고(Ctrl+Alt+↑↓ 이동, ←→ 페이지, Enter 수락, Esc 닫기; 기존 기본 단축키는 revision 5에서 이관), 오버레이를 재설계했다(
INPUT-06/INPUT-07). 개인 문구 코퍼스는 터미널·에디터·코딩 에이전트와 비문장·플레이스홀더를 학습하지 않고 기존 데이터도 같은 규칙으로 정리한다(INPUT-04/INPUT-05). 제안 단축키가 받아쓰기를 켜던 버그, 구버전 사이드카가/uia/focus없이 남던 버그(런타임 최소 버전 1.5.0), Ollama 러너 콘솔 창, 사이드카 이중 기동을 고쳤다. 실시간 자막 창은 끌어서 옮길 수 있고 첫 자막 전까지 준비 안내를 보인다. 무서명 로컬 게시 예외(GAP-REL-06)를 유지한다.Previous update: 2026-09-22 — Gemma/Ollama 폭주 방어 계약을 기록했다. 19:14:12 부팅 워밍업이
keep_alive: 30m으로gemma4:e4b를 19:44:12까지 VRAM 3,226,342,521 bytes / context 4096으로 강제 상주시킨 것이 관측됐으며, 같은 시점 Windows GPU Engine PID 표본에는 Ollama의 활성 compute가 없었다. 즉 당시 상태는 무한 추론이 아니라 강제 residency였다. 19:11:17~19:11:58의 자동 제안 연속 생성은 기존 900 ms·12/min·5 candidates·128 tokens·한 글자 재생성 정책이 허용한 burst였다. 현재 구현 계약은 부팅 warmup 제거,keep_alive: 2m, 제안 600 ms / 최소 5 s 간격 / 기본 6회·hard max 12회 per min / 3 candidates / 64 tokens / 12-char growth / 8 s timeout, 그리고 요청별 취소·상한·종료 정리다. 독립 표적 검증은 6 test files / 69 tests passed / 0 failed, 변경 코드·테스트 ESLint와git diff --check도 exit 0이다. Raw Ollama에서는 cold bounded 요청이 client hard timeout 15.044 s에 취소된 뒤/api/ps가 비었고/api/version은 80 ms에 회복했다. 명시 warmup은 HTTP 200 / 16.639 s, 후속 warm 요청은 bodyoptions.num_predict=1,keep_alive='2m'로 553 ms HTTP 200 /done:true/eval_count:1/done_reason:length였고/api/psexpiry는 약 119.9 s였다. 19:48:59 +09:00에는 새 generate/unload/kill/retry 없이 충분히 지난 뒤 한 번의/api/ps가 HTTP 200 / 45.8 ms /{models:[]}였고/api/version은 HTTP 200 / 7.3 ms /0.32.13이었다. 이는 raw API 수준의 expiry 뒤 unload 확인일 뿐 앱 재시작·GUI·실제 타이핑 증거는 아니므로 상태는[~]로 유지한다 (11GAP-LLM-04, GAP-INPUT-06).Previous update: 2026-09-21 — Input intelligence (입력 레메트리 + 다음 문장 제안) 신규. 데스크톱에 입력 수집기(
InputTelemetryService), UIA 컨텍스트 브리지(사이드카GET /uia/focus), 제안 서비스(SuggestionService), 어렛 커 오버레이, 설정 > 입력 탭(동의·정책·주간 인사이트·개인 문구)을 추가했다. 카탈로그에INPUT-0105 + GAP-LLM-03, §7 에 CONSTRAINT-INPUT-01(키 내용 미저장 — ActivityWatch 정책 채택)을 기록. 설계 근거는 조사 기반이다: 어렛은INPUT-08(전부 데스크톱[~]— 유닛 48건은 GREEN 이지만 실앱 타이핑 검증 전), 백로그에 GAP-INPUT-01GetGUIThreadInfo가 아니라 UIATextPattern.GetSelection(Chromium 은TextPattern2미구현), 타이핑 스트는 키코드 복원이 아니라 UIA 스냅샷 diff(한/일 IME 대응), 디바운스/토큰 한도는 인라인 컴플리션 실측값(Continue 350 / Tabby 250 / twinny 300 ms, 출력 64256 토큰). 의존성:05;koffi3.3.1(포그라운드 창 FFI), 사이드카uiautomation2.0.29 +comtypes. 데스크톱 유닛 총계 1409(+49), Electron ABI 실행에서 신규 실패 0건. 당시의 24.7초/4.9초 지연 설명과keep_alive: 30m·부팅 워밍업 처방은 현재 상태가 아닌 과거 가설/완화 이력이며, 최신 운영 결론은 위 2026-09-22 항목과11GAP-LLM-04를 따른다. 직전: LLM instruction-prompt fix (9c2b4d4): the custom-instruction path inserted the instruction's own wording instead of the processed result and had never worked in any shipped release (v0.1.0-alpha..v1.4.0, introducedfea923d2026-04-05, not a regression).llm-prompts.tsis now the SSOT for prompt resolution and placeholder substitution, shared byVoiceModeService/ChainService/LLM.PROCESS. AI-04/05/06/07 are demoted to[~]on desktop — fixed with unit tests, but not verified in a running app and the four relatedtests/red/*.usecase.test.tscould not execute (better-sqlite3ABI). New: GAP-LLM-01 (no target-language setting), GAP-LLM-02 (this fix unverified); GAP-INFRA-06 amended (the ABI masks verification, not just dev-env switching cost); GAP-I18N-01 amended (popup.error.defaultmissing in 10 locales). Earlier the same day: CAP-16 (desktop key bindings rebuilt on one@d3ro/core/keybindingSSOT — multiple bindings per action, mouse buttons,HOTKEY→KEYBINDINGIPC group), verified on Windows by a manual run, so CAP-16 and CAP-02 are[x]and GAP-KEY-01 is closed. Still open: GAP-KEY-02/03, GAP-QA-02, GAP-I18N-01/02, GAP-INFRA-06, GAP-LLM-01/02, GAP-INPUT-0111§7 holds accepted design constraints (things deliberately kept, not gaps) Scope: entire monorepoD:/workspace/D3ROVoiceat product version1.17.1(release/product-version.json) Purpose: let any agent (or human) answer two questions in under a minute:
- What infrastructure exists? (build, CI, services, APIs, data, packages, deploy)
- How far is each feature developed? (per surface, with file anchors and status)
This is the entry point. Read the index, then open only the sub-document you need. Do not read all files every time.
1. How to use this map
| You need to know… | Open |
|---|---|
| The product, its IA, platforms, identity/data model | 01-system-overview.md |
| Repo layout, build, CI/CD, Docker, deploy, scripts, docs | 02-infrastructure.md |
Shared packages (@d3ro/core, ui, ui-native, i18n, api-client) |
03-shared-packages.md |
| Desktop (Electron) services, IPC, pages, popups, status | 04-desktop-app.md |
| Web (Next.js) routes, components, clients, status | 05-web-app.md |
| Mobile (React Native) screens, features, tabs, status | 06-mobile-app.md |
| .NET cloud API: controllers, services, tables, auth | 07-api-server.md |
| Admin back office (Next.js) routes, guards, status | 08-admin-console.md |
| Supabase migrations, Edge Functions, Cloudflare worker | 09-supabase-backend.md |
| The feature map — every feature, per platform, with status | 10-feature-catalog.md |
| Known gaps / under-developed / backlog | 11-gap-backlog.md |
| Mandatory rules for keeping this map current | 12-update-protocol.md |
An agent starting a task should:
- Read the relevant surface doc (04–09) for infrastructure.
- Read
10-feature-catalog.mdfor the feature's current status and platform coverage. - Read
11-gap-backlog.mdto see if the feature is already tracked as backlog. - After finishing, follow
12-update-protocol.mdbefore the work is considered done.
2. Status legend
Feature rows in 10-feature-catalog.md use this scale:
| Symbol | Meaning |
|---|---|
[x] |
Implemented and verified on this platform (code + tests / evidence exist in-repo). |
[~] |
Implemented but partial, unverified, or blocked on an external/console gate. |
[ ] |
Planned or absent on this platform. |
[!] |
Blocked on something outside the repo (external console, secret, physical device, store review). |
[-] |
Not applicable to this platform (with a one-line reason). |
Status is per platform. A feature can be [x] on desktop, [~] on mobile, [ ] on web.
3. One-paragraph system summary
D3RO Voice is a multi-platform AI voice assistant (transcription, LLM command execution, meeting intelligence, RAG, voice conversation) sold as Free / Pro / Pro+ / Team / Enterprise tiers. It ships as an Electron desktop app (local-first: bundled SoX, faster-whisper sidecar, Ollama, local SQLite), a React Native mobile app (apps/mobile-rn, cloud-first: Supabase auth + Edge Functions + on-device Whisper fallback), a Next.js web console, a Next.js admin back office, and a .NET cloud API (AI proxy + back office backend). The shared backend is Supabase (Postgres + RLS + Auth + Storage + ~27 Deno Edge Functions), deployed to a Synology NAS via Docker with a Cloudflare edge worker and tunnel. Shared code lives in packages/*. Distribution: Windows NSIS + macOS DMG (GitLab/Forgejo feed + electron-updater), Android APK/AAB via Google Play.
4. Reading order for a brand-new agent
AGENTS.md(root) — operating rules + the obligation to update this map.docs/map/01-system-overview.md— the big picture and IA.- The surface doc for your task (04–09).
docs/map/10-feature-catalog.md— find the feature and its status.docs/map/11-gap-backlog.md— check for existing backlog notes.
Deeper design history (not required to start): docs/design/*, docs/phases/*, docs/v2/*, docs/v3/*, memory/*, CHANGELOG.md. The mobile SSOT is docs/v3/MOBILE_APP_COMPLETION_SSOT.md.
5. Maintenance
This map must change whenever a feature is added, removed, changed, or deferred.
See 12-update-protocol.md for the exact checklist and
AGENTS.md for the agent obligation.