NOTICE.md +1−0 View file@@ -0,0 +1 @@
1 +
이 코드는 A-SW Hub 연동 교육과 파이프라인 시험을 위한 비아의 참조 MVP입니다. 한국생산기술연구원의 공식 연구개발 결과물이 아닙니다.REPOSITORY
kitech/speed-control-asw Private
[참조 MVP] 작업 속도 제어 A-SW — 곡률, 작업 종류와 장애물 거리를 이용해 안전 목표 속도를 산정합니다.
https://git.agrithing.ai/kitech/speed-control-asw.git c105eba feat: adopt cpp ACU SDV reference implementation
5370f9c ci: add language-specific static and dynamic analysis
8897104 docs: define component scope and interface contract
ce13cd4 ci: verify contract tests and evidence package
f7e21c8 feat: add executable reference MVP
5bb5e1a docs: define component scope and interface contract
COMMIT DETAIL
docs: define component scope and interface contract
5bb5e1ad84d07d525cf5c0a1f3425c05ca12f174 README.md +37−0 View file@@ -0,0 +1,37 @@
1 +
# 작업 속도 제어 A-SW 2 +
3 +
> **연동 검증용 참조 MVP** — 본 저장소는 주식회사 비아가 A-SW Hub 사용 흐름을 검증하기 위해 제작한 참조 구현입니다. 한국생산기술연구원의 공식 납품 코드나 연구성과를 대체하지 않습니다. 4 +
5 +
## 목적 6 +
7 +
곡률, 작업 종류와 장애물 거리를 이용해 안전 목표 속도를 산정합니다. 8 +
9 +
- 사업 역할 기관: **한국생산기술연구원** 10 +
- 기술 영역: **Control** 11 +
- 성숙도: 인터페이스 협의 및 파이프라인 검증용 MVP 12 +
- 실행환경: Python 3.11 이상, 외부 패키지 없음 13 +
14 +
## 실행 15 +
16 +
```bash 17 +
python run.py examples/input.json 18 +
python -m unittest discover -s tests -v 19 +
``` 20 +
21 +
CLI는 JSON 입력 하나를 받아 JSON 결과 하나를 출력합니다. 실제 기관 구현으로 교체할 때도 `contracts/component.interface.json`과 `release/manifest.json`의 식별자를 유지하면 통합 릴리스에서 버전을 추적할 수 있습니다. 22 +
23 +
## 저장소 구성 24 +
25 +
- `asw_component/component.py`: 최소 실행 로직 26 +
- `examples/input.json`: 재현 가능한 입력 27 +
- `contracts/`: 기계 판독형 인터페이스 계약 28 +
- `tests/`: 기준 동작 시험 29 +
- `release/manifest.json`: 소유기관·버전·호환성 선언 30 +
- `.gitea/workflows/verify.yml`: 계약→시험→증빙 패키지 CI 31 +
32 +
## 완료 기준 33 +
34 +
1. 예제 입력이 오류 없이 실행됩니다. 35 +
2. 계약 JSON과 단위시험이 통과합니다. 36 +
3. Gitea Actions가 증빙 패키지와 SHA-256을 생성합니다. 37 +
4. 실제 기관 코드는 동일 계약을 구현한 뒤 별도 승인·MIL/HIL 검증을 거칩니다.contracts/component.interface.json +29−0 View file@@ -0,0 +1,29 @@
1 +
{ 2 +
"$schema": "https://json-schema.org/draft/2020-12/schema", 3 +
"title": "작업 속도 제어 A-SW interface", 4 +
"type": "object", 5 +
"required": [ 6 +
"component", 7 +
"inputContract", 8 +
"outputContract" 9 +
], 10 +
"properties": { 11 +
"component": { 12 +
"const": "kitech/speed-control-asw" 13 +
}, 14 +
"inputContract": { 15 +
"type": "string" 16 +
}, 17 +
"outputContract": { 18 +
"type": "string" 19 +
}, 20 +
"transport": { 21 +
"enum": [ 22 +
"JSON/CLI", 23 +
"ROS2-adapter", 24 +
"HTTP-adapter", 25 +
"CAN-adapter" 26 +
] 27 +
} 28 +
} 29 +
}release/manifest.json +20−0 View file@@ -0,0 +1,20 @@
1 +
{ 2 +
"schemaVersion": "asw.release/v1", 3 +
"component": "kitech/speed-control-asw", 4 +
"displayName": "작업 속도 제어 A-SW", 5 +
"owner": "한국생산기술연구원", 6 +
"implementationAuthor": "주식회사 비아 (연동 검증용 참조 구현)", 7 +
"version": "0.1.0-mvp", 8 +
"domain": "Control", 9 +
"status": "REFERENCE_MVP", 10 +
"compatibility": { 11 +
"product": "unmanned-autonomous-agri-machine", 12 +
"api": "asw-component/v1" 13 +
}, 14 +
"evidence": [ 15 +
"unit-test", 16 +
"interface-contract", 17 +
"example-run", 18 +
"sha256" 19 +
] 20 +
}