diff --git a/README.md b/README.md index d087abb..280bb38 100644 --- a/README.md +++ b/README.md @@ -1,154 +1,134 @@ # Echo -**내가 익히고 싶은 영어를, 직접 말하고 다시 들어보는 연습.** +**내가 익히고 싶은 영어로, 듣고 말하고 피드백받는 연습.** -Echo는 사용자가 준비한 대본과 문장으로 영어를 연습하는 개인 프로젝트입니다. 상대방의 대사를 듣고 내 역할을 녹음한 뒤, 원문과 전사문을 비교하고 피드백을 확인합니다. 연습 중 끊기거나 저장에 실패해도 이미 끝낸 작업을 반복하지 않도록 만드는 데 집중했습니다. +## [→ Echo 서비스 바로가기](https://echo-navy-iota.vercel.app) -**[서비스 바로가기](https://echo-navy-iota.vercel.app)** · [녹음·분석 코드](./src/views/recording/services/hooks/useRoleplayRecordingController.ts) · [설계·검증 문서](./docs/portfolio/verification.md) +Google 로그인으로 시작합니다. 음성 생성·분석은 이용 권한이 부여된 계정에서 사용할 수 있습니다. -Google 로그인을 사용합니다. 음성 생성과 분석은 이용 권한이 부여된 계정에서 사용할 수 있습니다. 배포 주소는 2026-10-08 로그인 화면 응답을 확인했습니다. +| 연습 | 사용 방법 | 현재 범위 | +| --------- | ------------------------------------------------------- | --------------------------------------------------------- | +| 롤플레잉 | 대본 준비 → 역할 선택 → 상대방 듣기·내 대사 녹음 → 분석 | 저장·이어하기·분석 결과 조회 연결 | +| 문단 암기 | 영어 문단 준비 → 읽기·암기 설정 → 녹음 | 편집·연습 UI 제공. 녹음 저장·분석의 전체 연결은 후속 과제 | +| 어법 연습 | 문장·어법 분석 → 검토·저장 → 예문 생성 → 회상·시험 | 노트·예문·연습·기록 연결. 실제 AI·운영 DB 검증은 별도 | -
-화면 미리보기 — 연습 모드를 고르는 홈 - -![Echo 홈 화면](./docs/design/echo/practice-hub-20261004/integrated-home.png) - -2026-10-04 실제 컴포넌트 통합 화면의 검증 기록입니다. - -
- -**프로젝트에서 맡은 일** - -사용자 흐름과 화면 구성을 정하고, 컴포넌트·상태의 책임을 나눴습니다. Next.js에서 인증·조회·저장 경계를 설계하고, 브라우저 녹음부터 파일 저장, 세션 완료, 비동기 분석까지 연결했습니다. 특히 정상 동작 이후에 남는 문제인 중복 요청, 응답 유실, 화면 이탈, 부분 실패를 검토하고 수정했습니다. - -**현재 제공하는 흐름** - -| 기능 | 흐름 | 구현 범위 | -| --------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------- | -| 롤플레잉 | 대본 작성 → 역할 선택 → 상대방 음성 → 내 대사 녹음 → 문장별 저장 → 분석 | 저장·이어하기·완료·분석 결과 조회 연결 | -| 문단 암기 | 문단 작성·확정 → 연습 설정 → 녹음 | 편집·연습 UI 구현. 녹음 저장부터 분석까지의 전체 연결은 후속 과제 | -| 어법 연습 | 문장·어법 설명 → 분석 검토·편집 → 저장 → 암기·시험 | 입력·저장·목록·암기·시험·기록 연결. 운영 DB·실제 AI 검증은 별도 | - -**실제 아키텍처** +## 구조와 설계 선택 ![Echo 녹음·분석 아키텍처](./docs/portfolio/architecture.svg) -웹 앱은 Vercel의 Next.js에서 실행하고, 인증·관계형 데이터·녹음 파일은 Supabase를 사용합니다. 녹음 분석은 Postgres의 `analysis_jobs`와 `pg_cron`, Edge Function으로 분리했습니다. 화면의 요청이 끝나도 분석 작업과 결과가 DB에 남습니다. - -도표는 배포 기준 코드 `f5bef12`의 녹음·분석 경로를 Archify로 작성했습니다. 상대방 음성 생성은 Next.js의 Server Action에서 OpenAI TTS를 호출하는 별도 경로입니다. [인터랙티브 아키텍처 HTML](./docs/portfolio/architecture.html)은 내려받아 브라우저에서 열 수 있으며, 노드에서 근거 코드로 이동할 수 있습니다. - -```text -src/ - app/ 라우트·레이아웃, 인증 진입점, API Route Handler - views/ 화면 조합, 화면별 상태·이벤트 조정, ViewModel 변환 - widgets/ 앱 셸·내비게이션과 여러 화면에서 쓰는 조합 - features/ 녹음·저장 등 사용자 기능과 요청 흐름 - entities/ 도메인 모델·규칙, repository 계약과 구현 - shared/ 공용 UI, AudioCapture, 외부 클라이언트·로깅 -supabase/ - migrations/ 소유권·저장 순서·완료 조건·작업 선점을 보장하는 SQL - functions/ 음성 전사·평가·결과 저장 worker -``` +기존 Archify 구조도입니다. 웹 요청은 **Next.js**, 사용자 데이터와 녹음은 **Supabase**, 오래 걸리는 분석은 **Edge Function**이 맡습니다. [구조도 HTML](./docs/portfolio/architecture.html) · [설계·검증 기록](./docs/portfolio/verification.md) -FSD 계층 안에서도 파일의 길이보다 변경 이유를 기준으로 책임을 나눴습니다. 녹음 장치의 수명은 `AudioCapture`, 녹음 상태는 reducer, 대화 진행은 세션 store, 저장은 서버 서비스가 담당합니다. 서버 전용 코드는 `server-only`로 구분하고 주요 녹음·분석 경계는 ESLint로 검사합니다. +| 고민 | 선택한 구조 | 해결 방식 | +| --------------------------------------- | -------------------------------- | ----------------------------------------------------------------------------------- | +| 화면 조작과 서버 권한 검사가 뒤섞임 | Server / Client Component 분리 | 서버는 인증·조회, 클라이언트는 편집·녹음·재생을 담당 | +| 녹음·대화·저장을 한 화면에서 모두 관리 | FSD 계층 + 책임별 상태 | 장치는 `AudioCapture`, 녹음 전이는 reducer, 대화 진행은 Zustand, 저장은 서버 서비스 | +| 파일은 올라갔는데 DB 확정 응답이 유실됨 | Storage + 멱등 저장 RPC | 같은 녹음 ID·해시로 재시도하고 DB에서 저장 순서·중복을 검사 | +| 전사·평가가 웹 요청보다 오래 걸림 | Postgres 작업 큐 + cron + worker | 완료 시 작업을 남기고, 문장별 결과를 저장하며 분할 처리 | -**기술을 선택하고 적용한 이유** +- **주요 기술:** Next.js App Router · React · TypeScript / Zustand / Supabase / OpenAI. +- **UI·검증:** Tailwind CSS · CVA · Radix UI / Jest · Testing Library · Storybook. +- **선택의 비용:** 파일과 DB는 하나의 트랜잭션이 아니며, 분석 시작에는 cron 대기가 생깁니다. 재시도·작업 선점을 별도로 설계했습니다. -| 선택 | 해결하려던 문제와 적용 방식 | 함께 고려한 점 | -| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | -| Next.js App Router · React · TypeScript | 인증된 조회와 브라우저 상호작용을 한 앱 안에서 나누기 위해 사용. Server Component는 조회·조합, Client Component는 편집·녹음을 담당 | 저장 진입점에서도 인증을 다시 확인. 서버 조회 결과와 로컬 편집 상태의 수명을 구분 | -| Server Action + Route Handler | 자료 저장·세션 생성은 Server Action, 녹음 파일은 `FormData`를 받는 `/api/roleplay-recordings`로 처리 | 화면이 DB·Storage 세부 API를 직접 조정하지 않도록 서버에 저장 책임을 둠 | -| Zustand + React reducer | 편집기의 행별 구독과 여러 UI가 공유하는 연습 상태는 Zustand, 녹음 자체의 상태 전이는 reducer로 관리 | 모든 값을 전역화하지 않고 메뉴 등 일시적인 상태는 해당 컴포넌트에 유지 | -| Supabase Auth · Postgres · Storage | 로그인·소유권·관계형 학습 기록·오디오 저장을 구성하고, 저장 순서와 완료 조건을 DB에서도 검사 | 파일 업로드와 DB 트랜잭션은 원자적이지 않으므로 재시도·응답 유실을 별도로 처리 | -| Postgres 작업 큐 + pg_cron · Edge Functions | 음성 전사와 평가를 웹 요청 수명에서 분리하고 기존 DB로 작업 상태·재처리를 관리 | 작업 선점·오래된 실행 차단이 필요하며 cron 주기에 따른 시작 대기가 있음 | -| Tailwind CSS · CVA · Radix UI | 역할 기반 토큰과 variant로 화면 간 일관성을 유지하고, 다이얼로그·메뉴의 공통 동작을 재사용 | 스타일 변경 시 한글 입력·키보드·포커스·기존 props 계약을 함께 확인 | -| Jest · Testing Library · Storybook/Vitest | 순수 상태 전이와 실제 컴포넌트 상호작용을 나눠 검증 | 외부 API mock 테스트와 실제 마이크·DB·유료 분석 확인은 구분 | +### FSD: 화면에서 공용 기반으로 내려가는 의존성 -**핵심 흐름 1 — 녹음 시작과 저장** +![Echo의 FSD 계층](./docs/portfolio/fsd.svg) -![녹음 시작·저장 시퀀스](./docs/portfolio/recording.svg) +FSD(Feature-Sliced Design)를 바탕으로 **역할이 같은 코드를 모으고, 상위 계층이 하위 계층을 사용**하도록 구성했습니다. Next.js의 라우팅은 `app`, 화면 조합은 `views`로 구분한 프로젝트 변형입니다. -1. 연습 시작 시 대본·역할·음성·평가 모드를 세션 스냅샷으로 저장합니다. 이후 원본 대본이 바뀌어도 진행 중인 연습의 기준은 유지됩니다. -2. 내 차례가 되면 `getUserMedia`로 마이크 권한을 요청하고, `MediaRecorder.isTypeSupported`로 지원 형식을 골라 녹음합니다. 중지 시 최종 데이터 이벤트를 기다려 Blob을 만들고 마이크 트랙을 해제합니다. -3. 저장 요청은 Blob과 `recordingId`를 전송합니다. 서버는 인증·Origin·세션 소유권·대상 문장·파일 크기·MIME을 확인한 뒤 Storage에 업로드합니다. -4. `commit_roleplay_recording` RPC가 세션 행을 잠그고, 다음에 저장할 학습자 문장과 업로드된 오브젝트를 확인합니다. 녹음 확정과 진행 위치 변경은 같은 DB 트랜잭션에서 처리합니다. -5. 성공 응답 뒤에만 클라이언트의 Blob을 해제하고 다음 문장으로 이동합니다. 실패하면 오디오를 유지해 다시 듣거나 저장을 재시도할 수 있습니다. +| 계층 | 맡은 일 | 예시 | +| ---------- | ---------------------------- | ----------------------------------------- | +| `app` | 라우트·레이아웃·서버 진입점 | `page.tsx`, 인증 callback, 녹음 API | +| `views` | 화면 조합·화면별 이벤트 진행 | 대본 편집기, 녹음 화면, 분석 결과 | +| `widgets` | 여러 화면에서 쓰는 UI 조합 | 앱 셸, 내비게이션 | +| `features` | 사용자가 수행하는 기능 | TXT 불러오기, 녹음 저장, 음성 요청 | +| `entities` | 도메인 모델·규칙·저장 계약 | 대본, 세션, 녹음, repository | +| `shared` | 공용 UI·장치·외부 연동 기반 | 버튼, `AudioCapture`, Supabase 클라이언트 | -[녹음 장치 제어](./src/shared/lib/audio/AudioCapture.ts) · [화면의 녹음·저장 조정](./src/views/recording/services/hooks/useRecordingTurn.ts) · [서버 저장](./src/features/recording-storage/services/server/saveLearnerRecording.ts) · [저장·완료 RPC](./supabase/migrations/20260910120000_roleplay_recording_completion.sql) · [시퀀스 HTML](./docs/portfolio/recording.html) +- **읽는 단위:** 계층 → 기능/도메인 → `ui`·`models`·`services`. 예: `features/recording-storage/services`. +- **의존 규칙:** 아래 계층을 사용할 수 있으며, 모든 계층을 차례로 거칠 필요는 없습니다. 그림은 계층 규칙이지 전체 import 그래프는 아닙니다. +- **실행 위치는 별도 구분:** 같은 계층에도 서버·클라이언트 코드가 있습니다. `server-only`와 주요 녹음·분석 경계의 ESLint 규칙으로 잘못된 연결을 막습니다. +- **서버 밖 분석:** `supabase/migrations`에 DB 제약·작업 선점, `supabase/functions`에 분석 worker를 둡니다. -**핵심 흐름 2 — 세션 완료와 분석** +[탐색 가능한 FSD 구조도](./docs/portfolio/fsd.html) -![세션 완료·비동기 분석 시퀀스](./docs/portfolio/analysis.svg) +## 대표 이벤트 흐름 -1. 마지막 녹음과 필요한 상대방 발화를 마친 뒤 완료를 요청합니다. `finish_roleplay_recording`은 필수 녹음이 모두 있는지 확인하고, 세션 완료와 분석 작업 생성을 같은 트랜잭션에서 처리합니다. -2. `pg_cron`이 분석 함수를 호출하면 `FOR UPDATE SKIP LOCKED`로 작업 하나를 선점합니다. 선점할 때마다 새 `claim_token`을 발급합니다. -3. worker는 아직 처리하지 않은 문장을 최대 3개씩 처리합니다. 오디오를 내려받고 재사용 가능한 결과가 있는지 확인한 뒤, 필요한 경우 음성 전사 → 텍스트 평가 → 문장별 결과 저장을 실행합니다. -4. 한 묶음의 모든 처리가 끝난 뒤, 남은 문장이 있으면 작업을 다시 대기 상태로 돌리고 모두 처리했으면 완료합니다. 일부 실패가 발생하면 성공한 문장의 결과를 남긴 채 작업을 실패 상태로 전환합니다. -5. 결과 화면은 저장된 작업 상태와 결과를 조회합니다. 조회 자체가 새 분석을 시작하지 않으며, 진행 중인 분석은 주기적으로 다시 조회합니다. +아래 시퀀스는 현재 코드의 정상 경로를 중심으로 정리했습니다. 역할 분리·상대방 발화·백그라운드 분석은 **롤플레잉 기준**이며, 문단 암기의 미연결 경로와 구분합니다. Archify HTML은 내려받아 브라우저에서 열 수 있습니다. 도표 설명은 한국어, 뷰어 기본 메뉴는 영어입니다. -[배치 처리](./supabase/functions/process-analysis-job/processClaimedJob.ts) · [선점 토큰 검증](./supabase/migrations/20260910090000_analysis_claim_fencing.sql) · [읽기 전용 결과 조회](./src/views/analysis-result/services/server/loadSessionAnalysis.ts) · [시퀀스 HTML](./docs/portfolio/analysis.html) +### 1. 영어 대본·문단 저장 -도표는 정상 경로를 중심으로 표시했습니다. 실제 처리는 작업 없음, 이용 권한 없음, 공급자 오류, 결과 재사용과 부분 실패 경로를 함께 다룹니다. exact 모드의 원문·전사문 차이는 코드로 계산하고, context 모드는 표현 차이보다 의미를 기준으로 평가하도록 구분했습니다. +![영어 자료 저장 시퀀스](./docs/portfolio/material-save.svg) -**구현하면서 가장 많이 고민한 부분** +- **흐름:** 편집 초안 → 인증·스키마 검증 → repository 저장 → 목록 갱신. +- **보존:** 저장 오류는 화면에 알리고 입력을 유지합니다. 자료 수정과 연습 세션 스냅샷은 분리합니다. +- **Next.js 활용:** Server Action이 저장을 담당하고, `revalidatePath`로 자료 목록·마이페이지를 갱신합니다. 편집 화면은 성공 후 `router.push`·`router.refresh`로 이동·갱신합니다. -**저장 버튼을 다시 누르면 같은 녹음이 두 번 생기지 않을까?** +[대본 저장 코드](./src/views/role-play/services/action/saveRolePlayMaterial.ts) · [문단 저장 코드](./src/views/memorization/services/action/saveMemorizationMaterial.ts) · [시퀀스 HTML](./docs/portfolio/material-save.html) -버튼 비활성화만으로는 서버 저장 후 응답이 유실되는 상황을 해결할 수 없었습니다. 같은 Blob에는 `WeakMap`으로 같은 녹음 ID를 부여하고, 서버에서는 ID·문장·오디오 SHA-256이 포함된 오브젝트 경로를 비교합니다. 이미 확정된 동일 요청은 성공으로 반환하고, 같은 ID에 다른 내용이 오면 충돌로 처리합니다. +### 2. TXT 파일 → AI 검증 → 파트너·내 역할 분리 -Storage 업로드와 DB 저장은 별개의 작업입니다. DB 확정에서 오류를 받았다고 파일을 바로 지우면, 실제 저장은 끝났지만 응답만 유실된 녹음까지 삭제할 수 있습니다. 그래서 오류 응답만으로 파일을 삭제하지 않고 같은 요청으로 재시도할 수 있게 했습니다. 이 선택에는 확정되지 않은 오브젝트가 남을 수 있다는 비용이 있으며, 파일 정리는 별도의 책임으로 다룹니다. +![TXT 검증·역할 분리 시퀀스](./docs/portfolio/txt-import.svg) -**녹음 저장은 성공했는데 세션 완료가 실패하면 다시 녹음해야 할까?** +- **흐름:** TXT 업로드 → 2인 대화 판별 → `partner`·`me` 분류 → 서버 재검증 → 편집기에 반영. +- **검증:** 확장자·빈 입력은 코드로 검사합니다. AI가 대화와 화자를 판별한 뒤, 응답 스키마·화자 수·대사의 화자 참조를 다시 검사합니다. 결과는 사용자가 검토·수정하고 저장합니다. +- **Next.js 활용:** File을 Server Action으로 전달하고, `server-only` 파서에서 OpenAI를 호출합니다. 클라이언트는 `useTransition`으로 대기·중복 동작을 관리합니다. -문장 저장과 세션 완료를 별도 상태로 관리했습니다. 마지막 문장이 저장됐다면 완료 요청이 실패해도 재녹음을 요구하지 않고 `완료 확인`에서 완료 처리만 재시도합니다. 화면에 돌아왔을 때는 서버에 확정된 문장 중 첫 미저장 위치를 찾아 이어갑니다. 뒤로가기로 캐시된 화면에 복귀하는 경우에도 서버 상태를 다시 읽습니다. +[TXT 파서](./src/features/roleplay-txt-import/services/server/parseRoleplayTxtImport.ts) · [AI 응답 재검증](./src/features/roleplay-txt-import/services/server/normalizeRoleplayTxtImportOutput.ts) · [시퀀스 HTML](./docs/portfolio/txt-import.html) -**마이크 권한 창과 음성 재생이 화면보다 늦게 끝나면 어떻게 할까?** +### 3. 음성 준비와 실제 대화 -마이크 권한 요청은 화면을 떠난 뒤에 끝날 수 있습니다. 녹음 시작마다 token을 두고 취소·언마운트 시 무효화해, 늦게 완료된 시작 요청의 장치를 정리합니다. 상대방 음성도 재생 요청 ID를 비교해 이전 응답과 종료 이벤트가 다음 차례를 바꾸지 않도록 했습니다. 사용자 입력에서 오디오 재생을 준비하고, 자동 재생이 거부되면 직접 재생할 수 있는 상태를 제공합니다. +![목소리 확인·세션 생성 시퀀스](./docs/portfolio/session-preparation.svg) -**분석 하나가 실패했을 때 다른 문장의 저장은 어떻게 될까?** +![대화 차례별 음성·녹음 시퀀스](./docs/portfolio/conversation.svg) -`Promise.all`은 하나가 실패해도 나머지 작업을 취소하지 않습니다. 작업을 먼저 실패 처리하면 아직 실행 중인 문장들이 뒤늦게 저장을 시도할 수 있어, `Promise.allSettled`로 해당 묶음이 모두 끝난 뒤 작업 상태를 전환했습니다. worker가 작업을 다시 가져간 경우에는 `claim_token`이 달라지므로 이전 worker의 결과 저장과 완료 요청을 DB에서 거부합니다. +- **시작 전:** 목소리·속도를 골라 샘플을 미리 듣습니다. 시작하면 대본·내 역할·음성 설정·평가 모드를 세션 스냅샷으로 저장합니다. +- **대화 중:** 상대방 차례마다 저장된 대사로 TTS 생성 → 재생 종료 → 내 대사 녹음 → 저장 후 다음 차례로 진행합니다. 마지막 상대방 대사가 있으면 그 발화까지 마친 뒤 완료합니다. +- **생성 시점:** 현재 구현은 **시작 전 샘플 생성 + 차례별 대사 생성**입니다. 전체 대화 음성을 미리 생성·영속 저장하는 방식은 아닙니다. +- **Next.js 활용:** Server Action에서 인증·세션·이용량을 확인하고 TTS를 호출합니다. 세션 경로로 `router.push`하며, Client Component가 브라우저 오디오·마이크 수명을 관리합니다. -실패한 분석을 재시도할 때는 사용자·세션·원문 스냅샷·오디오 해시·평가 모드·모델·분석 코드 버전이 같은 결과만 재사용합니다. 다만 공급자 호출 성공 후 DB 저장 전에 응답이 유실되면 재과금 가능성은 남습니다. +[세션 생성](./src/views/role-play/services/action/createRolePlaySession.ts) · [음성 생성](./src/features/roleplay-sessions/services/actions/speakRolePlayPartnerLine.ts) · [대화 진행](./src/views/recording/services/hooks/useRoleplayRecordingController.ts) · [준비 시퀀스](./docs/portfolio/session-preparation.html) · [대화 시퀀스](./docs/portfolio/conversation.html) -**프론트엔드에서 지킨 기준** +### 4. 내 녹음 저장과 이어하기 -- **구독은 실제로 바뀌는 단위에 맞췄습니다.** 대사 목록은 ID 배열, 행은 자신의 데이터, 개수 표시는 개수만 구독합니다. 이벤트에서만 필요한 값은 `getState()`로 읽습니다. Profiler와 실제 렌더 호출 측정에서 대사 수정 시 다른 행 0회, 제목 변경 시 대사 행 0회를 확인했습니다. [측정 기록](./docs/design/echo/practice-hub-20261004/review-followup.md) -- **홈과 연습 화면의 목적을 나눴습니다.** 홈에서는 연습 모드 선택에 집중하고 기록·관리는 마이페이지로 옮겼습니다. 직접 진입이나 새로고침으로 방문 이력이 없어도 돌아갈 상위 화면을 정했습니다. -- **사용자가 들인 입력을 보호했습니다.** 미저장 입력·녹음이 있으면 이탈을 확인하고, 저장 중에는 중복 동작과 이탈을 제어합니다. 미저장 오디오는 메모리에만 있어 브라우저 종료 후 복원되지는 않습니다. -- **공용 UI는 따로 확인한 뒤 연결했습니다.** props·이벤트 정의 → 독립 Storybook·유닛 검증 → 실제 화면 통합 순서로 작업했습니다. 한글 조합·키보드·포커스 복귀·오류 상태·모션 감소와 390px 화면을 확인했습니다. [디자인 시스템](./docs/design-system.md) +![녹음 시작·저장 시퀀스](./docs/portfolio/recording.svg) -어법 화면은 제목·설명·레이아웃을 서버에서 조합하고, 편집·회상 입력은 클라이언트 영역에 둡니다. 저장·취소 뒤의 이동은 `app` 라우트가 담당합니다. 회상 연습은 세션 상태와 문항별 입력의 수명을 나눠 문항 전환 시 답안을 유지하고, 다른 세션을 열 때 이전 입력이 섞이지 않도록 했습니다. +- **흐름:** 마이크 녹음 → 최종 Blob → 파일 업로드 → DB에서 녹음 확정·진행 위치 갱신. +- **실패 복구:** 성공 응답 뒤에만 Blob을 해제합니다. 저장 실패는 같은 녹음을 재시도하고, 완료 요청만 실패했다면 재녹음 없이 완료만 재시도합니다. +- **Next.js 활용:** `/api/roleplay-recordings` Route Handler가 `FormData`를 받아 인증·Origin·소유권·파일을 검사합니다. 뒤로가기로 복귀하면 `router.refresh`로 서버의 저장 위치를 다시 읽습니다. -**검증과 남은 범위** +[녹음 제어](./src/shared/lib/audio/AudioCapture.ts) · [서버 저장](./src/features/recording-storage/services/server/saveLearnerRecording.ts) · [시퀀스 HTML](./docs/portfolio/recording.html) -테스트는 파일 수보다 실패 이후의 동작을 확인하는 데 사용했습니다. 녹음 권한 요청 중 취소, 저장 중복·실패, 완료 재시도, 마지막 상대방 발화, 오디오 해제, 부분 분석 실패와 오래된 worker의 쓰기 차단이 주요 검증 대상입니다. +### 5. 대화 분석 백그라운드 처리 -[홈·편집기 통합 검증](./docs/design/echo/practice-hub-20261004/review-followup.md)에는 Jest 120 suites·406 tests, Storybook 73 files·290 tests 및 타입·린트·빌드 통과가 기록돼 있습니다. 해당 작업 시점의 결과이며, 이번 README 변경에서 제품 테스트를 새로 실행한 것은 아닙니다. +![세션 완료·비동기 분석 시퀀스](./docs/portfolio/analysis.svg) -- 실제 계정·마이크·유료 분석의 전체 E2E와 브라우저별 장치 호환성은 별도 확인 범위입니다. -- 문단 암기의 저장·완료·분석 전체 연결은 미완료입니다. -- 어법 기능은 [별도 구현·검증 기록](./docs/design/echo/grammar-practice-20261005/implementation-20261006.md)에서 다룹니다. 운영 DB·실제 AI 검증과 로컬 검증을 구분합니다. +- **등록:** 필수 녹음 확인 → 세션 완료와 `analysis_jobs` 생성을 한 DB 트랜잭션으로 처리. +- **실행:** cron → worker 선점 → 최대 3문장씩 오디오 전사·평가 → 문장별 저장 → 잔여 작업 재대기 또는 완료. +- **복구:** 성공한 문장은 남기고, 같은 입력·모델·분석 버전의 결과를 재사용합니다. `claim_token`으로 이전 worker의 늦은 쓰기를 거부합니다. +- **Next.js 활용:** 결과는 서버에서 소유권 확인 후 읽고, 진행 중에는 클라이언트가 갱신합니다. 재시도 Action은 경로를 무효화하며, 긴 AI 처리는 Next.js 요청 수명 밖에서 실행합니다. 결과 조회만으로 새 분석을 만들지 않습니다. -**로컬 실행** +[worker 처리](./supabase/functions/process-analysis-job/processClaimedJob.ts) · [결과 조회](./src/views/analysis-result/services/server/loadSessionAnalysis.ts) · [시퀀스 HTML](./docs/portfolio/analysis.html) -Node.js 22와 npm을 사용합니다. +## 실행과 검증 ```sh npm ci cp .env.example .env.local +npm run dev # localhost:3000 ``` -개발용 Supabase의 URL·publishable key를 설정합니다. 서버 저장·음성·분석에는 service-role key·OpenAI key, 해당 DB 마이그레이션과 이용 권한이 필요합니다. Google OAuth의 callback도 실행 주소에 맞춥니다. 자세한 설정은 [Supabase 운영 가이드](./docs/operations/analysis-processor-supabase.md)와 [AI 이용 권한·비용 제어](./docs/operations/ai-cost-controls.md)를 참고합니다. +- **환경:** Node.js 22, Supabase URL·키, Google OAuth callback 설정. 서버 음성·분석에는 OpenAI key·DB 마이그레이션·이용 권한이 필요합니다. +- **검사:** `npm test -- --runInBand` · `npm run typecheck` · `npm run lint` · `npm run build`. +- **UI 확인:** `npm run storybook`. 상호작용 검사는 `npx playwright install chromium` 후 `npm run test:storybook`. +- **검증 범위:** 로컬 테스트와 실제 계정·마이크·유료 AI E2E는 구분합니다. [검증 기록](./docs/portfolio/verification.md) · [Supabase 설정](./docs/operations/analysis-processor-supabase.md) · [AI 권한·비용](./docs/operations/ai-cost-controls.md). -```sh -npm run dev # 앱: localhost:3000 -npm run storybook # 컴포넌트: localhost:6006 -npm test -- --runInBand -npm run typecheck -npm run lint -npm run build -``` +## 어려웠던 문제와 해결 + +| 문제 | 원인 | 분석 | 해결 | +| ---------------------------------- | ------------------------------------------------ | ----------------------------------------- | --------------------------------------------------------------------------- | +| 재시도할 때 녹음 중복 | DB 저장 후 응답만 유실될 수 있음 | 버튼 잠금만으로 서버 중복을 막을 수 없음 | 같은 Blob에 같은 ID, 서버에서 ID·문장·SHA-256 비교 후 동일 요청은 성공 반환 | +| 저장 성공 후 완료 실패 | 문장 저장과 세션 완료가 별도 요청 | 재녹음하면 이미 확정한 데이터와 충돌 | 저장·완료 상태 분리, 완료 처리만 재시도 | +| 이탈 후 마이크·이전 음성 응답 도착 | 장치 권한·재생 요청이 화면보다 늦게 완료 | 오래된 콜백이 다음 차례를 바꿀 수 있음 | 요청 token 무효화, 마이크 트랙·오디오 URL 해제, 재생 차단 시 수동 재시도 | +| 일부 분석 실패 뒤 늦은 결과 저장 | `Promise.all`의 실패가 다른 실행을 취소하지 않음 | job을 먼저 닫으면 남은 문장이 뒤늦게 저장 | `allSettled` 후 상태 전환, `claim_token`으로 오래된 worker 쓰기 차단 | -Storybook 상호작용 테스트는 `npx playwright install chromium` 후 `npm run test:storybook`으로 실행합니다. 로컬 DB 검증은 Docker와 로컬 Supabase가 필요하며 [녹음 검증 가이드](./docs/operations/recording-refactor-verification.md)에 실행 방법과 확인 범위를 기록했습니다. +남은 한계: 미저장 녹음은 브라우저 종료 시 복원되지 않습니다. 미확정 업로드 파일의 정리와, AI 호출 성공 후 결과 저장 전 장애로 인한 재과금 가능성은 별도 관리 대상입니다. diff --git a/docs/portfolio/conversation.html b/docs/portfolio/conversation.html new file mode 100644 index 0000000..bd11242 --- /dev/null +++ b/docs/portfolio/conversation.html @@ -0,0 +1,14933 @@ + + + + + + + 대화 중 · 상대방 듣기와 내 대사 녹음 Diagram + + + + + + + + +
+ +
+
+
+

