@@ -11,6 +11,12 @@
    
    주행·시저리프트·충전 상태를 단일 플랫폼 상태로 조정하는 참조 MVP입니다.
    
  + ## MVP 동작 범위
  + 
  + - 배터리·높이 안전범위 검사
  + - 주행 중 리프트 인터록
  + - 높이 오차 기반 승강 명령
  + 
    ## 실행
    
    ```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 +13−3 View file

@@ -2,6 +2,16 @@ from __future__ import annotations
    
    
    def execute(payload: dict) -> dict:
  −     if not isinstance(payload, dict) or not payload:
  −         raise ValueError("a non-empty object is required")
  −     return {"component": "agerobotics/high-lift-mobile-platform", "accepted": True, "status": "READY", "target": "mcu", "input_fields": sorted(payload.keys())}
  +     current, requested = float(payload.get("liftHeightM", 0)), float(payload.get("requestedHeightM", 0))
  +     battery = float(payload.get("batteryPercent", 0))
  +     delta = requested - current
  +     reasons = []
  +     if battery < 20: reasons.append("LOW_BATTERY")
  +     if not 0.4 <= requested <= 2.4: reasons.append("HEIGHT_OUT_OF_RANGE")
  +     if abs(delta) > 0.02 and payload.get("driveState") != "HOLD": reasons.append("DRIVE_NOT_HELD")
  +     accepted = not reasons
  +     command = "BLOCKED" if not accepted else ("HOLD" if abs(delta) <= 0.02 else ("LIFT" if delta > 0 else "LOWER"))
  +     return {"component": "agerobotics/high-lift-mobile-platform", "accepted": accepted,
  +             "status": "PLATFORM_READY" if accepted else "INTERLOCK", "target": "mcu",
  +             "command": command, "deltaM": round(delta, 3), "blockingReasons": reasons,
  +             "batteryPercent": battery}

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

@@ -5,7 +5,12 @@
      "required": [
        "component",
        "accepted",
  −     "status"
  +     "status",
  +     "target",
  +     "command",
  +     "deltaM",
  +     "blockingReasons",
  +     "batteryPercent"
      ],
      "properties": {
        "component": {
@@ -19,6 +24,18 @@
        },
        "target": {
          "const": "mcu"
  +     },
  +     "command": {
  +       "type": "string"
  +     },
  +     "deltaM": {
  +       "type": "number"
  +     },
  +     "blockingReasons": {
  +       "type": "array"
  +     },
  +     "batteryPercent": {
  +       "type": "number"
        }
      }
    }

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

@@ -0,0 +1,6 @@
  + {
  +   "driveState": "MOVING",
  +   "liftHeightM": 1,
  +   "requestedHeightM": 1.8,
  +   "batteryPercent": 76
  + }

modified pyproject.toml +1−1 View file

@@ -1,5 +1,5 @@
    [project]
    name = "high-lift-mobile-platform"
  − version = "0.1.0"
  + version = "0.2.0"
    description = "주행·시저리프트·충전 상태를 단일 플랫폼 상태로 조정하는 참조 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": "Mobile Platform",
      "status": "REFERENCE_MVP",
      "compatibility": {

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

@@ -12,6 +12,18 @@ class ComponentTest(unittest.TestCase):
            result = execute(payload)
            self.assertTrue(result["accepted"])
            self.assertEqual(result["component"], "agerobotics/high-lift-mobile-platform")
  +         self.assertEqual(result["target"], "mcu")
  +         self.assertEqual(result["command"], "LIFT")
  +         self.assertEqual(result["deltaM"], 0.2)
  +         self.assertEqual(result["blockingReasons"], [])
  + 
  +     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"], "agerobotics/high-lift-mobile-platform")
  +         self.assertFalse(result["accepted"])
  +         self.assertEqual(result["status"], "INTERLOCK")
  +         self.assertIn("DRIVE_NOT_HELD", result["blockingReasons"])
    
    if __name__ == "__main__":
        unittest.main()