-
Notifications
You must be signed in to change notification settings - Fork 0
Home
hywznn edited this page Jul 23, 2026
·
8 revisions
FOWOCO Server는 AI 모델을 실행하는 저장소가 아니라, AI의 제안을 실제 HR 업무로 안전하게 연결하는 운영 서버입니다.
이 서버가 보장해야 하는 핵심은 다음 네 가지입니다.
- 사업장과 권한이 다른 사용자의 데이터를 섞지 않습니다.
- AI 결과를 바로 발송하지 않고 HR 검토·승인을 거칩니다.
- 업무카드의 상태, 증빙, 외부기관 제출 여부를 DB에 남깁니다.
- 생성·수정·승인·전달·완료의 주체와 시간을 감사 기록으로 남깁니다.
| 하려는 일 | 작업할 저장소 | 쉬운 판단 기준 |
|---|---|---|
| 로그인, 근로자, 문서, 업무카드, 승인, Worker Link, 감사 | fowoco/server |
실제 HR 업무 데이터와 상태를 바꾸는가? |
| Prompt, Agent Pipeline, 모델 선택, Provider 호출, 응답 1차 파싱 | fowoco/ai |
모델에게 무엇을 묻고 어떻게 결과를 만드는가? |
| Context Pack, Workflow Catalog, Intent, 용어·정책 근거 | fowoco/knowledge |
AI와 업무 규칙이 참고할 검증된 지식인가? |
| 화면, 입력 모달, 진행상태 표시, API 호출 UX | fowoco/client |
사용자가 보는 화면과 상호작용인가? |
| 통합 배포, 네트워크, Secret, 모니터링 기반 | fowoco/infra |
여러 서비스를 함께 실행하는 환경인가? |
경계가 모호하면 먼저 저장소 경계와 계약을 확인합니다.
flowchart LR
C["React Client"] -->|External API| S["Spring Boot Server"]
S --> DB["PostgreSQL"]
S --> FS["FileStorage"]
S -->|Internal API| A["AI Runtime"]
K["Pinned Knowledge Bundle"] --> A
K -. "Workflow projection" .-> S
A --> P["External LLM / Cloud Endpoint"]
S --> W["만료되는 Worker Link"]
Knowledge는 운영 중 임의로 조회하는 지식 서비스가 아니라, 버전이 고정된 배포 산출물입니다. Server는 AI Runtime을 호출하며 OpenAI·Gemini·LM Studio 같은 Provider를 직접 호출하지 않습니다.
HR 자연어 입력
→ Server가 AiRun을 DB에 저장
→ AI Runtime이 후보를 반환
→ Server가 계약과 업무 핵심값을 다시 검증
→ HR이 사용할 후보만 확정
→ HR 승인
→ Worker Link로 전달
→ 응답·증빙 확인
→ 완료 및 감사 기록
AI Run의 성공은 업무 승인이나 발송을 뜻하지 않습니다. AI는 후보를 제안하고, Server가 권한·상태·승인·증빙을 강제합니다.
- 실제 구현된 Server External API의 최종 기준은 Server의 Swagger/OpenAPI입니다.
- Server↔AI Runtime 내부 계약의 기준은
fowoco/ai가 배포하는 Internal OpenAPI와 Structured Output Schema입니다. - 업무 의미와 규칙의 기준은
fowoco/knowledge가 배포하는 versioned bundle입니다. - Wiki와 Notion에 API 개수를 손으로 중복 기록하지 않습니다. 구현 수량은 OpenAPI에서 계산합니다.
2026-07-23 기준
main에는 Health와 Auth·Company가 구현돼 있습니다. Approval·Audit 8개 API와 Task core는 PR #37, Workflow Catalog·Task·Checklist 7개 API는 stacked PR #39에서 리뷰 중입니다. 병합 전에는 계획·PR의 API를 현재main동작으로 오해하지 말고 Swagger와 PR 상태를 함께 확인하세요.