유해위험방지계획서 심사 대비 도구

부천 소사 안전포털
사용 안내와 제작 가이드

부천 소사구 심곡본동 룩소르LH 주상복합 신축공사(지하 4층·지상 23층, 굴착 19.88m)의 유해위험방지계획서 공단 제출본을 바탕으로 만든 심사 대비 포털을 어떻게 쓰는지, 그리고 다른 현장에서 같은 결과물을 다시 만들려면 어떤 순서로 무엇을 시키면 되는지 정리한 문서

심사일 2026.10.07근거 표기: 본책 N 계획서 PDF 쪽 · 브리핑 N 브리핑자료 쪽 · 법령

1바로 쓰는 주소

구분	주소 · 위치	설명
시작 페이지	https://sosa.luxor.kr	누구나 열 수 있는 공개 주소 · 설명 영상과 전체 메뉴
3D 시뮬레이터·포털	sosa.luxor.kr/site/	3D 위험대응 시뮬레이터와 브리핑·교육·점검·가이드 · 내 PC에서는 룩소르 폴더의 index.html로 인터넷 없이 열림
설명 영상 시청 페이지	sosa.luxor.kr/watch/	현장 개요와 시나리오 6개의 대응 절차를 음성과 자막으로 설명
전체 설명 영상	sosa.luxor.kr/watch/video/full.mp4	아래 7편을 하나로 이은 파일
장면별 설명 영상	00_intro.mp4 현장 개요 01_retain.mp4 흙막이 가시설 붕괴 02_rain.mp4 집중호우 · 침수 03_crane.mp4 타워크레인 강풍 04_shore.mp4 거푸집 동바리 붕괴 05_confined.mp4 밀폐공간 질식 06_fire.mp4 지하층 화재 · 폭발	모두 sosa.luxor.kr/watch/video/ 안에 있음 · 파일명 앞 번호가 시나리오 번호
문서간 불일치 검토서	부천소사_문서간_불일치_검토서.docx	Word 파일 · 원문 인용, 쪽 번호, 정정 제안, 조치 체크표
공유 썸네일	sosa.luxor.kr/share/	og-thumb.jpg(포털) · watch-thumb.jpg(영상) · guide-thumb.jpg(이 문서), 1200×630

PC 화면(가로 1280px 이상)에서 Chrome 또는 Edge 권장, 휴대폰에서도 열람 가능
포털 첫 화면 위쪽의 모드 단추(휴대폰은 화면 아래 탭)로 브리핑 · 교육 · 점검 · 가이드 중 하나를 고름
처음이라면 가이드 모드의 따라 하기 투어로 1분 안에 화면 구성을 익힘
영상은 시청 페이지에서 장면별로 고르거나 전체 영상을 재생 · 영상 파일(.mp4)은 웹 페이지가 아니어서 공유 미리보기가 나오지 않으므로, 공유할 때는 시청 페이지 주소를 씀

2화면 구성과 조작

2-1. 비상대응 시나리오 6개

아래 표는 포털의 시나리오 데이터(scenarios.js)에서 그대로 뽑은 값. 관리기준 수치는 계측값 막대가 경보 단계를 바꾸는 경계

