d3ro-voice/docs/map/00-index.md

23 KiB
Raw Permalink Blame History

D3RO Voice — Feature & Infrastructure Map (Index)

Status: ACTIVE Last full audit: 2026-09-13 Last update: 2026-11-01 — 미완료 작업 복구·1.16.0 배포 준비. 회의 import 계정 전환 경합을 재현·수정했고, 입력 A/B는 이전 2/17 → 현재 17/17이다. 공개 엔진 1.10.0에서 빠진 CPU/UIA 수정을 1.16.0 최소 엔진과 선행 게시로 연결한다. 모바일 최신 .3 APK의 첫 실행 실패와 .2의 과거 4/4 PASS를 구분했다. 상세 증거: completion report.

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.14.0 (release/product-version.json, released 2026-10-29) 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.