CareerWeb Backend (FastAPI)

Quickstart

1. Create a virtualenv and install dependencies:

   • python -m venv .venv
   • source .venv/bin/activate
   • pip install -r requirements.txt

2. Run the server:

   • uvicorn app.main:app --reload

API

• POST /api/job-postings
  • Request: { "url": "...", "title": "...", "body": "..." }
  • Response:
    • { "status": "queued", "jobId": 123 }
    • { "status": "duplicate", "existingId": 123 }
• GET /api/job-postings
  • Response list items:
    • { id, companyName, title, postedAt, url, notionUrl, atsScore }
• POST /api/job-postings/{id}/ats
  • Response: { status: "completed", jobId }

Environment Variables

• NOTION_TOKEN: Notion API 토큰
• NOTION_DATABASE_ID: Notion DB ID
• RESUME_NOTION_URL: ATS 분석에 사용할 이력서 Notion 페이지 URL
• GEMINI_API_KEY: Gemini API 키 (Google AI Studio)
• GEMINI_MODEL: Gemini 모델 (기본 gemini-1.5-flash)

.env 사용

• .env.example을 복사해 .env로 만들고 값을 채우세요.
• python-dotenv가 자동으로 로드합니다.