번호	시나리오	공정 단계	단계를 바꾸는 계측값	진행 단계	본책 근거
01	흙막이 가시설 붕괴	굴착 단계	지중경사계 최대 수평변위 1차 29.8 · 2차 39.8 · 3차 49.7 mm	평상시 → 1단계 · 안전 → 2단계 · 주의 → 3단계 · 위험 → 응급 복구	본책 668본책 3본책 1266본책 660본책 1269
02	집중호우 · 침수	굴착 단계	지하수위 일 변화량 1차 0.5 · 2차 0.75 · 3차 1 m	호우 예보 접수 → 작업 중지 · 안내방송 → 저지대 근로자 대피 → 배수 · 응급 보강 → 공사 재개 전 점검	본책 668본책 201본책 221본책 540본책 1274
03	타워크레인 강풍	골조 공사	풍속 (평균풍속) 1·2차 10 · 3차 15 m/s	안전 작업 범위 → 주의 경보 → 경고 경보 → 위험 경보	본책 477본책 472본책 160본책 480본책 501
04	거푸집 동바리 붕괴	골조 공사 · 슬래브 타설	계측값 없이 단계별 진행	타설 전 점검 → 타설 중 이상 징후 → 하부 근로자 대피 → 붕괴 · 구조 → 긴급 보강 · 재발 방지	본책 1286본책 1395본책 200브리핑 17본책 1289
05	밀폐공간 질식	마감 공사 · 지하층	산소농도 1차 18 · 2차 12 · 3차 10 % 값이 기준 미만으로 내려가면 단계 상승	작업 전 측정 → 환기 불량 · 산소 저하 → 감시인 발견 · 신고 → 구조 · 강제 환기 → 응급조치 · 상황 종료	본책 1881본책 1883본책 1882본책 200본책 198
06	지하층 화재 · 폭발	설비 공사 · 지하층	계측값 없이 단계별 진행	13:30 화재 발생 → 13:35 최초 발견 · 보고 → 13:45 신고 · 구급차 유도 → 13:50 화재 진압 → 13:55 구호 · 소화 확인 → 14:00 상황 종료	본책 199본책 200

2-2. 사용 모드 4가지

모드	쓰임
브리핑	심사 대비. 현장 개요와 투시도, 공정 계획, 주변 현황, 공종별 위험요인, 3D 비상대응 시뮬레이터, 장비·가설·산안비, 안전관리 조직, 모의 심사, 심사 전 보완 사항
교육	근로자 교육. 오늘의 TBM(작업 전 안전점검) 카드, 7대 재해 예방, 3대 사고, 안전 퀴즈, 용어 풀이
점검	관리자 실무. 심사 CHECK LIST 44항목 숙지 표시, 회의·점검 일정, 비상연락망, 현장 판정기(풍속·가스·계측 기준 판정)
가이드	사용 안내, 공부 계획, 제작 순서 (이 문서와 같은 내용을 포털 안에서 볼 수 있음)

2-3. 시뮬레이터 조작

조작	하는 일
3D 모형 / 단면도	3D 실척 모형과 2D 단면도 전환. 3D를 쓸 수 없는 기기는 자동으로 단면도
지하 단면	남측 지반을 상자 모양으로 잘라 지층과 지하층 내부 표시
표지	3D 위 설명 라벨 켜기·끄기
전체 화면	3D가 화면 전체를 채우는 관제실 화면 (Esc로 닫기)
자유 보기	굴착·골조·완공 단계 전경. 완공 모형은 투시도 외관을 반영
시간	주간·야간·하루 흐름 (창문·가로등·차량 불빛)
투시도 → 3D	투시도가 같은 방향의 3D 시점으로 녹아들며 전환
단계 막대	평상시 → 1·2·3단계 → 복구. 키보드 ←→로도 이동
계측값 막대	값을 움직이면 관리기준(초과·미만)에 따라 경보 단계가 자동으로 바뀜
자동 진행	6초 간격으로 단계를 차례로 진행
경보음	본책 203쪽의 경보 신호 패턴 재생 (처음 누를 때 소리 허용)
음성 브리핑	선택한 시나리오의 단계별 상황·조치를 음성과 자막으로 읽으며 3D가 함께 진행
우측 패널	단계별 상황, 경보, 조직별 조치와 담당자, 근거 쪽, 심사 예상 질문
검색	Ctrl+K로 전체 검색. "668쪽"처럼 쪽 번호로도 찾고, 쪽 번호 배지를 누르면 같은 쪽을 근거로 하는 항목이 모임

3모의 심사관 (AI)

