CtrlFactory Getting Started

설비 등록 및 첫 모니터링 연동 가이드 — ctrlplus.kr/flow · AI 모델링 · 대시보드

---

1. 개념 (Concept)

1.1 CtrlFactory란?

CtrlFactory는 산업 설비의 실시간 모니터링 → AI 예측 → 자동 정비까지 End-to-End로 연결하는 CtrlPlus 산업 자동화 플랫폼이다.

현장 센서 → XYFlow 파이프라인 설계 → AI 이상 감지 → 대시보드 시각화 ESP32-S3 ctrlplus.kr/flow FastAPI Next.js

1.2 전체 온보딩 여정

1.3 CtrlPlus 플랫폼 내 위치

---

2. Step 1 — 사이트 및 설비 등록

2.1 등록 데이터 모델

2.2 설비 등록 API 시퀀스

2.3 임계값 초기 설정

---

3. Step 2 — ESP32-S3 펌웨어 플래싱

3.1 PlatformIO 프로젝트 구조

3.2 WiFi 프로비저닝 플로우

---

4. Step 3 — XYFlow 파이프라인 설계

4.1 ctrlplus.kr/flow 진입 구조

4.2 CtrlFactory 프리셋 로드 흐름

4.3 CtrlFactory 기본 모니터링 XYFlow 파이프라인

4.4 NODE_CATEGORY × CtrlFactory 스킨 매핑

4.5 CategoryPreset 복합키 구조 (CtrlFactory)

---

5. Step 4 — AI 모델 연동

5.1 초기 모델 학습 플로우

5.2 AI 모델 XYFlow 노드 설정

5.3 Edge AI (TFLite) 온디바이스 추론

---

6. Step 5 — 대시보드 구성

6.1 Next.js 대시보드 컴포넌트 트리

6.2 실시간 데이터 흐름 (대시보드 관점)

6.3 Three.js 디지털 트윈 초기화

---

7. Step 6 — 알람 및 CMMS

7.1 알람 → Work Order 자동화 플로우

---

8. 전체 온보딩 아키텍처 요약

---

부록. 빠른 참조

환경 변수 및 엔드포인트 치트시트

[Spring Boot :8443] POST /api/sites 사이트 생성 POST /api/machines 설비 등록 POST /api/devices ESP32 디바이스 등록 PUT /api/machines/{id}/threshold 임계값 설정 GET /api/alerts/stream SSE 알람 스트림 [FastAPI :9989] POST /api/v1/ctrlmind/ingest 센서 데이터 수신 POST /api/v1/ctrlmind/train AI 모델 학습 트리거 GET /api/v1/ctrlmind/health/{id} Health Score 조회 GET /api/v1/ctrlmind/stream/{id} SSE 실시간 스트림 [XYFlow /flow] basePath: /flow 프리셋 경로: presets-data/ctrlFactory/{preset_id}.json 복합키 예시: ctrlFactory::manager::monitoring::dashboard

CtrlFactory 프리셋 복합키 목록

센서 → 노드 타입 매핑