> For the complete documentation index, see [llms.txt](https://melissa-industry.gitbook.io/openmascotai_hologram/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://melissa-industry.gitbook.io/openmascotai_hologram/undefined-1/files.md). # 리포 파일 안내 설계 파일과 출력 파일이 모두 이 리포에 있습니다. 설명서만 보고 만들 수 있지만, 치수를 바꾸거나 다른 프린터로 뽑을 때 봅니다. ## 폴더 | 폴더 · 파일 | 내용 | | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `print/H2D/*.gcode.3mf` | H2D용 출력 파일 15장. USB에 넣어 바로 뽑음 | | `print/H2D/README.md` | 판별 설정 · 서포트 위치 · 떼는 요령 | | `print/plates/<판>/*.stl` | 판별 STL(베드 좌표). 다른 프린터에서 슬라이스할 때 | | `print/parts/*.step` | 부품별 STEP(기기 좌표). CAD에서 볼 때 | | `print/HOLO_print_assembly_ap214.step` | 출력 부품 전체가 조립된 STEP | | `cad/hologram_concept_ap214.step` | 개념 설계 전체(구매 부품 포함) | | `cad/fit_test/` | 모니터 모서리 쿠폰 · 수축 막대 · 구멍 시험편 STL | | `drawings/` | 삼면도 · 광로 단면 · 배치도(PNG · SVG · DXF R2000) | | `drawings/kicad/` | 전장 도면집 KiCad 10 프로젝트(HOLO-EL.kicad\_pro · 시트 9장 · HOLO.kicad\_sym) + 인쇄용 PDF · SVG | | `drawings/pcb/HOLO-A1/` | 허브 기판 PCB KiCad 10 프로젝트(회로도 · 기판 · 사용자 라이브러리) + 샘플PCB 접수용 거버 zip(`HOLO-A1_rev-A_gerber.zip`) + 기판 도면 PDF · 3D 렌더 · README(주문법 · 확인 목록) | | `renders/` | 렌더와 Blender 원본, 조립서 그림(`renders/manual/`), 완성 배치 그림(`renders/final_views/`), 5단계 기둥 홈 · 3단계 LED 링 그림(`renders/step5_views/` · `renders/step3_views/`) | | `renders/assembly/HOLO_full_assembly.glb` · `.blend` | 부품을 전부 제자리에 둔 전체 조립 3D(윈도우 3D 뷰어 · Blender에서 열어 돌려 봄) | | `docs/specs/2026-09-26-hologram-device-design.md` | 설계 문서. 왜 이렇게 만들었는지가 모두 적혀 있음 | | `docs/shopping_list_2026-09-26.md` · `docs/bom_2026-09-26.csv` | 구매 목록 · 부품표 | | `pages/` | 조립서 · 주문표 · 개념 · 배선서 웹 페이지 원본 | | `tools/` | 설계 스크립트 | ## 설계 스크립트 모든 치수는 `tools/dims.py` 한 파일에 있습니다. 나머지 스크립트가 이 값을 읽어 형상 · 도면 · 출력 파일 · 배선서를 만듭니다. | 스크립트 | 만드는 것 | 실행 | | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `tools/make_step.py` | 개념 설계 STEP · IGES | `uv run --python 3.11 --with cadquery python tools/make_step.py` | | `tools/make_print_parts.py` | 1차 출력 부품(옆벽 · 누름대 · 핀) STEP · 판별 STL | 같은 방식 | | `tools/print_shells.py` + `tools/make_print_batch2.py` | 2 · 3차 출력 부품(받침 · 상판 · 뚜껑 · 기둥 · 받침대 · 덕트) · 조립 간섭 검사 | `uv run --python 3.11 --with cadquery python tools/make_print_batch2.py` | | `tools/make_drawings.py` | 도면 3장(SVG · PNG · DXF) | `uv run --no-project --with numpy --with pillow --with ezdxf --with playwright python tools/make_drawings.py` | | `tools/build_scene.py` · `tools/build_manual_renders.py` | Blender 렌더(Blender 필요) | Blender 명령줄 | | `tools/build_final_views.py` + `tools/helpers/final_views_labels.py` | 완성 배치 3D 그림 9장 · 번호표 · 전체 조립 GLB/.blend | `blender -b --factory-startup -P tools/build_final_views.py -- --export` 뒤 `python tools/helpers/final_views_labels.py` | | `tools/build_step5_views.py` · `tools/build_step3_views.py` + `tools/helpers/step5_views_labels.py` | 5단계 그림 2장(기둥 홈 · LED 스트립 · 판 세 장) · 3단계 그림 2장(LED 링 자리) | `blender -b --factory-startup -P tools/build_step5_views.py`(3단계는 build\_step3\_views.py) 뒤 `python tools/helpers/step5_views_labels.py` | | `tools/helpers/make_wiring_page.py` | 배선서 페이지(회로 · 배치 그림 · 전장 도면집) | `python tools/helpers/make_wiring_page.py` | | `tools/helpers/render_figs.py` | 설명서용 PNG(배선 그림) | `uv run --no-project --with playwright python tools/helpers/render_figs.py` | | `tools/kicad/make_kicad.py` | 전장 도면집 KiCad 프로젝트 생성 + kicad-cli PDF · SVG · ERC(+ `--png` 설명서 PNG) | `python tools/kicad/make_kicad.py` (KiCad 10 필요) | | `tools/kicad/make_pcb.py` | 허브 기판 PCB 프로젝트 생성 + 자동 배선 + ERC · DRC + 도면 · 3D 렌더 · 거버 zip | `python tools/kicad/make_pcb.py` (KiCad 10 필요) | | `tools/helpers/bambu/support/` | 출력 파일 슬라이스(Bambu Studio 명령줄, 서포트 분석 · 차단) | 폴더의 README | | `tools/helpers/check_manual.py` | 이 설명서의 숫자 · 링크 검사 | `python tools/helpers/check_manual.py` | `uv`는 파이썬 패키지 실행 도구입니다(astral.sh/uv). cadquery는 CAD 라이브러리라 처음 실행 때 내려받는 데 몇 분 걸립니다. ## 치수를 바꾸고 싶을 때 1. `tools/dims.py`에서 값을 고칩니다. 예를 들어 다른 모니터를 쓰려면 `PANEL_MOD_*`(모니터 크기)와 `PANEL_PORT_SLOT`(포트 창)을 바꿉니다. 2. `make_print_batch2.py`(그리고 옆벽이 바뀌면 `make_print_parts.py`)를 돌려 STL을 다시 만듭니다. 조립 간섭 검사가 "CLASH"를 내면 그 부품을 봅니다. 3. `tools/helpers/bambu/support/README.md`대로 슬라이스해 `.gcode.3mf`를 만듭니다. 서포트가 필요한 곳을 자동으로 찾아 넣습니다. 4. `make_drawings.py`와 `make_wiring_page.py`로 도면과 배선서를 다시 만들고, 설명서의 숫자를 고친 뒤 `check_manual.py`를 돌립니다. ## 설명서 고치기 설명서 원본은 `docs/manual/ko/`입니다. 깃북은 이 폴더를 그대로 가져가므로, 깃북 편집기가 아니라 여기 파일을 고치고 커밋합니다. 새 페이지를 만들면 `SUMMARY.md`에도 넣어야 보입니다. 그림은 `docs/manual/ko/images/`에 두고 상대 경로로 넣습니다.