금요일까지 우수제품 규격서(HWPX) 한 건이 업로드 → 자동 파싱 → 비교 화면에 최적 배치되는 골든 패스를 완성합니다. 백엔드와 추출 엔진은 이미 동작 — 프론트엔드 통합 작업이 핵심입니다.
| Repo | 사용할 브랜치 | 역할 |
|---|---|---|
| pps-mono-repo | feat/onprem-h100-deploy | 우수제품 frontend + BFF (이번주 작업 코드 전부 여기) |
| hwpx-intelligence | main | HWPX 추출 엔진 (별도 repo · 수정 불필요) |
| 영역 | 핵심 컴포넌트 / 역할 |
|---|---|
| 진입점 | LandingClient (메인 / 평가 시작 CTA) → 팝업으로 평가 화면 오픈 |
| 평가 화면 컨테이너 | HomeClient — 현재 mock 데이터 (authors-mock · bid-items-mock) 로만 렌더 |
| 업체 비교 메인 | AuthorComparePanel — 업체별(=Proposal) 핵심 비교 패널 |
| 입찰/공고 카드 | BidItemSelector · noticeDetail/* (기본정보·기술·요구사항·평가 탭) |
| 비교 섹션 5종 | analysis/compare/CompareTechSection · CompareEvaluationSection · CompareRequirementsSection · CompareKpiMatrix · 각 Detail 섹션 |
| 비교 센터 패널 | center/CompareCenterPanel · ItemCompare* (핵심기술/평가/요구사항 항목별) |
| AI 챗봇 패널 | ChatPanel (AuthorComparePanel 옆에서 질문응답) |
| 관리자 영역 | admin/(auth)/login · admin/(protected)/{analysis · usage · system · settings} |
박찬호님 안내사항. 우수제품 프론트엔드 / BFF 에서 LLM 호출이 필요할 때 (AI 챗봇, 평가 분석 등) 반드시 ai_engine 레이어를 경유합니다. 프롬프트와 여러 서비스의 LLM 호출을 중앙에서 관리하기 위한 설계.
| 영역 | 호출 가능 여부 | 설명 |
|---|---|---|
services/ai_engine/online |
권장 진입점 | 실시간 서비스 진입점 — eval_chatbot · rfp_gen_chatbot · rfp_gen_doc_assistant 등. 여기를 통해 호출. |
services/ai_engine/core |
내부 인프라 | LLM 엔진(Gemini/Qwen) · clients · 캐싱 등 — online 레이어가 사용. 직접 사용 지양. |
services/ai_engine/core/prompts |
프롬프트 중앙 관리 | RFP · 제안서 · 평가 · 챗봇 등 모든 프롬프트 템플릿이 한 곳에. 새 프롬프트 추가 시 여기에. |
services/ai_engine/offline |
직접 호출 금지 | 배치 처리 전용 — 외부 서비스에서 직접 호출하지 않도록 의도적으로 분리되어 있음. |
| 각 앱 레이어에서 LLM SDK 직접 호출 | 금지 | OpenAI · Gemini · Qwen 클라이언트를 앱 코드에서 직접 import 하지 않음. |
참고 — jodal-eval-ai/pps-mono-repo/tree/main/services/ai_engine/offline · core/prompts
ai_engine/online 진입점을 경유하고, 환경변수로 외부 base URL · API 키만 교체합니다. 사내 vLLM 으로의 전환은 시연·운영 환경 진입 시 인프라 측이 진행.
현재 평가 화면(HomeClient)은 mock 데이터만 가져오고, 업로드 UI 자체가 없음. BFF·추출 엔진은 동작하므로 화면 영역만 추가하면 됩니다.
BFF가 업로드를 받으면 추출 엔진을 자동 호출하고, 완료 시 webhook으로 결과가 BFF에 저장되는 흐름은 모두 구현 완료. 운영용 API 키만 필요합니다.
HomeClient / AuthorComparePanel 이 현재 hardcoded mock 만 보여줌. BFF가 매핑된 결과를 응답하므로 데이터 소스만 교체 + UX 배치 결정이 필요합니다.
| 영역 | 상태 | 설명 |
|---|---|---|
| BFF 업로드 → 추출 트리거 | 동작 | callback_url 자동 부착 + 멱등 webhook 수신 |
| ProductRecord → Proposal 매핑 (9 필드) | 동작 | 매핑 로직 1곳에 캡슐화 |
| 비교 결과 조회 API | 동작 | spec_id 단건 + 전체 리스트 |
| frontend 업로드 컴포넌트 | 없음 | ① 의 핵심 |
| frontend 비교 UI 실데이터 | mock | ③ 의 핵심 |
| 추출 엔진 API 키 | 미설정 | ② 의 핵심 |
| 자동 회귀 가드 (e2e + pytest) | 196 시나리오 | 변경 시마다 3.8초 회귀 |
| ai_engine 레이어 (online · prompts) | 존재 | LLM 호출 진입점 + 프롬프트 중앙 관리 — 우수제품 평가 화면도 여기 경유 |
samples/2. 배전반 규격서/ — gitignore (외부 배포 금지)