브리핑 모드의 모의 심사 영역에서 사용 · 위쪽 탭으로 AI 모의 심사 · 자유 질문 · 카드 학습을 고름
AI 모의 심사: 공종 선택 → "심사 질문 받기" → 답변 입력 → "채점 받기" (Ctrl+Enter) · 질문은 계획서와 CHECK LIST로 만든 48문항, 공종 15개 (공사개요, 가설전기, 비계·방지망, 천공기·이동식크레인, 타워크레인, 리프트, 굴착·흙막이, 계측, 동바리·데크, 갱폼, 철근콘크리트, 마감, 밀폐공간, 화재, 비상대응)
채점 결과: 등급(상·중·하), 잘한 점, 빠진 점, 근거 쪽수가 붙은 모범 답변 요점 · 수치·기준·절차·책임자만 보고 말투나 문장 형식은 평가하지 않음
연습 기록: 공종별 최근 등급이 남고, "하"가 있는 공종에는 본책 해당 쪽을 다시 읽으라는 표시가 붙음 (이 기기에 저장)
자유 질문: 계획서 내용을 물으면 포털에 정리된 공사개요·공종별 위험·비상대응·CHECK LIST·보완 사항에서 근거를 찾아 쪽 번호를 붙여 답함 · Enter로 보내기, Shift+Enter로 줄바꿈
카드 학습: 질문 카드를 넘기며 숙지 여부를 표시 · 공종별 걸러 보기, "심사 엄격 항목만", "다시 볼 문제만", 순서 섞기 지원

AI는 어떻게 동작하나

공개 사이트(sosa.luxor.kr)와 내 PC 폴더에서는 키워드 채점과 자료 검색으로 동작함 (서버 비용 없음)
내 PC 파일로 열었거나 AI 사용을 허용하지 않으면 키워드 채점과 자료 검색으로 자동 전환
AI 답변의 쪽 번호와 수치는 포털 데이터 범위 안에서만 나오도록 걸러지지만, 심사 전에는 본책 원문 쪽으로 다시 확인

4주말 공부 순서 (10/7 심사 대비)

번호 순서대로 하면 됨. 체크 표시는 이 기기의 브라우저에만 남음

심사 전 보완 사항 확인문서 간 불일치를 읽고 정정하거나 답변을 준비브리핑 › 심사 전 보완 사항
전체 설명 영상 시청 또는 전체 음성 브리핑현장 개요와 6개 시나리오 대응 순서를 소리 내어 따라 말하기설명 영상 시청 페이지 · 가이드 › 전체 음성 브리핑
시나리오 6개 자동 진행단계별 관리기준 수치와 책임 조직 외우기브리핑 › 비상대응 시뮬레이터
시나리오별 심사 예상 질문 펼쳐 보기답변 요점과 근거 쪽수 확인비상대응 시뮬레이터 › 우측 패널
CHECK LIST 숙지 표시44항목을 숙지·보완 필요로 표시점검 › 심사 CHECK LIST
모의 심사관으로 공종별 연습"하"를 받은 공종은 본책 해당 쪽 다시 읽기브리핑 › 모의 심사
엄격 심사 항목 카드 학습데크슬래브·타워크레인·데릭 해체 관련 문항모의 심사 › 카드 학습
현장 판정기 연습풍속·산소농도·계측 관리기준을 직접 넣어 보기점검 › 현장 판정기
비상연락망과 비상조직 공석 확인배치예정 조와 감리 미정에 대한 답변 준비브리핑 › 안전관리 조직 · 점검 › 비상연락망

날짜별 나눔 예시

날짜	할 일
10/3 (토)	1. 심사 전 보완 사항 확인 2. 전체 설명 영상 시청 또는 전체 음성 브리핑 3. 시나리오 6개 자동 진행
10/4 (일)	4. 시나리오별 심사 예상 질문 펼쳐 보기 5. CHECK LIST 숙지 표시
10/5 (월)	6. 모의 심사관으로 공종별 연습 7. 엄격 심사 항목 카드 학습
10/6 (화)	8. 현장 판정기 연습 9. 비상연락망과 비상조직 공석 확인

심사 당일 아침에는 보완 사항 목록과 시나리오별 관리기준 수치만 한 번 더 훑어봄

5심사 전 보완 사항

계획서 본책·브리핑자료 사이에서 찾은 불일치 20건 (중요도 높음 3 · 중간 8 · 낮음 9). 원문 인용과 정정 제안은 문서간 불일치 검토서(Word)에 있음

