Claude Code 등 코딩 에이전트가 이 저장소에서 작업할 때 따라야 할 안내 문서.
산업 데이터를 비교·분석해 가설을 통계적으로 검증하는 정형데이터 분석 프로젝트다.
핵심 가설과 목표: 스마트장비·로봇 도입이 산업재해를 줄이는가를 검증한다. 검증 방법으로 **비율검정(two-proportion test)**을 채택했다 — 스마트 안전장비 도입 현장의 재해율과 전국 중소규모 건설현장 평균 재해율을 비교해, 그 차이가 통계적으로 유의한지 2표본 비율 Z-검정·Fisher 정확검정·95% 신뢰구간으로 분석한다. 재해율은 연속형 측정값(반응시간 등)이 아니라 "재해 발생 여부"를 근로자 수에 대해 집계한 비율(proportion) 데이터이므로, 평균 차이를 보는 t-검정이 아니라 비율검정이 적합하다. (당초 검토했던 도입 전/후 대응표본 t-검정은 전/후 데이터 확보에 실패해 폐기 — 상세 경위는 docu/work.md.)
현재 상태: 비율검정 분석을 문서 수준에서 완료했다(docu/비율검정_분석문서.md). 근거 데이터는 류정·박인선(2025, Crisisonomy) 논문 및 News1(2024)의 공개 통계이며, 도입 현장(123개소, 근로자 4,481명) 재해율 0.357% vs 전국 평균 0.461%를 비교했다. 결과: 상대적으로 22.56% 낮았으나 통계적 유의성은 확인되지 않음(Fisher 정확검정 p≈0.18, 95% CI가 0을 포함). 사고가 드문 사건(rare event)이라 현재 표본 규모로는 검정력이 부족한 것으로 해석되며, 방향성 자체는 K-NAVI의 필요성을 뒷받침한다. asset/의 CSV(로봇밀도, 대업종별 사고재해자/사망자, 재해정도)와 src/plane/의 시각화는 배경·정황 자료다. 비율검정 재현 스크립트는 src/origin/proportion_test.py에 구현돼 있으며 실행 결과가 분석 문서 수치와 일치함을 확인했다. 상세 설계·현황은 docu/design.md, 진행 상황·작업 이력은 docu/work.md 참고 (작업 완료 시 work.md에 날짜와 함께 기록할 것).
python -m pip install -r requirements.txt
VSCode에서는
Python (버전 고정 없음). ctrl+shift+p -> Run Task -> 필요라이브러리 설치시
requirements.txt 에 명시된 라이브러리 자동 설치 혹은
Ctrl+Shift+B (기본 빌드 태스크 "필요 라이브러리 설치") 한 번으로 설치가 끝난다 (.vscode/tasks.json이 OS별로 python/python3 명령을 자동 선택).
테스트와 린터는 아직 설정되어 있지 않다.
가설 검증(비율검정)을 중심으로 데이터는 아래 흐름을 따른다.
근거 통계
├ asset/ CSV (고용노동부 산업재해현황 + IFR 로봇밀도) — 배경/정황 자료
└ 논문 인용 수치 (류정·박인선 2025, News1 2024) — 비율검정 대상
↓
[구현 완료] 전처리 + 탐색적 집계·시각화 (src/plane/) — 히트맵·막대그래프
↓
[완료, 문서화] 비율검정 (도입현장 재해율 vs 전국 평균 재해율)
· 2표본 비율 Z-검정 + Fisher 정확검정 + 95% 신뢰구간
· 결과·계산과정: docu/비율검정_분석문서.md
↓
[일부 완료] 결과 시각화 — 사고재해율 비교(10번), 사망자·부상자 비교(11번)
↓
[구현 완료] 비율검정 재현 스크립트 — src/origin/proportion_test.py (분석 문서 결과와 일치 확인됨)
asset/ — 원본 CSV 11개, 배경/정황 통계(로봇밀도 1, 대업종별 사고재해자 2023src/plane/visualize.py, src/plane/visualizetwo.py — asset/ 데이터를 탐색적으로 정리·시각화하는 스크립트(핵심 히트맵 4종 + 확장 분석 5종).src/plane/visualize_smart_equipment.py, src/plane/visualize_casualties.py — 논문 인용 수치로 도입현장 vs 전국 평균을 비교하는 차트(사고재해율 10번, 사망자·부상자 11번). 비율검정 결과의 시각적 근거.src/origin/proportion_test.py — 채택된 비율검정(2표본 Z-검정 + Fisher 정확검정 + 95% CI + 독립성 보정)을 재현하는 실행 스크립트. python src/origin/proportion_test.py로 결과표 출력. asset/ CSV가 아니라 논문 인용 수치(상수)를 사용.visualizations/ — 생성된 PNG(커밋됨). 스크립트를 다시 실행하면 같은 파일명으로 덮어씀.docu/ — 비율검정_분석문서.md(채택된 비율검정의 가설·계산과정·결과·한계 전체), design.md(프로젝트 개요·현황), work.md(날짜·작성자별 작업 일지).asset/ 폴더에서만 읽는다. 경로는 pathlib.Path로 다루고 하드코딩된 절대경로를 넣지 않는다."광 업", "농 업") — 매칭 전 정규화 필요. 스크립트마다 처리 방식이 다르니 새로 작성할 때는 일관되게 맞출 것.아직 댓글이 없습니다.
로그인 후 댓글을 남길 수 있어요