건설도면프로젝트 학습자료 양식 템플릿 (kikum.xyz/physical-ai-motion 준수)
| 항목 | 내용 |
|---|
| 작성일 | 2026년 11월 17일 |
| 목적 | kikum.xyz/physical-ai-motion 양식을 준수하는 학습자료 HTML(SEQ 19)을 만들기 위한 사전 확정 템플릿 문서 — 색상 팔레트·레이아웃 구조를 원본에서 실측해 규격화한다 |
| 측정 방법 | 원본 페이지 HTML(167,249B, 인라인 CSS 단일 파일)을 직접 내려받아 hex 색상 빈도·:root 변수·@keyframes·@page·문서 골격(body>nav.toolbar + main.paper-wrap + section.readout + section.week-group×N)을 추출 (원본 사본: .style_probe/physical-ai-motion/page.html) |
| 적용 대상 | 19번 시각화 학습자료 HTML 전 페이지 (프로젝트명 표기: 건설도면프로젝트) |
1 색상 팔레트 (원본 실측 — 사용 빈도 순)
1.1 기본 3색 (:root CSS 변수 그대로)
| 변수 | Hex | 원본 사용 | 역할 |
|---|
--paper | #F6F4ED | 77회 | 배경 종이색(전체 페이지) |
--ink | #142B3E | 81회 | 본문 잉크(진네이비)·다크 패널 |
--blue | #245CE4 | 109회(최다) | 주 강조(링크·액션·주요 강조·모션 빔) |
1.2 보조 팔레트 (원본 등장 순)
| Hex | 명칭(본 템플릿) | 용도 |
|---|
| #C9D2D6 | line-silver | 구분선·테두리(84회) |
| #556877 | slate | 보조 본문 회색(64회) |
| #DDE2DF | line-soft | 연한 구분선 |
| #7596A9 | steel | 비활성·보조 라벨 |
| #087F78 | teal-deep | 2차 강조(합격·성공 상태) |
| #63CDC1 / #83DDD1 | teal-light | 성공 상태 밝은 채움·모션 궤적 |
| #D66137 | orange | 3차 강조(경고·주의 포인트) |
| #DFE9EF / #B4CBD9 / #97B2C6 | blue-tint 1~3 | 카드 배경·맵 하이라이트 단계 |
| #FFFFFF | white | 카드 표면 |
| #526673 · #375062 · #203C51 | ink-단계 | 잉크 명도 단계(표·캡션) |
1.3 상태 색 매핑 (본 프로젝트 도식 규약과의 접점)
| 상태 | 색 | 비고 |
|---|
| 강조·진행 | --blue #245CE4 | 원본 모션 빔과 동일 |
| 성공·실증 | #087F78 (+밝은 채움 #63CDC1) | 에뮬 가능/패스 |
| 보류·주의 | #D66137 | 불가·보류(부분 지원은 blue-tint) |
| 앱/중립 | #556877·#C9D2D6 | 14 drawio의 파랑/보라 계열을 본 팔레트의 잉크·틴트로 치환 |
2 레이아웃 구조 (원본 골격 실측)
body#motion-document color-scheme:light
├─ nav.toolbar (aria-label "재생과 인쇄") — sticky 상단바
│ ├─ .brand 로고·문서명
│ ├─ .scrubber 모션 재생 스크러버(진행)
│ └─ .pdf-link 인쇄/저장 링크 버튼
└─ main.paper-wrap A2 종이 컨테이너
├─ section.readout 선택 단계 상세 패널
│ ├─ #read-title · #poster-title · #poster-desc
│ ├─ 링크 3종: #lecture-link/#example-link/#repo-link (host·title 표기)
│ └─ #supplements-section 보조 자료(#supplement-links)
├─ section.weekly-study 주간 계획 헤더(#weekly-heading "…이번 주에 할 일")
└─ section.week-group × N 월 단위 그룹(data-week-month)
├─ .month-bg / .month-rail 배경·레일(세로 시각 축)
├─ .week-marker / .week-chip 주 표식·칩
└─ (히어로) .hero-map — .route(경로) + .rover(이동체) + .beam(빔)×n + .data-flow
골격 규칙: ① 상단 툴바(항상 노출) ② 상단 상세 패널(readout) ③ 본문은 그룹 반복(월→본 프로젝트는 학습 단원 그룹으로 치환) ④ 각 그룹 안에 마커·칩·링크카드.
3 타이포그래피·용지 규격
| 항목 | 규격(원본 실측) |
|---|
| 폰트 | "Malgun Gothic", Arial, sans-serif (시스템 폰트만 — 외부 로딩 없음) |
| 용지 | A2 세로 420mm × 594mm, @page{size:420mm 594mm;margin:0} |
| 화면 픽셀 | 96dpi 기준 1587 × 2245px (페이지 1장 분량) |
| 다크모드 | 비사용(color-scheme:light 고정) — 종이 질감 유지 |
| 여백 | @page margin 0 — 시각 프레임은 .paper-wrap 내부 패딩으로 |
4 모션(모션그래픽) 규격 — 원본 @keyframes 4종
| 키프레임 | 원본 용도 | 본 템플릿 재현 규칙 |
|---|
beam | 히어로맵 광선 펄스 | 파란 빔이 경로 위로 주기적 통과(opacity/스케일 변조) |
data-flow | 데이터 흐름 | 점선(stroke-dashoffset) 이동 — 파이프라인 방향성 표현 |
route | 경로 그리기 | stroke-dashoffset으로 경로가 순차 그려짐 |
rover | 이동체 | 경로를 따라 이동하는 마커(offset-path 또는 translate) |
공통 규칙: 애니메이션은 장식이 아니라 흐름 설명(데이터 이동 방향·처리 순서)에만 사용. prefers-reduced-motion 시 전부 정지(접근성). 재생/정지는 툴바 .scrubber가 담당.
5 콘텐츠 구성 규격 (학습자료 치환 매핑)
| 원본 요소 | 건설도면프로젝트 학습자료(19번) 치환 |
|---|
| 월(月) 그룹 ×7 | 학습 단원 그룹(개요→입력→검색→검증→관계→이벤트→운영) |
| week-chip | 단원별 카드(핵심 개념 1장) |
| readout 링크 3종(lecture/example/repo) | 공인 학습자료 링크(공식 문서·공식 영상·실증 스크립트) — 18번 URL 목록과 1:1 |
| supplements | 용어집(15번)·drawio(14번)·보고서 내부 링크 |
| 히어로맵(경로+로버) | 종단 파이프라인(빔=데이터 흐름) |
6 준수 체크리스트 (19번 HTML 발행 전 자체 점검)
- [ ]
:root 3색 변수명·값 원본과 동일(--ink/--paper/--blue) - [ ] 보조 팔레트는 §1.2 hex만 사용(신규 색 생성 금지 — 명도 단계 제외)
- [ ]
@page{size:420mm 594mm;margin:0} + 화면 1587×2245px 페이지 반복 - [ ] 골격 = toolbar + paper-wrap + readout + 그룹 반복
- [ ] 모션은 beam/data-flow/route/rover 4종의 목적에 일치하게만
- [ ] 외부 리소스(CDN·웹폰트·이미지) 0개 — 오프라인 완전 동작
- [ ] 프로젝트명 표기 건설도면프로젝트 통일
- [ ] 모든 수치·판정은 실측 출처(05·06·07 보고서) 각주
*본 문서는 템플릿 확정 문서다 — 이 규격대로 19번 HTML을 제작한다. 원본 사본은 저작물 참고용으로 .style_probe/에만 보관하고 배포물에는 포함하지 않는다.*