대화 중 · 상대방 듣기와 내 대사 녹음

+
+
+ + + + + + + +
+ + 대화 중 · 상대방 듣기와 내 대사 녹음 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 상대방 차례 · 세션 / 문장 ID 전달 + + + + + + + + 저장된 대사 확인 · 이용량 검사 + + + + + + + + 해당 차례의 상대방 음성 생성 + + + + + + + + 오디오 반환 + + + + + + + + audioBase64 반환 + + + + + + + + 음성 재생 → 내 차례 녹음 + + + + + + + + Blob 반환 → 문장 저장 후 다음 차례 + + + + + + + + + 준비·연습 화면 · 역할 · 목소리 · 차례 · Sequence participant + + + + 준비·연습 화면 + 역할 · 목소리 · 차례 + + + + Server Action · 세션 생성 · TTS · Sequence participant + + + + Server Action + 세션 생성 · TTS + + + + Postgres · 대본 스냅샷 · 이용량 · Sequence participant + + + + Postgres + 대본 스냅샷 · 이용량 + + + + OpenAI TTS · 샘플 / 상대방 대사 · Sequence participant + + + + OpenAI TTS + 샘플 / 상대방 대사 + + + + 브라우저 오디오 · 재생 · 마이크 · Sequence participant + + + + 브라우저 오디오 + 재생 · 마이크 + + + + + Legend + + + request + + + + return + + + + security + + + + default message + + + +

