수십년간 묵은 갈증이 해소된것 같습니다. "전통기술 관련하여 제작이나 작동원리를 쉽게 알 수 있는 프로그램이 있으면 좋겠다" 맘만 먹고 수십년이 흘렀네요. 플래시를 열심히 배워서 플래시로 구현해 볼까? 3D 모델링을 배우고 나서는 3D 모델링으로 구현해 볼까? 마음만 열심히 앞섰는데 드디어 실현이 되었습니다. 클로드를 사용한지 1주일 정도 되는것 같습니다. 그 전에는 glm-5.3-flash를 사용했었습니다. 일주일 사이에 만든 자료들 입니다.
hanok-ten.vercel.app · 원문 보기jagyeongnu.vercel.app · 원문 보기angbuilgu.vercel.app · 원문 보기geojunggi-1z5j-eight.vercel.app · 원문 보기chukugi.vercel.app · 원문 보기iljungsungsiwi.vercel.app · 원문 보기
singijeon.vercel.app · 원문 보기
glm으로 3D 모델링 시도해 보았는데 상당히 손이 많이 갔습니다. 아무래도 처음 시도해 보니 프롬프트도 모르고 방법도 몰라서 그랬던것 같습니다. 그런데 클로드는 짠~~~뿅하고 바로 만들어 주는데 감탄이 절로 나왔습니다. 전통기술을 가르칠땐 주로 동영상으로 학생들에게 교육했습니다. 자격루 같은 것은 영상을 보아도 참으로 이해하기 난해 합니다. 국립고궁박물관에서 복원을 하였지만 복원에 사용된 부재의 치수나 방법 등은 무엇때문인지 모르겠으나 치수등 데이타를 공개하지 않습니다. 가장 많은 수정을 한 것이 자격루 입니다. 전통기술 시리즈가 완성되어 내년에 모둠별로 1개씩 선택하여 공부한 뒤 친구들에게 알려주는 방식으로 수업을 계획해 보려 합니다. 1차시 : 전통기술 배우기 2차시 : 자료 만들기 3차시 : 모둠별 돌아가면서 설명하기 전통기술과 관련된 자료를 만들때 시행착오 내용을 정리하고자 합니다.
- 확실한 근거로 제작해라. 제일 중요 합니다.
- 클로드는 사진만 제공해 주면 자바스크립트로 알아서 부재를 만들어 줍니다. 이때 다양한 사진 자료가 좋습니다. 앞, 뒤, 옆 다양한 각도에서 캡쳐한 이미지를 던져 줘야 합니다.
- 전통기술은 자료가 많이 없습니다. 논문이나 각종 보고서를 미리 다운받아 제공해줘야 합니다. 알아서 만들라고 하면 자신이 구현하지 못하는 부분은 아예 손을 대지 않습니다.
- 교육용 앱이라서 근거를 통해 만들라고 해야 합니다. 그런데 AI가 찾을 수 없는 부재의 치수는 가정해서 만들라고 하고 이를 표시하라고 하면 됩니다.
- 1개만 제대로 되면 이때부터 나머지는 일사 천리 입니다. 처음 하는 것에 신경을 많이 써야 합니다. 그리고 첫번째 것이 완성되면 해당 skill로 나머지 것들도 같은 형식으로 만들라고 하면 됩니다.
- stl 과 같은 모델링 파일이 필요한 경우에는 openSCAD 코드로도 작성해 달라고 하면 클로드가 잘 만들어 줍니다. 그럼 3D 프린터로 출력도 할 수 있습니다. 한옥.짜맞춤 3D 교실은 openSCAD 코드가 제공 됩니다. 해당 파일 클로드에 던져주고 부재별 stl 만들어 달라고 하면 알아서 척척 만들어 줄겁니다.
- 수정시 캡쳐후 해당 부분을 고쳐 달라고 하면 클로드가 제일 빨리 알아 듣습니다. 텍스트로 전달하다 보면 클로드와 사용자 간의 소통이 원활하게 진행되지 않는 경우도 생깁니다. 아래 사진의 경우 "빨간색으로 표시한 신기전 앞부분을 삭제해줘."