#	중요도	항목	근거
1	높음	타워크레인 풍속 기준 혼재	본책 459본책 477본책 479본책 480본책 483안전보건규칙 제37조
2	중간	공사명·용도 명칭 불일치	본책 1본책 3본책 7본책 10본책 139본책 173
3	높음	비상조직·안전조직 공석	본책 7본책 176본책 189본책 193
4	중간	질식 훈련 시나리오에 화재 문구 잔존	본책 198본책 200본책 1881
5	낮음	밀폐공간 대피계획 문구 오기	본책 200안전보건규칙 제639조
6	낮음	협의체 회의일 표기 차이	본책 186본책 188
7	중간	적정공기 기준 수치 차이	본책 1876본책 1878본책 1883안전보건규칙 제618조
8	높음	계측기 수량 공란·불일치	본책 665본책 1266
9	중간	시스템동바리 적용 층고 기준 3가지	브리핑 17브리핑 18본책 1286
10	중간	2차 대피장소 미지정	본책 192본책 205
11	중간	리프트 대수 불일치	본책 159본책 160본책 168본책 170본책 490
12	낮음	타워크레인 하중·설치시기 표기 차이	본책 159본책 163본책 400본책 410브리핑 5브리핑 25브리핑 27
13	중간	지하수위 검토에 타 현장 문구 의심	본책 639
14	낮음	준공일 표기 차이	본책 3본책 7본책 173
15	낮음	굴착 가설계단 수량 차이	본책 543본책 162브리핑 4
16	낮음	굴착장비 대수 표기 차이	본책 160본책 515본책 519
17	중간	갱폼·알폼 구조검토 미완	브리핑 20CHECK LIST
18	낮음	철근콘크리트 작업기간 오타	본책 1739
19	낮음	경찰 연락처 표기	본책 195
20	낮음	한전 연락처 2종 병기	본책 138본책 195

포털의 보완 사항 화면에서 항목마다 조치 상태(미착수·조치중·완료)를 표시해 두면 공부 진행률에 반영됨

6제작 가이드 — 다른 현장에서 같은 작업을 하는 방법

6-1. 준비물

구분	내용
원자료	유해위험방지계획서 PDF(공단 제출본), 브리핑자료 PDF·HWP, CHECK LIST HWP, 투시도·조감도 이미지
작업 도구	Claude Code (데스크톱 앱 또는 터미널), Python·Node (검증·빌드용)
게시	정적 호스팅(Netlify) + 자체 도메인 sosa.luxor.kr · HTTPS 자동 발급 · GPU 서버 불필요
AI	보는 사람의 Claude 계정으로 채점 (서버 비용 없음)
영상	Windows 한국어 음성(Heami) · 그래픽 카드가 있는 PC(3D 캡처) · Python PIL(자막·캐릭터) · ffmpeg
소요 시간	자료 파악부터 게시까지 반나절 안팎
주의	현장 실명·연락처는 계획서에 적힌 범위만 사용, 외부 공유 전 확인

PDF와 이미지를 한 폴더에 모은 뒤 그 폴더를 Claude Code 작업 폴더로 열기
인증키나 접속 정보가 생기면 한 파일에 모아 두고 대화창에 값을 직접 붙여 넣지 않기
여러 도구가 같은 폴더를 쓰면 결과물이 섞이므로, 도구별 하위 폴더를 정해 두고 그 안에만 쓰게 하기

6-2. 진행 순서와 Claude Code 입력 문장

회색 상자의 문장을 복사해 Claude Code에 그대로 넣고, 각 단계의 확인 항목을 직접 점검한 뒤 다음 단계로 넘어감

① 자료 파악 (에이전트 2개)

이 폴더의 유해위험방지계획서 PDF, 브리핑자료, CHECK LIST를 파악해 주세요.
에이전트 2개로 나눠 한쪽은 참고 사이트를, 한쪽은 문서 추출(공사개요, 공종별 위험, 비상대응, 계측 관리기준, 문서간 불일치)을 맡기고 모든 항목에 본책 PDF 쪽 번호를 붙여 주세요.

확인 정리된 수치와 쪽 번호 몇 개를 PDF에서 직접 대조

② 데이터 계약과 작성

화면이 읽을 데이터 형식(data-contract.md)을 먼저 정하고, 에이전트가 data.js와 scenarios.js를 그 형식으로 채우게 해 주세요.
CHECK LIST의 본문 쪽번호는 PDF 쪽으로 환산하고, 계획서에 없는 내용은 만들지 말아 주세요.

확인 node --check로 문법 확인, 항목 수 확인