+ + + + + + + + + +
+ + +
+ +
+ +
+ + + + diff --git a/docs/portfolio/conversation.json b/docs/portfolio/conversation.json new file mode 100644 index 0000000..a9baef0 --- /dev/null +++ b/docs/portfolio/conversation.json @@ -0,0 +1,103 @@ +{ + "schema_version": 1, + "diagram_type": "sequence", + "meta": { + "title": "대화 중 · 상대방 듣기와 내 대사 녹음", + "quality_profile": "showcase", + "column_fit": "spread", + "viewBox": [ + 1080, + 500 + ] + }, + "participants": [ + { + "id": "screen", + "type": "frontend", + "label": "준비·연습 화면", + "sublabel": "역할 · 목소리 · 차례" + }, + { + "id": "server", + "type": "backend", + "label": "Server Action", + "sublabel": "세션 생성 · TTS" + }, + { + "id": "db", + "type": "database", + "label": "Postgres", + "sublabel": "대본 스냅샷 · 이용량" + }, + { + "id": "tts", + "type": "external", + "label": "OpenAI TTS", + "sublabel": "샘플 / 상대방 대사" + }, + { + "id": "audio", + "type": "frontend", + "label": "브라우저 오디오", + "sublabel": "재생 · 마이크" + } + ], + "messages": [ + { + "id": "conversation-7", + "from": "screen", + "to": "server", + "y": 160, + "label": "상대방 차례 · 세션 / 문장 ID 전달", + "variant": "emphasis" + }, + { + "id": "conversation-8", + "from": "server", + "to": "db", + "y": 196, + "label": "저장된 대사 확인 · 이용량 검사", + "variant": "security" + }, + { + "id": "conversation-9", + "from": "server", + "to": "tts", + "y": 232, + "label": "해당 차례의 상대방 음성 생성", + "variant": "default" + }, + { + "id": "conversation-10", + "from": "tts", + "to": "server", + "y": 268, + "label": "오디오 반환", + "variant": "return" + }, + { + "id": "conversation-11", + "from": "server", + "to": "screen", + "y": 304, + "label": "audioBase64 반환", + "variant": "return" + }, + { + "id": "conversation-12", + "from": "screen", + "to": "audio", + "y": 340, + "label": "음성 재생 → 내 차례 녹음", + "variant": "default" + }, + { + "id": "conversation-13", + "from": "audio", + "to": "screen", + "y": 376, + "label": "Blob 반환 → 문장 저장 후 다음 차례", + "variant": "return" + } + ] +} diff --git a/docs/portfolio/conversation.svg b/docs/portfolio/conversation.svg new file mode 100644 index 0000000..09e621a --- /dev/null +++ b/docs/portfolio/conversation.svg @@ -0,0 +1,600 @@ + + + 대화 중 · 상대방 듣기와 내 대사 녹음 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 상대방 차례 · 세션 / 문장 ID 전달 + + + + + + + + 저장된 대사 확인 · 이용량 검사 + + + + + + + + 해당 차례의 상대방 음성 생성 + + + + + + + + 오디오 반환 + + + + + + + + audioBase64 반환 + + + + + + + + 음성 재생 → 내 차례 녹음 + + + + + + + + Blob 반환 → 문장 저장 후 다음 차례 + + + + + + + + + 준비·연습 화면 · 역할 · 목소리 · 차례 · Sequence participant + + + + 준비·연습 화면 + 역할 · 목소리 · 차례 + + + + Server Action · 세션 생성 · TTS · Sequence participant + + + + Server Action + 세션 생성 · TTS + + + + Postgres · 대본 스냅샷 · 이용량 · Sequence participant + + + + Postgres + 대본 스냅샷 · 이용량 + + + + OpenAI TTS · 샘플 / 상대방 대사 · Sequence participant + + + + OpenAI TTS + 샘플 / 상대방 대사 + + + + 브라우저 오디오 · 재생 · 마이크 · Sequence participant + + + + 브라우저 오디오 + 재생 · 마이크 + + + + + Legend + + + request + + + + return + + + + security + + + + default message + + + \ No newline at end of file diff --git a/docs/portfolio/fsd.html b/docs/portfolio/fsd.html new file mode 100644 index 0000000..4aa4cfd --- /dev/null +++ b/docs/portfolio/fsd.html @@ -0,0 +1,14889 @@ + + + + + + + Echo의 FSD 계층 · 상위에서 하위로 의존 Diagram + + + + + + + + +
+ +
+
+
+

