[AI Run] 자연어 요청과 추가 질문 화면 연동

[hywznn]

왜 필요한가요?

업무 생성 화면은 자연어 입력 UI가 있지만 기존에는 정적 검토 화면으로 이동할 뿐 Server에 분석을 요청하지 않았습니다.

Refs #229
Depends on fowoco/server#82
Depends on fowoco/ai#6

무엇이 바뀌나요?

• POST /api/v1/ai-runs로 사용자가 입력한 발화문 원문을 전송합니다.
• 빠른 선택 버튼은 예시 문구를 입력창에 채우기만 하며 Client에서 Intent 코드를 붙이지 않습니다.
• 사용자가 예시 문구를 수정하면 수정된 문장을 그대로 Server에 전달하고, AI가 detectedIntent를 판단합니다.
• 같은 클릭의 중복 생성을 막기 위해 Idempotency-Key를 전달합니다.
• NEEDS_INFO 질문을 표시하고 /answers로 답변합니다.
• REVIEW_REQUIRED 후보와 Runtime 실패 상태를 표시합니다.
• QUEUED/RUNNING 상태는 GET API로 다시 조회합니다.
• 검토 URL에 aiRunId를 보존해 새로고침 후에도 서버에서 실행 상태를 복구합니다.
• 기존 직접 업무 생성 화면과 정적 검토 fallback은 유지합니다.
• 로컬 Vite의 /api 요청을 127.0.0.1:8080으로 연결합니다.

확인 방법

• npm test: 66 files, 347 tests passed
• npm run build: success
• npm run lint: success

실제 브라우저 검증

• 데모 계정 로그인 → 업무 생성 → 체류연장 원문 → AiRun 요청까지 확인했습니다.
• Server CORS 수정 후 /tasks/new/review?aiRunId=...로 이동하고 Runtime 오류 상태를 표시했습니다.
• 실제 AI Runtime 성공 결과는 AI [Screen] HR 대시보드 #6 반영 후 마지막으로 다시 확인합니다.

병합 전 확인

• Server PR #82의 API 계약 확정
• AI [Screen] HR 대시보드 #6 Runtime smoke test 통과
• 대표 발화문 → 질문 → 답변 → 후보 화면 수동 확인

현재 Server와 AI의 선행 작업이 남아 있어 Draft로 유지합니다.

[BcKmini]

• CreateWorkPage.tsx의 intentHint -> 예시 태그(체류연장 준비 등)를 클릭하면 intentHint가 세팅되는데, 그 뒤에 텍스트를 완전히 다른 내용으로 고쳐 써도 예전 힌트가 그대로 남아있음.

• instructionWithHint가 이 stale한 힌트를 계속 붙여서 보내게 됨 -> 힌트가 판정값이 아니라곤 하지만, 텍스트를 수동으로 편집하면 힌트를 초기화하는 게 안전할 것 같음

[hywznn]

힌트는 사실

발화문 = "발화문" + 태그 

인 구조고 필요 없다고 봐도될것 같습니다 intent의 힘을 빌려야죠 거기선

[BcKmini]

확인했습니다. AI Run 자연어 요청·질문·후보 검토 흐름은 이미 develop 통합을 거쳐 main에 병합됐습니다(#296). 이 PR의 base가 8/4 시점 main이라 지금 main 기준으로는 내용이 이미 흡수되어 있어 보입니다 — 별문제 없고, 정리 차원에서 닫아도 괜찮을 것 같습니다.