careermate 0.1.0 → 0.1.2

package/scripts/shots-seed.ts

@@ -0,0 +1,192 @@
+/**
+ * `shots-seed` — richer demo data for marketing screenshots ONLY.
+ *
+ * Unlike `scripts/seed.ts` (one job, for a first-run feel), this fills the whole
+ * pipeline: jobs across every status, a few cover letters, fit analyses, and an
+ * interview prep — so the home dashboard, the applications board and the jobs
+ * list all look populated in the landing-page screenshots.
+ *
+ * NEVER run this against real data. Always isolate into a throwaway dir:
+ *   CAREERMATE_DATA_DIR=./.shots-data npm run shots:seed
+ */
+import {
+  profileRepo, experienceRepo, projectRepo, skillRepo, getDataDir,
+} from '@careermate/db';
+import {
+  saveProfile, saveJobPosting, saveFitAnalysis, saveCoverLetterVersion,
+  updateApplicationStatus, saveInterviewPrep, addResume,
+} from '@careermate/core';
+
+if (profileRepo.get()?.name) {
+  console.error('⚠️  데이터가 이미 있습니다. 마케팅 시드는 빈 throwaway 폴더에서만 실행하세요.');
+  console.error('   예:  CAREERMATE_DATA_DIR=./.shots-data npm run shots:seed');
+  process.exit(1);
+}
+
+saveProfile({
+  name: '홍길동',
+  email: 'gildong.hong@example.com',
+  phone: '010-1234-5678',
+  location: '서울',
+  headline: '5년 차 백엔드 엔지니어 · 결제/정산 도메인',
+  summary: '대규모 트래픽 환경에서 결제·정산 시스템을 설계·운영했습니다. 안정성과 데이터 정합성을 중시하며, 문제를 정량적으로 정의하고 개선하는 것을 좋아합니다.',
+  desired_roles: ['백엔드 엔지니어', '서버 개발자', '플랫폼 엔지니어'],
+  desired_conditions: '서울/판교, 정규직, 원격 일부 가능, 결제/금융 도메인 선호',
+  preferred_tone: '담백하고 구체적이며, 성과를 숫자로 보여주는 문체',
+  emphasis_points: ['대규모 트래픽 처리 경험', '데이터 정합성', '장애 대응', '동료와의 협업'],
+  links: [
+    { label: 'GitHub', url: 'https://github.com/example' },
+    { label: '기술 블로그', url: 'https://blog.example.com' },
+  ],
+});
+
+experienceRepo.add({
+  company: '페이테크', role: '백엔드 엔지니어', employment_type: '정규직',
+  start_date: '2021-03', is_current: true,
+  description: '결제 게이트웨이와 정산 시스템 개발·운영',
+  achievements: ['결제 승인 API p99 응답시간 320ms→110ms 개선', '정산 배치 처리 시간 6시간→40분 단축', '장애 0건으로 연간 거래액 1.2조 처리'],
+  tech: ['Java', 'Spring Boot', 'Kafka', 'MySQL', 'Redis', 'Kubernetes'],
+});
+experienceRepo.add({
+  company: '커머스랩', role: '주니어 백엔드 개발자', employment_type: '정규직',
+  start_date: '2019-01', end_date: '2021-02',
+  description: '커머스 주문/재고 서비스 개발',
+  achievements: ['주문 동시성 이슈 해결로 재고 오차 99% 감소', '검색 응답속도 2배 개선'],
+  tech: ['Python', 'Django', 'PostgreSQL', 'Elasticsearch'],
+});
+
+projectRepo.add({
+  name: '실시간 정산 파이프라인', role: '설계 및 리드',
+  description: 'Kafka 기반 이벤트 스트리밍으로 준실시간 정산 파이프라인 구축',
+  highlights: ['정산 지연 6시간→실시간', '재처리 가능한 멱등 설계'],
+  tech: ['Kafka', 'Spring', 'MySQL'], url: 'https://github.com/example/settlement',
+});
+projectRepo.add({
+  name: '결제 장애 자동 복구 시스템', role: '개발',
+  description: 'PG사 장애 시 자동 우회 라우팅 및 알림',
+  highlights: ['장애 평균 복구시간 15분→2분'], tech: ['Java', 'Spring', 'Redis'],
+});
+
+for (const s of [
+  { name: 'Java', category: '언어', level: '상', years: 5 },
+  { name: 'Spring Boot', category: '프레임워크', level: '상', years: 5 },
+  { name: 'Kafka', category: '인프라', level: '중', years: 3 },
+  { name: 'MySQL', category: '데이터베이스', level: '상', years: 5 },
+  { name: 'Kubernetes', category: '인프라', level: '중', years: 2 },
+  { name: 'Python', category: '언어', level: '중', years: 3 },
+]) skillRepo.add(s);
+
+addResume({
+  kind: 'resume', title: '홍길동 이력서 (백엔드)', is_primary: true, source: 'manual',
+  content: `# 홍길동 — 백엔드 엔지니어\n\n## 경력 요약\n결제·정산 도메인 5년. 대규모 트래픽 안정화와 데이터 정합성에 강점.\n\n## 핵심 성과\n- 결제 승인 API p99 320ms→110ms\n- 정산 배치 6시간→40분\n- 연간 거래액 1.2조 무중단 처리`,
+});
+
+/** One demo job: posting → optional fit analysis → optional cover letter → status. */
+function job(spec: {
+  company: string; position: string; location: string; deadline: string;
+  description: string; requirements: string[]; keywords: string[];
+  status: string; score?: number; fit?: { summary: string; strengths: string[]; gaps: string[]; matched: string[]; missing: string[] };
+  cover?: { title: string; content: string };
+}) {
+  const { job: j } = saveJobPosting({
+    company: spec.company, position: spec.position, url: `https://example.com/${encodeURIComponent(spec.company)}`,
+    location: spec.location, employment_type: '정규직', description: spec.description,
+    requirements: spec.requirements, keywords: spec.keywords, deadline: spec.deadline, source: '데모',
+  });
+  if (spec.fit && spec.score != null) {
+    saveFitAnalysis({
+      job_id: j.id, score: spec.score, summary: spec.fit.summary,
+      strengths: spec.fit.strengths, gaps: spec.fit.gaps,
+      matched_keywords: spec.fit.matched, missing_keywords: spec.fit.missing,
+      recommendations: ['지원동기에 결제 도메인 경험을 구체 수치로', '부족 키워드는 학습 의지로 보완'],
+    });
+  }
+  let coverLetterId: number | undefined;
+  if (spec.cover) {
+    const { coverLetter } = saveCoverLetterVersion({
+      job_id: j.id, title: spec.cover.title, content: spec.cover.content, note: '초안', source: 'ai',
+    });
+    coverLetterId = coverLetter.id;
+  }
+  if (spec.status !== 'draft') updateApplicationStatus(j.id, spec.status, `데모: ${spec.status}`);
+  return { jobId: j.id, coverLetterId };
+}
+
+// 최종 합격
+job({
+  company: '쿠팡', position: '백엔드 엔지니어 (정산플랫폼)', location: '서울 송파', deadline: '2026-05-30',
+  description: '대규모 정산 플랫폼의 안정성과 확장성을 책임질 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin 백엔드', '대규모 트래픽', '정산 도메인'], keywords: ['Java', 'Spring', 'Kafka', '정산', 'MSA'],
+  status: 'final_passed', score: 91,
+  fit: { summary: '정산 도메인 경험이 공고와 거의 완벽히 일치합니다.', strengths: ['정산 파이프라인 설계 경험', '대규모 트래픽 안정화'], gaps: ['Kotlin 실무 경험'], matched: ['Java', 'Spring', 'Kafka', '정산'], missing: ['Kotlin'] },
+  cover: { title: '쿠팡 정산플랫폼 자기소개서', content: '저는 "정산은 단 1원도 틀려선 안 된다"는 원칙으로 일해 왔습니다...(데모)' },
+});
+
+// 면접
+const naver = job({
+  company: '네이버', position: '서버 개발자 (페이)', location: '경기 성남', deadline: '2026-07-10',
+  description: '네이버페이 결제/정산 백엔드를 함께 만들 서버 개발자를 찾습니다.',
+  requirements: ['Java 백엔드', '결제 시스템 경험', '대용량 처리'], keywords: ['Java', 'Spring', '결제', '대용량'],
+  status: 'interview', score: 84,
+  fit: { summary: '결제 백엔드 경험과 강하게 일치하며 대용량 처리 성과가 돋보입니다.', strengths: ['결제 API 성능 개선(p99)', '대용량 트래픽 경험'], gaps: ['검색 도메인 경험은 제한적'], matched: ['Java', 'Spring', '결제'], missing: ['대용량 검색'] },
+  cover: { title: '네이버페이 자기소개서', content: '결제 시스템의 신뢰성을 숫자로 증명해 온 백엔드 엔지니어입니다...(데모)' },
+});
+saveInterviewPrep({
+  job_id: naver.jobId,
+  questions: [
+    { question: '결제 승인 API 응답시간을 어떻게 개선했나요?', intent: '성능 개선 접근법', followups: ['병목은 어떻게 찾았나요?'], answer_outline: '프로파일링으로 커넥션 풀 병목 발견 → 캐시 도입 → p99 320→110ms.' },
+    { question: '데이터 정합성이 깨질 뻔한 경험은?', intent: '장애 대응', followups: ['멱등성 보장은?'], answer_outline: '정산 재처리 중복 지급 위험 → 멱등키+분산락으로 해결.' },
+  ],
+  star_guides: [
+    { question: '가장 큰 기술적 성과', situation: '정산 배치 6시간 소요', task: '처리 시간 단축', action: 'Kafka 이벤트 스트리밍 재설계', result: '6시간→40분, 지연 0건' },
+  ],
+  self_introduction: '안녕하세요. 결제·정산 도메인에서 5년간 "정확함"을 지켜온 백엔드 엔지니어 홍길동입니다...(데모 1분 자기소개)',
+  notes: '결제 도메인 질문 집중 예상. 정량 수치 암기.',
+});
+
+// 서류 합격
+const toss = job({
+  company: '토스', position: '백엔드 엔지니어 (결제)', location: '서울 강남', deadline: '2026-07-15',
+  description: '토스 결제 시스템의 안정성과 확장성을 책임질 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin 백엔드', '대규모 트래픽', '결제/정산 도메인 이해'], keywords: ['Java', 'Kotlin', 'Spring', 'Kafka', '결제', 'MSA'],
+  status: 'document_passed', score: 88,
+  fit: { summary: '결제·정산 경험과 대규모 트래픽 이력이 요구사항과 강하게 일치합니다.', strengths: ['결제/정산 5년', 'p99 개선 성과', 'Kafka 이벤트 처리'], gaps: ['Kotlin 실무 경험 부족', 'MSA 리딩 제한적'], matched: ['Java', 'Spring', 'Kafka', '결제'], missing: ['Kotlin', 'MSA'] },
+  cover: { title: '토스 백엔드 자기소개서', content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다...(데모)' },
+});
+saveCoverLetterVersion({
+  cover_letter_id: toss.coverLetterId,
+  content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다. 페이테크에서 결제 승인 API의 p99 응답시간을 320ms에서 110ms로 줄이며...(데모 v2)',
+  note: '지원동기와 정량 성과 보강', source: 'edit',
+});
+
+// 지원 완료
+job({
+  company: '카카오페이', position: '백엔드 엔지니어 (정산)', location: '경기 판교', deadline: '2026-07-20',
+  description: '카카오페이 정산 시스템 백엔드 개발자를 찾습니다.',
+  requirements: ['Java/Kotlin', 'MSA', '정산/회계 이해'], keywords: ['Java', 'Kotlin', 'MSA', '정산'],
+  status: 'applied', score: 79,
+  fit: { summary: '정산 경험은 강하나 MSA 전환 리딩 경험 보강이 필요합니다.', strengths: ['정산 도메인 경험', '데이터 정합성'], gaps: ['MSA 리딩', 'Kotlin'], matched: ['Java', '정산'], missing: ['Kotlin', 'MSA'] },
+  cover: { title: '카카오페이 자기소개서', content: '정산의 정확성과 속도를 동시에 끌어올린 경험을 가지고 있습니다...(데모)' },
+});
+
+// 지원 예정
+job({
+  company: '당근', position: '서버 개발자 (커머스)', location: '서울 강남', deadline: '2026-08-01',
+  description: '당근 중고거래/커머스 백엔드 서버 개발자를 찾습니다.',
+  requirements: ['Java/Kotlin 또는 Go', '대용량 트래픽', '커머스 도메인'], keywords: ['Java', 'Go', '대용량', '커머스'],
+  status: 'planned', score: 73,
+  fit: { summary: '대용량 처리 경험은 적합하나 커머스 도메인 노출은 초기 경력에 한정됩니다.', strengths: ['대용량 트래픽', '주문/재고 경험'], gaps: ['최근 커머스 경험', 'Go'], matched: ['Java', '대용량'], missing: ['Go', '커머스'] },
+});
+
+// 보류
+job({
+  company: '라인', position: '백엔드 엔지니어 (Fintech)', location: '서울 영등포', deadline: '2026-08-10',
+  description: 'LINE Fintech 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin', '글로벌 서비스 경험', '금융 도메인'], keywords: ['Java', 'Kotlin', '금융', '글로벌'],
+  status: 'on_hold', score: 70,
+  fit: { summary: '금융 도메인은 적합하나 글로벌 서비스 경험이 부족합니다.', strengths: ['금융/결제 도메인'], gaps: ['글로벌 서비스', 'Kotlin'], matched: ['Java', '금융'], missing: ['글로벌', 'Kotlin'] },
+});
+
+console.log('✅ 마케팅용 데모 데이터를 생성했습니다.');
+console.log(`   위치: ${getDataDir()}`);
+console.log('   공고 6건(최종합격·면접·서류합격·지원·예정·보류) · 적합도 6 · 자기소개서 4 · 면접 준비 1');

