iot-dc3/README.ko.md

English | 中文 | 日本語 | Tiếng Việt | 한국어 | Español | Русский

AI 어시스턴트: IoT DC3의 간결한 AI 친화적 개요를 보려면 먼저 README.ai.md를 읽어주세요.

IoT DC3 — 멀티 프로토콜, 클라우드 네이티브, 오픈소스 산업용 IoT 플랫폼
AI 기반 — 디바이스 연결에서 산업 에이전트로

https://dc3.site

🔌 멀티 프로토콜 연결  ·  🤖 AI Agentic Center  ·  ☁️ 클라우드 네이티브 마이크로서비스

---

📸 제품 미리보기

📸 플랫폼 개요	📸 디바이스 관리	📸 AI 채팅
홈 / 대시보드 시스템 개요 · 디바이스 온라인 통계 · 데이터 트렌드 차트	디바이스 관리 디바이스 목록 · 온라인 상태 · 검색 및 필터링	AI 채팅 자연어 디바이스 쿼리 · 데이터 분석 · 지능형 지원

🏗️ 아키텍처 개요

아키텍처 한눈에 보기

6계층 마이크로서비스 아키텍처: 클라이언트 → 게이트웨이 → 4개 센터 서비스 → 메시지 버스 → 36개 프로토콜 드라이버 → 현장 디바이스. PostgreSQL (TimescaleDB + pgvector + AGE) 영속성 계층과 선택적 관찰 가능성 스택 (ELK + Prometheus + Grafana)이 한눈에 보입니다.

🧱 설계 원칙 — 서비스 간 호출은 항상 Facade 인터페이스를 통해 이루어집니다. DO/BO/VO 3계층 모델은 영속성, 비즈니스, API 형태를 엄격히 분리합니다. 테넌트 격리는 데이터베이스, 캐시, API 경로 전체에 걸쳐 적용됩니다. 서비스와 팀 전반에 걸쳐 확장 가능한 명확한 경계입니다.

📖 전체 아키텍처 문서는 시스템 아키텍처 개요를 참조하세요.

✨ 핵심 기능

🔌 멀티 프로토콜 디바이스 연결

IoT DC3는 산업 자동화, IoT 통신, 데이터 브리징, 기본 통신, 시뮬레이션/디버깅 시나리오를 위한 36개의 접근 드라이버 모듈을 포함하여 일반적인 디바이스와 데이터 소스의 연결 비용을 줄입니다:

카테고리	드라이버 모듈
🏭 산업 프로토콜	Modbus TCP · Modbus RTU · OPC UA · OPC DA · Siemens S7 · BACnet/IP · EtherNet/IP · Omron FINS · Mitsubishi MELSEC · IEC 60870-5-104 · IEC 61850 · DNP3 · DLMS · DLT645 · KNX · M-Bus · SL651
📡 IoT 프로토콜	MQTT · CoAP · LwM2M · HTTP · BLE · Zigbee · LoRaWAN
🗄️ 데이터 브리징	MySQL · PostgreSQL · Oracle · SQL Server · Redis
🔧 기본 통신 및 네트워크 관리	TCP/UDP · Serial · SNMP · CAN · Kafka
🧪 시뮬레이션 및 디버깅	Virtual · Listening Virtual

Driver SDK를 통해 커스텀 프로토콜 드라이버를 빠르게 개발하고 실행 중인 플랫폼에 등록할 수 있습니다.

🤖 AI 기능 통합

Spring AI 기반의 에이전틱 센터는 대규모 언어 모델을 IoT 운영 워크플로에 연결합니다:

• 자연어 기반 운영 지원 — Tool Calling을 통해 LLM이 권한 관리 하에 디바이스를 쿼리하고, 포인트를 읽/쓰고, 명령 실행을 지원합니다
• 지능형 알람 분석 — AI가 근본 원인 분석과 대응 제안을 지원합니다
• 데이터 인사이트 — 자연어로 디바이스 데이터를 쿼리하고 시각화 차트를 생성합니다
• 멀티 모델 지원 — OpenAI API 스타일 프로바이더와 GPT, Claude, DeepSeek, Qwen 같은 주요 모델을 호환합니다
• 대화 메모리 — 다중 턴 대화와 컨텍스트 메모리를 데이터베이스에 영속화합니다

🏗️ 클라우드 네이티브 마이크로서비스

Spring Boot 4 + Spring Cloud 2025 기반의 분산 마이크로서비스 아키텍처:

• 서비스 거버넌스 — Spring Cloud Gateway를 통합 진입점으로 사용하며, 정적 라우팅과 유연한 환경 변수 설정
• 효율적인 통신 — gRPC 서비스 간 호출과 Protobuf 직렬화
• 수평적 확장 — 무상태 설계로 비즈니스 부하에 따라 개별 서비스를 독립적으로 확장
• 복원력 — 교체 가능한 서비스 노드와 장애 격리

📊 실시간 데이터 엔진

• 데이터 수집 — 드라이버 계층이 디바이스 원격 측정 데이터를 수집하고 RabbitMQ를 통해 비동기적으로 전송
• 시계열 저장 — 실시간 및 이력 데이터의 효율적인 쿼리
• 규칙 엔진 — 유연한 알람 규칙, 다중 수준 알람 및 알림 지원
• 이벤트 추적 — 전체 명령 및 이벤트 이력

🔐 엔터프라이즈 보안 및 멀티테넌시

• 테넌트 격리 — 데이터베이스, 캐시, API 경로 전체에 걸친 테넌트 수준 격리
• 인증 및 인가 — JWT + Spring Security, RBAC 권한 모델
• 전송 암호화 — TLS/SSL 통신 지원
• 감사 추적 — 사용자 작업 및 시스템 이벤트 로그

🧩 개발자 친화적

• Driver SDK — 완비된 드라이버 개발 도구 키트. 드라이버 작성 가이드 참조
• 프론트엔드/백엔드 분리 — Vue 3 + TypeScript 프론트엔드, RESTful + gRPC API
• 컨테이너화된 배포 — Podman / Docker Compose로 원커맨드 시작, Kubernetes 등 컨테이너 플랫폼으로 쉽게 마이그레이션
• 완전한 문서 — 온라인 문서, 퀵스타트 가이드, 문제 해결 가이드

⚡ 퀵스타트

소스 기반 로컬 개발을 위해 PostgreSQL과 RabbitMQ를 시작하고, 로컬 환경 변수를 로드한 뒤 빌드합니다:

make up-db
source dc3/env/dev.env.sh
mvn -s .mvn/settings.xml clean package

중국 본토에서는 Alibaba Cloud 레지스트리를 사용하려면 make up-db-cn을 사용하세요.

📖 서비스 시작 순서, IDE 설정, 검증 명령 및 흔한 주의사항은 전체 퀵스타트를 참조하세요.

🛠️ 기술 스택

IoT DC3는 Java 21, Spring Boot 4, Spring Cloud 2025, Spring AI 2, PostgreSQL, RabbitMQ, gRPC, Vue 3, TypeScript, Vite 기반으로 구축되었습니다.

구성 요소 세부 정보와 사용 위치는 기술 스택을 참조하세요.

📖 문서 및 커뮤니티

리소스	링크
📚 온라인 문서	docs.dc3.site
🚀 퀵스타트	퀵스타트 가이드
🛠️ 기술 스택	Technology Stack
🏗️ 아키텍처	모듈 및 의존성
🔧 드라이버 개발	드라이버 작성 가이드
🐛 문제 해결	문제 해결
📋 변경 로그	릴리스 변경 로그
🐛 이슈 피드백	GitHub Issues
🇨🇳 Gitee 미러	Gitee GVP 프로젝트

🌍 사용 사례

🏭	스마트 팩토리	생산 라인 설비 모니터링, 공정 파라미터 수집, 예측 유지보수, OEE 분석
⚡	에너지 모니터링	전력/수도/가스 원격 검침, 에너지 트렌드 분석, 이상 알람
🌾	스마트 농업	온실 환경 모니터링, 자동 관개 제어, 병충해 경고, 수확량 예측
🏙️	스마트 시티	가로등 관리, 환경 품질 모니터링, 시설 운영, 안전 모니터링

🤝 기여하기

모든 형태의 기여를 환영합니다. 다음 워크플로를 따라주세요:

1. Fork 및 브랜치 — main에서 브랜치를 만들고 feature/your_name/feature_description 형식으로 이름을 지정하세요 (예: feature/pnoker/mqtt_driver)
2. 개발 및 커밋 — 새 브랜치에서 변경을 완료하고 Conventional Commits 사양을 따르세요
3. PR 열기 — develop 브랜치에 Pull Request를 제출하여 관리자에게 리뷰와 머지를 받으세요

📄 라이선스

IoT DC3는 AGPL 3.0 라이선스 하에 오픈소스로 제공됩니다.

• ✅ 개인 학습, 연구, 내부 사용 — 무료
• ✅ 코드 수정 및 수정 사항 오픈소스화 — 환영합니다
• ⚠️ 수정 사항을 오픈소스화하지 않고 제3자에게 상업 서비스로 제공하는 경우 — 상업 라이선스 필요

상업 라이선스 세부 정보는 LICENSE.txt를 참조하세요.