d3ro-voice/docs/map/00-index.md
Yun Chan 876e72ea2f
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s
docs(wave7): record peer-swarm bug fixes, metrics, and map sync
2026-11-14 15:41:48 +09:00

33 KiB
Raw Blame History

D3RO Voice — Feature & Infrastructure Map (Index)

Status: ACTIVE Last full audit: 2026-09-13 Last update: 2026-11-14 — Wave 7 6-세션 네이티브 피어 스웜(2a009e4..cc3f746, REFACTOR_WAVE7_REPORT.md) 통합 및 모노레포 전 게이트 검증 완료 (post-v1.17.1). input-core·desktop-shell·mobile-app·cloud-surfaces·verifier·monitor 피어 리뷰(@mention/#seq)를 거쳐 문장부호 직후 무공백 오타 라이브 트리거·서비스 취소/해제·모바일 내구성 큐/화면 가드·Cloudflare/Edge/.NET/Web/Admin 보안 수정을 main에 통합하고 Batch 1(dotnet test 55/55, sidecar 33/33, Edge 273/273, Worker 15/15, Site Bridge 5/5, 정적 게이트) + Batch 2(Vitest 270 files / 3,640 tests, Jest 103 suites / 651 tests, typecheck·lint·build·check:desktop-renderer·test:metrics:write 454 files / 3,738 cases) 통과(운영 v1.17.1 재배포·실기기/GUI [~]/[!]/RED 경계 유지).

Previous 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 HTTP 200, 태그 v1.17.1 canonical/mirror 푸시; Human Release #339 ~91MB 바이너리 첨부만 Cloudflare HTTP 524/ECONNRESET GAP-REL-16 예외), Supabase 운영 DB(db push --remote, 전체 74개 마이그레이션 일치) 및 Edge Functions 24종(--import-map deno.json --use-api) 재배포, 랜딩 사이트(site/ → Cloudflare Pages d3ro, https://d3ro.chanpaca.net/release-identity.json = 1.17.1/6c6875b & assetlinks.json 검증 GREEN), Cloudflare Worker(d3ro-voice-api --keep-vars, Version ID fe6d9532-0052-48f5-b62c-45c86f6aaaa5), NAS Docker 스택(d3ro_voice_api v1.17.1 /health 200, d3ro_voice_admin :3001/d3ro-admin.chanpaca.net/login 200, d3ro_voice_web :3002/app/login·d3ro.chanpaca.net/app/login 200) 반영 완료.

Earlier update: 2026-11-14 — 전 표면 코드 위생 · 최적화 · 버그 헌팅 완결(Wave 6, 66b6b45, WS1–WS4 병렬). (1) Desktop Main & Sidecar (WS1): ipc/renderer-broadcast.ts(safeSendToRenderer/broadcastToAllWindows) 9개 파일 단일화, OnlineLLMService 스트림 abort/401/예외 래핑, UnifiedSearchService FTS5→LIKE 런타임 폴백·집계·정렬·인덱스(started_at/created_at) 보강, rag/chunk-store.ts 캐시 무효화·중복 embedding JSON 제거·손상 Float32 방어, disk-wav-audio-sink.ts uint32 오버플로·헤더 write 실패 fd 정리, AdMediationEngine/AudioCaptureService/LocalLLMService/WindowManager 타이머·팝업 레이스 수정, sidecar/main.py UploadFile.close()·PCM 바이트 경계·/shutdown 스레드 join 완료. (2) Shared Packages & Desktop Renderer (WS2): @d3ro/i18n shared.ts 및 지연 로드/언마운트 레이스 차단(25/25), @d3ro/core PII 플레이스홀더·CSV BOM/CR·타임스탬프·검색 경계값(626/626), @d3ro/ui wave-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 슬롯 전환 시 높이 고착 수정·내구성 큐 조기 폐기 경합 차단·녹음 리스 누수·언마운트 재생/로케일 레이스 해결(Jest 98 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-token fail-closed 강화(Deno 270/270), .NET SttProxyService Base64 상한 + CancellationToken 전파(xUnit 32/32), Cloudflare Worker resolveBackendTargetUrl SSRF·타임아웃·/worker-health 정보 노출 차단(Deno 9/9), 웹 MarkdownPreview DOM XSS/레이스·WebPush 재진입·team-client fail-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 정션 제거, .NET SttController 무호출 중복 라우트(GET /providers, POST /test) 삭제. (2) 번들·코드 스플리팅 & 대형 모듈 분리: @d3ro/i18n을 렌더러/웹 동적 로케일 청크(index.tsx), 무-React 동기 로더(@d3ro/i18n/main), 모바일 지연 엔트리(index.native.tsx, Metro inlineRequires)로 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 전문 검색, RAG embedding_blob(Float32Array) + WeakMap 캐시, PersonalGraphService 단일 트랜잭션, Windows koffi SendInput 일원화, 기본 모드 mousemove/wheel 훅 차단, 백그라운드 팝업 지연 생성, LocalSTTService 주 Whisper 모델 유휴/클라우드 언로드, 회의 녹음 PCM 디스크 스트리밍(DiskWavAudioSink, 메모리 상주 O(N)→O(1))을 적용했다. (4) Wave 5 계약·보안 & 기능 백로그 해소: @d3ro/core에 guards/csv/format/unified-search/admin-roles/ports 6개 SSOT 모듈을 추출해 앱 간 중복을 제거하고, 클라우드 LLM·고객지원 redactPII/rehydrateText 및 녹음 폐기 시 secureWipeAudioChunks/secureZeroBuffer를 실배선했으며, 고아 키 253개를 정리한 2,500키 × 12개 언어를 데스크톱·웹(LocaleSwitcher)·모바일(온보딩/설정/계정 + Android localeFilters 12개, R8/shrinkResources) 전 표면에 노출했다. 또한 site/ 정적·빌드 CI 게이트(typecheck:site/lint:site), 웹 teams 실 멤버 수 집계(team-client.ts), 모바일 >=600dp 태블릿/폴더블 반응형 레이아웃(@d3ro/ui-native/responsive, 10개 화면 + FreeTierBanner 90dp 슬롯 예약), meeting_memos.revision 불변 CAS(마이그레이션 #74 20261113000001), 사이드카 POST /diarize + 데스크톱·웹·모바일 화자 배지·필터 바(MTG-08)를 완성했다. (5) TDD v2.0 Phase 2~5 자동화 게이트: check:i18n, check:ds-contract(SegmentControl ARIA tablist/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, 11 GAP-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, 11 O-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 매핑 및 OS globalShortcut 캡처 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.py xterm-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개 서비스만 HEAD f49acf0와 수정본으로 바꿔 같은 현재 의존성·시험에서 비교했다: 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과 11 GAP-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 the vs 오늘 새 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-rn 6개 표면을 전수 순회해 design.md 계약 위반을 모두 해소했다 (npm run check:design 0건).

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은 vs TMsms→쓰는), 쌍자음 잔여 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 요청은 body options.num_predict=1, keep_alive='2m'로 553 ms HTTP 200 / done:true / eval_count:1 / done_reason:length였고 /api/ps expiry는 약 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·실제 타이핑 증거는 아니므로 상태는 [~]로 유지한다 (11 GAP-LLM-04, GAP-INPUT-06).

Previous update: 2026-09-21 — Input intelligence (입력 레메트리 + 다음 문장 제안) 신규. 데스크톱에 입력 수집기(InputTelemetryService), UIA 컨텍스트 브리지(사이드카 GET /uia/focus), 제안 서비스(SuggestionService), 어렛 커 오버레이, 설정 > 입력 탭(동의·정책·주간 인사이트·개인 문구)을 추가했다. 카탈로그에 INPUT-01INPUT-08(전부 데스크톱 [~] — 유닛 48건은 GREEN 이지만 실앱 타이핑 검증 전), 백로그에 GAP-INPUT-0105 + GAP-LLM-03, §7 에 CONSTRAINT-INPUT-01(키 내용 미저장 — ActivityWatch 정책 채택)을 기록. 설계 근거는 조사 기반이다: 어렛은 GetGUIThreadInfo 가 아니라 UIA TextPattern.GetSelection(Chromium 은 TextPattern2 미구현), 타이핑 스트는 키코드 복원이 아니라 UIA 스냅샷 diff(한/일 IME 대응), 디바운스/토큰 한도는 인라인 컴플리션 실측값(Continue 350 / Tabby 250 / twinny 300 ms, 출력 64256 토큰). 의존성: koffi 3.3.1(포그라운드 창 FFI), 사이드카 uiautomation 2.0.29 + comtypes. 데스크톱 유닛 총계 1409(+49), Electron ABI 실행에서 신규 실패 0건. 당시의 24.7초/4.9초 지연 설명과 keep_alive: 30m·부팅 워밍업 처방은 현재 상태가 아닌 과거 가설/완화 이력이며, 최신 운영 결론은 위 2026-09-22 항목과 11 GAP-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, introduced fea923d 2026-04-05, not a regression). llm-prompts.ts is now the SSOT for prompt resolution and placeholder substitution, shared by VoiceModeService / 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 related tests/red/*.usecase.test.ts could not execute (better-sqlite3 ABI). 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.default missing in 10 locales). Earlier the same day: CAP-16 (desktop key bindings rebuilt on one @d3ro/core/keybinding SSOT — multiple bindings per action, mouse buttons, HOTKEY → KEYBINDING IPC 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-0105; 11 §7 holds accepted design constraints (things deliberately kept, not gaps) Scope: entire monorepo D:/workspace/D3ROVoice at product version 1.17.1 (release/product-version.json) Purpose: let any agent (or human) answer two questions in under a minute:

  1. What infrastructure exists? (build, CI, services, APIs, data, packages, deploy)
  2. 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:

  1. Read the relevant surface doc (04–09) for infrastructure.
  2. Read 10-feature-catalog.md for the feature's current status and platform coverage.
  3. Read 11-gap-backlog.md to see if the feature is already tracked as backlog.
  4. After finishing, follow 12-update-protocol.md before 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

  1. AGENTS.md (root) — operating rules + the obligation to update this map.
  2. docs/map/01-system-overview.md — the big picture and IA.
  3. The surface doc for your task (04–09).
  4. docs/map/10-feature-catalog.md — find the feature and its status.
  5. 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.