NOTICE.md +1−0 View file@@ -0,0 +1 @@
1 +
이 코드는 A-SW Hub 연동 교육과 파이프라인 시험을 위한 비아의 참조 MVP입니다. 전북대학교의 공식 연구개발 결과물이 아닙니다.REPOSITORY
jbnu/3d-environment-perception Private
[참조 MVP] 3D 주행환경 인지 A-SW — 3차원 점군을 격자 군집화해 장애물 위치와 경계 상자를 생성합니다.
https://git.agrithing.ai/jbnu/3d-environment-perception.git 456d174 feat: 인지 신뢰도 감사 필드 제안
7b37d22 feat: adopt python VPU SDV reference implementation
8b9d3f5 feat: adopt python VPU SDV reference implementation
2d2177a ci: add language-specific static and dynamic analysis
914852b docs: define component scope and interface contract
15d0349 ci: verify contract tests and evidence package
d73e993 feat: add executable reference MVP
402fbd3 docs: define component scope and interface contract
COMMIT DETAIL
docs: define component scope and interface contract
402fbd3b8e1b237e09a8f87dd1830e18b86b97c7 README.md +37−0 View file@@ -0,0 +1,37 @@
1 +
# 3D 주행환경 인지 A-SW 2 +
3 +
> **연동 검증용 참조 MVP** — 본 저장소는 주식회사 비아가 A-SW Hub 사용 흐름을 검증하기 위해 제작한 참조 구현입니다. 전북대학교의 공식 납품 코드나 연구성과를 대체하지 않습니다. 4 +
5 +
## 목적 6 +
7 +
3차원 점군을 격자 군집화해 장애물 위치와 경계 상자를 생성합니다. 8 +
9 +
- 사업 역할 기관: **전북대학교** 10 +
- 기술 영역: **Perception** 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": "3D 주행환경 인지 A-SW interface", 4 +
"type": "object", 5 +
"required": [ 6 +
"component", 7 +
"inputContract", 8 +
"outputContract" 9 +
], 10 +
"properties": { 11 +
"component": { 12 +
"const": "jbnu/3d-environment-perception" 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": "jbnu/3d-environment-perception", 4 +
"displayName": "3D 주행환경 인지 A-SW", 5 +
"owner": "전북대학교", 6 +
"implementationAuthor": "주식회사 비아 (연동 검증용 참조 구현)", 7 +
"version": "0.1.0-mvp", 8 +
"domain": "Perception", 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 +
}