WORK — 함께 일하기
모든 직원- AI 작업공간 — Knowledge Space · 질문 · Recipe 결과물
- 켠 Module
- 설치한 Industry Pack의 Agent
Layered Architecture
4계층 — 판매 단위가 곧 코드 단위
고객마다 다른 것은 설정·Customization·Extension으로 두고, Core는 고객별로 고치지 않습니다. 그래서 업그레이드가 모든 설치에서 같은 절차로 끝납니다.
| 계층 | 구성 | 버전 관리 |
|---|---|---|
| Industry Pack | Process Map · Common Knowledge(법령) · Knowledge Space · AI Agent · Playbook · Recipe · Label Schema · Eval Set · Connector 템플릿 | 팩마다 버전과 필요한 Core 버전 |
| Module | 회계 · 영업(입찰·RFP·해외사업) · 일정 · 메일 · 경비 · 총무 · 법무관리 · Memory — 모두 직접 개발, 켜고 끄며, 내장 구현과 외부 제품 Adapter를 교체 가능 | 모듈마다 버전과 필요한 Core 버전 |
| Platform (관리하기) | 회사·브랜드 · 사용자·권한 · LLM Provider · 커넥트센터 · Org Unit·보안 · Release · Citizen Developer 개선 | Core 버전을 따름 |
| Core — WithUs-RAG | Knowledge Space · Indexing · Hybrid Search · Rerank · Citation 답변 · AI Agent · Evaluation · Common Knowledge · 인용 그래프 | 제품 버전 (예: v1.50.0) |
RAG Pipeline
Ingestion에서 Evaluation 까지
Ingestion문서 수집·분할PDF · HWP/HWPX · DOCX · XLSX · PPTX. 제목 구조와 쪽을 살려 Chunking 하고, 법령은 조문 단위, 판례는 판시사항·요지 단위로 나눕니다.
RetrievalHybrid Search한국어 형태소 기반 전문 검색 + 벡터 검색(pgvector, 없으면 In-memory)을 합친 뒤 Rerank. 볼 권한이 있는 Knowledge Space만 검색합니다.
GenerationCitation 답변근거 문장을 그대로 인용하고, 근거가 없는 문장은 표시합니다. Agent는 Playbook 단계와 Output Check로 스스로 검증합니다.
Evaluation품질 지표Eval Set으로 Retrieval Hit · 정답성 · Faithfulness · 인용률 · 거절률을 회차별로 비교합니다.
3-Room UI
화면은 세 영역
Room과 Module 이름은 설정이라 고객사가 바꿉니다. BUILD·ADMIN은 별도 창으로 열고 창끼리 로그인·메뉴 상태를 맞춥니다.
BUILD — 함께 만들기
기본 모두 · 별도 창- AI Agent · Playbook · Prompt
- 검색 구성 · Evaluation
- Citizen Developer 개선 요청
ADMIN — 관리하기
회사 관리자 · 별도 창- 사용자·권한 · LLM Provider · Secret
- Module·Pack · 커넥트센터
- Org Unit·보안 · Release · 버전 정보
Integration
커넥트센터 — 모든 연동을 API 로
새 기능은 화면 전용으로 만들지 않고 서버 함수와 화면을 나눕니다. 그래서 같은 기능을 OpenAPI · Connector · MCP로 내놓을 수 있습니다.
API Hub
연동에 쓰는 상용·사내 API를 등록하고 버전을 관리합니다.
- 연결 시험 · Schema 검사 · Health Check
- 호출 로그
- 등록한 API를 RAG Connector · Agent Tool · MCP로 재사용
ERP 연결
중소기업 ERP를 OpenAPI 또는 엑셀 템플릿으로 붙입니다.
- 이카운트 OpenAPI
- 더존 · 얼마에요 엑셀 템플릿
- 쓰기 동작은 별도 승인
OpenAPI · MCP
WithUs-Ai 기능을 외부 시스템과 AI 도구에 공개합니다.
- API Key 마다 사용자 권한 · 한도
- 호출 기록
- 원래 시스템 권한을 지킨 검색
Security
권한 밖 문서는 근거로도 쓰지 않습니다
Org Unit 격리
부서·재판부의 지식과 질문·답변·결과물은 그 단위 안에서만 봅니다. 회사 관리자도 열 수 없고, Strict Unit은 전사 공개로도 열리지 않습니다.
Audit Log
열람 · 질문 · 내려받기 · 권한 변경 · 거절된 접근을 단위별로 기록하고 단위 관리자가 봅니다.
Secret 암호화
API Key·비밀번호는 설치마다 DB에 암호화해 두고, 코드·저장소·화면에 노출하지 않습니다.
인증 방식 선택
자체 로그인 · Cloudflare Access(Zero Trust) · SSO를 하나로 가정하지 않습니다.
Deployment
On-premise 우선, SaaS는 같은 코드로
| On-premise (1차) | Air-gapped (폐쇄망) | SaaS | |
|---|---|---|---|
| 설치 | 고객 서버·NAS 한 대의 Docker Compose | 같음 — 설치 패키지·Release Bundle을 파일로 반입 | 위더스 운영 클라우드 |
| Tenancy | 설치 하나 = 회사 하나 | 같음 | DB-per-tenant (회사마다 DB 분리) |
| LLM | 회사 API Key(Claude) 또는 사내 Ollama | 사내 Ollama(GPU 서버)만으로 핵심 기능 | 플랫폼 Key 또는 회사 Key · Ollama Cloud |
| Vector Search | pgvector, 없으면 In-memory | 같음 | pgvector |
| Common Knowledge | 설치마다 가져오기 | 법령·판례 패키지를 파일로 올리기 | 한 번 넣고 모든 회사가 읽기 전용 |
| 공공기관 연동 | Embedded 모드 | DMZ Relay 모드 — Core가 먼저 접속 · mTLS · DMZ 무저장 | Embedded 모드 |
Release · CI/CD
Staging에서 검증한 것만 Production 으로
CI는 위더스가, CD(업그레이드 받기·Customization 관리)는 제품 안에서 합니다. 모든 단계를 기록하고 Rollback을 남깁니다.
- Release Bundle 받기
Core·Module·Pack 버전을 묶어 검증한 패키지를 받습니다. 폐쇄망은 파일로 올립니다.
- Staging 반영
같은 서버의 Staging 환경에 먼저 올리고, Migration은 다시 실행해도 안전하게(Idempotent) 작성합니다.
- 자동 점검 + 사람 확인
Self-check · Eval Set 회차 비교 · 화면 확인. 현업의 Citizen Developer 개선도 여기서 시험합니다.
- 승인
IT 검증을 마친 변경만 결재를 거쳐 Production으로 내보냅니다.
- Production 반영 · Rollback
반영 직전 백업을 남기고, 문제가 생기면 이전 버전으로 Rollback 합니다.
3-Tier 버전 관리① Product (Core·Module·Pack) ② Customization (설정·팩 수정 Change Set) ③ Extension (고객 확장 모듈). Core는 고객별로 고치지 않습니다.
Tech Stack
검증된 오픈소스 위에
| 영역 | 구성 |
|---|---|
| Web · API | Python · Starlette · Uvicorn |
| Database | PostgreSQL 16 · pgvector · 전문 검색 인덱스 |
| Embedding · Rerank | Voyage AI 또는 사내 Ollama Embedding |
| LLM | Claude (Citation 지원) · Ollama (사내 GPU · Cloud) — 기능별 선택 |
| Runtime | Docker Compose — Production · Staging 컨테이너 |
| Integration | OpenAPI 3 · MCP · mTLS DMZ Relay |
우리 시스템에 어떻게 붙일지 같이 그려 보시죠
기존 업무시스템·ERP 와의 연동 방식, On-premise·폐쇄망 구성을 함께 설계합니다.