FlowCraft 기술 구조 구상 – 어떻게 만들 것인가?

📌 이 문서는 FlowCraft를 만들기 위해 고민하고 있는 기술 구조를 정리한 구상 초안입니다.
현재는 개발 전 단계이며, 모든 구조와 스택은 테스트 및 검토를 거쳐
실제 개발 상황에 따라 변경될 수 있습니다.
이 글은 방향성을 잡기 위한 기록으로,
추후 주요 결정 사항이 정리되면 새로운 글로 다시 정리해 나갈 예정입니다.

---

🎯 FlowCraft는 어떤 기술 기반으로 만들어질까?

FlowCraft는 다음 목표를 기술적으로 뒷받침하는 구조로 구상 중입니다:

• ✅ 개인이 스스로 만들 수 있는 자동화 흐름
• ✅ 시각적인 구성 UI
• ✅ 조건과 반복이 있는 실행 로직
• ✅ 외부 AI API와의 자연스러운 연결

---

🧱 시스템 구성도 (텍스트 다이어그램)

사용자
  │
  ▼
[프론트엔드 UI - React/Vue]
  │
  ▼
[Flow Editor (Canvas + Node System)]
  │
  ▼
[백엔드 서버 - FastAPI]
  ├──> [AI API 연동 (OpenAI / HuggingFace)]
  ├──> [DB (SQLite → PostgreSQL)]
  └──> [실행 엔진 (Execution Engine)]
              │
              ▼
        [자동화 흐름 실행]

배포: Docker / NAS / 로컬 서버

---

🔧 기술 스택 초안 (검토 중)

📝 이 모든 스택은 확정되지 않았으며,
기능 구현 가능성 및 학습 상황에 따라 변경될 수 있습니다.

---

🧩 핵심 구현 요소 구상

1. 시각적 플로우 에디터

• 사용자 중심 인터페이스 (캔버스 기반)
• 노드 연결, 조건 분기 등 직관적인 UX
• JSON 기반 구조 저장

2. 실행 엔진

• DAG(Directed Acyclic Graph) 기반 흐름 제어
• 조건 분기 / 반복 / 실패 핸들링 구조 설계
• 추후 큐 기반 처리 또는 멀티 노드 확장 가능성 고려

3. AI 연동 구조

• 외부 API를 호출하는 노드 설계
• 사용자 정의 입력값을 이용한 프롬프트 생성 및 응답 처리
• 다양한 AI 모델 지원 가능성을 열어둠

---

⚠️ 아직 미정 / 테스트 예정 요소

• 프레임워크 선택 (Vue vs React)
• 실행 엔진 처리 방식
• 노드 저장 포맷 및 템플릿 구조
• 전체적인 저장/호출 흐름

---

🔜 앞으로 할 일

• [ ] 캔버스 UI 및 노드 구조 와이어프레임 제작
• [ ] 샘플 플로우를 JSON으로 설계해보기
• [ ] AI 연동 테스트
• [ ] 기능 구현 실험
• [ ] 확정되는 구조가 나오면 새로운 문서로 정리

---

✍️ 개인적인 메모

이 글은 지금까지 해온 고민을 정리하고,
앞으로 어떤 방향으로 진행할 수 있을지를 스스로 점검하기 위한 기록입니다.

완성된 구조가 아니기 때문에
이 내용은 언제든지 바뀔 수 있고,
그 변화는 기록으로 남겨 계속 발전시켜 나갈 생각입니다.

---

🚀 FlowCraft는 지금 구조를 구상하며 설계의 방향을 잡아가는 중입니다.
기록은 시작이고, 나중에 돌아볼 이정표입니다.