Echo의 FSD 계층 · 상위에서 하위로 의존

+
+
+ + + + + + + +
+ + Echo의 FSD 계층 · 상위에서 하위로 의존 + An architecture diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + app · 라우트와 진입점 · page / layout / Route Handler · Architecture component + + + + app · 라우트와 진입점 + page / layout / Route Handler + + + + views · 화면별 조합과 진행 · 화면 상태 / 이벤트 조정 / ViewModel · Architecture component + + + + views · 화면별 조합과 진행 + 화면 상태 / 이벤트 조정 / ViewModel + + + + widgets · 여러 화면의 공통 조합 · 앱 셸 / 내비게이션 · Architecture component + + + + widgets · 여러 화면의 공통 조합 + 앱 셸 / 내비게이션 + + + + features · 사용자 기능 · TXT 불러오기 / 녹음 저장 / 음성 요청 · Architecture component + + + + features · 사용자 기능 + TXT 불러오기 / 녹음 저장 / 음성 요청 + + + + entities · 도메인 계약과 규칙 · 세션 / 녹음 / repository · Architecture component + + + + entities · 도메인 계약과 규칙 + 세션 / 녹음 / repository + + + + shared · 공용 기반 · UI / AudioCapture / 외부 클라이언트 · Architecture component + + + + shared · 공용 기반 + UI / AudioCapture / 외부 클라이언트 + + + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + + + + + +

