careermate 0.1.1 → 0.1.3

package/apps/web/demo/seed.js

@@ -0,0 +1,269 @@
+// =============================================================================
+// Demo seed data — realistic sample career workspace for careermate.life/demo.
+// Loaded fresh into the in-memory demo DB on every page load (and on reset).
+// Shapes mirror @careermate/shared *Record types (see packages/shared/src/schemas.ts).
+// All timestamps are fixed strings so the demo is deterministic (no Date.now()).
+// =============================================================================
+
+// Anchor "now" for relative-time rendering. Recent activity is dated near this.
+const T = (iso) => iso; // readability helper
+
+export function buildSeed() {
+  return {
+    profile: {
+      id: 'p1',
+      created_at: '2026-05-02T09:00:00.000Z',
+      updated_at: '2026-06-14T11:20:00.000Z',
+      name: '김하늘',
+      email: 'haneul.kim@example.com',
+      phone: '010-1234-5678',
+      location: '서울 성동구',
+      headline: '5년차 백엔드 엔지니어 · 결제/정산 도메인',
+      summary:
+        '대규모 트래픽의 결제·정산 시스템을 설계·운영해 온 백엔드 엔지니어입니다. ' +
+        '장애 대응과 점진적 마이그레이션 경험이 많고, 팀의 배포 파이프라인을 정비해 ' +
+        '배포 빈도를 주 1회에서 일 5회로 끌어올렸습니다.',
+      desired_roles: ['백엔드 엔지니어', '플랫폼 엔지니어'],
+      desired_conditions: '연봉 7,000만원+ · 서울/판교 · 주 2회 이상 재택',
+      preferred_tone: '담백하고 구체적인 · 성과는 숫자로',
+      emphasis_points: ['결제/정산 도메인 전문성', '대용량 트래픽 안정화', '팀 생산성 개선'],
+      links: [
+        { label: 'GitHub', url: 'https://github.com/example' },
+        { label: '기술 블로그', url: 'https://blog.example.com' },
+      ],
+    },
+
+    experiences: [
+      {
+        id: 'e1', created_at: '2026-05-02T09:05:00.000Z', updated_at: '2026-05-02T09:05:00.000Z',
+        company: '페이코어', role: '백엔드 엔지니어 (시니어)', employment_type: '정규직',
+        start_date: '2022-03', end_date: null, is_current: true,
+        description: '결제 게이트웨이와 정산 시스템 백엔드 개발·운영.',
+        achievements: [
+          '정산 배치 처리 시간을 4시간 → 38분으로 단축 (쿼리·인덱스·병렬화)',
+          '결제 승인 API p99 지연 320ms → 110ms 개선',
+          '무중단 DB 마이그레이션으로 월 1회 정기 점검 다운타임 제거',
+        ],
+        tech: ['Java', 'Spring', 'Kafka', 'MySQL', 'Redis', 'Kubernetes'],
+        order_index: 0,
+      },
+      {
+        id: 'e2', created_at: '2026-05-02T09:06:00.000Z', updated_at: '2026-05-02T09:06:00.000Z',
+        company: '커머스랩', role: '백엔드 엔지니어', employment_type: '정규직',
+        start_date: '2019-01', end_date: '2022-02', is_current: false,
+        description: '이커머스 주문/재고 도메인 API 개발.',
+        achievements: [
+          '주문 폭주 시 재고 동시성 버그 해결 (분산 락 도입, 오버셀 0건)',
+          '신규 정기배송 기능 백엔드 단독 설계·출시',
+        ],
+        tech: ['Node.js', 'TypeScript', 'PostgreSQL', 'AWS'],
+        order_index: 1,
+      },
+    ],
+
+    projects: [
+      {
+        id: 'pr1', created_at: '2026-05-02T09:10:00.000Z', updated_at: '2026-05-02T09:10:00.000Z',
+        name: '정산 시스템 차세대 리아키텍처', role: '리드',
+        description: '레거시 배치 정산을 이벤트 기반 스트리밍 정산으로 전환.',
+        highlights: ['Kafka 기반 이벤트 소싱 도입', '정산 정확도 검증 파이프라인 자동화'],
+        tech: ['Kafka', 'Java', 'Spring Batch'],
+        url: 'https://github.com/example/settlement', start_date: '2023-06', end_date: '2024-01',
+        order_index: 0,
+      },
+      {
+        id: 'pr2', created_at: '2026-05-02T09:11:00.000Z', updated_at: '2026-05-02T09:11:00.000Z',
+        name: '사내 배포 파이프라인 정비', role: '개인 주도',
+        description: 'GitHub Actions + ArgoCD로 카나리 배포 자동화.',
+        highlights: ['배포 빈도 주1회 → 일5회', '롤백 평균 12분 → 90초'],
+        tech: ['GitHub Actions', 'ArgoCD', 'Kubernetes'],
+        url: null, start_date: '2024-02', end_date: '2024-05',
+        order_index: 1,
+      },
+    ],
+
+    skills: [
+      { id: 's1', created_at: '2026-05-02T09:12:00.000Z', updated_at: '2026-05-02T09:12:00.000Z', name: 'Java / Spring', category: '언어/프레임워크', level: '상', years: 5, order_index: 0 },
+      { id: 's2', created_at: '2026-05-02T09:12:10.000Z', updated_at: '2026-05-02T09:12:10.000Z', name: 'Kafka', category: '인프라', level: '상', years: 3, order_index: 1 },
+      { id: 's3', created_at: '2026-05-02T09:12:20.000Z', updated_at: '2026-05-02T09:12:20.000Z', name: 'MySQL / PostgreSQL', category: '데이터베이스', level: '상', years: 5, order_index: 2 },
+      { id: 's4', created_at: '2026-05-02T09:12:30.000Z', updated_at: '2026-05-02T09:12:30.000Z', name: 'Kubernetes', category: '인프라', level: '중', years: 3, order_index: 3 },
+      { id: 's5', created_at: '2026-05-02T09:12:40.000Z', updated_at: '2026-05-02T09:12:40.000Z', name: 'TypeScript / Node.js', category: '언어/프레임워크', level: '중', years: 3, order_index: 4 },
+    ],
+
+    documents: [
+      {
+        id: 'd1', created_at: '2026-05-03T10:00:00.000Z', updated_at: '2026-06-10T08:30:00.000Z',
+        kind: 'resume', title: '김하늘 이력서 (2026)', source: 'upload', is_primary: true,
+        tags: ['백엔드', '결제'],
+        content:
+          '# 김하늘 — 백엔드 엔지니어\n\n## 경력 요약\n결제·정산 도메인 5년. 대용량 트래픽 안정화와 팀 생산성 개선에 강점.\n\n' +
+          '## 핵심 성과\n- 정산 배치 4h → 38m\n- 결제 API p99 320ms → 110ms\n- 무중단 마이그레이션으로 정기 다운타임 제거\n',
+      },
+      {
+        id: 'd2', created_at: '2026-05-20T13:00:00.000Z', updated_at: '2026-05-20T13:00:00.000Z',
+        kind: 'career_description', title: '경력기술서 — 페이코어', source: 'manual', is_primary: false,
+        tags: ['결제'],
+        content: '## 페이코어 (2022.03~)\n결제 게이트웨이/정산 백엔드. 상세 프로젝트와 성과는 본문 참조.\n',
+      },
+    ],
+
+    jobs: [
+      {
+        id: 'j1', created_at: '2026-06-01T09:00:00.000Z', updated_at: '2026-06-12T09:00:00.000Z',
+        company: '토스페이먼츠', position: '백엔드 엔지니어 (결제)', url: 'https://example.com/jobs/j1',
+        location: '서울 강남구', employment_type: '정규직',
+        description: '결제 코어 시스템을 함께 만들 백엔드 엔지니어를 찾습니다. 대용량 트랜잭션 처리 경험 우대.',
+        requirements: ['JVM 기반 백엔드 5년+', '대용량 트래픽 경험', '결제/금융 도메인 우대'],
+        keywords: ['Java', 'Spring', 'Kafka', 'MSA', '결제'],
+        deadline: '2026-06-30', source: '원티드',
+      },
+      {
+        id: 'j2', created_at: '2026-06-03T09:00:00.000Z', updated_at: '2026-06-11T09:00:00.000Z',
+        company: '쿠팡', position: 'Software Engineer, Backend', url: 'https://example.com/jobs/j2',
+        location: '서울 송파구', employment_type: '정규직',
+        description: '커머스 주문/정산 플랫폼 백엔드. 글로벌 스케일의 분산 시스템.',
+        requirements: ['분산 시스템 설계 경험', 'Java 또는 Kotlin', '영어 협업 가능'],
+        keywords: ['Java', 'Kotlin', 'AWS', '분산시스템'],
+        deadline: '2026-07-15', source: '사람인',
+      },
+      {
+        id: 'j3', created_at: '2026-06-05T09:00:00.000Z', updated_at: '2026-06-05T09:00:00.000Z',
+        company: '당근', position: '플랫폼 엔지니어', url: 'https://example.com/jobs/j3',
+        location: '서울 서초구', employment_type: '정규직',
+        description: '사내 개발 생산성을 끌어올릴 플랫폼 엔지니어.',
+        requirements: ['Kubernetes 운영 경험', 'CI/CD 파이프라인 설계', 'Go 또는 Java'],
+        keywords: ['Kubernetes', 'CI/CD', 'Platform', 'Go'],
+        deadline: null, source: '직접 입력',
+      },
+      {
+        id: 'j4', created_at: '2026-05-25T09:00:00.000Z', updated_at: '2026-06-08T09:00:00.000Z',
+        company: '네이버페이', position: '백엔드 개발자 (정산)', url: 'https://example.com/jobs/j4',
+        location: '경기 성남시', employment_type: '정규직',
+        description: '정산 시스템 백엔드 개발. 배치/스트리밍 정산 경험 우대.',
+        requirements: ['Spring Batch 경험', '정산 도메인 이해', 'SQL 최적화'],
+        keywords: ['Java', 'Spring Batch', '정산', 'MySQL'],
+        deadline: '2026-06-22', source: '원티드',
+      },
+      {
+        id: 'j5', created_at: '2026-05-15T09:00:00.000Z', updated_at: '2026-06-02T09:00:00.000Z',
+        company: '배달의민족', position: '서버 개발자', url: 'https://example.com/jobs/j5',
+        location: '서울 송파구', employment_type: '정규직',
+        description: '주문 중계 플랫폼 서버 개발.',
+        requirements: ['Java/Kotlin', '대용량 트래픽', 'MSA 경험'],
+        keywords: ['Kotlin', 'Spring', 'MSA'],
+        deadline: '2026-06-18', source: '사람인',
+      },
+      {
+        id: 'j6', created_at: '2026-06-10T09:00:00.000Z', updated_at: '2026-06-10T09:00:00.000Z',
+        company: '카카오뱅크', position: '백엔드 엔지니어', url: 'https://example.com/jobs/j6',
+        location: '경기 성남시', employment_type: '정규직',
+        description: '뱅킹 코어 백엔드. 안정성과 정합성이 최우선.',
+        requirements: ['금융 도메인 경험', 'Java', '높은 테스트 커버리지 문화'],
+        keywords: ['Java', '금융', 'Spring'],
+        deadline: '2026-07-05', source: '직접 입력',
+      },
+    ],
+
+    // job_id → application. status drives the pipeline + board.
+    applications: [
+      { id: 'a1', created_at: '2026-06-01T10:00:00.000Z', updated_at: '2026-06-13T10:00:00.000Z', job_id: 'j1', status: 'interview', resume_id: 'd1', cover_letter_id: 'c1', applied_at: '2026-06-06', notes: '1차 기술면접 통과, 2차 임원면접 예정' },
+      { id: 'a2', created_at: '2026-06-03T10:00:00.000Z', updated_at: '2026-06-09T10:00:00.000Z', job_id: 'j2', status: 'applied', resume_id: 'd1', cover_letter_id: null, applied_at: '2026-06-09', notes: null },
+      { id: 'a3', created_at: '2026-06-05T10:00:00.000Z', updated_at: '2026-06-05T10:00:00.000Z', job_id: 'j3', status: 'planned', resume_id: null, cover_letter_id: null, applied_at: null, notes: '지원서 작성 중' },
+      { id: 'a4', created_at: '2026-05-25T10:00:00.000Z', updated_at: '2026-06-12T10:00:00.000Z', job_id: 'j4', status: 'document_passed', resume_id: 'd1', cover_letter_id: 'c2', applied_at: '2026-05-28', notes: '서류 합격 — 면접 일정 조율 중' },
+      { id: 'a5', created_at: '2026-05-15T10:00:00.000Z', updated_at: '2026-06-02T10:00:00.000Z', job_id: 'j5', status: 'rejected', resume_id: 'd1', cover_letter_id: null, applied_at: '2026-05-18', notes: '서류 탈락' },
+      { id: 'a6', created_at: '2026-06-10T10:00:00.000Z', updated_at: '2026-06-10T10:00:00.000Z', job_id: 'j6', status: 'draft', resume_id: null, cover_letter_id: null, applied_at: null, notes: null },
+    ],
+
+    fits: [
+      {
+        id: 'f1', created_at: '2026-06-02T09:30:00.000Z', updated_at: '2026-06-02T09:30:00.000Z', job_id: 'j1',
+        score: 88, summary: '결제 도메인 전문성과 대용량 트래픽 경험이 공고 요구와 강하게 맞습니다.',
+        strengths: ['결제/정산 5년 실무', 'Kafka·Spring 숙련', 'p99 지연 개선 정량 성과'],
+        gaps: ['MSA 전환 리딩 경험은 보강하면 좋음'],
+        matched_keywords: ['Java', 'Spring', 'Kafka', '결제'], missing_keywords: ['MSA'],
+        recommendations: ['지원동기에 결제 코어 안정화 경험을 앞세우기', 'MSA 관련 학습/사이드 언급'],
+      },
+      {
+        id: 'f2', created_at: '2026-05-26T09:30:00.000Z', updated_at: '2026-05-26T09:30:00.000Z', job_id: 'j4',
+        score: 91, summary: '정산 배치 최적화 경험이 공고 핵심 요구와 거의 일치합니다.',
+        strengths: ['Spring Batch 정산 실무', '배치 4h→38m 성과', 'SQL 최적화'],
+        gaps: ['스트리밍 정산은 프로젝트 경험 1건'],
+        matched_keywords: ['Java', 'Spring Batch', '정산', 'MySQL'], missing_keywords: [],
+        recommendations: ['정산 정확도 검증 자동화 사례를 구체 수치로 제시'],
+      },
+      {
+        id: 'f3', created_at: '2026-06-04T09:30:00.000Z', updated_at: '2026-06-04T09:30:00.000Z', job_id: 'j2',
+        score: 72, summary: '백엔드 역량은 충분하나 글로벌 스케일 분산 시스템 경험은 부분적입니다.',
+        strengths: ['대용량 트래픽 안정화', '동시성 문제 해결'],
+        gaps: ['글로벌 멀티리전 운영 경험', '영어 협업 빈도'],
+        matched_keywords: ['Java', 'AWS'], missing_keywords: ['Kotlin', '분산시스템'],
+        recommendations: ['분산 트랜잭션 사례 강조', 'Kotlin 학습 계획 언급'],
+      },
+    ],
+
+    coverLetters: [
+      {
+        id: 'c1', created_at: '2026-06-04T11:00:00.000Z', updated_at: '2026-06-08T11:00:00.000Z',
+        title: '토스페이먼츠 백엔드 지원동기', job_id: 'j1', is_primary: true,
+        current_version_id: 'c1v2', version_count: 2,
+        current_content:
+          '결제는 한 번의 오류가 곧 신뢰의 손실인 도메인입니다. 페이코어에서 결제 승인 API의 p99 지연을 ' +
+          '320ms에서 110ms로 줄이며, 빠르면서도 틀리지 않는 시스템이 무엇인지 체득했습니다. ' +
+          '토스페이먼츠의 결제 코어에서 이 경험을 이어가고 싶습니다.',
+        versions: [
+          { id: 'c1v1', cover_letter_id: 'c1', version_no: 1, content: '(초안) 결제 도메인 경험 중심 지원동기 초안.', note: '초안', source: 'ai', created_at: '2026-06-04T11:00:00.000Z' },
+          { id: 'c1v2', cover_letter_id: 'c1', version_no: 2, content: '결제는 한 번의 오류가 곧 신뢰의 손실인 도메인입니다. 페이코어에서 결제 승인 API의 p99 지연을 320ms에서 110ms로 줄이며, 빠르면서도 틀리지 않는 시스템이 무엇인지 체득했습니다. 토스페이먼츠의 결제 코어에서 이 경험을 이어가고 싶습니다.', note: '수치 보강 + 마무리 다듬기', source: 'edit', created_at: '2026-06-08T11:00:00.000Z' },
+        ],
+      },
+      {
+        id: 'c2', created_at: '2026-05-27T11:00:00.000Z', updated_at: '2026-05-27T11:00:00.000Z',
+        title: '네이버페이 정산 지원동기', job_id: 'j4', is_primary: false,
+        current_version_id: 'c2v1', version_count: 1,
+        current_content:
+          '정산은 정확함이 전부입니다. Spring Batch 기반 정산 배치를 4시간에서 38분으로 줄이면서도 ' +
+          '검증 파이프라인을 자동화해 정합성을 지켰습니다. 네이버페이 정산 시스템에 기여하고 싶습니다.',
+        versions: [
+          { id: 'c2v1', cover_letter_id: 'c2', version_no: 1, content: '정산은 정확함이 전부입니다. Spring Batch 기반 정산 배치를 4시간에서 38분으로 줄이면서도 검증 파이프라인을 자동화해 정합성을 지켰습니다. 네이버페이 정산 시스템에 기여하고 싶습니다.', note: 'AI 생성', source: 'ai', created_at: '2026-05-27T11:00:00.000Z' },
+        ],
+      },
+    ],
+
+    interviews: [
+      {
+        id: 'iv1', created_at: '2026-06-12T14:00:00.000Z', updated_at: '2026-06-13T09:30:00.000Z', job_id: 'j1',
+        self_introduction:
+          '안녕하세요, 결제·정산 도메인 5년차 백엔드 엔지니어 김하늘입니다. ' +
+          '페이코어에서 하루 수백만 건의 결제 트랜잭션을 다루며, "빠르면서도 절대 틀리지 않는" 시스템을 ' +
+          '만드는 데 집중해 왔습니다. 결제 승인 API의 p99 지연을 320ms에서 110ms로 줄였고, ' +
+          '정산 배치를 4시간에서 38분으로 단축하면서도 검증 자동화로 정합성을 지켰습니다. ' +
+          '토스페이먼츠의 결제 코어에서 이 경험을 한 단계 더 키우고 싶습니다.',
+        notes:
+          '2차 임원면접 — 컬처핏 + 시스템 설계 위주 예상.\n' +
+          '· 결제 도메인에서의 "정확성 vs 속도" 트레이드오프 관점 강조하기\n' +
+          '· 페이코어 → 토스페이먼츠 지원 동기(규모/임팩트) 솔직하게\n' +
+          '· 역질문: 결제 코어 팀의 온콜/장애 대응 문화, 차세대 정산 로드맵',
+        questions: [
+          { question: '결제 승인 API의 p99 지연을 어떻게 320ms에서 110ms로 줄였나요?', intent: '성능 최적화의 사고 과정과 측정 기반 접근 확인', followups: ['병목을 어떻게 측정했나요?', '개선의 트레이드오프는 무엇이었나요?', '캐시 정합성은 어떻게 보장했나요?'], answer_outline: 'APM으로 구간별 측정 → 가설(N+1 쿼리·직렬화·커넥션 대기) → 인덱스 재설계·커넥션풀 튜닝·읽기 캐시 순차 적용 → 각 단계 A/B로 효과 검증. 캐시는 TTL+이벤트 무효화로 정합성 유지.' },
+          { question: '무중단으로 결제 DB를 마이그레이션한 경험을 설명해 주세요.', intent: '운영 안정성과 단계적 전환 설계 역량', followups: ['롤백 전략은?', '데이터 정합성 검증은?'], answer_outline: '듀얼 라이트 → 과거 데이터 백필 → 신구 비교 검증 → 점진 트래픽 컷오버. 각 단계가 가역적이라 언제든 롤백 가능하게 설계.' },
+          { question: '대용량 트래픽에서 동시성 문제를 해결한 사례가 있나요?', intent: '분산 환경 동시성 이해도', followups: ['분산 락의 한계는?', '멱등성은 어떻게 보장했나요?'], answer_outline: '주문 폭주 시 재고 오버셀 → 분산 락(Redis) + 멱등 키로 중복 처리 차단. 락 경합이 큰 구간은 큐 기반 직렬화로 전환해 오버셀 0건 달성.' },
+          { question: '결제처럼 정확성이 중요한 도메인에서 장애가 났을 때 어떻게 대응하나요?', intent: '장애 대응 원칙과 우선순위 판단', followups: ['사후 분석은 어떻게 하나요?'], answer_outline: '1) 영향 범위 격리·차단(서킷브레이커) 2) 정합성 우선 — 의심 거래는 보류 처리 3) 복구 후 정산 재대사 4) 블레임리스 포스트모템으로 재발 방지 액션화.' },
+          { question: '함께 일하기 좋은 동료/팀 문화는 무엇이라고 생각하나요?', intent: '컬처핏', followups: ['코드 리뷰 문화에 대한 생각은?'], answer_outline: '문제를 숨기지 않고 일찍 공유하는 문화, 그리고 결정의 "왜"를 문서로 남기는 팀. 리뷰는 사람이 아니라 코드/설계를 향하게.' },
+        ],
+        star_guides: [
+          { question: '가장 어려웠던 장애 대응 경험은?', situation: '월말 정산 배치가 지연되며 마감 시한을 넘길 위험에 처함', task: '4시간 내 정산을 정확히 완료하고 재발을 막아야 했음', action: '병목 배치를 병렬화하고 인덱스를 재설계, 핫픽스를 무중단 배포 후 검증 파이프라인으로 정합성 확인', result: '처리 시간을 38분으로 단축하고 이후 동일 장애 재발 0건, 정산 SLA를 안정화' },
+          { question: '주도적으로 팀의 문제를 개선한 경험은?', situation: '배포가 주 1회로 묶여 기능 출시가 느리고 롤백이 어려웠음', task: '배포 빈도를 높이면서도 안정성을 잃지 않아야 했음', action: 'GitHub Actions + ArgoCD로 카나리 배포 자동화, 헬스체크 기반 자동 롤백 구성', result: '배포 빈도 주1회 → 일5회, 롤백 평균 12분 → 90초로 단축' },
+        ],
+      },
+    ],
+
+    activities: [
+      { id: 'ac1', type: 'application_status_changed', entity_type: 'application', entity_id: 'a1', summary: '토스페이먼츠 — 면접 진행으로 상태를 변경했습니다.', created_at: '2026-06-13T10:00:00.000Z' },
+      { id: 'ac2', type: 'interview_prep_saved', entity_type: 'interview_prep', entity_id: 'iv1', summary: '토스페이먼츠 면접 준비 자료를 저장했습니다.', created_at: '2026-06-12T14:00:00.000Z' },
+      { id: 'ac3', type: 'application_status_changed', entity_type: 'application', entity_id: 'a4', summary: '네이버페이 — 서류 합격으로 상태를 변경했습니다.', created_at: '2026-06-12T10:00:00.000Z' },
+      { id: 'ac4', type: 'cover_letter_version_saved', entity_type: 'cover_letter', entity_id: 'c1', summary: '토스페이먼츠 지원동기 v2를 저장했습니다.', created_at: '2026-06-08T11:00:00.000Z' },
+      { id: 'ac5', type: 'fit_analysis_saved', entity_type: 'fit_analysis', entity_id: 'f1', summary: '토스페이먼츠 적합도 분석(88점)을 저장했습니다.', created_at: '2026-06-02T09:30:00.000Z' },
+      { id: 'ac6', type: 'job_saved', entity_type: 'job', entity_id: 'j6', summary: '카카오뱅크 공고를 저장했습니다.', created_at: '2026-06-10T09:00:00.000Z' },
+      { id: 'ac7', type: 'resume_added', entity_type: 'document', entity_id: 'd1', summary: '김하늘 이력서(2026)를 추가했습니다.', created_at: '2026-05-03T10:00:00.000Z' },
+    ],
+  };
+}

