careermate 0.1.0

package/scripts/seed.ts

@@ -0,0 +1,129 @@
+/**
+ * `npm run seed` — populate the database with realistic demo data so a new user
+ * (or the demo walkthrough) immediately sees a populated dashboard. Refuses to
+ * run if real data already exists, unless `--force` is passed. Tip: seed into a
+ * throwaway location with `CAREERMATE_DATA_DIR=./demo-data npm run seed`.
+ */
+import {
+  profileRepo, experienceRepo, projectRepo, skillRepo, documentRepo, getDataDir,
+} from '@careermate/db';
+import {
+  saveProfile, saveJobPosting, saveFitAnalysis, saveCoverLetterVersion,
+  updateApplicationStatus, saveInterviewPrep, addResume,
+} from '@careermate/core';
+
+const force = process.argv.includes('--force');
+
+function main(): void {
+  if (profileRepo.get()?.name && !force) {
+    console.log('⚠️  이미 프로필 데이터가 있습니다. 데모 데이터를 덮어쓰지 않습니다.');
+    console.log('   별도 폴더에 넣으려면:  CAREERMATE_DATA_DIR=./demo-data npm run seed');
+    console.log('   그래도 진행하려면:     npm run seed -- --force');
+    process.exit(0);
+  }
+
+  saveProfile({
+    name: '이서연',
+    email: 'seoyeon.lee@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조 무중단 처리`,
+  });
+
+  // A job with full analysis + cover letter + status + interview prep
+  const { job } = saveJobPosting({
+    company: '토스', position: '백엔드 엔지니어 (결제)',
+    url: 'https://example.com/toss/backend', location: '서울 강남', employment_type: '정규직',
+    description: '토스 결제 시스템의 안정성과 확장성을 책임질 백엔드 엔지니어를 찾습니다. 대규모 트래픽 환경에서의 결제/정산 경험을 우대합니다.',
+    requirements: ['Java/Kotlin 백엔드 개발 경험', '대규모 트래픽 처리 경험', '결제/정산 도메인 이해'],
+    keywords: ['Java', 'Kotlin', 'Spring', 'Kafka', '결제', 'MSA'], deadline: '2026-07-15', source: '데모',
+  });
+  saveFitAnalysis({
+    job_id: job.id, score: 88,
+    summary: '결제·정산 도메인 경험과 대규모 트래픽 처리 이력이 공고 요구사항과 강하게 일치합니다. Kotlin 경험만 보완하면 최상위 적합도입니다.',
+    strengths: ['결제/정산 도메인 5년 경험', '대규모 트래픽 안정화 성과(p99 개선)', 'Kafka 기반 이벤트 처리 경험'],
+    gaps: ['Kotlin 실무 경험 부족(Java는 능숙)', 'MSA 전환 리딩 경험은 제한적'],
+    matched_keywords: ['Java', 'Spring', 'Kafka', '결제'], missing_keywords: ['Kotlin', 'MSA'],
+    recommendations: ['지원동기에 결제 도메인 애정과 정합성 경험을 구체 수치로 강조', 'Kotlin은 학습 의지+Java 전이 가능성으로 보완'],
+  });
+  const { coverLetter } = saveCoverLetterVersion({
+    job_id: job.id, title: '토스 백엔드 자기소개서',
+    content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다...(데모 자기소개서 v1)', note: '초안', source: 'ai',
+  });
+  saveCoverLetterVersion({
+    cover_letter_id: coverLetter.id,
+    content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다. 페이테크에서 결제 승인 API의 p99 응답시간을 320ms에서 110ms로 줄이며...(데모 자기소개서 v2 — 지원동기·성과 보강)',
+    note: '지원동기와 정량 성과 보강', source: 'edit',
+  });
+  updateApplicationStatus(job.id, 'document_passed', '데모: 서류 합격 처리');
+  saveInterviewPrep({
+    job_id: job.id,
+    questions: [
+      { question: '결제 승인 API 응답시간을 어떻게 개선했나요?', intent: '성능 개선의 깊이와 접근법 확인', followups: ['병목은 어떻게 찾았나요?', '트레이드오프는 없었나요?'], answer_outline: '프로파일링으로 DB 커넥션 풀 병목 발견 → 캐시 계층 도입 → 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: '결제 도메인 질문에 집중 예상. 정량 수치 암기.',
+  });
+
+  console.log('✅ 데모 데이터를 생성했습니다.');
+  console.log(`   위치: ${getDataDir()}`);
+  console.log(`   프로필 1 · 경력 ${experienceRepo.list().length} · 프로젝트 ${projectRepo.list().length} · 기술 ${skillRepo.list().length} · 문서 ${documentRepo.list().length}`);
+  console.log('   공고 1(토스, 적합도 88, 서류 합격) · 자기소개서 1(2버전) · 면접 준비 1');
+  console.log('\n   `npm start` 로 대시보드를 열어 확인하세요.');
+}
+
+main();

package/scripts/test.ts

@@ -0,0 +1,117 @@
+/**
+ * `npm test` — end-to-end smoke test of the whole system in one run:
+ *   1. core + DB use-cases
+ *   2. HTTP API + security gate (CSRF token, Host allow-list, cross-origin)
+ *   3. MCP stdio server with a real MCP client (via a spawnSync probe)
+ *   4. THE key invariant: the dashboard (API) and the MCP server (separate
+ *      process) read & write the SAME local database.
+ *
+ * Run it through the plain-Node runner: `npm test` (→ scripts/run.mjs), which
+ * reads the TEST_VERDICT line below. HTTP calls use node:http with agent:false
+ * (no keep-alive pooling) because the spawnSync probe blocks the event loop,
+ * which would otherwise leave a stale pooled socket → ECONNRESET.
+ *
+ * Runs entirely against a throwaway data directory; never touches real data.
+ */
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import net from 'node:net';
+import http from 'node:http';
+import { spawnSync } from 'node:child_process';
+
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'cf-e2e-'));
+process.env.CAREERMATE_DATA_DIR = tmp;
+process.env.CAREERMATE_NO_OPEN = '1';
+
+const { startServer } = await import('../apps/web/src/server.ts');
+const { SESSION_TOKEN } = await import('../apps/web/src/security.ts');
+const here = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1'));
+
+let pass = 0;
+let fail = 0;
+const ok = (name: string, cond: boolean, extra = '') => {
+  if (cond) { pass++; console.log(`  ✅ ${name}`); }
+  else { fail++; console.log(`  ❌ ${name} ${extra}`); }
+};
+const section = (s: string) => console.log(`\n${s}`);
+
+const { port, server } = await startServer(46070);
+const ORIGIN = `127.0.0.1:${port}`;
+
+/** Fresh-socket HTTP (no keep-alive) so a blocking spawnSync can't stale a pool. */
+function reqRaw(method: string, p: string, body?: unknown, headers: Record<string, string> = {}): Promise<{ status: number; text: string; headers: http.IncomingHttpHeaders }> {
+  return new Promise((resolve, reject) => {
+    const payload = body !== undefined ? JSON.stringify(body) : undefined;
+    const r = http.request(
+      { host: '127.0.0.1', port, path: p, method, agent: false, headers: { 'content-type': 'application/json', ...headers } },
+      (res) => { let d = ''; res.on('data', (c) => (d += c)); res.on('end', () => resolve({ status: res.statusCode!, text: d, headers: res.headers })); },
+    );
+    r.on('error', reject);
+    if (payload) r.write(payload);
+    r.end();
+  });
+}
+const authed = (m: string, p: string, b?: unknown) => reqRaw(m, p, b, { 'x-careermate-token': SESSION_TOKEN });
+const json = async (m: string, p: string, b?: unknown, h?: Record<string, string>) => JSON.parse((await reqRaw(m, p, b, h)).text);
+
+/* ---------------------------------------------------------- 1. API + security */
+section('1) HTTP API + 보안');
+ok('헬스 체크', (await json('GET', '/api/health')).ok === true);
+ok('토큰 없는 변경요청 차단(CSRF)', (await reqRaw('PUT', '/api/profile', {})).status === 403);
+ok('외부 Origin 차단', (await reqRaw('GET', '/api/health', undefined, { origin: 'https://attacker.example' })).status === 403);
+
+const spoof = await new Promise<string>((res) => {
+  const s = net.connect(port, '127.0.0.1', () => s.write(`GET /api/health HTTP/1.1\r\nHost: attacker.example\r\nConnection: close\r\n\r\n`));
+  let b = ''; s.on('data', (d) => (b += d)); s.on('end', () => res(b.split('\r\n')[0]!));
+});
+ok('Host 스푸핑 차단(DNS 리바인딩)', spoof.includes('403'));
+ok('zod 입력검증', (await authed('POST', '/api/jobs', { company: '' })).status === 400);
+
+/* ------------------------------------------------------------- 2. API 업무 흐름 */
+section('2) 대시보드 업무 흐름 (API)');
+await authed('PUT', '/api/profile', { name: '김커리어', desired_roles: ['백엔드'], preferred_tone: '담백' });
+ok('프로필 저장/조회', (await json('GET', '/api/profile')).profile.name === '김커리어');
+ok('온보딩 상태 반영', (await json('GET', '/api/onboarding')).has_profile === true);
+
+const apiJob = (await json('POST', '/api/jobs', { company: '라인', position: '서버 개발자', keywords: ['Java'] }, { 'x-careermate-token': SESSION_TOKEN })).job;
+await authed('PUT', `/api/jobs/${apiJob.id}/fit`, { score: 77, strengths: ['s'] });
+const statusRes = await json('PUT', `/api/applications/${apiJob.id}/status`, { status: 'document_passed' }, { 'x-careermate-token': SESSION_TOKEN });
+ok('상태 변경 + 면접 힌트', statusRes.application.status === 'document_passed' && !!statusRes.hint);
+const ctx = await json('GET', `/api/context?job_id=${apiJob.id}`);
+ok('get_application_context 집계', ctx.job?.id === apiJob.id && ctx.fit_analysis?.score === 77 && ctx.writing_preferences.preferred_tone === '담백');
+const cl = (await json('POST', '/api/cover-letters', { title: '라인 자소서', job_id: apiJob.id, content: 'v1' }, { 'x-careermate-token': SESSION_TOKEN })).cover_letter;
+await authed('POST', `/api/cover-letters/${cl.id}/versions`, { content: 'v2', note: '보강' });
+ok('자소서 버전 관리', (await json('GET', `/api/cover-letters/${cl.id}`)).cover_letter.version_count === 2);
+const exp = await reqRaw('GET', `/api/export/cover-letter/${cl.id}?format=md`);
+ok('자소서 내보내기(MD)', String(exp.headers['content-disposition'] || '').includes('attachment'));
+
+/* ------------------------------------------------- 3 & 4. MCP + DB 공유 불변식 */
+section('3) MCP 서버 (stdio) + 4) 핵심 불변식: 대시보드 ↔ MCP 동일 DB');
+await authed('PUT', '/api/profile', { headline: 'API가 추가한 한 줄' });
+
+// Run the MCP stdio session as a fully-reaped child; read its verdict from stdout.
+const probe = spawnSync(process.execPath, ['--no-warnings', '--import', 'tsx', path.join(here, 'mcp-probe.ts')], {
+  cwd: path.resolve(here, '..'),
+  env: { ...process.env },
+  encoding: 'utf8',
+  timeout: 60000,
+});
+const probeLine = (probe.stdout || '').split('\n').find((l) => l.startsWith('RESULT '));
+const pr = probeLine ? JSON.parse(probeLine.slice('RESULT '.length)) : { ok: false, error: probe.stderr?.slice(0, 200) };
+
+ok('MCP 서버 연결 + 도구 20개 이상 노출', pr.ok === true && pr.toolCount >= 20, `(${pr.toolCount ?? 0})`);
+ok('get_application_context 존재', pr.hasContext === true);
+ok('MCP가 API가 쓴 프로필 이름을 읽음 (DB 공유 ←)', pr.profileName === '김커리어');
+ok('MCP가 API의 수정(한 줄 소개)을 즉시 봄 (←)', pr.profileHeadline === 'API가 추가한 한 줄');
+ok('MCP save_job_posting', !!pr.jobId);
+ok('대시보드(API)가 MCP가 저장한 공고를 봄 (→)', (await json('GET', '/api/jobs')).jobs.some((j: any) => j.id === pr.jobId));
+
+console.log(`\n${'='.repeat(40)}`);
+console.log(`결과: ${pass} 통과 · ${fail} 실패`);
+console.log(fail === 0 ? '✅ 전체 통과' : '❌ 실패 있음');
+console.log(fail === 0 ? 'TEST_VERDICT PASS' : `TEST_VERDICT FAIL ${fail}`);
+
+await new Promise<void>((r) => server.close(() => r()));
+try { fs.rmSync(tmp, { recursive: true, force: true }); } catch { /* ignore */ }
+process.exit(fail === 0 ? 0 : 1);

