yunchan/d3ro-voice
1
0
Fork 0
Code Issues Pull requests Projects Releases 3 Packages Wiki Activity Actions
d3ro-voice/docs/map/05-web-app.md
Yun Chan eedd127ea7
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 1m13s
Details
ci / 워크스페이스 빌드 검증 (push) Has been skipped
Details
ci / 모바일 린트·타입·Jest (push) Failing after 1m4s
Details
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 37s
Details
ci / .NET API 서버 테스트 (push) Successful in 27s
Details
deploy-site / deploy (push) Failing after 20s
Details
refactor(billing): remove Stripe; payments are Payple (web) and Google Play (mobile) 
Stripe is not used. Keeping its checkout, portal and webhook paths meant a
second payment provider, a second return-URL format and dead UI.

- Delete the stripe-checkout, stripe-portal and stripe-webhook functions and
  their config; billing-catalog serves Payple prices only, and the web parser
  rejects a catalog that still mixes in Stripe prices.
- Web: drop the Stripe checkout/portal buttons, provider toggle and return
  notices; billing shows Payple only. Past rows with provider='stripe' are
  still displayed ("Stripe (종료)") with a support contact instead of a portal.
- Desktop: delete the Stripe checkout modal, payment IPC channels, preload
  namespace and their types; "Remove ads with Pro" opens the web billing page
  via license.openBilling. Support/refund copy names Payple.
- billingUrl() loses the Stripe-only success/canceled result option; the
  Deno contract is regenerated.
- Migrations and the DB's accepted provider values are untouched (history).
- Docs and the backlog record the removal (MON-04, EXT-STRIPE-01, GAP-BILL-03).

Verified: typecheck (desktop/web/admin/api-client/mobile), contract:check,
deno check all functions, deno test 80/80, desktop 1478/1480 on the Electron
runtime (2 known environment failures), web and admin builds, release
metadata and mobile boundary self-tests, eslint on changed files.
2026-09-26 20:56:18 +09:00

5 KiB
Raw Blame History

05 — Web App (Next.js) Map

Surface: apps/web Stack: Next.js 15 App Router + React 19 + MUI (via @d3ro/ui) + Supabase Role: cloud console; the reference surface for server-shared data UX

1. Route tree (src/app/)

Root layout: ThemeProvider → I18nProvider → AuthProvider.

Route Type Feature
/ server Redirects: session → /dashboard, else /login (also /login when Supabase unconfigured)
/login client OAuth (Google/GitHub/Apple) + email/password
/accept-invite client Team invite acceptance (?token= → team-accept); stores pending token if logged out
/download client Download center + release history; desktop installers marked "release pending"; client SHA-256 verify tool
/releases server Re-exports /download
/auth/callback route handler OAuth code → session exchange
(app)/record server <MicRecorder/> real-time record/STT
(app)/commands client Custom instruction CRUD/reorder/activate/execute
(app)/dashboard client Stats (sessions, time, words, streak), tier, recent history
(app)/actions server NL command → LLM parse → action (<ActionRunner/>)
(app)/meetings server Meetings list
(app)/meetings/[id] server Meeting detail: audio player, live transcript (Realtime), memos, generated docs
(app)/knowledge server RAG doc list + add + semantic search (search "planned V2-M+1")
(app)/teams server Teams list + create
(app)/teams/[id] server Team detail: members, owner-only invite, team meetings
(app)/chat server Talk AI chat (<ChatPanel/>)
(app)/dictionary client Pronunciation dictionary CRUD
(app)/history client History list: search, favorites, pagination, copy/delete
(app)/history/[id] client History detail: edit title/original/polished, favorite, delete
(app)/billing client Plans + Payple checkout/manage (Stripe removed 2026-09-26; legacy provider='stripe' rows shown read-only)

(app)/layout.tsx is the auth guard + shared <Sidebar/>.

2. Components (src/components/)

Group Components
actions/ action-runner.tsx (LLM parse → action: create_meeting/search_knowledge/create_memo/send_team_invite)
record/ mic-recorder.tsx (MediaRecorder + level analyser → transcribeWebAudio)
dashboard/ meetings-trend-chart.tsx (recharts)
billing/ billing-checkout-options, payple-checkout-button, payple-client, payple-manage-button
meetings/ document-editor, generate-document-button, live-transcript-list (Realtime), markdown-preview (Mermaid), meeting-audio-player (signed URL), memo-form
chat/ chat-panel.tsx
teams/ create-team-form, invite-member-form, activity-feed (team notes + realtime)
knowledge/ add-knowledge-form (text or .txt/.md file, newline-aware chunking, embed-chunks on submit), knowledge-search (semantic via search-knowledge)
layout/ sidebar.tsx (nav, theme selector, logout, i18n)
providers/ auth-provider, i18n-provider, theme-mode-context, theme-provider

3. Clients (src/lib/)

File Purpose
billing-catalog.ts Parse/validate billing catalog (schema v1, pro/pro_plus, Payple KRW prices only)
command-client.ts Custom instruction client (types, error codes, execute)
dashboard-client.ts Dashboard snapshot loader
dictionary-client.ts Dictionary CRUD/pagination/search + serializeDictionary / parseDictionaryFile / importDictionaryFile (JSON/CSV)
history-client.ts History list/get/update/delete, revision-safe
supabase-browser.ts Re-export @d3ro/api-client/supabase-browser
supabase-server.ts Next cookies() wrapper
web-stt-client.ts Web STT via stt-proxy, 25 MB limit, WebSttError codes

4. Tests

Playwright specs in apps/web/e2e/: billing, payple-checkout, dashboard-dictionary-commands, history, web-stt-client, smoke.

5. Web status summary

  • Full App Router console: auth (email + OAuth), record/STT, history (list+detail), commands, actions, meetings (list+detail+docs), knowledge (add+search), teams (list+detail+invite), chat, dictionary, billing, download/releases.
  • Backed by Supabase tables + Edge Functions (stt-proxy, llm-proxy, team-invite, team-accept, payple-checkout, payple-manage, search-knowledge, generate-meeting-document).
  • No literal TODO/FIXME markers; remaining smaller items (see 11-gap-backlog.md WEB-*):
    • Teams member_count is 0 in MVP (separate query needed) — teams/page.tsx.
    • Action runner team-invite uses a manual redirect safety path instead of a live invite (action-runner.tsx).
    • /download shows "artifact not yet published" for the current desktop release.
  • Knowledge file upload, semantic search, dictionary import/export, and the team activity feed are now implemented ([x] in the catalog).