package/apps/web/public/app.js

@@ -19,6 +19,7 @@ const view = document.getElementById('view');
 const navEl = document.getElementById('nav');
 const titleEl = document.getElementById('topbar-title');
 const actionsEl = document.getElementById('topbar-actions');
+const routeStatusEl = document.getElementById('route-status');
 const moduleCache = new Map();
 
 function parseHash() {
@@ -87,23 +88,54 @@ async function route() {
     if (token !== renderToken) return; // a newer navigation superseded this one
     clear(view);
     await mod.render(ctx);
+    // Announce just the new page name to screen readers (titleEl reflects any
+    // detail-page ctx.setTitle override).
+    if (routeStatusEl) routeStatusEl.textContent = titleEl.textContent || def.label;
   } catch (err) {
     if (token !== renderToken) return;
     clear(view);
     view.append(el('div', { class: 'card' }, el('div', { class: 'card__body' },
       el('h3', { style: { marginBottom: '8px' } }, '페이지를 불러오지 못했습니다'),
-      el('p', { class: 'text-secondary' }, err instanceof Error ? err.message : String(err)))));
+      el('p', { class: 'text-secondary', style: { marginBottom: '14px' } }, err instanceof Error ? err.message : String(err)),
+      el('button', { class: 'btn btn--primary', type: 'button', onClick: () => route() }, '다시 시도'))));
     toastError(err);
   }
 }
 