+ + + + + + + + + +
+ + +
+ +
+ +
+ + + + diff --git a/docs/portfolio/fsd.json b/docs/portfolio/fsd.json new file mode 100644 index 0000000..bc96984 --- /dev/null +++ b/docs/portfolio/fsd.json @@ -0,0 +1,150 @@ +{ + "schema_version": 1, + "diagram_type": "architecture", + "meta": { + "title": "Echo의 FSD 계층 · 상위에서 하위로 의존", + "quality_profile": "showcase", + "viewBox": [ + 1080, + 540 + ] + }, + "components": [ + { + "id": "app", + "type": "frontend", + "label": "app · 라우트와 진입점", + "sublabel": "page / layout / Route Handler", + "pos": [ + 290, + 20 + ], + "size": [ + 500, + 54 + ] + }, + { + "id": "views", + "type": "frontend", + "label": "views · 화면별 조합과 진행", + "sublabel": "화면 상태 / 이벤트 조정 / ViewModel", + "pos": [ + 290, + 105 + ], + "size": [ + 500, + 54 + ] + }, + { + "id": "widgets", + "type": "frontend", + "label": "widgets · 여러 화면의 공통 조합", + "sublabel": "앱 셸 / 내비게이션", + "pos": [ + 290, + 190 + ], + "size": [ + 500, + 54 + ] + }, + { + "id": "features", + "type": "backend", + "label": "features · 사용자 기능", + "sublabel": "TXT 불러오기 / 녹음 저장 / 음성 요청", + "pos": [ + 290, + 275 + ], + "size": [ + 500, + 54 + ] + }, + { + "id": "entities", + "type": "backend", + "label": "entities · 도메인 계약과 규칙", + "sublabel": "세션 / 녹음 / repository", + "pos": [ + 290, + 360 + ], + "size": [ + 500, + 54 + ] + }, + { + "id": "shared", + "type": "backend", + "label": "shared · 공용 기반", + "sublabel": "UI / AudioCapture / 외부 클라이언트", + "pos": [ + 290, + 445 + ], + "size": [ + 500, + 54 + ] + } + ], + "connections": [ + { + "id": "depends-app", + "from": "app", + "to": "views", + "label": "하위 계층 사용", + "labelAt": [ + 540, + 89.5 + ] + }, + { + "id": "depends-views", + "from": "views", + "to": "widgets", + "label": "하위 계층 사용", + "labelAt": [ + 540, + 174.5 + ] + }, + { + "id": "depends-widgets", + "from": "widgets", + "to": "features", + "label": "하위 계층 사용", + "labelAt": [ + 540, + 259.5 + ] + }, + { + "id": "depends-features", + "from": "features", + "to": "entities", + "label": "하위 계층 사용", + "labelAt": [ + 540, + 344.5 + ] + }, + { + "id": "depends-entities", + "from": "entities", + "to": "shared", + "label": "하위 계층 사용", + "labelAt": [ + 540, + 429.5 + ] + } + ] +} diff --git a/docs/portfolio/fsd.svg b/docs/portfolio/fsd.svg new file mode 100644 index 0000000..b3dda8b --- /dev/null +++ b/docs/portfolio/fsd.svg @@ -0,0 +1,556 @@ + + + Echo의 FSD 계층 · 상위에서 하위로 의존 + An architecture diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + app · 라우트와 진입점 · page / layout / Route Handler · Architecture component + + + + app · 라우트와 진입점 + page / layout / Route Handler + + + + views · 화면별 조합과 진행 · 화면 상태 / 이벤트 조정 / ViewModel · Architecture component + + + + views · 화면별 조합과 진행 + 화면 상태 / 이벤트 조정 / ViewModel + + + + widgets · 여러 화면의 공통 조합 · 앱 셸 / 내비게이션 · Architecture component + + + + widgets · 여러 화면의 공통 조합 + 앱 셸 / 내비게이션 + + + + features · 사용자 기능 · TXT 불러오기 / 녹음 저장 / 음성 요청 · Architecture component + + + + features · 사용자 기능 + TXT 불러오기 / 녹음 저장 / 음성 요청 + + + + entities · 도메인 계약과 규칙 · 세션 / 녹음 / repository · Architecture component + + + + entities · 도메인 계약과 규칙 + 세션 / 녹음 / repository + + + + shared · 공용 기반 · UI / AudioCapture / 외부 클라이언트 · Architecture component + + + + shared · 공용 기반 + UI / AudioCapture / 외부 클라이언트 + + + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + 하위 계층 사용 + + + + + + + + \ No newline at end of file diff --git a/docs/portfolio/material-save.html b/docs/portfolio/material-save.html new file mode 100644 index 0000000..4ca178c --- /dev/null +++ b/docs/portfolio/material-save.html @@ -0,0 +1,14906 @@ + + + + + + + 영어 대본·문단 저장 Diagram + + + + + + + + +
+ +
+
+
+