package/scripts/shots.ts

@@ -0,0 +1,89 @@
+/**
+ * `shots` — capture real dashboard screenshots for the landing page.
+ *
+ * Starts the local web server against whatever data dir is configured, then uses
+ * Playwright to capture home / applications / jobs in BOTH light and dark themes
+ * into install-page/shots/{screen}-{theme}.png. The landing page embeds these and
+ * swaps light↔dark to match its own theme toggle.
+ *
+ * Run against the throwaway marketing data (see shots-seed.ts):
+ *   CAREERMATE_DATA_DIR=./.shots-data CAREERMATE_NO_OPEN=1 npm run shots
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { chromium } from 'playwright';
+import { startServer } from '../apps/web/src/server.ts';
+import { getDataDir } from '@careermate/db';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const OUT_DIR = path.resolve(__dirname, '../install-page/shots');
+fs.mkdirSync(OUT_DIR, { recursive: true });
+
+const SCREENS = [
+  { name: 'home', hash: '#/home' },
+  { name: 'applications', hash: '#/applications' },
+  { name: 'jobs', hash: '#/jobs' },
+  { name: 'documents', hash: '#/documents' },
+  { name: 'interview', hash: '#/interview' },
+  { name: 'settings', hash: '#/settings' },
+];
+const THEMES = ['light', 'dark'] as const;
+
+// A desktop viewport that fits the home/board content without scrolling; @2x for
+// crisp text on retina/landing-card sizes.
+const VIEWPORT = { width: 1360, height: 940 };
+
+async function main(): Promise<void> {
+  process.env.CAREERMATE_NO_OPEN = '1';
+  const { url } = await startServer(Number(process.env.CAREERMATE_PORT ?? 4337));
+  const expectedDir = getDataDir();
+  console.log(`서버 시작: ${url}  (data: ${expectedDir})`);
+
+  // Safety: never screenshot real career data. Confirm the server we'll capture is
+  // actually serving our throwaway demo dir — not another careermate instance that
+  // grabbed the URL (e.g. a real dashboard on the default port).
+  const health = await fetch(`${url}/api/health`).then((r) => r.json()).catch(() => null) as { data_dir?: string } | null;
+  if (!health || path.resolve(health.data_dir ?? '') !== path.resolve(expectedDir)) {
+    throw new Error(`연결된 서버의 데이터 폴더(${health?.data_dir ?? '?'})가 예상(${expectedDir})과 다릅니다. `
+      + '실제 데이터를 캡처할 위험이 있어 중단합니다. CAREERMATE_DATA_DIR을 빈 throwaway 폴더로 지정하세요.');
+  }
+
+  const browser = await chromium.launch();
+  try {
+    for (const theme of THEMES) {
+      const ctx = await browser.newContext({ viewport: VIEWPORT, deviceScaleFactor: 2 });
+      // The dashboard reads localStorage 'cf-theme' on boot (app.js initTheme).
+      await ctx.addInitScript((t) => {
+        try { window.localStorage.setItem('cf-theme', t as string); } catch { /* ignore */ }
+      }, theme);
+      const page = await ctx.newPage();
+
+      for (const s of SCREENS) {
+        await page.goto(`${url}/${s.hash}`, { waitUntil: 'networkidle' });
+        // wait for the route to render (spinner gone) and webfont to load
+        await page.waitForFunction(() => {
+          const v = document.getElementById('view');
+          const hasSpinner = !!document.querySelector('.spinner');
+          const fontsReady = !document.fonts || document.fonts.status === 'loaded';
+          return !!v && v.childElementCount > 0 && !hasSpinner && fontsReady;
+        }, { timeout: 10_000 }).catch(() => { /* best effort */ });
+        await page.waitForTimeout(450);
+
+        const file = path.join(OUT_DIR, `${s.name}-${theme}.png`);
+        await page.screenshot({ path: file });
+        console.log(`  ✓ ${path.relative(process.cwd(), file)}`);
+      }
+      await ctx.close();
+    }
+  } finally {
+    await browser.close();
+  }
+  console.log('완료. install-page/shots/*.png 생성됨.');
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('스크린샷 캡처 실패:', err instanceof Error ? err.stack : err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -25,5 +25,7 @@
       "@careermate/workflows": ["packages/workflows/src/index.ts"]
     }
   },