+// Mobile/narrow-window nav: the sidebar is the only navigation, so below 900px it
+// becomes an off-canvas drawer toggled from the topbar. Without this a phone/narrow
+// window is stranded on whatever page loaded first.
+function setupMobileNav() {
+  const toggle = document.getElementById('nav-toggle');
+  const scrim = document.getElementById('nav-scrim');
+  const app = document.querySelector('.app');
+  if (!toggle || !app) return;
+  const setOpen = (open) => {
+    app.classList.toggle('nav-open', open);
+    toggle.setAttribute('aria-expanded', open ? 'true' : 'false');
+    toggle.setAttribute('aria-label', open ? '메뉴 닫기' : '메뉴 열기');
+  };
+  toggle.addEventListener('click', () => setOpen(!app.classList.contains('nav-open')));
+  scrim?.addEventListener('click', () => setOpen(false));
+  navEl.addEventListener('click', (e) => { if (e.target.closest('.nav__item')) setOpen(false); });
+  document.addEventListener('keydown', (e) => { if (e.key === 'Escape' && app.classList.contains('nav-open')) setOpen(false); });
+}
+
 function initTheme() {
-  const saved = localStorage.getItem('cf-theme');
+  // Read new key, falling back to the legacy 'cf-theme' so existing users keep their choice.
+  const saved = localStorage.getItem('careermate-theme') || localStorage.getItem('cf-theme');
   if (saved === 'light' || saved === 'dark') document.documentElement.dataset.theme = saved;
 }
 
 async function boot() {
   initTheme();
+  setupMobileNav();
+  // Skip link: jump keyboard focus past the sidebar to the page content. A hash
+  // anchor would collide with the router, so move focus directly instead.
+  document.getElementById('skip-link')?.addEventListener('click', () => {
+    view.setAttribute('tabindex', '-1');
+    view.focus();
+  });
   // Show data location in the footer (privacy: user can always see where data lives).
   try {
     const h = await get('/api/health');

package/apps/web/public/index.html

@@ -13,8 +13,10 @@
   <link rel="stylesheet" href="/styles.css" />
 </head>
 <body>
+  <button class="skip-link" id="skip-link" type="button">본문으로 건너뛰기</button>
   <div class="app">
-    <aside class="sidebar">
+    <div class="nav-scrim" id="nav-scrim"></div>
+    <aside class="sidebar" id="sidebar">
       <div class="sidebar__brand">
         <div class="sidebar__logo">C</div>
         <div>
@@ -31,12 +33,18 @@
 
     <div class="main">
       <header class="topbar">
+        <button class="nav-toggle" id="nav-toggle" type="button" aria-label="메뉴 열기" aria-expanded="false" aria-controls="sidebar">
+          <svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M3 6h18M3 12h18M3 18h18"/></svg>
+        </button>
         <div class="topbar__title" id="topbar-title">CareerMate</div>
         <div class="topbar__spacer"></div>
         <div id="topbar-actions" class="flex gap-2"></div>
       </header>
-      <main id="view" class="view" aria-live="polite"></main>
+      <main id="view" class="view"></main>
     </div>
+    <!-- Concise route announcer: speaks only the new page name, not the whole view
+         (the old aria-live on #view re-read the entire page on every navigation). -->
+    <div id="route-status" class="sr-only" role="status" aria-live="polite"></div>
   </div>
 
   <script type="module" src="/app.js"></script>

package/apps/web/public/lib.js

@@ -10,6 +10,19 @@
 
 /* --------------------------------------------------------------- DOM helper */
 
+/**
+ * Neutralize script-capable URL schemes before they reach an href/src. Career
+ * data (profile links, job URLs) is user-controlled and can arrive via the MCP
+ * path with no CSRF gate, so a stored `javascript:…` link would execute when
+ * clicked. http(s)/mailto and scheme-less/relative URLs pass through unchanged;
+ * any other explicit scheme is replaced with a harmless '#'.
+ */
+export function safeUrl(v) {
+  const s = String(v).trim();
+  if (/^[a-z][a-z0-9+.-]*:/i.test(s)) return /^(https?:|mailto:)/i.test(s) ? s : '#';
+  return s;
+}
+
 /**
  * Create an element. `props` may include: class, id, type, value, placeholder,
  * href, title, disabled, dataset:{}, style:{}, attrs:{}, and on* event handlers
@@ -27,7 +40,19 @@ export function el(tag, props = {}, ...children) {
     else if (k === 'dataset') Object.assign(node.dataset, v);
     else if (k === 'style') Object.assign(node.style, v);
     else if (k === 'attrs') for (const [a, val] of Object.entries(v)) node.setAttribute(a, val);
+    else if (k === 'href' || k === 'src') node.setAttribute(k, safeUrl(v)); // block javascript:/data: URLs
     else if (k.startsWith('on') && typeof v === 'function') node.addEventListener(k.slice(2).toLowerCase(), v);
+    else if (k === 'activate' && typeof v === 'function') {
+      // Make a non-native element behave like a button for keyboard + AT users:
+      // role, focusability, and Enter/Space activation. Use this instead of a bare
+      // onClick on clickable <div>/<span> so they aren't mouse-only dead zones.
+      if (!node.getAttribute('role')) node.setAttribute('role', 'button');
+      if (node.getAttribute('tabindex') == null) node.setAttribute('tabindex', '0');
+      node.addEventListener('click', v);
+      node.addEventListener('keydown', (e) => {
+        if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); v(e); }
+      });
+    }
     else if (k in node) { try { node[k] = v; } catch { node.setAttribute(k, v); } }
     else node.setAttribute(k, v);
   }
@@ -40,7 +65,6 @@ function appendChildren(node, children) {
     node.append(c instanceof Node ? c : document.createTextNode(String(c)));
   }
 }
-export function frag(...children) { const f = document.createDocumentFragment(); appendChildren(f, children); return f; }
 export function clear(node) { while (node.firstChild) node.removeChild(node.firstChild); return node; }
 export function mount(node, ...children) { clear(node); appendChildren(node, children); return node; }
 
@@ -94,19 +118,33 @@ const TOKEN = document.querySelector('meta[name="careermate-token"]')?.content |
 
 /** Call the JSON API. Throws Error(message) on non-2xx. */
 export async function api(method, path, body) {
-  const res = await fetch(path, {
-    method,
-    headers: {
-      'Content-Type': 'application/json',
-      ...(method !== 'GET' ? { 'x-careermate-token': TOKEN } : {}),
-    },
-    body: body !== undefined ? JSON.stringify(body) : undefined,
-  });
+  let res;
+  try {
+    res = await fetch(path, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...(method !== 'GET' ? { 'x-careermate-token': TOKEN } : {}),
+      },
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+  } catch {
+    // Connection failure (server stopped, machine asleep) — never surface "Failed to fetch".
+    throw new Error('서버에 연결하지 못했어요. 대시보드가 실행 중인지 확인한 뒤 다시 시도해 주세요.');
+  }
   const text = await res.text();
-  const data = text ? JSON.parse(text) : {};
-  if (!res.ok) throw new Error(data.error || `요청 실패 (${res.status})`);
+  let data = {};
+  if (text) { try { data = JSON.parse(text); } catch { /* non-JSON error page */ } }
+  if (!res.ok) throw new Error(data.error || friendlyStatus(res.status));
   return data;
 }
+// Friendly fallback when the server didn't supply a message — never show a raw status code.
+function friendlyStatus(status) {
+  if (status === 404) return '요청한 항목을 찾을 수 없어요. 새로고침 후 다시 시도해 주세요.';
+  if (status === 403) return '권한 확인이 필요해요. 대시보드를 새로고침해 주세요.';
+  if (status >= 500) return '일시적인 오류가 발생했어요. 잠시 후 다시 시도해 주세요.';
+  return '요청을 처리하지 못했어요. 입력을 확인하고 다시 시도해 주세요.';
+}
 export const get = (p) => api('GET', p);
 export const post = (p, b) => api('POST', p, b);
 export const put = (p, b) => api('PUT', p, b);
@@ -134,6 +172,22 @@ export function scoreClass(score) {
   if (score >= 50) return 'score-mid';
   return 'score-weak';
 }
+/** Textarea (newline-separated) → trimmed array, empties dropped. */
+export function linesToArray(str) { return String(str || '').split('\n').map((s) => s.trim()).filter(Boolean); }
+/** CSV ("a, b, c") → trimmed array, empties dropped. */
+export function csvToArray(str) { return String(str || '').split(',').map((s) => s.trim()).filter(Boolean); }
+
+/**
+ * Application status code → saturated theme colour. Single source of truth so a
+ * colour means the same pipeline stage everywhere (home pipeline bar/dots,
+ * applications board dots, badges). MUST track the badge--{status} hues in CSS.
+ */
+export const STATUS_COLOR = {
+  draft: 'var(--slate)', planned: 'var(--blue)', applied: 'var(--violet)',
+  document_passed: 'var(--teal)', interview: 'var(--amber)',
+  final_passed: 'var(--green)', on_hold: 'var(--slate)', rejected: 'var(--red)',
+};
+export const statusColor = (code) => STATUS_COLOR[code] || 'var(--text-tertiary)';
 
 /* ---------------------------------------------------------------- routing */
 export function navigate(hash) { location.hash = hash.startsWith('#') ? hash : '#' + hash; }
@@ -149,17 +203,50 @@ export function Btn(label, { icon: ic, variant = '', sm, onClick, type, disabled
 export function IconBtn(name, { onClick, title, variant = 'ghost' } = {}) {
   return el('button', { class: `btn btn--${variant} icon-btn`, onClick, title, attrs: { 'aria-label': title || name } }, icon(name));
 }
+/**
+ * A footer button for async saves. While `action()` runs the button is disabled
+ * (so a slow local round-trip can't be double-clicked into duplicate records),
+ * and if it throws the message is shown in the modal's persistent `.modal__error`
+ * slot (not a transient toast) so the user sees why the save failed and can fix
+ * and retry. `action` should THROW on failure (validation or API) and is expected
+ * to call close()/reload() itself on success.
+ */
+export function SubmitBtn(label, action, { variant = 'primary', icon: ic } = {}) {
+  let busy = false;
+  const btn = Btn(label, {
+    variant,
+    icon: ic,
+    onClick: async () => {
+      if (busy) return;
+      busy = true;
+      btn.disabled = true;
+      const slot = btn.closest('.modal')?.querySelector('.modal__error');
+      if (slot) { slot.hidden = true; slot.textContent = ''; }
+      try {
+        await action();
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (slot) { slot.textContent = msg; slot.hidden = false; slot.scrollIntoView?.({ block: 'nearest' }); }
+        else toastError(e);
+      } finally {
+        busy = false;
+        btn.disabled = false;
+      }
+    },
+  });
+  return btn;
+}
 export function Card({ title, sub, actions, body, clickable, onClick } = {}) {
   const head = (title || actions) && el('div', { class: 'card__head' },
     title && el('h3', {}, title),
     sub && el('span', { class: 'sub' }, sub),
     actions && el('div', { class: 'right' }, ...[].concat(actions)),
   );
-  return el('div', { class: `card${clickable ? ' is-clickable' : ''}`, onClick },
+  return el('div', { class: `card${clickable ? ' is-clickable' : ''}`, activate: onClick },
     head, el('div', { class: 'card__body' }, ...[].concat(body || [])));
 }
-export function Stat({ label, value, hint, iconName }) {
-  return el('div', { class: 'stat' },
+export function Stat({ label, value, hint, iconName, onClick }) {
+  return el('div', { class: 'stat', activate: onClick },
     el('div', { class: 'stat__label' }, iconName && icon(iconName), label),
     el('div', { class: 'stat__value tnum' }, value),
     hint && el('div', { class: 'stat__hint' }, hint),
@@ -178,7 +265,7 @@ export function Chips(items, { accent } = {}) {
 }
 /** Dense list row: leading slot → title + muted sub → right-aligned trailing. */
 export function ListRow({ leading, title, sub, trailing, onClick } = {}) {
-  return el('div', { class: `list-row${onClick ? ' is-clickable' : ''}`, onClick },
+  return el('div', { class: `list-row${onClick ? ' is-clickable' : ''}`, activate: onClick },
     leading && el('div', { class: 'list-row__lead' }, leading),
     el('div', { class: 'list-row__main' },
       el('div', { class: 'list-row__title' }, title),
@@ -187,9 +274,11 @@ export function ListRow({ leading, title, sub, trailing, onClick } = {}) {
 }
 /** Onboarding checklist row: hollow dot (todo, links via onClick) or green check (done, struck through). */
 export function CheckRow({ done, label, onClick } = {}) {
-  return el('div', { class: `check-row${done ? ' is-done' : ''}` },
+  // Whole row is the activation target (bigger hit area + keyboard) when it's a todo.
+  const interactive = !done && typeof onClick === 'function';
+  return el('div', { class: `check-row${done ? ' is-done' : ''}`, activate: interactive ? onClick : undefined },
     done ? icon('check', 'check-row__icon') : el('span', { class: 'check-row__dot' }),
-    el('span', { class: `check-row__label${!done && onClick ? ' is-link' : ''}`, onClick: done ? null : onClick }, label));
+    el('span', { class: `check-row__label${interactive ? ' is-link' : ''}` }, label));
 }
 export function Field(label, control, hint) {
   return el('div', { class: 'field' }, label && el('label', {}, label), control, hint && el('div', { class: 'hint' }, hint));
@@ -222,6 +311,8 @@ export function toastOk(msg) { toast(msg, { type: 'success' }); }
 
 /* ------------------------------------------------------------------ modal */
 let modalRoot;
+let modalReturnFocus = null;
+const MODAL_FOCUSABLE = 'a[href],button:not([disabled]),input:not([disabled]),textarea:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
 function ensureModalRoot() {
   if (!modalRoot) {
     modalRoot = el('div', { class: 'modal-root' });
@@ -230,7 +321,11 @@ function ensureModalRoot() {
   }
   return modalRoot;
 }
-export function closeModal() { if (modalRoot) { modalRoot.classList.remove('is-open'); clear(modalRoot); } }
+export function closeModal() {
+  if (modalRoot) { modalRoot.classList.remove('is-open'); clear(modalRoot); }
+  // Return focus to whatever opened the modal so keyboard users aren't dumped at the page top.
+  if (modalReturnFocus) { try { modalReturnFocus.focus(); } catch { /* element gone */ } modalReturnFocus = null; }
+}
 /**
  * Open a modal. `render(close)` returns the modal body content. Provide title,
  * optional footer buttons via `footer(close)`. Returns nothing; call closeModal().
@@ -238,18 +333,36 @@ export function closeModal() { if (modalRoot) { modalRoot.classList.remove('is-o
 export function openModal({ title, body, footer, size }) {
   const root = ensureModalRoot();
   const close = closeModal;
+  modalReturnFocus = document.activeElement; // restored by closeModal
   const closeBtn = IconBtn('plus', { title: '닫기', onClick: close }); // rotated to look like ×
   closeBtn.style.transform = 'rotate(45deg)';
-  const modal = el('div', { class: `modal${size === 'lg' ? ' modal--lg' : ''}` },
-    el('div', { class: 'modal__head' }, el('h3', {}, title), el('div', { class: 'topbar__spacer' }), closeBtn),
+  const modal = el('div', {
+    class: `modal${size === 'lg' ? ' modal--lg' : ''}`,
+    attrs: { role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': 'modal-title' },
+  },
+    el('div', { class: 'modal__head' }, el('h3', { id: 'modal-title' }, title), el('div', { class: 'topbar__spacer' }), closeBtn),
   );
+  // Focus trap: keep Tab / Shift+Tab inside the dialog instead of leaking to the page behind.
+  modal.addEventListener('keydown', (e) => {
+    if (e.key !== 'Tab') return;
+    const f = [...modal.querySelectorAll(MODAL_FOCUSABLE)].filter((x) => x.offsetParent !== null);
+    if (!f.length) return;
+    const first = f[0], last = f[f.length - 1];
+    if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
+    else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
+  });
   const bodyNode = el('div', { class: 'modal__body' });
   appendChildren(bodyNode, [typeof body === 'function' ? body(close) : body]);
   modal.append(bodyNode);
+  // Persistent inline error slot so a failed save shows a clear reason instead of
+  // relying on a 3.8s toast. Placed between body and footer (always visible). Any
+  // SubmitBtn inside the modal writes here — including inline editors in bodies
+  // that have no footer; see SubmitBtn.
+  modal.append(el('div', { class: 'modal__error', hidden: true, attrs: { role: 'alert', 'aria-live': 'assertive' } }));
   if (footer) modal.append(el('div', { class: 'modal__foot' }, ...[].concat(footer(close))));
   mount(root, el('div', { class: 'modal__scrim', onClick: close }), modal);
   root.classList.add('is-open');
-  setTimeout(() => bodyNode.querySelector('input,textarea,select,button')?.focus(), 30);
+  setTimeout(() => (bodyNode.querySelector('input,textarea,select') || modal.querySelector(MODAL_FOCUSABLE))?.focus(), 30);
 }
 /** Confirmation dialog. Returns a Promise<boolean>. */
 export function confirmDialog({ title = '확인', message, confirmLabel = '확인', danger } = {}) {
@@ -275,7 +388,6 @@ export function downloadUrl(url) {
   const a = el('a', { href: url, download: '' });
   document.body.append(a); a.click(); a.remove();
 }
-export function debounce(fn, ms = 250) { let t; return (...a) => { clearTimeout(t); t = setTimeout(() => fn(...a), ms); }; }
 
 /** Shared meta (statuses, document kinds) loaded once. */
 let _meta = null;