NewWebConfigurator/CHANGELOG.md

# Changelog — Web Configurator

파트너 전달용 변경 이력입니다. **v1.11.16부터** 이 형식으로 관리합니다.

---

## [v1.12.1] — 2026-06-29
### Added
- **텔레메트리 Uplink (Ethernet 전환)**: dpworldapp 클라우드 텔레메트리(프로토콜·업데이트·RTCM) 송신을 웹 UI 에서 Wi-Fi↔Ethernet 전환. 호스트 라우트(/32)만 사용 — dpworldapp·OS 설정 무접촉. 워치독 자가복원 + 관리 인터페이스 보호.
- **라우팅 투명성**: 서버별 실제 송신 인터페이스 표시 + 인터페이스 선택의 영향(로컬 LAN 가림 등) 적용 전 경고(읽기 전용).
### Fixed
- **전체 소스 리뷰 41건 반영**(정직성·안전성·구조): 점검 전 상태의 거짓 정상표시 제거, 설정 로드 실패 시 빈 값 저장 차단, 로그 자동정리 마지막 아카이브 과삭제 방지, 중복 경로/보안 로직 통합 등. **dpworldapp 공유 DB(device/protocol 설정)·계약·타입은 무변경.**
### Note
- 설치 경로(`/usr/lib/web-configurator`)·기본 포트(`:9090`)는 v1.12.0 그대로 유지.

## [v1.12.0] — 2026-06-25
### Changed
- **앱 코드 설치 경로 이전**: `/opt/web-configurator` → `/usr/lib/web-configurator` (협력사 BSP
  베이킹 정합 — FHS상 `/usr/lib` 가 read-only program code 자리). 쓰기 런타임 데이터는 그대로 유지:
  로그 `/opt/log/dpworldapp`, 펌웨어 `/opt/fw_staging`·`/opt/fw_upload`, 설정 백업 `/opt/config_backups`.
- `web-configurator.service`: `ExecStart`·`WorkingDirectory` 를 새 경로로 변경. 코드 디렉토리는
  서비스가 직접 쓰지 않으므로 `ReadWritePaths` 에서 제거(`ProtectSystem=strict` 하 read-only 로 충분).
- `BSP-INTEGRATION.md` 레시피: 코드 설치를 `${libdir}/web-configurator`(=`/usr/lib`) 로 변경,
  쓰기 디렉토리 목록에서 코드 디렉토리 제외. `scripts/deploy.ps1` `$AppDir` 동일 이전.
- **기본 포트 통일 8080→9090**: `server.py` 코드 기본 포트를 9090 으로 변경(systemd 유닛값과 동일).
  설정기는 PC 개발·디바이스 모두 `:9090` 단일 포트. 디바이스의 `:8080` 은 별개의 레거시 Java
  app-runner 임을 문서에서 명확화(README/DEPLOY/network-apply-engine-guide). 디바이스 동작은
  무변경(유닛이 이미 `PORT=9090` 지정) — bare/PC 실행 시 기본값만 9090 으로 바뀜.

> 앱 로직·UI·디바이스 계약은 무변경. 설치 경로(배포 계약) 이전 + 포트 정돈. 이전 버전: v1.11.16.

---

## [v1.11.16] — 2026-06-23
### Changed
- `web-configurator.service` 의 `MemoryMax` 를 **48M → 128M** 로 상향. support-bundle(진단 zip, 메모리 빌드)
  + UI 동시 사용 시 실측 피크 ~40-50MB로 OOM-kill 위험이 있어 여유를 확보 (장비 RAM 3.4GB 대비 3.7%,
  누수 방지 캡은 유지). 정적자산 최대 93KB·펌웨어 업로드는 디스크 스트리밍이라 메모리 영향 없음.

### Docs
- BSP 통합 가이드 정비 — 네트워크-적용 하드닝본을 **`/usr/bin/dpworld-network-apply.sh` 원본 교체
  (BSP 베이킹)** 하는 것을 1차 방식으로 명시. `.service.d` override 드롭인은 라이브 후적용 fallback으로 정리.
  (`RELEASE-NOTES.md` §3, `BSP-INTEGRATION.md` §7, `docs/firmware-boot-hardening.md`)
- 배포물을 repo 루트(flat) 구조로 정리.

> 앱 코드·UI는 v1.11.15와 동일 (기능 무변경). 본 릴리스는 배포 단위의 메모리 정책 + 통합 가이드 정비입니다.

---

## [v1.11.15] — 2026-06-23
### Changed
- 사이드바 네비게이션 정비: **System** 그룹(Dashboard + Log)과 **Firmware** 그룹 분리, System 그룹에 monitor 아이콘 적용. (v1.11.14–v1.11.15)
- (v1.11.12–v1.11.13: 대시보드 visual-calm 시도 후 되돌림 — 최종 외형 변화 없음)