-  "include": ["packages/**/*.ts", "apps/**/*.ts", "scripts/**/*.ts"]
+  "include": ["packages/**/*.ts", "apps/**/*.ts", "scripts/**/*.ts"],
+  "//exclude": "scripts/shots*.ts는 Playwright 브라우저 컨텍스트(window/document)·임시 시드용 마케팅 도구라 타입검사 제외(배포물 아님).",
+  "exclude": ["node_modules", "scripts/shots.ts", "scripts/shots-seed.ts"]
 }

package/dist/mcp-smoke.err

@@ -1,3 +0,0 @@
-[careermate-mcp] 연결됨 · 도구 24개 · 데이터: C:\Users\승택\.careermate
-(node:23944) ExperimentalWarning: SQLite is an experimental feature and might change at any time
-(Use `node --trace-warnings ...` to show where the warning was created)

package/dist/mcpb-stage/README.md

@@ -1,219 +0,0 @@
-# CareerMate
-
-**MCP 우선(MCP-first) 로컬 커리어 관리 도구.** ChatGPT·Claude·Gemini 같은 당신의 AI를 인터페이스로 쓰고, CareerMate는 당신의 커리어 데이터를 **이 컴퓨터에만** 저장한 뒤 MCP로 노출합니다.
-
----
-
-## 핵심 철학
-
-- **MCP 우선** — 새 앱 사용법을 익힐 필요가 없습니다. 평소 쓰던 AI(ChatGPT·Claude·Gemini)와 대화하면, 그 AI가 CareerMate의 로컬 MCP 도구를 호출해 당신의 커리어 DB를 읽고 씁니다.
-- **로컬 우선** — 모든 데이터는 당신의 컴퓨터에만 저장됩니다(`~/.careermate`). 외부 서버로 전송하지 않습니다. 대시보드 웹 서버는 `127.0.0.1`(이 컴퓨터)에만 연결됩니다.
-- **LLM 비내장** — CareerMate 안에는 AI가 들어 있지 않습니다. 분석·글쓰기 같은 “생각하는 일”은 **당신의 AI**가 하고, CareerMate는 데이터를 **안전하게 보관·조회**하는 역할만 합니다.
-
-> 쉽게 말해: 당신의 AI가 “두뇌”, CareerMate는 그 두뇌가 꺼내 쓰는 “커리어 서랍장”입니다.
-
----
-
-## 무엇을 하나요?
-
-프로필·이력서·자기소개서·채용공고·지원 현황·면접 준비를 로컬 SQLite에 구조화해 저장하고, AI 어시스턴트가 MCP 도구로 그 데이터를 읽고 씁니다. 전형적인 흐름은 이렇습니다.
-
-1. 프로필·이력서 등록 → 2. 채용공고 저장·파싱 → 3. 적합도(핏) 분석 → 4. 맞춤 자기소개서 작성·버전 관리 → 5. 지원 상태 관리 → 6. 면접 준비
-
-언제든 대시보드를 열어 저장된 데이터를 눈으로 확인할 수 있습니다. 자세한 단계별 런북은 [`docs/START_WORKFLOW.md`](docs/START_WORKFLOW.md)를 참고하세요.
-
----
-
-## 주요 기능
-
-- **AI와 대화로 모든 작업** — MCP 도구 23개로 온보딩·프로필·이력서·자소서·공고·핏 분석·지원 상태·면접 준비까지 처리.
-- **지원 상태 8단계 관리** — `draft`(작성 중) · `planned`(지원 예정) · `applied`(지원 완료) · `document_passed`(서류 합격) · `interview`(면접 진행) · `final_passed`(최종 합격) · `rejected`(불합격) · `on_hold`(보류). `document_passed` 이상에서 면접 준비가 해금됩니다.
-- **자기소개서 버전 관리** — 공고별로 자소서 버전을 쌓고 타임라인으로 비교, 파일로 내보내기.
-- **채용공고 파싱** — 붙여넣은 공고 텍스트를 구조화해 저장.
-- **로컬 대시보드** — 프레임워크·CDN 없는 바닐라 JS로 만든 7페이지 웹 화면(다크모드 지원).
-- **데이터 내보내기/삭제** — Settings 페이지에서 직접.
-
----
-
-## 구성
-
-두 개의 로컬 프로세스가 같은 데이터베이스를 공유합니다.
-
-| 프로세스 | 실행 | 역할 |
-| --- | --- | --- |
-| **대시보드 웹 서버** | `npm start` | `http://127.0.0.1:4319` — 내 데이터를 눈으로 확인·관리. `127.0.0.1`에만 바인딩. |
-| **MCP 서버** | `npm run mcp` | stdio 기반. 보통 AI 클라이언트가 자동 실행. 도구 23개 제공. |
-
----
-
-## 빠른 시작
-
-### 요구사항
-
-- **Node.js >= 22.5.0** — 내장 `node:sqlite`를 사용하므로 컴파일러나 네이티브 빌드가 **필요 없습니다**.
-- 버전 확인:
-  ```bash
-  node --version
-  ```
-  `v22.5.0` 미만이거나 명령을 찾지 못하면 https://nodejs.org 에서 최신 LTS를 설치하세요.
-
-### 1) 설치
-
-빌드 단계가 없습니다. TypeScript는 `tsx`로 바로 실행됩니다.
-
-```bash
-npm install
-```
-
-### 2) 대시보드 실행
-
-```bash
-npm start
-```
-
-- 기본 주소는 `http://127.0.0.1:4319` 이며 브라우저가 자동으로 열립니다.
-- 포트가 사용 중이면 자동으로 다음 빈 포트로 폴백하니, 터미널에 출력된 실제 주소를 확인하세요.
-- 종료는 터미널에서 `Ctrl+C`.
-
-### 3) 데모 데이터로 둘러보기(선택)
-
-빈 화면이 낯설다면 예시 데이터를 넣어 기능을 미리 체험할 수 있습니다.
-
-```bash
-npm run seed
-```
-
-### 4) AI(MCP)에 연결
-
-당신의 AI가 CareerMate를 사용하려면 AI 클라이언트에 MCP 서버를 등록해야 합니다. Claude Desktop·ChatGPT·Cursor 등 클라이언트별 설정과 검증 방법은 **[`docs/INSTALL.md`](docs/INSTALL.md)** 를 따라가세요.
-
----
-
-## 대시보드 7페이지
-
-| 페이지 | 설명 |
-| --- | --- |
-| **Home** | 현재 상태·다음 할 일 한눈에. |
-| **Profile** | 프로필, 경력(experiences), 프로젝트, 스킬 관리. |
-| **Jobs** | 저장한 채용공고 목록과 상세(공고 내용·핏 분석). |
-| **Applications** | 지원 현황을 8단계 상태로 보는 칸반 보드. |
-| **Documents** | 자기소개서 버전 타임라인과 이력서. |
-| **Interview** | 면접 준비 자료(`document_passed` 이상에서 해금). |
-| **Settings** | 데이터 내보내기·삭제, 환경 정보. |
-
-다크모드를 지원합니다.
-
----
-
-## MCP 도구 한눈에 (23개)
-
-| 분류 | 도구 |
-| --- | --- |
-| 온보딩 | `get_onboarding_status` · `start_onboarding` |
-| 프로필 | `save_profile` · `get_profile` · `update_profile` |
-| 이력서 | `add_resume` · `get_resumes` |
-| 자기소개서 | `add_cover_letter` · `get_cover_letters` · `save_cover_letter_version` · `export_cover_letter` |
-| 채용공고 | `save_job_posting` · `get_job_posting` · `list_jobs` · `parse_job_posting` |
-| 핵심 컨텍스트 | **`get_application_context`** (지원에 필요한 맥락을 한 번에 모아줌) |
-| 핏 분석 | `save_fit_analysis` |
-| 지원 상태 | `update_application_status` |
-| 면접 준비 | `save_interview_prep` |
-| 대시보드/활동 | `open_dashboard` · `open_application` · `list_recent_activity` · `get_workflow_guide` |
-
-이 도구들 위에 5종의 워크플로우(`onboarding`, `analyze_job`, `write_cover_letter`, `manage_application_status`, `prepare_interview`)가 정의되어 있어, AI가 단계별로 자연스럽게 안내합니다.
-
----
-
-## 프로젝트 구조
-
-```
-CareerMate/
-├─ apps/
-│  ├─ web/            # 대시보드 + 로컬 API 서버 (npm start)
-│  └─ mcp/            # MCP stdio 서버 (npm run mcp)
-├─ packages/
-│  ├─ shared/         # 공용 타입·zod 스키마·유틸
-│  ├─ db/             # node:sqlite DB 접근·스키마·마이그레이션
-│  ├─ core/           # 도메인 유스케이스
-│  ├─ mcp-tools/      # MCP 도구 23개 정의
-│  ├─ exporters/      # 내보내기(자소서 등)
-│  ├─ parsers/        # 채용공고 파싱
-│  ├─ prompts/        # 프롬프트·안내 문구
-│  └─ workflows/      # 워크플로우 5종
-├─ install-page/      # 설치 안내 페이지
-├─ docs/              # 문서
-├─ scripts/           # migrate / seed / doctor / test 등
-└─ package.json
-```
-
-- **스택**: TypeScript(ESM), 무빌드 실행(`tsx`), 내장 `node:sqlite`(네이티브 컴파일 없음), `zod`, `@modelcontextprotocol/sdk`. 대시보드는 프레임워크·CDN 없는 바닐라 JS + 자체 CSS 디자인 시스템.
-- **데이터 저장소**: 12개 테이블(profile, experiences, projects, skills, documents, cover_letters, cover_letter_versions, jobs, fit_analyses, applications, interview_preps, activities). 두 프로세스(대시보드·MCP)가 **같은 SQLite DB**를 공유합니다.
-
----
-
-## npm 스크립트
-
-| 스크립트 | 설명 |
-| --- | --- |
-| `npm install` | 의존성 설치 (빌드 없음) |
-| `npm start` | 대시보드 웹 서버 실행 |
-| `npm run dev` | 대시보드 실행 (파일 변경 시 자동 재시작) |
-| `npm run mcp` | MCP 서버 실행 (stdio) |
-| `npm run migrate` | DB 생성/업그레이드 |
-| `npm run doctor` | 설치/환경 점검 |
-| `npm run seed` | 예시 데이터 삽입 |
-| `npm test` | E2E 테스트 실행 |
-| `npm run test:ui` | Playwright UI 스모크 테스트 |
-| `npm run typecheck` | 타입 검사 (`tsc --noEmit`) |
-
----
-
-## 데이터 위치 & 환경변수
-
-- 기본 폴더: `~/.careermate` (Windows: `%USERPROFILE%\.careermate`).
-  - `careermate.sqlite` — 데이터베이스 파일
-  - `exports/` — 내보낸 파일
-  - `backups/` — 백업
-  - `uploads/` — 업로드 파일
-  - `server.json` — 실행 중 핸드셰이크 정보
-- 환경변수로 동작을 바꿀 수 있습니다.
-  - `CAREERMATE_DATA_DIR` — 데이터 폴더 위치 변경
-  - `CAREERMATE_PORT` — 대시보드 포트 고정
-  - `CAREERMATE_NO_OPEN` — 시작 시 브라우저 자동 열기 끄기
-
----
-
-## 보안 / 프라이버시
-
-- **로컬 전용 바인딩** — 대시보드 서버는 `127.0.0.1`(loopback)에만 바인딩되어 외부에서 접근할 수 없습니다.
-- **DNS 리바인딩 차단** — Host 허용목록으로 검증.
-- **변경 요청 보호** — CSRF 세션 토큰(HTML `meta`로 주입), 외부 Origin 차단.
-- **정적 파일 보호** — 경로 traversal(상위 폴더 탈출) 차단.
-- **본문 크기 제한** — 요청 본문 8MB 제한.
-- **민감 정보 비노출** — 이력서·자기소개서 본문은 로그나 에러 응답에 노출되지 않습니다.
-- **외부 전송 없음** — MCP 서버는 네트워크 호출을 하지 않으며, 모든 데이터는 당신의 컴퓨터에만 남습니다. 내보내기·삭제는 대시보드 **Settings**에서 직접 할 수 있습니다.
-
----
-
-## 문서
-
-- [`docs/INSTALL.md`](docs/INSTALL.md) — 설치 및 AI 클라이언트(MCP) 연결 가이드.
-- [`docs/START_WORKFLOW.md`](docs/START_WORKFLOW.md) — 등록부터 면접 준비까지 단계별 작업 런북.
-
----
-
-## 테스트
-
-```bash
-npm test        # E2E 테스트 (보안·업무흐름·MCP stdio·대시보드↔MCP 동일 DB 양방향)
-npm run test:ui # 대시보드 페이지 렌더 스모크 (Playwright)
-npm run typecheck
-```
-
-기타 유용한 스크립트: `npm run migrate`(DB 생성/업그레이드), `npm run seed`(예시 데이터), `npm run doctor`(설치·환경 점검).
-
----
-
-## 라이선스
-
-MIT.