# 실행 환경

Python 3.14.4, Linux x86_64. 런타임·빌드·검산 코드는 Python 표준 라이브러리만 사용한다. Node v22.23.2는 JavaScript 구문 확인에 사용한다. 브라우저 QA는 Playwright 1.55.0과 기존 Chromium headless shell 1193을 사용하며 PLAYWRIGHT_CHROMIUM_EXECUTABLE은 선택적인 QA 실행파일 경로다. GPU·모델·API 키는 없다.

패키지 루트에서:

```sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python scripts/build.py
.venv/bin/python scripts/calculate.py data/demo_cohort_10y_industry.json --end-age 65 --reference C --output result.json
.venv/bin/python scripts/serve.py --port 8766
```

http://127.0.0.1:8766/ 접속. 종료 Ctrl+C. 다른 포트를 선택할 수 있다. 이 서버 대신 단순 정적 서버를 쓰면 문서는 열리지만 계산 API는 작동하지 않는다.

실제자료 결합:

```sh
python3 scripts/make_bundle.py --metadata metadata.json --aggregate aggregate.csv --standard standard_population.csv --reference reference_mortality.csv --output input.json
python3 scripts/calculate.py input.json --end-age 65 --reference C --output result.json
```

reference는60/64세 계산 시 생략할 수 있다. 해당 자료의 실제 group_code를 지정한다. JSON은 웹 계산기에서 그대로 불러올 수 있다. XML 추출이나 합성 예제 재생성 없이 동봉 자료로 실행 가능하다. 검증은 python3 scripts/test_calculate.py, python3 scripts/verify_package.py이며 브라우저 검사는 QA 환경에서 서버 실행 후 scripts/test_browser.py를 사용한다.