✍️ 필사 모드: 영어 스피킹 쉐도잉 시스템 설계: 90일 루틴과 측정 지표

# 90일 쉐도잉 프로그램 설정
program:
  name: '90-Day Shadowing System'
  daily_minutes: 15
  phases:
    - name: 'Foundation'
      weeks: 1-2
      stage: 'Mumbling'
      material: 'VOA Learning English'
      daily_routine:
        - listen_without_speaking: 3min
        - mumbling_practice: 10min
        - vocabulary_review: 2min
      target: '리듬 따라가기 40% 이상'

    - name: 'Sync'
      weeks: 3-4
      stage: 'Synchronized'
      material: 'TED-Ed'
      daily_routine:
        - full_speed_listening: 2min
        - synchronized_shadowing: 10min
        - script_check: 3min
      target: '동기화율 60% 이상'

    - name: 'Prosody'
      weeks: 5-8
      stage: 'Prosody Shadowing'
      material: 'TED Talks'
      daily_routine:
        - shadowing_with_recording: 10min
        - compare_with_original: 3min
        - note_problem_sounds: 2min
      target: '억양 유사도 자기평가 7/10 이상'

    - name: 'Content'
      weeks: 9-12
      stage: 'Content Shadowing'
      material: 'NPR / BBC'
      daily_routine:
        - blind_shadowing: 8min
        - retelling_in_own_words: 5min
        - new_vocabulary_log: 2min
      target: '첫 시도 쉐도잉 성공률 70% 이상'

[0:00-0:30]  오늘 소재 재생 - 전체 1회 청취 (핵심 파악)
[0:30-2:00]  1차 쉐도잉 - 녹음 시작
[2:00-4:00]  녹음 재생 + 원본 비교 - 차이 3개 메모
[4:00-8:00]  문제 구간 집중 반복 (최소 5회)
[8:00-12:00] 2차 쉐도잉 - 전체 통으로 녹음
[12:00-14:00] 2차 녹음 vs 원본 비교 - 개선점 확인
[14:00-15:00] 오늘 배운 표현 3개 메모 (단어장 앱에 추가)

import difflib
from google.cloud import speech_v1 as speech

def measure_accuracy(audio_path: str, expected_text: str) -> dict:
    """쉐도잉 녹음 파일의 발음 정확도를 측정한다."""
    client = speech.SpeechClient()

    with open(audio_path, "rb") as f:
        audio = speech.RecognitionAudio(content=f.read())

    config = speech.RecognitionConfig(
        encoding=speech.RecognitionConfig.AudioEncoding.LINEAR16,
        sample_rate_hertz=16000,
        language_code="en-US",
        enable_word_time_offsets=True,
    )

    response = client.recognize(config=config, audio=audio)

    recognized = " ".join(
        result.alternatives[0].transcript
        for result in response.results
    ).lower().split()

    expected = expected_text.lower().split()

    # 단어 단위 일치율 계산
    matcher = difflib.SequenceMatcher(None, expected, recognized)
    accuracy = matcher.ratio() * 100

    # 틀린 단어 목록 추출
    missed_words = []
    for tag, i1, i2, j1, j2 in matcher.get_opcodes():
        if tag in ("replace", "delete"):
            missed_words.extend(expected[i1:i2])

    return {
        "accuracy_pct": round(accuracy, 1),
        "total_expected": len(expected),
        "total_recognized": len(recognized),
        "missed_words": missed_words[:10],  # 상위 10개만
    }

# 사용 예시
result = measure_accuracy(
    "recordings/2026-03-04-ted-talk.wav",
    "The greatest glory in living lies not in never falling "
    "but in rising every time we fall"
)
print(f"정확도: {result['accuracy_pct']}%")
print(f"놓친 단어: {result['missed_words']}")

import json
from datetime import date, timedelta

def weekly_log(week_num: int, data: dict) -> dict:
    """주간 쉐도잉 성과를 기록하고 이전 주와 비교한다."""
    log = {
        "week": week_num,
        "period": f"{date.today() - timedelta(days=6)} ~ {date.today()}",
        "metrics": {
            "wpm": data.get("wpm", 0),
            "sync_rate_pct": data.get("sync_rate", 0),
            "pronunciation_accuracy_pct": data.get("accuracy", 0),
            "retelling_score": data.get("retelling", 0),
        },
        "practice_days": data.get("days_practiced", 0),
        "total_minutes": data.get("total_minutes", 0),
        "material_used": data.get("materials", []),
        "problem_sounds": data.get("problem_sounds", []),
        "notes": data.get("notes", ""),
    }

    # JSON 파일에 누적 저장
    log_file = "shadowing_progress.json"
    try:
        with open(log_file, "r") as f:
            all_logs = json.load(f)
    except FileNotFoundError:
        all_logs = []

    all_logs.append(log)

    with open(log_file, "w") as f:
        json.dump(all_logs, f, indent=2, ensure_ascii=False)

    return log

# 사용 예시
weekly_log(5, {
    "wpm": 105,
    "sync_rate": 65,
    "accuracy": 72,
    "retelling": 5,
    "days_practiced": 6,
    "total_minutes": 90,
    "materials": ["TED: The power of vulnerability"],
    "problem_sounds": ["th sound", "r/l distinction", "word-final consonants"],
    "notes": "연음 처리가 많이 나아졌으나 th 발음은 여전히 어렵다",
})