OSH AI Hub산업안전보건 데이터·AI 플랫폼
← 협업 템플릿으로
데이터 제작 가이드 · 공개v1.2

데이터 제작 가이드

협업자가 만든 자료를 OSH AI Hub에 연결할 수 있도록 준비하세요. 데이터 설명·검증·연구자 정보·실행 환경을 작성하는 양식과 다른 AI에게 전달할 작업 지시문을 제공합니다.

제작 가이드·템플릿 다운로드 (ZIP)

26.6 KB · 로그인 없이 다운로드 · 최종 버전 날짜 2026-09-19

협업은 이렇게 진행합니다

1. 양식과 지시문 받기

ZIP의 START-HERE.md부터 읽고 _template 폴더를 새 작업 위치로 복사하세요. AI 작업 지시문의 A 블록에 자료명과 원본 위치를 채웁니다.

2. 실제 자료로 채우기

원본을 보존하면서 표와 문서를 ID로 연결하고, 출처·연구자·버전·검사 결과를 기록합니다. 모르는 정보는 미확인으로 남깁니다.

3. 담당자에게 전달하기

완성한 패키지와 HANDOFF.md를 합의한 경로로 전달하세요. Hub에서 검증한 뒤 소개·DEMO·다운로드를 연결합니다.

이 페이지는 제작 양식을 제공합니다. 자료 업로드·자동 등록 기능은 아직 없으며, 원본 전달 경로와 공개 범위는 담당자와 정합니다.

기본 설명 파일 7개

README.md

자료 소개, 원문 제공자, 연구책임자·대표 연구자, 버전 날짜·업데이트 계획

dataset.json

자료 ID, 표 연결, 확인된 통계와 기능별 공개 상태

data_dictionary.csv

열의 의미·타입·단위·결측·출처

files.csv

파일 목록·크기·SHA-256·행 수

QUALITY.md

실제로 검사한 내용, 결과와 미검증 항목

ACCESS.md

이용 조건, 개인정보 검토와 공개 가능한 범위

HANDOFF.md

다음 담당자에게 전달할 실행 방법과 미완료 작업

소개 표를 제공하면 preview.csv, 가공하면 PROCESSING.md, DEMO를 만들면 DEMO.md와 실제 참조 코드를 함께 작성합니다.

DEMO · 합성 예시
템플릿에 들어 있는 3행은 양식 설명용입니다. 실제 자료와 섞지 말고 교체하세요.

Python 패키지도 함께 보내야 하나요?

데이터만 전달할 때

CSV·XLSX·MD와 설명만 있다면 requirements.txt는 필수가 아닙니다. 파일 형식과 읽는 방법을 기록하면 됩니다.

Python 코드를 전달할 때

requirements.txt 또는 pyproject.toml과 대응 lock 파일에 실제 사용한 패키지와 검증 버전을 적습니다. ENVIRONMENT.md에는 Python 버전·설치·실행·검사 명령을 기록하세요.

동봉한 requirements.txt는 주석만 있는 작성 양식입니다. 사용하는 패키지를 실제 검증한 버전으로 채우고 새 가상환경에서 실행해 보세요. 표준 라이브러리만 사용하면 외부 패키지 없음이라고 적습니다.

필요한 경우에만 OS 프로그램·GPU/CUDA·모델 정보를 추가합니다. JavaScript 앱은 package.json·lock 파일·Node 버전을 전달합니다. 키·토큰·.venv는 포함하지 않습니다.

연구자·버전 정보도 함께 기록하세요

원문 제공자, 연구책임자, 대표 연구자, 가공 주체를 구분합니다. 현재 버전·최종 버전 날짜·변경 이력과 다음 업데이트 주기·목표일·예정 변경·담당자를 작성하세요. 업데이트 계획은 계획 있음·미정·계획 없음·갱신 종료로 구분합니다.

DEMO 화면도 만들고 있다면

공통 색상·한글 폰트·카드·버튼은 Family Design 키트를 적용하세요.

OSH Family Design 보기

키트 버전과 확인

가이드 v1.2 · 공개일 2026-09-19. 변경 이력: 연구자·버전 관리 양식과 실행 환경·의존성 작성 안내를 포함합니다. 다음 업데이트 일정은 미정이며 규약 변경 시 새 버전으로 제공합니다.

ZIP 안의 KIT-MANIFEST.json에서 파일별 크기와 해시를 확인할 수 있습니다.

ZIP SHA-256 확인6a6eeb2fcca18cedc2facd90f4168a0fca22bf5fc5c402b61e0d8ac477e24517