---

## [v1.11.11] — 2026-06-23
### Changed
- config 쓰기 경로를 디바이스 config-reader 계약에 정렬: RS485 parity `no→none`, 2/4-byte order 공백형
  (`little swap`/`big swap`), register `idt` `float`(`float64` 제거), protocol 목록에서 CAN 제거
  (`can_input` 토글로 대체), 채널 `ai2`/`ai3`/`di2`/`di3` 지원.

### Added
- 기존 디바이스 DB의 옛 표기를 새 계약 표기로 **부팅 시 1회 자동 변환** (멱등 마이그레이션, 변경 전 자동 백업).

---

## [v1.11.10] — 2026-06-20
- 전체 코드리뷰 반영 — 입력 검증/정규화 강화 다수.
Release v1.11.16 - MemoryMax 128M + BSP-baking integration guide - web-configurator.service: MemoryMax 48M -> 128M (support-bundle+UI 동시 사용 시 OOM-kill 위험 제거; 장비 RAM 3.4GB 대비 3.7%, 누수 방지 캡 유지) - BSP 통합 가이드 정비: 네트워크-적용 하드닝본을 /usr/bin/dpworld-network-apply.sh 원본 교체(BSP 베이킹)하는 것을 1차 방식으로 명시. .service.d override 드롭인은 라이브 후적용(over-the-top) fallback으로 정리 - 최신 UI(v1.11.15: 사이드바 System/Firmware 그룹 + monitor 아이콘) 동기화 - 배포물 flat 레이아웃(루트=배포물), 내부 참조/산출물 정리 1 month ago			`# Changelog — Web Configurator`

			`파트너 전달용 변경 이력입니다. v1.11.16부터 이 형식으로 관리합니다.`

			`---`

Release v1.12.1 — Telemetry Uplink + routing transparency + 41-item stabilization Folds in the previously-uncommitted v1.12.0 changes (install path /opt/web-configurator -> /usr/lib/web-configurator; default port 8080 -> 9090), since v1.12.0 was never committed or tagged. The diff vs v1.11.16 therefore covers v1.12.0 + v1.12.1 together; CHANGELOG.md keeps the logical split. v1.12.1: - Telemetry Uplink: switch dpworldapp cloud telemetry egress between Wi-Fi and Ethernet using host routes (/32) only; no dpworldapp/OS network config touched; async apply + watchdog self-heal + management-interface protection. - Routing transparency: per-server actual egress interface + pre-apply warnings (read-only; no forwarding/NAT opened). - Full source review (41 items): honesty/safety/structure fixes. dpworldapp shared DB (device/protocol), atomic-write contract, and types unchanged. - Remove superseded pages ssid.js/network.js (aliased to wifi.js/server-setting.js). - Remove legacy deploy/nginx.conf sample (optional; excluded per integration guide). See CHANGELOG.md and RELEASE-NOTES.md for the full per-version breakdown. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> 1 month ago			`## [v1.12.1] — 2026-06-29`
			`### Added`
			`- 텔레메트리 Uplink (Ethernet 전환): dpworldapp 클라우드 텔레메트리(프로토콜·업데이트·RTCM) 송신을 웹 UI 에서 Wi-Fi↔Ethernet 전환. 호스트 라우트(/32)만 사용 — dpworldapp·OS 설정 무접촉. 워치독 자가복원 + 관리 인터페이스 보호.`
			`- 라우팅 투명성: 서버별 실제 송신 인터페이스 표시 + 인터페이스 선택의 영향(로컬 LAN 가림 등) 적용 전 경고(읽기 전용).`
			`### Fixed`
			`- 전체 소스 리뷰 41건 반영(정직성·안전성·구조): 점검 전 상태의 거짓 정상표시 제거, 설정 로드 실패 시 빈 값 저장 차단, 로그 자동정리 마지막 아카이브 과삭제 방지, 중복 경로/보안 로직 통합 등. dpworldapp 공유 DB(device/protocol 설정)·계약·타입은 무변경.`
			`### Note`
			- 설치 경로(`/usr/lib/web-configurator`)·기본 포트(`:9090`)는 v1.12.0 그대로 유지.

			`## [v1.12.0] — 2026-06-25`
			`### Changed`
			- 앱 코드 설치 경로 이전: `/opt/web-configurator` → `/usr/lib/web-configurator` (협력사 BSP
			베이킹 정합 — FHS상 `/usr/lib` 가 read-only program code 자리). 쓰기 런타임 데이터는 그대로 유지:
			로그 `/opt/log/dpworldapp`, 펌웨어 `/opt/fw_staging`·`/opt/fw_upload`, 설정 백업 `/opt/config_backups`.
			- `web-configurator.service`: `ExecStart`·`WorkingDirectory` 를 새 경로로 변경. 코드 디렉토리는
			서비스가 직접 쓰지 않으므로 `ReadWritePaths` 에서 제거(`ProtectSystem=strict` 하 read-only 로 충분).
			- `BSP-INTEGRATION.md` 레시피: 코드 설치를 `${libdir}/web-configurator`(=`/usr/lib`) 로 변경,
			쓰기 디렉토리 목록에서 코드 디렉토리 제외. `scripts/deploy.ps1` `$AppDir` 동일 이전.
			- 기본 포트 통일 8080→9090: `server.py` 코드 기본 포트를 9090 으로 변경(systemd 유닛값과 동일).
			설정기는 PC 개발·디바이스 모두 `:9090` 단일 포트. 디바이스의 `:8080` 은 별개의 레거시 Java
			`app-runner 임을 문서에서 명확화(README/DEPLOY/network-apply-engine-guide). 디바이스 동작은`
			무변경(유닛이 이미 `PORT=9090` 지정) — bare/PC 실행 시 기본값만 9090 으로 바뀜.

			`> 앱 로직·UI·디바이스 계약은 무변경. 설치 경로(배포 계약) 이전 + 포트 정돈. 이전 버전: v1.11.16.`

			`---`

