6.8 포트폴리오 패키징
좋은 포트폴리오는 최고 성공 영상 하나가 아니라 재현 가능한 엔지니어링 주장이다.
필수 구조
project/
├── README.md # 문제, 결과, 안전 범위, 빠른 시작
├── docs/architecture.svg
├── configs/ # limit, camera, policy version
├── src/ # inference, supervisor, bridge
├── launch/
├── experiments/
│ ├── protocol.md
│ ├── results.csv
│ └── failure_taxonomy.md
├── media/ # 성공뿐 아니라 대표 실패 영상
├── model_card.md
├── dataset_card.md
└── LICENSES/
README에는 Ubuntu/ROS 2/GPU/카메라/로봇 버전, 설치 명령, 실행 명령, 기대 출력, 알려진 한계, 안전 경고를 둔다. 비밀키, Hub token, 사람 얼굴/음성, 사유 공간 영상은 제거한다. 외부 모델, CAD, 이미지, 폰트의 라이선스를 기록한다.
보고할 결과
- 전체와 조건별 성공률 + Wilson 95% CI
- latency p50/p95/p99와 deadline miss
- failure taxonomy와 대표 실패 사례
- 필터/안전 감독기 전후 비교
- sim-only, shadow, low-speed, nominal 단계별 증거
- 재현 가능한 checkpoint/dataset/config hash