일주일간 클로드랑 전통기술 웹앱 신나게 잘 만들었습니다. 이젠 학기초 미술선생님과 함께 하고자 했던 프로젝트 해보려 떠나봅니다~~~ 아래는 핵심 skill.md 내용 입니다. 필요하신분은 수정하여 사용해 보세요..... name: heritage-edu-3d-webapp description: 거중기·녹로·측우기·신기전처럼 전통 과학기구·문화유산을 근거 기반 교육용 3D 웹앱(조립 순서, 원리, 시뮬레이션, 자료 그래프, 퀴즈)으로 만들 때 사용. 자료 조사·근거 표시·three.js 모형·물리 시뮬레이션·검증·GitHub/Vercel 배포 절차를 담음. 교육용 3D 웹앱 만들기 (전통 과학기구·문화유산) 원칙은 하나: 확실한 근거로 만들고, 근거가 없는 것은 「가정」이라고 화면에 밝힌다.
- 사용자가 제작 전에 준비할 것 (체크리스트)
맨 처음에 한꺼번에 주세요. 나중에 주면 같은 부분을 두세 번 다시 만들게 됩니다.
자료
[ ] 원본 그림·도면: 의궤 도설, 병기도설, 실측 도면 등. 「이 그림을 기준으로」라고 알려 주면 최우선 근거로 삼습니다.
[ ] 실물·복원품 사진 여러 장: 앞·옆·뒤·위, 부재가 맞물린 곳 확대 사진. 박물관 복원품 사진이 특히 유용합니다.
[ ] 논문·보고서 PDF: 가능하면 글자를 뽑을 수 있는 PDF(스캔본이면 필요한 쪽수를 알려 주세요).
[ ] 수치 데이터: CSV·XLSX 원본 파일과 그 출처 URL(예: Zenodo DOI, 기상자료개방포털).
[ ] 자료끼리 다를 때 따를 순서: 예) 「원본 그림 > 논문 > 백과사전 > 기사」.
결정할 것
[ ] 대상: 초등 고학년~중학생 / 고등학생 이상 (용어 수준이 달라짐)
[ ] 메뉴(탭): 예) 제작(조립 순서) · 구조 · 원리 · 직접 조작 · 현장 재현 · 자료 그래프 · 퀴즈
[ ] 중심 대상: 여러 종류가 있으면 무엇을 주인공으로 할지 (예: 화차+신기전기 중심)
[ ] 기록이 없는 부분 처리: 전통 기법으로 복원하고 「추정」 표시 / 빼기
[ ] 배포 위치: 새 폴더·새 저장소 / 기존 앱 안에 탭으로, GitHub Pages / Vercel
[ ] 배포 계정: GitHub 로그인(gh auth login), Vercel은 토큰 준비(PC 이름에 한글이 있으면 vercel login이 실패함)
요청하는 방법
고칠 곳은 스크린샷에 빨간 원으로 표시하고, 앱의 부재 이름(수레채, 옆판, 원공목통…)으로 말해 주세요. 「가운데 선」「바깥쪽」 같은 말은 여러 뜻으로 읽힙니다.
고칠 점은 화면을 다 둘러본 뒤 한 번에 묶어서 주세요.
질문 창을 거절했다면 원하는 방향을 한 줄로 알려 주세요.
- 작업 순서 (Claude)
자료부터 다 읽는다 — 코드를 쓰기 전에.
한글 PDF가 pdftotext로 안 뽑히면 pdfjs-dist(cMapUrl 지정)로 글자를 뽑는다. 그래도 안 되면 쪽을 그림으로 렌더링해 읽는다.
MHTML은 HTML 파트를 get_payload(decode=True).decode('utf-8')로 읽는다.
XLSX는 압축을 풀어 sharedStrings + sheetN.xml을 직접 해석(의존성 없이).
그림·사진은 직접 열어 본다. 원본 그림에 격자를 대고 주요 점을 재서 비율표를 먼저 만든다.
근거표를 만든다 — 부재·수치마다 값과 근거, 근거 수준(원문 / 2차 인용 / 복원 실험 / 가정).
애매하거나 사용자가 정할 것만 짧게 묻는다 — 질문 창은 4개 이하, 추천안을 첫 번째에. 기본값으로 정할 수 있는 것은 묻지 말고 정한 뒤 알린다.
순수 함수(sim.js) → 테스트 → 3D 모형 → 화면 → 검증 순서로 만든다.
스크린샷으로 확인하고 고친 뒤 보고한다. 「고쳤다」고 말하기 전에 같은 각도에서 다시 찍는다.
사용자가 요청할 때만 커밋·푸시·배포한다.
- 근거 원칙
화면의 모든 수치에 출처를 단다. 그래프 아래, 표 아래, 「근거와 출처」 접이식 상자, README. 단계마다 기록(파랑 꼬리표)과 추정(주황 꼬리표)을 나눠 표시한다. 기록이 없는 것(결구 방법, 피해 반경 등)은 만들되 「가정」 표시 + 근거로 알려진 사실만 함께 적는다. 바꿔 볼 수 있게 슬라이더로 두면 좋다. 자료 사이 불일치는 숨기지 말고 적는다. 예) 약통 겉지름 기록 102mm ≠ 안지름+두께×2 = 95.5mm → 복원은 95.5mm. 테스트로 검산하면 이런 불일치를 찾을 수 있다. 확인 못 한 연도·저자는 넣지 않는다. 위험한 내용(화약 등)은 역사·원리 수준까지만, 실제 제조 절차·수치는 넣지 않고 안전·법률 안내를 단다. 시뮬레이션은 복원 실험값으로 보정하고, 보정에 쓰지 않은 다른 실험 조건으로 검증한다(오차를 밝힌다).
- 기술 구성
three.js 0.160 + esbuild, 결과물은 한 개의 index.html(오프라인에서도 열림). 필요하면 페이지 여러 개(nokro.html).
폴더 구조
app/
src/sim.js 치수·근거·계산 (DOM/three 금지, node 테스트)
src/model.js 3D 모형
src/app.js 화면·탭·애니메이션·퀴즈
src/charts.js SVG 그래프(필요 시)
src/template.html HTML+CSS 틀 (%%SCRIPT%% 자리)
test/*.test.mjs node --test
tools/ 원자료 → src/data.js 변환
data/ 원자료(출처 README에 기록)
build.mjs, package.json, README.md, vercel.jsonpackage.json 테스트: node --test "test/*.test.mjs" (폴더만 주면 Windows에서 실패할 수 있음)
단위: 치수는 mm로 sim.js에, 3D는 m(÷1000), y가 위.
테마: CSS 변수(--bg --fg --pn --ac --bd --mut), 다크 모드, 16px 여백, 860px 이하 세로 배치.
화면 틀 (재사용)
왼쪽 3D(#cv) + 오른쪽 설명(aside), 위쪽 탭, 3D 위 캡션(#cap), 확대·축소·처음 시점 버튼.
이름표는 Sprite + sizeAttenuation:false(거리와 상관없이 같은 크기, 0.03 정도).
시점 이동은 view(pos, target)로 부드럽게, 세로 화면이면 거리를 늘린다.
조립 순서: 단계 배열(제목·설명·기록·추정·결구 종류) → 부재 그룹을 차례로 보이게 + 내려앉는 애니메이션 + 「부재 떼어 보기」.
결구(짜임·맞춤·이음)는 오른쪽 작은 캔버스에 따로 렌더링해 맞물렸다 벌어지기를 반복.
디버그용 전역: window.__set = {tab, step, ...}, window.__state(), window.__cam.
그래프
dataviz 원칙: 축 하나, 시대·종류 색은 고정 순서, 팔레트는 validate_palette.js로 검사(밝은·어두운 모드 각각), 마우스 오버 툴팁, 표로 보기, 그래프마다 출처.
- 자주 한 실수 (먼저 피하기)
Object.assign(mesh, { position }) → 오류(position은 읽기 전용). mesh.position.set()을 쓴다.
[hidden]이 CSS display:flex에 덮여 안 숨겨짐 → [hidden]{display:none!important}.
반 자른 단면(thetaLength: π)은 자른 면이 카메라 쪽을 향하는지 확인(회전 필요). 앞에 다른 부재가 가리지 않는지도.
피벗 위치: 앞을 들어 올리려면 뒤끝을 회전 중심으로.
거울상 부재(왼쪽 바퀴·도르래)의 회전 방향, 수레의 진행 방향(옆으로 미끄러지지 않게 돌아서 이동)을 처음부터 표로 점검.
실물 구조를 짐작하지 말 것: 받침이 있는지, 차축형(굴대 고정)인지 구동축인지, 바퀴가 차체 안/밖인지 → 사진으로 확인하고 모르면 묻는다.
CSG(구멍 뚫기)는 면이 빠져 윤곽선이 깨질 수 있음 → 꼭 필요할 때만.
셸 heredoc 안의 따옴표 문제 → 긴 수정은 Python/JS 스크립트 파일로 써서 실행하고, 바꿀 문자열이 있는지 assert로 확인.
swiftshader에서는 프레임이 느려 카메라 이동이 늦게 끝남 → 스크린샷 전에 4~5초 기다린다.
- 검증
테스트: 기록 치수 검산(합계·층수·지름=안지름+2×두께), 원자료 재현(논문의 평균·최댓값), 시뮬레이션이 실험 범위에 드는지, 결측 처리. 스크린샷(Playwright + chromium, swiftshader): 탭마다, 단계마다, 모바일(390×844). 콘솔 오류 0개 확인.
chromium.launch({ executablePath: <chrome.exe>, args: ['--use-gl=angle','--use-angle=swiftshader','--enable-unsafe-swiftshader'] })스크린샷을 직접 열어 보고: 라벨 겹침, 잘림, 부재 사이 틈, 엉뚱한 방향, 카메라 구도.
- 배포
GitHub (작업 저장소 안의 하위 폴더를 새 저장소로)
git add app && git commit -m "..." # 끝에 Co-Authored-By 줄
git push origin <작업 브랜치>
gh repo create <계정>/<앱> --public -d "..."
git subtree split --prefix=app -b app-export
git push https://github.com/<계정>/<앱>.git app-export:main
git branch -D app-export
gh api -X POST repos/<계정>/<앱>/pages -f "source[branch]=main" -f "source[path]=/" # PagesVercel: vercel.json (buildCommand: npm run build, outputDirectory: .). 로그인이 안 되면 토큰:
vercel deploy --prod --yes --token <토큰> — 토큰은 대화에 붙여 넣지 말고, 썼다면 바로 폐기. GitHub 저장소를 Vercel에 Import하면 푸시마다 자동 배포.
- 보고 방식
무엇을 했는지 → 검증 결과(테스트 수, 확인한 화면) → 근거 수준과 가정값 → 사용자가 정할 것(짧게). 실험값과 계산값은 표로 나란히, 오차는 숫자로. 커밋·배포 여부를 분명히(「아직 커밋하지 않았습니다」).

댓글 4
댓글 2개를 더 불러오고 있어요