Release v1.11.16 - MemoryMax 128M + BSP-baking integration guide - web-configurator.service: MemoryMax 48M -> 128M (support-bundle+UI 동시 사용 시 OOM-kill 위험 제거; 장비 RAM 3.4GB 대비 3.7%, 누수 방지 캡 유지) - BSP 통합 가이드 정비: 네트워크-적용 하드닝본을 /usr/bin/dpworld-network-apply.sh 원본 교체(BSP 베이킹)하는 것을 1차 방식으로 명시. .service.d override 드롭인은 라이브 후적용(over-the-top) fallback으로 정리 - 최신 UI(v1.11.15: 사이드바 System/Firmware 그룹 + monitor 아이콘) 동기화 - 배포물 flat 레이아웃(루트=배포물), 내부 참조/산출물 정리 1 month ago			`## [v1.11.16] — 2026-06-23`
			`### Changed`
			- `web-configurator.service` 의 `MemoryMax` 를 48M → 128M 로 상향. support-bundle(진단 zip, 메모리 빌드)
			`+ UI 동시 사용 시 실측 피크 ~40-50MB로 OOM-kill 위험이 있어 여유를 확보 (장비 RAM 3.4GB 대비 3.7%,`
			`누수 방지 캡은 유지). 정적자산 최대 93KB·펌웨어 업로드는 디스크 스트리밍이라 메모리 영향 없음.`

			`### Docs`
			- BSP 통합 가이드 정비 — 네트워크-적용 하드닝본을 **`/usr/bin/dpworld-network-apply.sh` 원본 교체
			(BSP 베이킹)** 하는 것을 1차 방식으로 명시. `.service.d` override 드롭인은 라이브 후적용 fallback으로 정리.
			(`RELEASE-NOTES.md` §3, `BSP-INTEGRATION.md` §7, `docs/firmware-boot-hardening.md`)
			`- 배포물을 repo 루트(flat) 구조로 정리.`

			`> 앱 코드·UI는 v1.11.15와 동일 (기능 무변경). 본 릴리스는 배포 단위의 메모리 정책 + 통합 가이드 정비입니다.`

			`---`

			`## [v1.11.15] — 2026-06-23`
			`### Changed`
			`- 사이드바 네비게이션 정비: System 그룹(Dashboard + Log)과 Firmware 그룹 분리, System 그룹에 monitor 아이콘 적용. (v1.11.14–v1.11.15)`
			`- (v1.11.12–v1.11.13: 대시보드 visual-calm 시도 후 되돌림 — 최종 외형 변화 없음)`

			`---`

			`## [v1.11.11] — 2026-06-23`
			`### Changed`
			- config 쓰기 경로를 디바이스 config-reader 계약에 정렬: RS485 parity `no→none`, 2/4-byte order 공백형
			(`little swap`/`big swap`), register `idt` `float`(`float64` 제거), protocol 목록에서 CAN 제거
			(`can_input` 토글로 대체), 채널 `ai2`/`ai3`/`di2`/`di3` 지원.

			`### Added`
			`- 기존 디바이스 DB의 옛 표기를 새 계약 표기로 부팅 시 1회 자동 변환 (멱등 마이그레이션, 변경 전 자동 백업).`

			`---`

			`## [v1.11.10] — 2026-06-20`
			`- 전체 코드리뷰 반영 — 입력 검증/정규화 강화 다수.`