AgroBlock Enterprise Smart Farm

📚 문서 모음

* 아래 경로의 Markdown 파일을 저장소에서 확인하세요.

• 요구사항 정의서

  엔터프라이즈 스마트팜 플랫폼의 기능/비기능 요구사항 정리

  docs/01_requirements.md
• 아키텍처 개요

  IoT, 데이터, AI, 운영 레이어를 아우르는 전체 구성도

  docs/02_architecture.md
• PoC 계획서

  8주 PoC 목표, 일정, 성공 기준 및 리스크 대응 계획

  docs/03_poc_plan.md
• 구현 로드맵

  Phase별 백로그와 거버넌스/운영 전략

  docs/04_implementation_roadmap.md
• 데이터 모델 개요

  주요 도메인 엔터티 및 데이터 거버넌스 전략

  docs/05_data_modeling.md
• 사용자 구현 필수 영역

  실서비스화를 위해 반드시 내부에서 구현해야 하는 항목

  docs/99_customer_action_items.md

🛠️ 제공 API

• GET
  /api/devices

  디바이스 메타데이터 및 최근 상태 조회

• GET
  /api/devices/:id/telemetry?range=1h

  센서 시계열 데이터 조회 (샘플 또는 외부 IoT API 프록시)

• POST
  /api/devices/:id/commands

  액추에이터 제어 명령 제출 (외부 Control Service 연계)

• POST
  /api/voice/commands

  음성/STT/RAG 파이프라인 호출 예시

• GET
  /api/system/health

  주요 외부 마이크로서비스 상태 점검

• POST
  /api/automation/rules/validate

  자동화 룰 유효성 사전 검증 (샘플 계산)

⚙️ 환경 변수

실제 외부 서비스와 연동하려면 Cloudflare Pages 환경 변수(또는 Wranger .dev.vars)에 아래 값을 설정하세요. 지정하지 않으면 샘플 데이터가 반환됩니다.

• IOT_API_BASE_URL
• IOT_API_KEY
• CONTROL_API_BASE_URL
• CONTROL_API_KEY
• RAG_API_BASE_URL
• RAG_API_KEY
• ANALYTICS_API_BASE_URL
• ANALYTICS_API_KEY