영어 대본·문단 저장

+
+
+ + + + + + + +
+ + 영어 대본·문단 저장 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 저장 · 초안 + 수정 대상 ID + + + + + + + + 인증·스키마 검증 후 저장 요청 + + + + + + + + 새 자료 생성 / 기존 자료 갱신 + + + + + + + + 저장 결과 + + + + + + + + 저장된 자료 ID + + + + + + + + 경로 갱신 후 성공 ID / 오류 반환 + + revalidatePath: 자료 목록 · 마이페이지 + + + + + + + + 편집 화면 · 로컬 초안 · Sequence participant + + + + 편집 화면 + 로컬 초안 + + + + Server Action · 인증 · 입력 검증 · Sequence participant + + + + Server Action + 인증 · 입력 검증 + + + + Repository · 도메인 저장 계약 · Sequence participant + + + + Repository + 도메인 저장 계약 + + + + Postgres · 사용자별 학습 자료 · Sequence participant + + + + Postgres + 사용자별 학습 자료 + + + + + Legend + + + request + + + + return + + + + default message + + + +

+ + + + + + + + + +
+ + +
+ +
+ +
+ + + + diff --git a/docs/portfolio/material-save.json b/docs/portfolio/material-save.json new file mode 100644 index 0000000..d7f6114 --- /dev/null +++ b/docs/portfolio/material-save.json @@ -0,0 +1,90 @@ +{ + "schema_version": 1, + "diagram_type": "sequence", + "meta": { + "title": "영어 대본·문단 저장", + "quality_profile": "showcase", + "column_fit": "spread", + "viewBox": [ + 1080, + 480 + ] + }, + "participants": [ + { + "id": "editor", + "type": "frontend", + "label": "편집 화면", + "sublabel": "로컬 초안" + }, + { + "id": "action", + "type": "backend", + "label": "Server Action", + "sublabel": "인증 · 입력 검증" + }, + { + "id": "repo", + "type": "backend", + "label": "Repository", + "sublabel": "도메인 저장 계약" + }, + { + "id": "db", + "type": "database", + "label": "Postgres", + "sublabel": "사용자별 학습 자료" + } + ], + "messages": [ + { + "id": "material-save-1", + "from": "editor", + "to": "action", + "y": 160, + "label": "저장 · 초안 + 수정 대상 ID", + "variant": "emphasis" + }, + { + "id": "material-save-3", + "from": "action", + "to": "repo", + "y": 196, + "label": "인증·스키마 검증 후 저장 요청", + "variant": "default" + }, + { + "id": "material-save-4", + "from": "repo", + "to": "db", + "y": 232, + "label": "새 자료 생성 / 기존 자료 갱신", + "variant": "default" + }, + { + "id": "material-save-5", + "from": "db", + "to": "repo", + "y": 268, + "label": "저장 결과", + "variant": "return" + }, + { + "id": "material-save-6", + "from": "repo", + "to": "action", + "y": 304, + "label": "저장된 자료 ID", + "variant": "return" + }, + { + "id": "material-save-8", + "from": "action", + "to": "editor", + "y": 340, + "label": "경로 갱신 후 성공 ID / 오류 반환", + "variant": "return", + "note": "revalidatePath: 자료 목록 · 마이페이지" + } + ] +} diff --git a/docs/portfolio/material-save.svg b/docs/portfolio/material-save.svg new file mode 100644 index 0000000..81c8420 --- /dev/null +++ b/docs/portfolio/material-save.svg @@ -0,0 +1,573 @@ + + + 영어 대본·문단 저장 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 저장 · 초안 + 수정 대상 ID + + + + + + + + 인증·스키마 검증 후 저장 요청 + + + + + + + + 새 자료 생성 / 기존 자료 갱신 + + + + + + + + 저장 결과 + + + + + + + + 저장된 자료 ID + + + + + + + + 경로 갱신 후 성공 ID / 오류 반환 + + revalidatePath: 자료 목록 · 마이페이지 + + + + + + + + 편집 화면 · 로컬 초안 · Sequence participant + + + + 편집 화면 + 로컬 초안 + + + + Server Action · 인증 · 입력 검증 · Sequence participant + + + + Server Action + 인증 · 입력 검증 + + + + Repository · 도메인 저장 계약 · Sequence participant + + + + Repository + 도메인 저장 계약 + + + + Postgres · 사용자별 학습 자료 · Sequence participant + + + + Postgres + 사용자별 학습 자료 + + + + + Legend + + + request + + + + return + + + + default message + + + \ No newline at end of file diff --git a/docs/portfolio/readme-diagrams.validation.json b/docs/portfolio/readme-diagrams.validation.json new file mode 100644 index 0000000..816046a --- /dev/null +++ b/docs/portfolio/readme-diagrams.validation.json @@ -0,0 +1,750 @@ +{ + "description": "README diagram delivery and browser verification; application behavior tests not run", + "artifacts": [ + { + "name": "fsd", + "diagram_type": "architecture", + "output": "fsd.html", + "specification_sha256": "e4d96fe4538906611c2962df8ddb083322ac196a9d09eb95dce2b9033d170494", + "artifact_sha256": "071267fa786532bc3d5a3efe800a9a843f91fee07ab348479988bed86e5a64c3", + "svg_sha256": "75c817fb87c751e41dee222841bb7e876217dbf537b390054faa54cf2f3252fb", + "validation": { + "checksPassed": 9, + "checkCount": 9, + "compositionProfile": "showcase", + "compositionStatus": "pass", + "errors": 0, + "warnings": 0 + }, + "browser_evidence": "passed", + "viewport_measurements": { + "status": "pass", + "viewports": [ + { + "width": 1440, + "height": 900, + "theme": "light", + "innerWidth": 1440, + "innerHeight": 900, + "scrollWidth": 1440, + "scrollHeight": 900, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1376, + "diagramWidth": 1346, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 9, + "minimumProjectedNodeText": "page / layout / Route Handler", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": false, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1600, + "height": 1000, + "theme": "light", + "innerWidth": 1600, + "innerHeight": 1000, + "scrollWidth": 1600, + "scrollHeight": 1000, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1536, + "diagramWidth": 1506, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 9, + "minimumProjectedNodeText": "page / layout / Route Handler", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": false, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1920, + "height": 1080, + "theme": "light", + "innerWidth": 1920, + "innerHeight": 1080, + "scrollWidth": 1920, + "scrollHeight": 1080, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1750, + "diagramWidth": 1720, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 9, + "minimumProjectedNodeText": "page / layout / Route Handler", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": false, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 2048, + "height": 1320, + "theme": "light", + "innerWidth": 2048, + "innerHeight": 1320, + "scrollWidth": 2048, + "scrollHeight": 1320, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1920, + "diagramWidth": 1870, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 9, + "minimumProjectedNodeText": "page / layout / Route Handler", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": false, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 41, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + } + ] + }, + "visual_review": "passed", + "visual_review_scope": "2048x1320 light / 1440x900 dark screenshots inspected; default READ view; labels, arrows and fit checked", + "correction_rounds": 1 + }, + { + "name": "material-save", + "diagram_type": "sequence", + "output": "material-save.html", + "specification_sha256": "c12ae6beccf4763037bdb599948570dc34d5007a0c844e179a810df792dbbbdc", + "artifact_sha256": "b4d5dd5ab312af98b039da10d25313d7450a276e205b62c005b2724c540e8567", + "svg_sha256": "32c9115e8f0e06113ba043d663ee93a20832438a972523f94ced3262e43d3a2b", + "validation": { + "checksPassed": 9, + "checkCount": 9, + "compositionProfile": "showcase", + "compositionStatus": "pass", + "errors": 0, + "warnings": 0 + }, + "browser_evidence": "passed", + "viewport_measurements": { + "status": "pass", + "viewports": [ + { + "width": 1440, + "height": 900, + "theme": "light", + "innerWidth": 1440, + "innerHeight": 900, + "scrollWidth": 1440, + "scrollHeight": 900, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1376, + "diagramWidth": 1346, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "로컬 초안", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1600, + "height": 1000, + "theme": "light", + "innerWidth": 1600, + "innerHeight": 1000, + "scrollWidth": 1600, + "scrollHeight": 1000, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1536, + "diagramWidth": 1506, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "로컬 초안", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1920, + "height": 1080, + "theme": "light", + "innerWidth": 1920, + "innerHeight": 1080, + "scrollWidth": 1920, + "scrollHeight": 1080, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1856, + "diagramWidth": 1826, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "로컬 초안", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 2048, + "height": 1320, + "theme": "light", + "innerWidth": 2048, + "innerHeight": 1320, + "scrollWidth": 2048, + "scrollHeight": 1320, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1920, + "diagramWidth": 1870, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "로컬 초안", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 41, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + } + ] + }, + "visual_review": "passed", + "visual_review_scope": "2048x1320 light / 1440x900 dark screenshots inspected; default READ view; labels, arrows and fit checked", + "correction_rounds": 0 + }, + { + "name": "txt-import", + "diagram_type": "sequence", + "output": "txt-import.html", + "specification_sha256": "572a91cc4ac67c33ec95d23fc5ff11827563b03b4134bfa1a69077311987868b", + "artifact_sha256": "46545da2b30725b900dca3c91aa1cc35fbfc8f8b16835d24748b348244c4e034", + "svg_sha256": "5671efa9a1ad02a2e7d71cf9c531f03c5be65fcf890ef6940733182ad677f777", + "validation": { + "checksPassed": 9, + "checkCount": 9, + "compositionProfile": "showcase", + "compositionStatus": "pass", + "errors": 0, + "warnings": 0 + }, + "browser_evidence": "passed", + "viewport_measurements": { + "status": "pass", + "viewports": [ + { + "width": 1440, + "height": 900, + "theme": "light", + "innerWidth": 1440, + "innerHeight": 900, + "scrollWidth": 1440, + "scrollHeight": 900, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1376, + "diagramWidth": 1346, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "TXT · 한 파일", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1600, + "height": 1000, + "theme": "light", + "innerWidth": 1600, + "innerHeight": 1000, + "scrollWidth": 1600, + "scrollHeight": 1000, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1536, + "diagramWidth": 1506, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "TXT · 한 파일", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1920, + "height": 1080, + "theme": "light", + "innerWidth": 1920, + "innerHeight": 1080, + "scrollWidth": 1920, + "scrollHeight": 1080, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1856, + "diagramWidth": 1826, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "TXT · 한 파일", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 2048, + "height": 1320, + "theme": "light", + "innerWidth": 2048, + "innerHeight": 1320, + "scrollWidth": 2048, + "scrollHeight": 1320, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1920, + "diagramWidth": 1870, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "TXT · 한 파일", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 41, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + } + ] + }, + "visual_review": "passed", + "visual_review_scope": "2048x1320 light / 1440x900 dark screenshots inspected; default READ view; labels, arrows and fit checked", + "correction_rounds": 0 + }, + { + "name": "session-preparation", + "diagram_type": "sequence", + "output": "session-preparation.html", + "specification_sha256": "623772e39826b506c0b196b1067ecfc8a904e1b5fa21ce679f6e29e936d58621", + "artifact_sha256": "5adcd378f5335aab932327bde8e0e7354f78eea0bb9eeb24f727b6e8dbf6a9a2", + "svg_sha256": "69617ea546f5b7f8b8ed1e90828f2963e7f0cbbc25c6583feb081e053af132f5", + "validation": { + "checksPassed": 9, + "checkCount": 9, + "compositionProfile": "showcase", + "compositionStatus": "pass", + "errors": 0, + "warnings": 0 + }, + "browser_evidence": "passed", + "viewport_measurements": { + "status": "pass", + "viewports": [ + { + "width": 1440, + "height": 900, + "theme": "light", + "innerWidth": 1440, + "innerHeight": 900, + "scrollWidth": 1440, + "scrollHeight": 900, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1376, + "diagramWidth": 1346, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1600, + "height": 1000, + "theme": "light", + "innerWidth": 1600, + "innerHeight": 1000, + "scrollWidth": 1600, + "scrollHeight": 1000, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1536, + "diagramWidth": 1506, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1920, + "height": 1080, + "theme": "light", + "innerWidth": 1920, + "innerHeight": 1080, + "scrollWidth": 1920, + "scrollHeight": 1080, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1856, + "diagramWidth": 1826, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 2048, + "height": 1320, + "theme": "light", + "innerWidth": 2048, + "innerHeight": 1320, + "scrollWidth": 2048, + "scrollHeight": 1320, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1920, + "diagramWidth": 1870, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 41, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + } + ] + }, + "visual_review": "passed", + "visual_review_scope": "2048x1320 light / 1440x900 dark screenshots inspected; default READ view; labels, arrows and fit checked", + "correction_rounds": 0 + }, + { + "name": "conversation", + "diagram_type": "sequence", + "output": "conversation.html", + "specification_sha256": "e1afd79e6110fd0c800c7947c831bcb2b7890003add5baa7c990289931fde5f6", + "artifact_sha256": "39a7b6501fb65ea089a19f8dd65a226a17c587dd8d87f8f9ff8b79e5071d13c9", + "svg_sha256": "53f770756756be8d65654047e57687ee4f25a08a5d500572e3dfc273ed11bbed", + "validation": { + "checksPassed": 9, + "checkCount": 9, + "compositionProfile": "showcase", + "compositionStatus": "pass", + "errors": 0, + "warnings": 0 + }, + "browser_evidence": "passed", + "viewport_measurements": { + "status": "pass", + "viewports": [ + { + "width": 1440, + "height": 900, + "theme": "light", + "innerWidth": 1440, + "innerHeight": 900, + "scrollWidth": 1440, + "scrollHeight": 900, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1376, + "diagramWidth": 1346, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1600, + "height": 1000, + "theme": "light", + "innerWidth": 1600, + "innerHeight": 1000, + "scrollWidth": 1600, + "scrollHeight": 1000, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1536, + "diagramWidth": 1506, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 1920, + "height": 1080, + "theme": "light", + "innerWidth": 1920, + "innerHeight": 1080, + "scrollWidth": 1920, + "scrollHeight": 1080, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1856, + "diagramWidth": 1826, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 51, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + }, + { + "width": 2048, + "height": 1320, + "theme": "light", + "innerWidth": 2048, + "innerHeight": 1320, + "scrollWidth": 2048, + "scrollHeight": 1320, + "overflowX": false, + "overflowY": false, + "ok": true, + "readerWidth": 1920, + "diagramWidth": 1870, + "viewBoxWidth": 1080, + "minimumProjectedNodeTextPx": 7, + "minimumProjectedNodeText": "역할 · 목소리 · 차례", + "minimumProjectedNodeTextDetail": "context", + "minimumRequiredNodeTextPx": 6, + "readabilityOk": true, + "hasLegend": true, + "hasNavigationDock": true, + "legendDockIntersectionArea": 0, + "dockStageIntersectionArea": 0, + "dockStageGap": 10.21875, + "requiredDockStageGap": 10, + "viewerChromeStageOk": true, + "viewerChromeReserve": 41, + "viewerChromeActive": true, + "viewerChromeOk": true, + "resolvedTheme": "light" + } + ] + }, + "visual_review": "passed", + "visual_review_scope": "2048x1320 light / 1440x900 dark screenshots inspected; default READ view; labels, arrows and fit checked", + "correction_rounds": 2 + } + ] +} diff --git a/docs/portfolio/session-preparation.html b/docs/portfolio/session-preparation.html new file mode 100644 index 0000000..9cbb608 --- /dev/null +++ b/docs/portfolio/session-preparation.html @@ -0,0 +1,14914 @@ + + + + + + + 세션 시작 전 · 목소리 확인과 대본 확정 Diagram + + + + + + + + +
+ +
+
+
+

