Home

FOWOCO AI Wiki

FOWOCO AI는 E-9 외국인근로자 고용 업무를 지원하는 FastAPI 기반 Agent Runtime입니다. 자연어 업무 분석, Renewal Workflow, 다국어 안내, CLOVA OCR, HWP/HWPX 문서 생성을 담당합니다.

이 Wiki는 2026-08-16 기준 fowoco/ai의 실제 코드와 테스트를 요약합니다. 법률 판단이나 정부기관 자동 제출을 수행하는 시스템이 아닙니다.

빠른 시작

• 아키텍처와 역할 경계
• API와 저장소 간 계약
• 구현 상태와 브랜치 차이
• 로컬 실행과 운영
• 테스트와 품질 기준
• Issue·PR·Label 운영 규칙

Source of Truth

충돌이 있을 때 다음 순서로 판단합니다.

1. 대상 브랜치의 실행 코드와 계약 테스트
2. 저장소의 계약 문서와 OpenAPI
3. 이 Wiki
4. Issue·PR 본문의 계획

주요 원문:

• README
• Analyses 계약
• Renewal Workflow 계약
• CLOVA OCR 계약
• Language Assistant 운영 문서

현재 브랜치 주의사항

main과 develop이 단순 선후 관계가 아니라 서로 갈라져 있습니다.

기준	2026-08-16 상태
main	기본·배포 브랜치. 배포 이미지와 최근 Docker/rollout 수정 포함
develop	Supervisor–Worker 리팩터링과 AI #44의 안내 fail-closed 포함
주의	develop을 그대로 main에 덮어쓰면 main 전용 배포 수정이 손실될 수 있음

병합 전에는 반드시 양방향 차이를 확인하고 통합 PR에서 회귀 테스트를 수행합니다.

역할 한 줄 요약

Knowledge: 업무 기준과 canonical ID
Server: DB 원본·Case/Task·승인·인증·파일 영속화
AI: Intent·Slot·Workflow 판단·안내·OCR·문서 생성
Client: HR 검토·선택·승인·근로자 화면

AI는 Server DB를 직접 조회하거나 Worker 원본 데이터를 확정하지 않습니다. 민감정보 저장, tenant 권한, 멱등성, 최종 승인과 발송은 Server가 담당합니다.