concept · wiki/concept-chemical-service-topology.md
Concept — chemical service topology
브라우저 UI와 백엔드 마이크로서비스 사이 **인증 경계(BFF/gateway)** 와 **도메인 서비스 분리** 구조.
corpusprojectlayermodeltypeconceptdomainbackendsprojectchemicalstatusactiveupdated2026-07-18originowned
Concept — chemical service topology
한 줄: 브라우저 UI와 백엔드 마이크로서비스 사이 인증 경계(BFF/gateway) 와 도메인 서비스 분리 구조.
서비스 맵 (HANDOFF 기준 포트)
| 서비스 | 포트 | 책임 |
|---|---|---|
| Frontend / Admin FE | 3000 / 3002 | Next UI |
| Gateway | 8001 | 사용자 인증·회사 스코프 |
| Admin Gateway | 8006 | 전역 관리 (bypass_rls) |
| Data Aggregator | 8002 | 화학·독성 데이터 |
| Regulatory Inventory | 8003 | 명부·watchlist |
| Simulation | 8004 | 룰 + RAG |
| Document Export | 8005 | PDF/IUCLID 등 |
인프라: PostgreSQL(+RLS), Redis, Kafka, Qdrant, llama.cpp.
명세와의 긴장 — 해소
- 과거 긴장: HANDOFF 다이어그램의 Next→MS 직접 rewrite 요약 vs spec BFF
- 정본 (2026-07-18 코드): decision-chemical-auth-bff
- Next
/api/*→ BFF only - sid + Redis JWT
- MS는 BFF 프록시 뒤에서만
HANDOFF raw 다이어그램은 스냅샷/축약으로 남기고 운영 서술에는 이 decision을 쓴다.