세션 시작 전 · 목소리 확인과 대본 확정

+
+
+ + + + + + + +
+ + 세션 시작 전 · 목소리 확인과 대본 확정 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 시작 전 · 목소리 샘플 요청 + + + + + + + + 인증·이용량 확인 후 샘플 생성 + + + + + + + + 샘플 음성 반환 + + + + + + + + 샘플 미리듣기 + + + + + + + + 연습 시작 · 역할 / 목소리 / 평가 모드 + + + + + + + + 소유 대본 조회 · 세션 스냅샷 저장 + + + + + + + + sessionId 반환 · 연습 경로 이동 + + + + + + + + + 준비·연습 화면 · 역할 · 목소리 · 차례 · Sequence participant + + + + 준비·연습 화면 + 역할 · 목소리 · 차례 + + + + Server Action · 세션 생성 · TTS · Sequence participant + + + + Server Action + 세션 생성 · TTS + + + + Postgres · 대본 스냅샷 · 이용량 · Sequence participant + + + + Postgres + 대본 스냅샷 · 이용량 + + + + OpenAI TTS · 샘플 / 상대방 대사 · Sequence participant + + + + OpenAI TTS + 샘플 / 상대방 대사 + + + + + Legend + + + request + + + + return + + + + default message + + + +

+ + + + + + + + + +
+ + +
+ +
+ +
+ + + + diff --git a/docs/portfolio/session-preparation.json b/docs/portfolio/session-preparation.json new file mode 100644 index 0000000..3a59d29 --- /dev/null +++ b/docs/portfolio/session-preparation.json @@ -0,0 +1,97 @@ +{ + "schema_version": 1, + "diagram_type": "sequence", + "meta": { + "title": "세션 시작 전 · 목소리 확인과 대본 확정", + "quality_profile": "showcase", + "column_fit": "spread", + "viewBox": [ + 1080, + 500 + ] + }, + "participants": [ + { + "id": "screen", + "type": "frontend", + "label": "준비·연습 화면", + "sublabel": "역할 · 목소리 · 차례" + }, + { + "id": "server", + "type": "backend", + "label": "Server Action", + "sublabel": "세션 생성 · TTS" + }, + { + "id": "db", + "type": "database", + "label": "Postgres", + "sublabel": "대본 스냅샷 · 이용량" + }, + { + "id": "tts", + "type": "external", + "label": "OpenAI TTS", + "sublabel": "샘플 / 상대방 대사" + } + ], + "messages": [ + { + "id": "conversation-1", + "from": "screen", + "to": "server", + "y": 160, + "label": "시작 전 · 목소리 샘플 요청", + "variant": "default" + }, + { + "id": "conversation-2", + "from": "server", + "to": "tts", + "y": 196, + "label": "인증·이용량 확인 후 샘플 생성", + "variant": "default" + }, + { + "id": "conversation-3", + "from": "tts", + "to": "server", + "y": 232, + "label": "샘플 음성 반환", + "variant": "return" + }, + { + "id": "preview-response", + "from": "server", + "to": "screen", + "y": 268, + "label": "샘플 미리듣기", + "variant": "return" + }, + { + "id": "conversation-4", + "from": "screen", + "to": "server", + "y": 304, + "label": "연습 시작 · 역할 / 목소리 / 평가 모드", + "variant": "emphasis" + }, + { + "id": "conversation-5", + "from": "server", + "to": "db", + "y": 340, + "label": "소유 대본 조회 · 세션 스냅샷 저장", + "variant": "default" + }, + { + "id": "conversation-6", + "from": "server", + "to": "screen", + "y": 376, + "label": "sessionId 반환 · 연습 경로 이동", + "variant": "return" + } + ] +} diff --git a/docs/portfolio/session-preparation.svg b/docs/portfolio/session-preparation.svg new file mode 100644 index 0000000..4b85778 --- /dev/null +++ b/docs/portfolio/session-preparation.svg @@ -0,0 +1,581 @@ + + + 세션 시작 전 · 목소리 확인과 대본 확정 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 시작 전 · 목소리 샘플 요청 + + + + + + + + 인증·이용량 확인 후 샘플 생성 + + + + + + + + 샘플 음성 반환 + + + + + + + + 샘플 미리듣기 + + + + + + + + 연습 시작 · 역할 / 목소리 / 평가 모드 + + + + + + + + 소유 대본 조회 · 세션 스냅샷 저장 + + + + + + + + sessionId 반환 · 연습 경로 이동 + + + + + + + + + 준비·연습 화면 · 역할 · 목소리 · 차례 · Sequence participant + + + + 준비·연습 화면 + 역할 · 목소리 · 차례 + + + + Server Action · 세션 생성 · TTS · Sequence participant + + + + Server Action + 세션 생성 · TTS + + + + Postgres · 대본 스냅샷 · 이용량 · Sequence participant + + + + Postgres + 대본 스냅샷 · 이용량 + + + + OpenAI TTS · 샘플 / 상대방 대사 · Sequence participant + + + + OpenAI TTS + 샘플 / 상대방 대사 + + + + + Legend + + + request + + + + return + + + + default message + + + \ No newline at end of file diff --git a/docs/portfolio/txt-import.html b/docs/portfolio/txt-import.html new file mode 100644 index 0000000..75798af --- /dev/null +++ b/docs/portfolio/txt-import.html @@ -0,0 +1,14909 @@ + + + + + + + TXT 대화 검증과 역할 분리 Diagram + + + + + + + + +
+ +
+
+
+

