🧮 고급 물리 문제 스튜디오 · Physics Problem Studio

주제·난이도·출제 스타일을 고르면, AI가 풀이·힌트·검산이 함께 있는 새로운 심화 물리 문제를 만들어 주는 작은 웹 앱입니다. 해석역학, 전자기학, 상대론 등 대학·올림피아드 수준 주제를 지원합니다.

모델은 문제를 직접 풀어 차원·극한·특수값으로 검산한 뒤 풀이를 적도록 유도되며, 모든 수식은 LaTeX로 출력되어 브라우저에서 MathJax로 렌더링됩니다.

⚠️ 문제와 풀이는 AI가 생성합니다. 시험·제출 전에는 반드시 직접 검산하세요.

---

특징

• 새로운 문제 생성 — 교과서 예제 복사가 아니라 주제에서 자연스럽게 나오는 독창적인 상황을 만듭니다.
• 풀이 · 힌트 · 검산 · 흔한 오답 — 각 문제마다 단계별 풀이, 단계적 힌트, 검산, 자주 틀리는 지점을 함께 제공합니다.
• 5가지 출제 스타일 — 세트형 계산, 증명·유도, 올림피아드 심화, 개념확인, 오류진단·모델링.
• LaTeX 렌더링 — MathJax로 그리스문자·첨자·분수·적분을 정확히 표시합니다.
• 마크다운 내보내기 — 생성 결과를 복사하거나 .md 파일로 저장합니다.
• 의존성 최소 — Express + Anthropic SDK뿐. 로그인·DB·결제 없음. API 키 하나면 실행됩니다.

빠른 시작

git clone https://github.com/fakeminjun7321/physics-problem-studio.git
cd physics-problem-studio
npm install

cp .env.example .env      # .env 를 열어 ANTHROPIC_API_KEY 를 채웁니다
npm start                 # http://localhost:3000

브라우저에서 http://localhost:3000 을 열고, 주제를 입력한 뒤 문제 생성을 누르면 됩니다.

Anthropic API 키는 console.anthropic.com 에서 발급받습니다.

동작 방식

public/index.html   폼 + 결과 렌더링(MathJax). 단일 페이지, 외부 자산 없음.
server.js           Express 서버 — /api/config 와 /api/generate 두 개의 엔드포인트.
lib/physics.js      출제 프롬프트 + 입력 검증 + 출력 정규화(문제 스펙).
lib/studio-core.js  모델 호출 + LaTeX-in-JSON 복구 파서.
lib/json-sanitize.js  문자열 안의 raw 제어문자 escape 복구.

1. 프론트엔드가 주제·난이도·스타일을 POST /api/generate 로 보냅니다.
2. 서버가 시스템 프롬프트를 구성해 Claude 를 호출합니다.
3. Claude 가 JSON 객체 하나를 반환합니다.
4. LaTeX 를 포함한 JSON 을 견고하게 파싱합니다 — 모델이 문자열 안에 \theta 같은 단일 백슬래시나 raw 제어문자를 넣어 깨지는 경우를 자동 복구합니다.
5. 스키마대로 정규화한 결과를 돌려주고, 프론트엔드가 렌더링합니다.

설정

환경 변수	필수	설명
ANTHROPIC_API_KEY	✅	Anthropic API 키. 없으면 생성이 503 을 반환합니다.
PORT		서버 포트 (기본 3000).

사용 모델은 lib/studio-core.js 의 STUDIO_MODELS 에서 바꿀 수 있습니다 (기본: Claude Opus 4.8 / Sonnet 5 / Haiku 4.5).

배포

일반 Node 웹 서비스이므로 어디서든 배포됩니다. 시작 명령은 npm start, PORT 는 호스트가 주입하는 값을 쓰며, ANTHROPIC_API_KEY 를 환경 변수로 설정하면 됩니다. .env 는 커밋하지 마세요 (.gitignore 에 이미 제외되어 있습니다).

라이선스

MIT