Files

T

eomsangdonandClaude Opus 5 eb30b774f8 chore(docs): docs 폴더 git 추적 전환 · PLAN·OWNERS 최상위 이관

- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록)
- `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록
  — 창끼리 공유하되 저장소에는 안 올리는 장부
- 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠)
- graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-09 18:19:07 +09:00

2.9 KiB

Raw Blame History

B07 외부 WebCAD 3종 비교 실행환경 검증 보고서

검증일: 2026-07-19
대상: OpenWebCAD, elhakimz/WebCAD, Maker.js Playground
범위: external_program/ 독립 실행환경, 실행·종료 스크립트, 안내 문서

구현 결과

external_program/openwebcad: bertyhell/openwebcad clone 및 npm ci 완료
external_program/elhakimz-webcad: elhakimz/webcad clone 및 npm ci 완료
external_program/makerjs: microsoft/maker.js clone 및 npm ci 완료
start-cad-demos.ps1: 개별/일괄 기동, 포트 충돌 검사, 준비 상태 확인, PID·로그 기록, 선택적 브라우저 열기 구현
stop-cad-demos.ps1: 기록된 루트 PID와 자식 프로세스만 종료하도록 구현
README_CAD_DEMOS.md: 실행·종료 명령, URL, 비교 항목, 라이선스 및 보안 주의사항 기록

자동 검증

항목	결과
PowerShell 스크립트 구문 분석	2개 파일 모두 오류 0건
OpenWebCAD `npm run build`	성공
elhakimz/WebCAD `npm run build`	성공
Maker.js workspace `npm run build`	성공
OpenWebCAD HTTP	`http://127.0.0.1:5175/` → 200
elhakimz/WebCAD HTTP	`http://127.0.0.1:5174/` → 200
Maker.js Playground HTTP	`http://127.0.0.1:8020/docs/playground/` → 200
일괄 종료	세 루트 PID 및 자식 프로세스 정상 종료
외부 저장소 상태	build 생성 파일 복원 후 세 저장소 tracked 변경 없음

테스트에서 확인된 원본 프로젝트 이슈

OpenWebCAD 테스트는 vitest --run 실행 후 worker 프로세스가 종료되지 않아 중단했다. build와 HTTP 기동은 성공했다.
elhakimz/WebCAD는 320개 중 319개 테스트가 통과했다. Documents/scad/drafting_bolt_2d.scad 픽스처가 원본 저장소에 없어 1개가 실패했다.
npm 설치 시 audit 경고는 OpenWebCAD 32건, elhakimz/WebCAD 8건, Maker.js 28건이다. 원본 재현성을 유지하기 위해 자동 수정하지 않았다.
elhakimz/WebCAD는 README에 MIT를 선언하지만 정식 LICENSE 파일이 없고, 직접 의존성 opencascade.js는 LGPL-2.1이다.

판정

세 후보 모두 사용자가 브라우저에서 직접 비교할 수 있는 상태다. 이 작업에서는 B07 또는 다른 애플리케이션 소스를 수정하거나 후보를 통합하지 않았다.

위키 반영 및 건강 점검

docs/wiki/concepts/b07_external_webcad_demos.md, index.md, log.md에 반영했다.
frontmatter, 상태, 관련 페이지, raw 원본, index 링크, log 기록, 100줄 제한을 수동 점검해 모두 통과했다.
Graphify 증분 갱신 결과: 342 nodes, 284 edges, 58 communities. GRAPH_REPORT와 graph.html을 재생성했다.
Graphify가 기존 추출 데이터에서 source_file 필드 누락 엣지 6건을 경고했다. 그래프는 생성됐지만 이 무결성 경고는 후속 위키 유지보수 항목이다.

2.9 KiB Raw Blame History

B07 외부 WebCAD 3종 비교 실행환경 검증 보고서

구현 결과

자동 검증

테스트에서 확인된 원본 프로젝트 이슈

판정

위키 반영 및 건강 점검

2.9 KiB

Raw Blame History