TXT 대화 검증과 역할 분리

+
+
+ + + + + + + +
+ + TXT 대화 검증과 역할 분리 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + TXT File 전달 + + + + + + + + 로그인 확인 후 파싱 요청 + + + + + + + + TXT 검사 후 2인 대화·역할 판별 + + + + + + + + 두 화자 · partner/me · 대사 반환 + + + + + + + + 스키마·화자 참조 검증 후 초안 반환 + + + + + + + + 역할별 편집 초안 반영 · 직접 검토 + + + + + + + + + 파일 선택 · TXT · 한 파일 · Sequence participant + + + + 파일 선택 + TXT · 한 파일 + + + + Server Action · transferTextFile · Sequence participant + + + + Server Action + transferTextFile + + + + 서버 파서 · 입출력 검증 · Sequence participant + + + + 서버 파서 + 입출력 검증 + + + + OpenAI · 대화 판별 · 역할 추출 · Sequence participant + + + + OpenAI + 대화 판별 · 역할 추출 + + + + + Legend + + + request + + + + return + + + + security + + + + default message + + + +

+ + + + + + + + + +
+ + +
+ +
+ +
+ + + + diff --git a/docs/portfolio/txt-import.json b/docs/portfolio/txt-import.json new file mode 100644 index 0000000..eb4fab4 --- /dev/null +++ b/docs/portfolio/txt-import.json @@ -0,0 +1,89 @@ +{ + "schema_version": 1, + "diagram_type": "sequence", + "meta": { + "title": "TXT 대화 검증과 역할 분리", + "quality_profile": "showcase", + "column_fit": "spread", + "viewBox": [ + 1080, + 480 + ] + }, + "participants": [ + { + "id": "upload", + "type": "frontend", + "label": "파일 선택", + "sublabel": "TXT · 한 파일" + }, + { + "id": "action", + "type": "backend", + "label": "Server Action", + "sublabel": "transferTextFile" + }, + { + "id": "parser", + "type": "backend", + "label": "서버 파서", + "sublabel": "입출력 검증" + }, + { + "id": "ai", + "type": "external", + "label": "OpenAI", + "sublabel": "대화 판별 · 역할 추출" + } + ], + "messages": [ + { + "id": "txt-import-1", + "from": "upload", + "to": "action", + "y": 160, + "label": "TXT File 전달", + "variant": "emphasis" + }, + { + "id": "txt-import-2", + "from": "action", + "to": "parser", + "y": 196, + "label": "로그인 확인 후 파싱 요청", + "variant": "security" + }, + { + "id": "txt-import-4", + "from": "parser", + "to": "ai", + "y": 232, + "label": "TXT 검사 후 2인 대화·역할 판별", + "variant": "default" + }, + { + "id": "txt-import-5", + "from": "ai", + "to": "parser", + "y": 268, + "label": "두 화자 · partner/me · 대사 반환", + "variant": "return" + }, + { + "id": "txt-import-7", + "from": "parser", + "to": "action", + "y": 304, + "label": "스키마·화자 참조 검증 후 초안 반환", + "variant": "return" + }, + { + "id": "txt-import-8", + "from": "action", + "to": "upload", + "y": 340, + "label": "역할별 편집 초안 반영 · 직접 검토", + "variant": "return" + } + ] +} diff --git a/docs/portfolio/txt-import.svg b/docs/portfolio/txt-import.svg new file mode 100644 index 0000000..93cc9d6 --- /dev/null +++ b/docs/portfolio/txt-import.svg @@ -0,0 +1,576 @@ + + + TXT 대화 검증과 역할 분리 + A sequence diagram generated by Archify. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + TXT File 전달 + + + + + + + + 로그인 확인 후 파싱 요청 + + + + + + + + TXT 검사 후 2인 대화·역할 판별 + + + + + + + + 두 화자 · partner/me · 대사 반환 + + + + + + + + 스키마·화자 참조 검증 후 초안 반환 + + + + + + + + 역할별 편집 초안 반영 · 직접 검토 + + + + + + + + + 파일 선택 · TXT · 한 파일 · Sequence participant + + + + 파일 선택 + TXT · 한 파일 + + + + Server Action · transferTextFile · Sequence participant + + + + Server Action + transferTextFile + + + + 서버 파서 · 입출력 검증 · Sequence participant + + + + 서버 파서 + 입출력 검증 + + + + OpenAI · 대화 판별 · 역할 추출 · Sequence participant + + + + OpenAI + 대화 판별 · 역할 추출 + + + + + Legend + + + request + + + + return + + + + security + + + + default message + + + \ No newline at end of file