teraWeb/final-build/README.md

# 최종 장비 빌드

릴리스: **20260910-demo-log-controls-1** · Linux ARM64 · 시연 장비: http://192.168.0.223/

2026-09-10 프론트엔드·API·로그 데몬에 이어 메일 알림 데몬을 갱신했습니다. 설치 SHA256 일치와 서비스 준비 **12/12**를 확인했습니다. 나머지 네 파일은 이전 최종 빌드 세트에서 유지했습니다.

메일 수정: 발송 시 현재 비밀번호 저장 파일을 읽어 UI에서 새로 저장한 SMTP/Trap 자격 증명을 반영합니다. 기존 테스트 메일 재시도는 **16:29:10 KST에 delivered**로 완료됐습니다. 이 상태는 SMTP 서버의 수락이며 수신함 도착 확인과는 구분합니다. 메일 데몬의 이전 실행 파일은 `/userdata/tera-backups/alarm-live-secrets-20260910`에 보관했습니다.

시리얼 키워드 수정: 실제 seriald가 logd에 기록한 새 RX 데이터도 알림 검사 대상에 포함합니다. 분할 수신을 이어서 비교하고 같은 기록을 반복 발송하지 않습니다. API와 배포 환경의 검사 주기는 2초입니다. 장비 적용 해시 및 12/12 준비 완료를 확인했으며 이전 API/환경 파일은 `/userdata/tera-backups/serial-keyword-20260910`에 보관했습니다. 과거 로그 재발송은 하지 않으므로 새 RX로 시연합니다.

이 디렉터리는 실행 파일 모음입니다. boot/rootfs를 포함한 전체 펌웨어 `.pkg`는 아닙니다. 장비 설정, 사용자 계정, 인증서 개인키와 런타임 로그는 포함하지 않습니다.

## 파일과 설치 경로

| 파일 | 장비 설치 경로 | 서비스 | 이번 변경 |
|---|---|---|---|
| frontend/tera-clone-demo-web | /usr/bin/tera-clone-demo-web | S61teraweb | 갱신 |
| backend/tera-clone-demo-api | /usr/bin/tera-api | S50tera-api | 갱신 |
| backend/tera-logd | /usr/bin/tera-logd | S44tera-logd | 갱신 |
| backend/tera-timed | /usr/bin/tera-timed | S45tera-timed | 유지 |
| backend/tera-clone-demo-alarmd | /usr/bin/tera-alarmd | S47tera-alarmd | 비밀번호 갱신 반영 수정 |
| backend/tera-seriald | /usr/bin/tera-seriald | S40tera-seriald | 유지 |
| backend/tera-sessiond | /usr/bin/tera-sessiond | S55tera-sessiond | 유지 |
| backend/tera-netd | /usr/bin/tera-netd | S43tera-netd | 유지 |

설치 실행 권한은 0755입니다. 이 장비의 웹 설정은 HTTP 80과 기존 서비스 구성을 유지합니다. 이번 로그 기능에는 일치하는 API·웹·로그 데몬이 모두 필요합니다. 배포 시 기존 바이너리를 백업하고 로그 데몬의 소켓 준비를 확인한 다음 API를 시작해야 합니다.

## 반영 내용

- 사용자 계정 작업 셀 정렬 수정.
- 포트 운영자의 로그 메뉴와 로그 API 접근 제거.
- 인증 서버의 ‘장애 시 인증’, 주소 필터의 ‘안전 안내’ 고정 UI 제거.
- DDNS IPv6 항목 제거. DDNS 화면에서 적용하면 IPv6 사용을 끄고 IPv6 도메인을 비웁니다.
- 시리얼 이벤트 감지 키워드 편집 및 포트 고급 설정과 공유.
- 시스템 로그의 기존 감사 기록 포함 삭제.
- 포트 로그 단일 채널 및 전체 48포트 삭제(확인 문자열 ALL).
- 포트 상태 이벤트 전체 삭제(확인 문자열 LINKS). 현재 링크 상태는 변경하지 않습니다.
- 삭제 체크포인트 및 다른 접속의 캐시 갱신 처리.

## 검증 결과

- 백엔드: logstorage, logservice, api, adapters/mock 패키지 전체 테스트 통과.
- 프론트엔드: handlers, mock 패키지 테스트 통과.
- JavaScript: 삭제 제어 11개, 로그 표시 7개, 시리얼 키워드 1개 테스트 통과.
- 전체 포트 삭제 후 다른 종류 로그 유지, 상태 이벤트 삭제 후 재시작 복구 방지, 새 이벤트 수집과 다른 클라이언트 캐시 갱신 검증.
- 8개 실행 파일의 ELF64 AArch64 형식과 체크섬 확인.
- 장비 배포 후 웹의 ALL/LINKS 코드 제공 및 준비 상태 12/12 확인.

검증을 위해 장비의 기존 로그를 실제로 삭제하지 않았습니다. SNMP·인증서 신뢰·48채널 전체 트래픽·실기 기록 중 전원 차단 내성은 이 릴리스에서 완료했다고 주장하지 않습니다.

## 파일 무결성과 배포 기록

[SHA256SUMS](SHA256SUMS)에 모든 실행 파일의 해시가 있습니다. [release-manifest.json](release-manifest.json)에 크기·설치 경로·검증 범위가 있습니다.

이번 장비 백업: `/userdata/tera-backups/ui-settings-20260910-125259`.

[시연 자료](../demo-guide/README.md)에는 실제 주소 필터 차단 사례와 복구, 제공된 SSL 인증서 입력 화면, SNMP 시험, 알림·로그 삭제 절차와 결과 기록표가 포함되어 있습니다.