physics_demo_sim

고등학교 물리 수업(물리학I)용 인터랙티브 시뮬레이션과 실험 분석 도구 모음입니다. 모두 설치 없이 브라우저에서 실행되며 스마트폰에 대응합니다.

🌐 바로 사용하기

배포하면 아래 주소로 접속합니다. 둘 중 하나만 설정해도 되고, 둘 다 써도 됩니다.

• Vercel: https://physics-demo-sim.vercel.app (저장소 import 후 자동 배포)
• GitHub Pages: https://hs2sks.github.io/physics_demo_sim/

Vercel 연동 (권장 — push할 때마다 자동 반영)

1. https://vercel.com 에 GitHub 계정으로 로그인
2. Add New… → Project → Import Git Repository → physics_demo_sim
3. Framework Preset은 Other(정적 사이트), 설정은 기본값 그대로 Deploy
4. 이후 main에 push하면 Vercel이 자동으로 다시 배포합니다.

이 저장소에는 정적 사이트용 vercel.json이 포함되어 있어 별도 빌드 설정이 필요 없습니다.

GitHub Pages (대안)

저장소 Settings → Pages → Source Deploy from a branch → Branch main / (root) → Save

구성

index.html                     ← 랜딩 페이지 (수업 자료 · 시뮬레이션 모음 · 학생 제출자료)
mechanics/                     역학
├── gravity/                   중력가속도(g) 측정
│   ├── free-fall/             🍎 자유낙하        ✔ 완료
│   ├── pendulum/              🕰 단진자          ✔ 완료
│   ├── inclined-plane/        📐 빗면            ✔ 완료
│   └── spring/                🌀 용수철 진자      준비 중
├── newton-second-law/         ⚖️ 뉴턴 제2법칙 가상 실험실  ✔ 완료
├── kepler-laws/                🪐 케플러 법칙 → 뉴턴 만유인력  ✔ 완료
├── circular-motion-vector/     🔄 등속원운동 벡터 워크벤치  ✔ 완료
├── circular-motion-lab/        🌀 등속원운동 실험 설계(구심력 측정·보고서)  ✔ 완료
└── equilibrium/               ⚖️ 역학적 평형(병진·회전)  ✔ 완료
electromagnetism/              전자기            시뮬레이션 7개
optics/                        광학              시뮬레이션 4개
└── newton-rings/              🔵 뉴턴 링(스마트폰 촬영·분석)  ✔ 완료
interdisciplinary/             융합
├── energy-city/               ⚡ 에너지 도시 건설 게임(3D, KENTECH 창의성 면접 문항)  ✔ 완료
└── village-defense/           🏹 시대를 건너는 마을 수비대(포물선·공기저항·천체 중력·전기장 디펜스 게임, 서버 랭킹)  ✔ 완료
modern-physics/                현대물리
└── photoelectric-effect/      💡 광전효과        ✔ 완료
tools/                         분석 도구
└── stroboscope/              📸 스트로보스코프(운동 영상 분석)  ✔ 완료
lectures/                      📚 수업 자료 (수업용 프레젠테이션 · 복습용)
├── index.html                 수업 자료 허브 (과목·단원별 목록, 검색)
└── index.json                 자료 목록
students/                      🎓 학생 제출자료 (년도·학기별 누적)
├── index.html                 학생 자료 허브 (목록)
├── 2026-1/
│   └── physics2-mechanics.html   2026학년도 1학기 물리학2 역학 (31명)
└── 2026-2/                       2026학년도 2학기 (과제방 제출작)
    ├── physics/                  2학년 물리학
    ├── physics2/                 3학년 물리학2
    └── mechanics-energy/         2학년 역학과 에너지
        (각 폴더: index.html 갤러리 · items.json 목록 · runs/NNN.html 작품)

각 시뮬레이션 폴더에는 index.html과 기획 문서 PRD.md가 함께 있습니다.

학생 자료 추가 방법

1. students/<년도>-<학기>/ 폴더에 갤러리 HTML 파일을 넣습니다 (예: students/2026-2/physics/index.html).
2. students/index.json 배열에 항목을 한 줄 추가합니다.

수업 자료(프레젠테이션) 추가 방법

1. lectures/<과목폴더>/ 에 프레젠테이션 HTML을 넣습니다 (예: lectures/physics1/2026-10-01-escape-velocity.html).
2. lectures/index.json 배열에 항목을 추가합니다.

{ "subject": "물리학1", "unit": "역학과 에너지", "title": "탈출 속도",
  "date": "2026-10-01", "desc": "한 줄 설명", "tags": ["만유인력"],
  "path": "physics1/2026-10-01-escape-velocity.html" }

이 페이지에는 수업용 프레젠테이션만 올립니다. 단독 시뮬레이션은 각 분야 폴더에 둡니다.

공통 특징

• 매개변수 조절 UI · 실시간 그래프 · 측정 기록 · CSV 저장
• 수동 측정(반응 시간 오차 체험) vs 자동 측정 비교
• 교사 시연용 큰 글씨 모드 / 학생 개별 탐구 / 수행평가(미지 행성 X) 겸용
• 실제 실험(학교 건물·교실) 보조 기능 내장

저작권·라이선스

© 2026 CrazyRay. 직접 만든 자료는 CC BY-NC-SA 4.0입니다. 대학 기출·교과서·외부 영상 등 외부 자료의 권리는 각 권리자에게 있으며, 출처와 삭제 요청 창구는 사이트의 legal.html·sources.html에 있습니다.