③ 교차 검증

두 에이전트가 서로 만든 데이터를 본책 원문과 대조하게 하고, 틀린 쪽 번호·수치·법령 기준을 고쳐 주세요.

확인 이번 작업에서는 흙막이 버팀보 4단→7단(본책 683쪽), 크레인 법령 풍속 20→15m/s를 이 단계에서 바로잡음

④ 화면 (4개 모드)

브리핑·교육·점검·가이드 4개 모드의 단일 HTML 포털로 만들어 주세요.
모든 수치에 쪽 번호 배지를 달고, 휴대폰·다크 모드·인쇄를 지원해 주세요.

확인 PC 1280px·휴대폰 390px·다크 모드에서 가로 넘침과 콘솔 오류 확인

⑤ 3D 시뮬레이터와 투시도

three.js로 1m 실척 3D 현장 모형을 만들고 굴착·골조·완공 단계와 6개 비상 시나리오를 본책 관리기준대로 재현해 주세요.
첨부한 투시도의 외관을 완공 모형에 반영하고 주간·야간·하루 흐름을 넣어 주세요.

확인 시나리오마다 1~3단계를 눌러 수치와 조직별 조치가 본책과 같은지 대조

⑥ 모의 심사관 (서버 없이)

Artifact의 Claude 호출 기능으로 모의 심사(질문 출제→답변 채점)와 자유 질문을 넣어 주세요.
채점은 수치·기준·절차·책임자만 평가하고, AI를 쓸 수 없으면 키워드 채점으로 대신하게 해 주세요.

확인 답을 아는 질문 3~4개로 쪽 번호가 근거 목록 안에서만 나오는지 확인

⑦ 음성 브리핑

브라우저 음성 합성으로 시나리오 단계별 상황과 조치를 읽고 3D가 자동 진행되게 해 주세요. 자막은 두 줄 가운데 정렬, 상자 없이 그림자와 하단 그라데이션으로.

확인 마지막 문장까지 끊기지 않는지, 단위(m·mm·%) 발음이 자연스러운지 확인

⑧ 검증과 게시

헤드리스 브라우저로 화면을 점검하고 Artifact로 게시해 주세요.

확인 3D 캔버스는 스크린샷에 안 잡힐 수 있어 캔버스 이미지를 직접 추출해 확인

⑨ Word 보고서 (에이전트 2개)

문서간 불일치를 컬러 텍스트 없이 Word로 작성해 주세요. 에이전트 2개로 작성과 검증을 나눠 주세요.