package/scripts/ui-smoke.ts

@@ -0,0 +1,73 @@
+/**
+ * `npm run test:ui` — render every dashboard page in a real browser and assert
+ * it mounts with no console/page errors. Optional: requires Playwright + a
+ * Chromium build (`npm i -D playwright && npx playwright install chromium`).
+ *
+ * Uses a throwaway data directory so it never touches the user's real data.
+ */
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'cf-uismoke-'));
+process.env.CAREERMATE_DATA_DIR = tmp;
+process.env.CAREERMATE_NO_OPEN = '1';
+
+const { startServer } = await import('../apps/web/src/server.ts');
+const { saveProfile, saveJobPosting, saveFitAnalysis, saveCoverLetterVersion, updateApplicationStatus, saveInterviewPrep } =
+  await import('@careermate/core');
+
+// minimal data so every page has something to render
+saveProfile({ name: '테스트', desired_roles: ['개발자'], preferred_tone: '담백하게' });
+const { job } = saveJobPosting({ company: '테스트회사', position: '개발자', keywords: ['JS'] });
+saveFitAnalysis({ job_id: job.id, score: 80, strengths: ['강점'], gaps: ['보완'] });
+saveCoverLetterVersion({ job_id: job.id, title: '자소서', content: '내용 v1', note: '초안' });
+updateApplicationStatus(job.id, 'document_passed');
+saveInterviewPrep({ job_id: job.id, questions: [{ question: '질문?' }], self_introduction: '소개' });
+
+let chromium: any;
+try {
+  ({ chromium } = await import('playwright'));
+} catch {
+  console.log('⚠️  Playwright가 설치되어 있지 않습니다. 건너뜁니다.');
+  console.log('    설치: npm i -D playwright && npx playwright install chromium');
+  process.exit(0);
+}
+
+const { port, server } = await startServer(46050);
+const base = `http://127.0.0.1:${port}`;
+const browser = await chromium.launch();
+const page = await browser.newPage({ viewport: { width: 1440, height: 900 } });
+
+const errors: string[] = [];
+let route = '';
+page.on('console', (m: any) => { if (m.type() === 'error') errors.push(`[${route}] ${m.text()}`); });
+page.on('pageerror', (e: any) => errors.push(`[${route}] PAGEERROR ${e.message}`));
+
+const routes: [string, string][] = [
+  ['home', '#/'], ['profile', '#/profile'], ['jobs', '#/jobs'], ['job-detail', `#/jobs/${job.id}`],
+  ['applications', '#/applications'], ['documents', '#/documents'], ['interview', '#/interview'], ['settings', '#/settings'],
+];
+
+let failures = 0;
+for (const [name, hash] of routes) {
+  route = name;
+  await page.goto(base + '/' + hash, { waitUntil: 'networkidle' });
+  await page.waitForTimeout(400);
+  const mounted = await page.$eval('#view', (node: any) => node.children.length > 0).catch(() => false);
+  const ok = mounted;
+  if (!ok) failures++;
+  console.log(`  ${ok ? '✅' : '❌'} ${name.padEnd(13)} mounted=${mounted}`);
+}
+
+if (errors.length) { console.log('\n콘솔/페이지 오류:'); errors.forEach((e) => console.log('  ' + e)); }
+failures += errors.length;
+console.log(`\n${failures === 0 ? '✅ UI 스모크 테스트 통과' : `❌ 실패 ${failures}건`}`);
+console.log(failures === 0 ? 'UI_VERDICT PASS' : `UI_VERDICT FAIL ${failures}`);
+
+await browser.close();
+await new Promise((r) => setTimeout(r, 200));
+await new Promise<void>((r) => server.close(() => r()));
+try { fs.rmSync(tmp, { recursive: true, force: true }); } catch { /* ignore */ }
+process.exitCode = failures === 0 ? 0 : 1;
+setTimeout(() => process.exit(process.exitCode), 1500).unref();

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2023"],
+    "types": ["node"],
+    "strict": true,
+    "noUncheckedIndexedAccess": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": {
+      "@careermate/shared": ["packages/shared/src/index.ts"],
+      "@careermate/db": ["packages/db/src/index.ts"],
+      "@careermate/core": ["packages/core/src/index.ts"],
+      "@careermate/mcp-tools": ["packages/mcp-tools/src/index.ts"],
+      "@careermate/exporters": ["packages/exporters/src/index.ts"],
+      "@careermate/parsers": ["packages/parsers/src/index.ts"],
+      "@careermate/prompts": ["packages/prompts/src/index.ts"],
+      "@careermate/workflows": ["packages/workflows/src/index.ts"]
+    }
+  },
+  "include": ["packages/**/*.ts", "apps/**/*.ts", "scripts/**/*.ts"]
+}