@@ -11,6 +11,12 @@
    
    RGB-D 관측에서 과실과 생장점을 식별하고 로봇 작업 후보를 구조화하는 참조 MVP입니다.
    
  + ## MVP 동작 범위
  + 
  + - 신뢰도 임계값 기반 관측 필터링
  + - 과실·생장점 작업 우선순위 산정
  + - 3차원 작업 후보와 제외 건수 생성
  + 
    ## 실행
    
    ```bash
@@ -18,4 +24,4 @@ python run.py examples/input.json
    python -m unittest discover -s tests -v
    ```
    
  − 실제 기관 구현은 `contracts/component.interface.json`의 저장소 식별자와 제품 기준선 연결 규칙을 유지하면서 교체할 수 있습니다.
  + 정상 입력은 `examples/input.json`, 차단·안전 경로는 `examples/failure-input.json`으로 재현합니다. 실제 기관 구현은 `contracts/component.interface.json`의 저장소 식별자와 제품 기준선 연결 규칙을 유지하면서 교체할 수 있습니다.

modified asw_component/component.py +27−3 View file

@@ -1,7 +1,31 @@
    from __future__ import annotations
    
  + SUPPORTED = {"fruit": 1, "growth-tip": 2}
  + 
    
    def execute(payload: dict) -> dict:
  −     if not isinstance(payload, dict) or not payload:
  −         raise ValueError("a non-empty object is required")
  −     return {"component": "metafarmers/fruit-work-target-perception", "accepted": True, "status": "READY", "target": "vpu", "input_fields": sorted(payload.keys())}
  +     if not isinstance(payload, dict):
  +         raise ValueError("payload must be an object")
  +     threshold = float(payload.get("threshold", 0.8))
  +     if not 0 <= threshold <= 1:
  +         raise ValueError("threshold must be between 0 and 1")
  +     candidates = []
  +     rejected = 0
  +     for observation in payload.get("observations", []):
  +         kind = observation.get("kind")
  +         confidence = float(observation.get("confidence", 0))
  +         position = observation.get("positionMm")
  +         if kind not in SUPPORTED or confidence < threshold or not isinstance(position, list) or len(position) != 3:
  +             rejected += 1
  +             continue
  +         candidates.append({
  +             "id": observation["id"], "kind": kind, "confidence": round(confidence, 4),
  +             "positionMm": [float(value) for value in position], "priority": SUPPORTED[kind],
  +         })
  +     candidates.sort(key=lambda item: (-item["priority"], -item["confidence"], item["id"]))
  +     counts = {kind: sum(item["kind"] == kind for item in candidates) for kind in SUPPORTED}
  +     accepted = bool(candidates)
  +     return {"component": "metafarmers/fruit-work-target-perception", "accepted": accepted,
  +             "status": "TARGETS_READY" if accepted else "NO_TARGETS", "target": "vpu",
  +             "frameId": str(payload.get("frameId", "unknown")), "candidates": candidates,
  +             "counts": counts, "rejected": rejected}

modified contracts/component.interface.json +18−1 View file

@@ -5,7 +5,12 @@
      "required": [
        "component",
        "accepted",
  −     "status"
  +     "status",
  +     "target",
  +     "frameId",
  +     "candidates",
  +     "counts",
  +     "rejected"
      ],
      "properties": {
        "component": {
@@ -19,6 +24,18 @@
        },
        "target": {
          "const": "vpu"
  +     },
  +     "frameId": {
  +       "type": "string"
  +     },
  +     "candidates": {
  +       "type": "array"
  +     },
  +     "counts": {
  +       "type": "object"
  +     },
  +     "rejected": {
  +       "type": "integer"
        }
      }
    }

added examples/failure-input.json +16−0 View file

@@ -0,0 +1,16 @@
  + {
  +   "frameId": "greenhouse-row-04",
  +   "observations": [
  +     {
  +       "id": "fruit-19",
  +       "kind": "fruit",
  +       "confidence": 0.51,
  +       "positionMm": [
  +         300,
  +         20,
  +         1200
  +       ]
  +     }
  +   ],
  +   "threshold": 0.8
  + }

modified examples/input.json +22−2 View file

@@ -4,12 +4,32 @@
        {
          "id": "fruit-17",
          "kind": "fruit",
  −       "confidence": 0.94
  +       "confidence": 0.94,
  +       "positionMm": [
  +         420,
  +         -80,
  +         1380
  +       ]
        },
        {
          "id": "tip-02",
          "kind": "growth-tip",
  −       "confidence": 0.89
  +       "confidence": 0.89,
  +       "positionMm": [
  +         438,
  +         -65,
  +         1510
  +       ]
  +     },
  +     {
  +       "id": "leaf-09",
  +       "kind": "leaf",
  +       "confidence": 0.97,
  +       "positionMm": [
  +         400,
  +         -30,
  +         1450
  +       ]
        }
      ],
      "threshold": 0.8

modified pyproject.toml +1−1 View file

@@ -1,5 +1,5 @@
    [project]
    name = "fruit-work-target-perception"
  − version = "0.1.0"
  + version = "0.2.0"
    description = "RGB-D 관측에서 과실과 생장점을 식별하고 로봇 작업 후보를 구조화하는 참조 MVP입니다."
    requires-python = ">=3.11"

modified release/manifest.json +1−1 View file

@@ -4,7 +4,7 @@
      "displayName": "과채류 작업대상 인식",
      "owner": "주식회사 메타파머스",
      "implementationAuthor": "주식회사 비아 (연동 검증용 참조 구현)",
  −   "version": "0.1.0-mvp",
  +   "version": "0.2.0-mvp",
      "domain": "Perception",
      "status": "REFERENCE_MVP",
      "compatibility": {

modified tests/test_component.py +13−0 View file

@@ -12,6 +12,19 @@ class ComponentTest(unittest.TestCase):
            result = execute(payload)
            self.assertTrue(result["accepted"])
            self.assertEqual(result["component"], "metafarmers/fruit-work-target-perception")
  +         self.assertEqual(result["target"], "vpu")
  +         self.assertEqual(result["status"], "TARGETS_READY")
  +         self.assertEqual([item["id"] for item in result["candidates"]], ["tip-02", "fruit-17"])
  +         self.assertEqual(result["counts"], {"fruit": 1, "growth-tip": 1})
  +         self.assertEqual(result["rejected"], 1)
  + 
  +     def test_safety_or_failure_path(self):
  +         payload = json.loads((ROOT / "examples/failure-input.json").read_text(encoding="utf-8"))
  +         result = execute(payload)
  +         self.assertEqual(result["component"], "metafarmers/fruit-work-target-perception")
  +         self.assertFalse(result["accepted"])
  +         self.assertEqual(result["status"], "NO_TARGETS")
  +         self.assertEqual(result["candidates"], [])
    
    if __name__ == "__main__":
        unittest.main()