확인 모든 word/*.xml에서 색·강조·음영이 없는지, 인용이 해당 쪽에 실제로 있는지 확인

⑩ 설명 영상

현장 개요 1편과 시나리오 6편, 전체를 이어 붙인 영상 1편을 만들어 주세요.
- 음성: 장면별 상황과 조치 문장을 Windows 한국어 음성(Microsoft Heami)으로 읽고, 단위(m·mm·%)와 약어는 읽기 쉬운 말로 바꿔 주세요.
- 화면: 헤드리스 Chrome을 그래픽 카드(--use-angle=d3d11)로 띄우고, 가상 시간으로 프레임을 하나씩 진행시키며 3D 캔버스를 초당 24장으로 캡처해 주세요.
- 자막과 안내 캐릭터: Python PIL로 두 줄 자막(그림자, 하단 그라데이션)과 만화풍 안내 캐릭터를 프레임에 합성해 주세요.
- 합치기: ffmpeg로 프레임과 음성을 MP4로 묶고, 시청 페이지(watch/index.html)도 만들어 주세요.

확인 영상마다 끝부분을 재생해 마지막 문장까지 끊기지 않는지, 음성과 화면 단계가 맞는지, 자막이 화면 밖으로 나가지 않는지 확인

⑪ 공유 썸네일과 사용 안내

투시도를 배경으로 포털·영상·가이드용 1200×630 썸네일을 만들고 og:image에 연결해 주세요.
사용 방법과 제작 순서를 정리한 안내 페이지를 한 파일로 만들고, 서버 없이 암호로 잠가 주세요(본문 암호화).

확인 썸네일 글자가 여백 안에 들어오는지, 틀린 암호로는 본문이 열리지 않는지 확인

6-3. 이번 작업에서 겪은 문제와 해결

문제	원인	해결
참고 사이트가 같은 현장	같은 공단 제출본을 근거로 함	쪽 번호·수치를 PDF로 다시 검증한 뒤에만 재사용
흙막이 버팀보를 4단으로 그림	참고 모형 값을 그대로 씀	교차 검증에서 본책 683쪽 7단 확인 후 수정
크레인 법령 풍속 20m/s	참고 사이트 오기	현행 안전보건규칙 제37조(순간 15m/s)로 수정
경계값이 다음 단계로 판정	"이상" 비교 사용	계획서 표현대로 "초과·미만" 비교
보조 계측값이 기준과 어긋남	단순 비례 환산	관리기준 구간별 선형 환산
3D가 스크린샷에 안 나옴	헤드리스 GPU 버퍼	preserveDrawingBuffer + 캔버스 이미지 직접 추출
땅이 굴착부를 덮음	지면 평면에 구멍 없음	지면을 구멍 난 도형으로 생성
방음벽·건물이 굴착부를 가림	카메라 시야 가림	가림 객체 자동 반투명
지하 단면이 밋밋함	한 평면만 절개	상자형 절개 + 지층 단면
로컬 파일에서 숨긴 요소가 보임	게시 환경의 기본 규칙 없음	[hidden] 규칙 직접 추가
투시도 이미지 37MB	원본 5016px PNG	1920px JPEG로 압축
Word 기본 스타일에 색	문서 생성기 기본값	모든 XML 색을 000000으로 정리 후 재검사
다른 도구의 파일이 섞임	같은 폴더를 함께 사용	원위치로 되돌리고 룩소르 폴더만 사용
쪽 번호 예시를 AI가 복사	지시문 예시 번호	근거 목록 안의 쪽만 쓰도록 지시, 화면에서 한 번 더 걸러냄
영상 캡처가 느림	그래픽 카드 없이 CPU(SwiftShader)로 렌더링	Chrome을 RTX 5080 그래픽 카드(Direct3D11)로 실행해 프레임당 180ms→14ms

6-4. 결과물 점검표

모든 수치와 쪽 번호를 본책 원문과 대조 공유 링크가 열리는지, 다른 사람에게 공유 설정했는지 확인 3D가 열리지 않는 기기에서 단면도로 바뀌는지 확인 모의 심사관이 근거 쪽수를 붙여 답하는지 확인 음성 브리핑과 설명 영상이 마지막 문장까지 끊기지 않는지 확인 이름·전문 용어 발음을 직접 들어 확인 Word 보고서를 Word에서 열어 쪽 나눔 확인 썸네일 주소가 실제 게시 주소(절대 경로)로 바뀌었는지 확인 현장 실명·연락처를 외부에 공유해도 되는지 확인

6-5. 구성

구성	내용
포털 화면	site/index.html 한 파일 (src/app.html·app.css·app.js·guide.js를 build.py가 합침)
데이터	site/src/data.js (현장 데이터) · site/src/scenarios.js (6개 시나리오)
3D	site/src/sim3d.js (three.js r147, 1m 실척) · site/src/scene.js (2D 단면도 대체 화면)
투시도	site/render/*.jpg (사용자 제공, 1920px)
AI	Artifact의 Claude 호출 기능 · 없으면 키워드 채점
음성	브라우저 음성 합성 (Web Speech) · 없으면 자막만
설명 영상	watch/index.html (시청 페이지) · watch/video/*.mp4 · video/ (tts.py 음성, capture.js 3D 캡처, segments.json 대본)
보고서	부천소사_문서간_불일치_검토서.docx
썸네일	share/*.jpg · share/make_thumbs.py (Python PIL, 맑은 고딕)
이 문서	guide/guide.html · guide/build_guide.js (Node, 본문 AES-GCM 암호화)
빌드	python site/build.py → site/index.html, site/build/artifact.html · node guide/build_guide.js → guide/guide.html

서버 접속 정보와 인증키는 문서와 코드에 기록하지 않음
현장 실명과 연락처는 계획서에 적힌 범위에서만 쓰고, 외부 공유 전에 담당자 확인