README.md

---
license: mit
title: CertBridge
emoji: 📋
colorFrom: indigo
colorTo: purple
sdk: static
pinned: false
tags:
  - certbridge
  - ai-parsing
  - quality-certificate
  - neo4j
  - graphrag
  - tauri
  - react
---

# 🔬 CertBridge — AI 성적서 자동 파싱 및 레거시 통합 시스템

<div align="center">

**Claude · Gemini · OpenAI 호환 API를 활용한 제품 성적서 자동 파싱 → Neo4j 온톨로지 → 레거시 시스템 통합**

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/Node.js-20+-339933?logo=node.js)](https://nodejs.org)
[![Tauri](https://img.shields.io/badge/Tauri-2.0-24C8D8?logo=tauri)](https://tauri.app)
[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev)

</div>

---

## 📦 다운로드

| 구성요소 | 파일 | 대상 OS |
|----------|------|---------|
| 🖥️ **서버** | `certbridge-server-v0.1.0-ubuntu.tar.gz` | Ubuntu 22.04+ |
| 💻 **클라이언트** | `CertBridge_0.1.0_x64-setup.exe` (NSIS) | Windows 10+ |
| 💻 **클라이언트** | `CertBridge_0.1.0_x64_en-US.msi` (MSI) | Windows 10+ |
| 📖 **설치 가이드** | `installation-guide.html` | - |
| 📖 **사용 가이드** | `usage-guide.html` | - |

## 🏗️ 아키텍처

```
┌─────────────────────────────────────────────────────────────┐
│                    CertBridge Desktop Client                │
│                 (Tauri 2.0 + React 19 + TypeScript)         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐   │
│  │ 파싱 뷰  │ │ 메타관리 │ │ 온톨로지 │ │ 대시보드     │   │
│  │ AI 파싱  │ │ 템플릿   │ │ GraphRAG │ │ 모니터링     │   │
│  └──────────┘ └──────────┘ └──────────┘ └──────────────┘   │
└─────────────────────┬───────────────────────────────────────┘
                      │ REST API (JWT Auth)
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                CertBridge Central Server                     │
│                  (Node.js + Express)                          │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐   │
│  │ 사용자   │ │ 파싱     │ │ 그래프   │ │ 레거시       │   │
│  │ 인증/권한│ │ 프록시   │ │ RAG     │ │ 전송 프록시  │   │
│  └──────────┘ └──────────┘ └──────────┘ └──────────────┘   │
│        │           │            │              │             │
│   ┌────▼────┐ ┌────▼───┐ ┌─────▼────┐  ┌─────▼──────┐     │
│   │PostgreSQL│ │ Redis  │ │  Neo4j   │  │   MinIO    │     │
│   │  (메타) │ │(캐시)  │ │(온톨로지)│  │(파일저장)  │     │
│   └─────────┘ └────────┘ └──────────┘  └────────────┘     │
└─────────────────────────────────────────────────────────────┘
```

## 🚀 빠른 시작

### 서버 설치 (Ubuntu)

```bash
# 1. 다운로드 & 압축 해제
tar -xzf certbridge-server-v0.1.0-ubuntu.tar.gz
cd certbridge-server-ubuntu

# 2. 자동 설치 (Docker, Node.js, DB 포함)
chmod +x setup.sh
sudo ./setup.sh

# 3. 설치 확인
curl http://localhost:8090/health
```

### 클라이언트 설치 (Windows)

1. `CertBridge_0.1.0_x64-setup.exe` 다운로드
2. 설치 마법사 실행
3. 앱 실행 후 서버 URL 입력: `http://<서버IP>:8090`
4. 관리자 로그인: `admin` / `admin123`

## 🔑 핵심 기능

- **AI 성적서 파싱**: PDF, Excel, 이미지 → Claude/Gemini/OpenAI로 자동 구조화
- **Neo4j 온톨로지**: 소재-성적서-시험항목 그래프 자동 구축
- **GraphRAG Q&A**: 자연어로 성적서 데이터 질의 (Cypher 자동 변환)
- **레거시 통합**: 기존 시스템 API/DB로 파싱 결과 자동 전송
- **그룹/역할 관리**: 관리자·입력자·분석가 역할별 접근 제어
- **실시간 대시보드**: 파싱 통계, 정확도, 시스템 모니터링

## 📋 시스템 요구사항

### 서버
- Ubuntu 22.04+ / Debian 12+
- Docker & Docker Compose
- Node.js 20+
- RAM 4GB+, 디스크 20GB+

### 클라이언트
- Windows 10+ (64bit)
- RAM 2GB+

## 📄 License

MIT License — 자유롭게 사용, 수정, 배포 가능