Home

Jump to bottom

hywznn edited this page Jul 21, 2026 · 8 revisions

FOWOCO Server Wiki

FOWOCO 서버는외국인근로자를 고용한 사업장의 HR·총무 업무를 안전한 Workflow로 운영하는 Spring Boot 백엔드입니다.

AI는 판단자가 아니라 보조자입니다. 모든 AI 결과는 서버의 권한·상태·승인·증빙·감사 규칙 안에서만 사용합니다.

처음 왔다면

MVP 로드맵에서 지금 만들 기능과 순서를 확인합니다.
API 카탈로그에서 42개 API와 담당 Issue를 찾습니다.
백엔드 아키텍처에서 각 구성요소의 책임을 확인합니다.
로컬 개발 가이드로 서버를 실행합니다.
작업할 GitHub Issue를 선택하고 완료 조건을 읽습니다.
질문·아이디어·설계 비교는 Discussions에 먼저 남깁니다.
데모 전에는 데모 배포 가이드와 GitHub 협업 가이드를 확인합니다.

현재 구현 상태

2026-07-21 기준 API 카탈로그는 42개입니다. GET /health 1개가 구현됐고 41개는 계획 상태입니다. 계획과 구현을 혼동하지 않도록 현재 동작은 코드와 Swagger/OpenAPI를 우선 확인합니다.

핵심 링크

MVP 대표 흐름

HR 로그인 → 근로자 등록 → 자연어 분석 → 업무카드 후보 → HR 승인 → 근로자 보안 링크 → 근로자 응답 → 완료 → 감사 로그

대표 입력:

응웬반A 체류연장 준비하고 여권 사본도 요청해줘

기대 결과는 체류연장과 여권 사본 요청 업무카드 후보 2개입니다. HR이 승인하기 전에는 근로자에게 전달되지 않습니다.

문서 목록

변하지 않는 원칙

사업장 데이터는 company_id로 격리합니다.
근로자는 로그인하지 않고 만료되는 보안 링크만 사용합니다.
민감정보를 AI에 보내지 않습니다.
AI 결과는 자동 발송하지 않습니다.
허용된 Workflow 상태 전이만 수행합니다.
모든 중요한 행동과 AI 버전을 기록합니다.
최종 데모는 외부 LLM API 또는 클라우드 Endpoint를 사용합니다.

FOWOCO Server Wiki · 저장소 · 저장소 경계 · API 안내 · Roadmap

문서와 구현이 다르면 현재 동작은 Server Swagger/OpenAPI를 우선하고, 차이는 Issue로 남깁니다.