move_detect/server/public/assets/admin.js
유창욱 e00ad69aa3 feat(safety,ux): 통보·억제·증거 체계 신설 + UI/UX 감사 21건 반영
UI/UX 점검에서 시작해 "이 제품이 안전 시스템으로서 무엇이 없나"까지 내려간 작업.
두 덩어리를 한 커밋으로 둔다 — 뒤쪽 기능들이 앞쪽에서 고친 화면 위에 얹혀 있다.

━━ 1부: UI/UX 감사 21건 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

동선 — 확인(ack) 경로가 위험했다
- 스트림 정렬을 '미확인 우선'에서 엄격 시간순으로 되돌린다. 확인 상태가 연대기를
  뒤집어 사고 재구성이 불가능했고, 확인하면 그 행이 목록 밖으로 사라지며 아래 행이
  밀려 올라와 같은 좌표를 두 번 누르면 다른 이벤트가 확인 처리됐다. 이제 제자리에서
  '확인됨'으로 전환되고 확정 토스트가 뜬다. 처리 큐는 정렬이 아니라 뷰모드 필터로 분리
  (전환해도 행끼리 상대 순서는 절대 안 바뀐다).
- 실행취소는 넣지 않았다. acknowledged_by는 감사로그가 함께 남는 추가 전용 기록이라
  무음 되돌리기가 안전 시스템에서 더 나쁜 속성이다. 대신 오탐·구역삭제를 2단계 확정으로.
- 이벤트 상세에 확인/오탐 신설. 판단하는 화면에 판단 도구가 없었다.
- 구역 설정에 장치·카메라 선택기. 시스템이 아는 값을 사람에게 묻고 있었고,
  플레이스홀더(device-01)마저 실제와 다른 포맷을 가르쳤다.
- 날짜 조회(키셋 커서 시딩). 사고 조사 진입로가 아예 없어 '더 보기'를 반복해야 했다.
- 경보음 세션 음소거(새 위급 도착 시 자동 해제). 끌 수 없는 반복음은 안전 콘솔이
  통째로 꺼지는 경로다.

전달 — 같은 단어가 화면마다 다른 숫자를 가리켰다
- KPI '미확인'(최근 200건)과 24시간 브리프 '미확인'이 40px 간격으로 충돌했다.
  KPI에 실제 집계 범위를 명시. 중대=위급+높음을 인라인 정의.
- 페이지 명칭 3종·날짜 포맷 3종 통일. '확인 필요' 칩을 전 심각도로 확장
  (그전엔 확인 여부가 먼 컬럼의 버튼 유무로만 구분됐다).
- 표본 게이트: 오탐율 '100% (1/1)'이 '33% (5/15)'보다 위에 뜨던 것, 최다 3건짜리
  시간패턴 히트맵, 6→8건에 붙던 빨간 ▲33%. 개선조치 효과는 푸아송 잡음 범위(√before)를
  넘어야 방향을 주장한다 — 안전회의에서 한 번 반박당하면 카드 전체가 신뢰를 잃는다.
- 카메라 위험 순위가 중대>0이면 전부 빨강이라 순위 노릇을 못 했다. 상대 기준으로.

시각 — 화면마다 완성도가 달랐다
- 구역 설정·이벤트 상세를 카드 셸로 재구성. 둘 다 스타일 없는 기본 폼이었고,
  납품 심사에서 "덜 만든 티"는 정확히 거기서 났다.
- 히트맵 토글은 aria-pressed만 있고 CSS 규칙이 없어 켜졌는지 눈으로 알 수 없었다.
- 존 색을 팔레트와 정합(팔레트 어디에도 없던 보라 제거), 채움+라벨칩+협착 점선.
  캔버스에 1px 외곽선만 그리면 실제 공장 프레임에서 사라진다.

━━ 2부: 안전 플랫폼 (마이그레이션 2026-08-09-safety-platform.sql) ━━━

통보 — 이 제품의 정의에 해당하는 구멍
  지금까지 감지는 브라우저 탭이 열려 있고 사람이 보고 있어야만 전달됐다. 새벽 3시에
  넘어진 작업자는 DB에 행 하나를 남기고 아침을 맞았다.
- 엣지 GPIO 경광등(edge/beacon.py). 인터넷·서버 없이 동작하는 유일한 경로라
  어떤 현장이든 이것부터 설정한다. /api/config의 beacons로 배선을 받고, 하드웨어가
  없거나 핀이 안 열리면 NullBeacon으로 떨어지되 그 사실은 반드시 로그로 남긴다.
- 메일·웹훅 채널 + 크론 디스패처(tools/dispatch_alerts.php). 중복 발송은 읽고-쓰기가
  아니라 (event,channel) UNIQUE로 막는다 — 크론 중첩 실행은 공유호스팅의 상수다.
- 미확인 위급은 unacked_escalation 이벤트가 되어 상위 채널로 올라간다(event_uuid로 멱등).
  '아무도 보지 않았다'는 사실 자체를 사건으로 만든다.
- 통보에 이미지는 싣지 않는다. 스냅샷은 PIPA 대상이고 메일링 리스트로 나가는 순간
  인증 프록시가 지키던 통제를 벗어난다 — 링크만 보낸다.

조용한 실패 제거
- 카메라 화각 이동·가림·조도 저하 감지(detectors/integrity.py). 존 판정은 화각 고정을
  전제로 서 있는데, 삼각대를 스치면 제한구역이 엉뚱한 바닥을 가리키면서 시스템은 계속
  초록불이었다. numpy만 사용하고, 지나가는 사람과 구분하기 위해 지속시간을 요구한다.
- 스토리지 여유 감시. 디스크가 차면 이미지 저장만 조용히 실패하고 보드는 멀쩡해 보인다.

끊겨 있던 배선 2건
- thresholds_from_config()가 정의만 있고 어디서도 호출되지 않았다. 서버에 표가 있고
  /api/config가 성실히 실어 보내고 엣지가 파싱한 뒤 버렸다 — 관리자가 무엇을 바꿔도
  장비는 부팅 시 edge.env 값으로 영원히 돌았다(edge/tuning.py).
- 존·임계값 저장이 config_version을 올리지 않아 '설정 지연' 표시가 애초에 켜질 수
  없었다. 지표는 있는데 그것을 켜는 사건이 없었다.

관리 화면 (그전에는 phpMyAdmin이 유일한 방법이었다)
- 임계값 편집: 자유 텍스트가 아니라 카탈로그(범위·단위·설명)로 렌더한다. 범위 밖 값은
  엣지가 기동 시 거부하는데 그때는 이미 공장 안 장비가 재시작 루프다. 키보드 앞에서 막는다.
  목록에 없는 키는 저장 불가 — 장비가 조용히 무시할 값이 '설정됨'으로 보이면 안 된다.
- 정비 억제: 사유 필수, 최대 8시간(한 교대), 자동 만료. 감지와 기록은 그대로 계속되고
  통보만 보류되며 그 보류도 원장에 status='suppressed'로 남는다 — 조사에서 '경보가 났지만
  의도적으로 withheld됐다'를 볼 수 있어야 한다.
- 교대 인수인계, 위험성평가, 설비 성능 추이, 설치 점검(/setup — 실제 상태 조회 기반).

증거·규정
- 감사로그 해시체인. 공유호스팅은 append-only 권한을 줄 수 없으니 '막는' 대신 '숨길 수
  없게' 만든다. 수정·삭제·우회삽입이 전부 탐지되고(tools/verify_audit_chain.php, 손상 시
  exit 1), 체인 이전 행은 손상이 아니라 '검증 불가 구간'으로 따로 센다 — 정상 시스템이
  매번 빨간불을 켜면 아무도 이 도구를 안 본다.
- 사고조사 패키지 1클릭: 전후 타임라인 + 통보 이력(누구에게 닿았는가) + 위험요인 +
  조치 이력 + 서명란. 인쇄 CSS로 그대로 제출 가능. 사고 다음 날 반나절을 쓸 사람은 없다.
- 이벤트→조치 직접 기록, 현장별 롤업(전역 계정만).

운영
- 일괄 확인(위급은 의도적으로 제외·2단계 확정), 키보드 트리아지(J/K/A/F/Enter),
  모바일 레이아웃(44px 타깃), 보존기간 정리(tools/maintain.php),
  백업/복구(tools/backup.php — www 안 출력은 거부), 데모 시드(tools/seed_demo.php).
- tools/는 전부 CLI 전용이고 납품 시 move_detect_app/tools/에 www 밖으로 배치된다.

미착수 4건 (모델·하드웨어가 선행 조건)
- 보호구·중장비 근접·화재 감지는 AGPL 아닌 가중치 확보 + HEF 컴파일이 관문이다.
  감지기 배선·이벤트 계약·심각도·쿨다운·테스트까지 만들고 기본 비활성으로 둔다
  (edge/detectors/pending.py). enabled=True인데 model=None이면 아무것도 하지 않도록
  명시적으로 막았다 — "곧 됩니다" 상태로 켜 두면 현장은 감지되고 있다고 믿는다.
- PLC 접점 협착 게이팅도 같은 이유로 인터페이스만.

검증: pytest 통과(skip 3 = 하드웨어·환경) / PHPUnit 221 (skip 0, +59).
Chrome 실렌더로 신규 4화면 + 임계값 저장→config_version 증가→감사 기록→체인 검증→
행 변조→탐지(exit 1) 전 경로 확인. cafe24 번들 + Pi 오프라인 번들(aarch64 휠 11개)
재생성, 소스 패리티 통과. 보안 자체점검: SQL 문자열 보간 0, innerHTML 0,
상태 변경 핸들러 전부 CSRF+RBAC.
2026-08-18 07:51:23 +09:00

322 lines
13 KiB
JavaScript

/**
* 시스템 설정: 통보 채널 + 감지 임계값.
*
* 이 두 화면이 없던 동안 납품된 현장은 (1) 감지되어도 아무에게도 알릴 수 없었고
* (2) 오탐이 나도 임계값을 고칠 방법이 phpMyAdmin 뿐이었다. 콘솔의 오탐율 패널이
* "이 카메라를 재튜닝하라"고 알려주는데 재튜닝할 화면이 없는 상태였다.
*
* 임계값 입력은 자유 텍스트가 아니라 서버가 내려준 카탈로그(범위·단위·설명)로 렌더한다.
* 범위 밖 값은 엣지가 기동 시 거부하는데, 그때는 이미 공장 안 장비가 재시작 루프에 빠진
* 뒤다 — 키보드 앞에서 막는 편이 낫다.
*
* XSS-safe: 모든 동적 값은 textContent. innerHTML 금지 (프로젝트 규약).
*/
(function () {
'use strict';
var B = window.APP_BASE || '';
var root = document.querySelector('.admin-page');
if (!root) return;
var csrf = null;
var catalog = {};
var devices = [];
function el(tag, cls, text) {
var n = document.createElement(tag);
if (cls) n.className = cls;
if (text !== undefined && text !== null) n.textContent = text;
return n;
}
function loadCsrf() {
return fetch(B + '/api/csrf', { headers: { Accept: 'application/json' } })
.then(function (r) { return r.ok ? r.json() : null; })
.then(function (d) { if (d && d.token) csrf = d.token; })
.catch(function () { /* 저장 시 403 으로 드러난다 */ });
}
function post(path, body) {
return fetch(B + path, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-Csrf-Token': csrf || '' },
body: JSON.stringify(body || {})
}).then(function (r) {
if (r.status === 401) { window.location.href = B + '/login'; return null; }
return r.json().then(function (d) { return { ok: r.ok, data: d }; });
});
}
// 서버 오류 코드 -> 사람이 고칠 수 있는 문장. 코드를 그대로 보여주면 운영자는
// 무엇을 고쳐야 할지 알 수 없다.
var ERRORS = {
out_of_range: '허용 범위를 벗어났습니다.',
not_numeric: '숫자를 입력하세요.',
not_finite: '유효한 숫자가 아닙니다.',
not_integer: '정수만 입력할 수 있습니다.',
unknown_key: '알 수 없는 항목입니다.',
unknown_device: '등록되지 않은 장치입니다.',
invalid_kind: '채널 종류가 올바르지 않습니다.',
invalid_name: '이름을 입력하세요.',
invalid_config: '연결 설정을 확인하세요 (수신자 주소 / URL).',
invalid_escalate_after: '에스컬레이션 지연은 30초 이상이어야 합니다.',
invalid_step: '단계는 0~5 사이여야 합니다.',
csrf: '세션이 만료되었습니다. 새로고침 후 다시 시도하세요.',
forbidden: '권한이 없습니다.',
not_found: '대상을 찾을 수 없습니다.'
};
function errText(code) { return ERRORS[code] || ('저장에 실패했습니다 (' + String(code) + ')'); }
// ============================================================ 통보 채널
var chList = document.getElementById('channel-list');
var chForm = document.getElementById('channel-form');
var chStatus = document.getElementById('ch-status');
var KIND_LABELS = { local: '현장 경광등', email: '메일', webhook: '웹훅' };
var SEV_LABELS = { critical: '위급만', high: '높음 이상', warning: '경고 이상', info: '전부' };
function field(id) { return document.getElementById(id); }
function showKind(kind) {
['local', 'email', 'webhook'].forEach(function (k) {
var box = root.querySelector('.kind-' + k);
if (box) box.hidden = (k !== kind);
});
}
function renderChannels(list) {
chList.textContent = '';
if (!list.length) {
var empty = el('p', 'admin-empty',
'설정된 통보 경로가 없습니다. 지금은 감지가 되어도 화면을 보고 있는 사람에게만 전달됩니다.');
chList.appendChild(empty);
return;
}
list.forEach(function (c) {
var row = el('div', 'channel-row' + (c.enabled ? '' : ' is-off'));
var main = el('div', 'channel-main');
main.appendChild(el('span', 'channel-kind', KIND_LABELS[c.kind] || c.kind));
main.appendChild(el('span', 'channel-name', c.name));
var meta = el('span', 'channel-meta');
var bits = [SEV_LABELS[c.min_severity] || c.min_severity];
if (c.step > 0) bits.push('에스컬레이션 ' + Math.round(c.escalate_after_s / 60) + '분 후');
else bits.push('즉시');
if (c.kind === 'local' && c.config && c.config.gpio_pin) bits.push('GPIO ' + c.config.gpio_pin);
if (c.kind === 'email' && c.config && c.config.to) bits.push([].concat(c.config.to).join(', '));
if (c.kind === 'webhook' && c.config && c.config.url) bits.push(c.config.url);
if (!c.enabled) bits.push('사용 안 함');
meta.textContent = bits.join(' · ');
main.appendChild(meta);
row.appendChild(main);
var edit = el('button', null, '수정');
edit.type = 'button';
edit.addEventListener('click', function () { openForm(c); });
row.appendChild(edit);
var del = el('button', 'zone-del', '삭제');
del.type = 'button';
var armed = false, timer = null;
del.addEventListener('click', function () {
if (!armed) {
armed = true; del.classList.add('is-armed'); del.textContent = '정말 삭제?';
timer = setTimeout(function () { armed = false; del.classList.remove('is-armed'); del.textContent = '삭제'; }, 4000);
return;
}
clearTimeout(timer);
post('/api/admin/channels/' + c.channel_id + '/delete').then(function (r) {
if (r && r.ok) loadChannels();
});
});
row.appendChild(del);
chList.appendChild(row);
});
}
function openForm(c) {
chForm.hidden = false;
chStatus.textContent = '';
c = c || {};
var cfg = c.config || {};
field('ch-id').value = c.channel_id || '';
field('ch-kind').value = c.kind || 'local';
field('ch-name').value = c.name || '';
field('ch-severity').value = c.min_severity || 'high';
field('ch-step').value = c.step || 0;
field('ch-after').value = c.escalate_after_s || 300;
field('ch-enabled').checked = c.channel_id ? !!c.enabled : true;
field('ch-pin').value = cfg.gpio_pin || 0;
field('ch-mode').value = cfg.mode || 'latch';
field('ch-hold').value = cfg.hold_s || 30;
field('ch-active-high').checked = !!cfg.active_high;
field('ch-to').value = cfg.to ? [].concat(cfg.to).join(', ') : '';
field('ch-from').value = cfg.from || '';
field('ch-url').value = cfg.url || '';
// 토큰은 서버가 마스킹해서 준다. 그대로 두면 "변경 안 함"이 된다.
field('ch-token').value = cfg.token || '';
showKind(field('ch-kind').value);
field('ch-after-wrap').hidden = Number(field('ch-step').value) === 0;
field('ch-name').focus();
}
function collectConfig(kind) {
if (kind === 'email') {
return { to: field('ch-to').value, from: field('ch-from').value.trim() };
}
if (kind === 'webhook') {
var out = { url: field('ch-url').value.trim() };
var t = field('ch-token').value.trim();
if (t) out.token = t;
return out;
}
return {
gpio_pin: Number(field('ch-pin').value) || 0,
mode: field('ch-mode').value,
hold_s: Number(field('ch-hold').value) || 30,
active_high: field('ch-active-high').checked
};
}
if (chForm) {
field('ch-kind').addEventListener('change', function () { showKind(this.value); });
field('ch-step').addEventListener('input', function () {
field('ch-after-wrap').hidden = Number(this.value) === 0;
});
document.getElementById('ch-cancel').addEventListener('click', function () { chForm.hidden = true; });
document.getElementById('channel-new').addEventListener('click', function () { openForm(null); });
chForm.addEventListener('submit', function (ev) {
ev.preventDefault();
var kind = field('ch-kind').value;
var body = {
channel_id: Number(field('ch-id').value) || 0,
kind: kind,
name: field('ch-name').value.trim(),
min_severity: field('ch-severity').value,
step: Number(field('ch-step').value) || 0,
escalate_after_s: Number(field('ch-after').value) || 0,
enabled: field('ch-enabled').checked ? 1 : 0,
config: collectConfig(kind)
};
chStatus.textContent = '저장 중…';
post('/api/admin/channels', body).then(function (r) {
if (!r) return;
if (!r.ok) { chStatus.textContent = errText(r.data && r.data.error); return; }
chStatus.textContent = '저장되었습니다.';
chForm.hidden = true;
loadChannels();
}).catch(function () { chStatus.textContent = '저장에 실패했습니다.'; });
});
}
function loadChannels() {
fetch(B + '/api/admin/channels', { headers: { Accept: 'application/json' } })
.then(function (r) {
if (r.status === 401) { window.location.href = B + '/login'; return null; }
return r.ok ? r.json() : null;
})
.then(function (d) { if (d) renderChannels(d.channels || []); })
.catch(function () { chList.textContent = '통보 경로를 불러오지 못했습니다.'; });
}
// ============================================================ 임계값
var thrDevice = document.getElementById('thr-device');
var thrList = document.getElementById('thr-list');
var thrStatus = document.getElementById('thr-status');
var values = {}; // device_id -> {key: value}
function renderThresholds() {
var dev = thrDevice.value;
thrList.textContent = '';
if (!dev) { thrList.textContent = '장치를 선택하세요.'; return; }
var current = values[dev] || {};
Object.keys(catalog).forEach(function (key) {
var spec = catalog[key];
var row = el('div', 'thr-row');
var head = el('div', 'thr-head');
head.appendChild(el('span', 'thr-label', spec.label));
var val = el('span', 'thr-value');
row.appendChild(head);
var input = document.createElement('input');
input.type = 'number';
input.min = spec.min;
input.max = spec.max;
input.step = spec.step;
// 값이 없으면 장비가 쓰고 있는 기본값을 보여준다 — 빈칸이면 "설정 안 됨"과
// "기본값과 같음"을 구분할 수 없다.
var isSet = Object.prototype.hasOwnProperty.call(current, key);
input.value = isSet ? current[key] : spec['default'];
head.appendChild(val);
val.textContent = (spec.unit ? spec.unit : '') + (isSet ? '' : ' · 기본값');
var controls = el('div', 'thr-controls');
controls.appendChild(input);
var save = el('button', 'btn-primary', '적용');
save.type = 'button';
save.addEventListener('click', function () {
thrStatus.textContent = '적용 중…';
post('/api/admin/thresholds', { device_id: dev, key: key, value: input.value })
.then(function (r) {
if (!r) return;
if (!r.ok) {
thrStatus.textContent = spec.label + ': ' + errText(r.data && r.data.error)
+ ' (허용 ' + spec.min + '~' + spec.max + ')';
return;
}
thrStatus.textContent = spec.label + ' 적용됨 — 다음 동기화 때 장치에 반영됩니다.';
loadThresholds();
})
.catch(function () { thrStatus.textContent = '적용에 실패했습니다.'; });
});
controls.appendChild(save);
row.appendChild(controls);
row.appendChild(el('p', 'thr-help', spec.help));
thrList.appendChild(row);
});
}
function loadThresholds() {
fetch(B + '/api/admin/thresholds', { headers: { Accept: 'application/json' } })
.then(function (r) {
if (r.status === 401) { window.location.href = B + '/login'; return null; }
if (r.status === 403) { thrList.textContent = '임계값 편집 권한이 없습니다.'; return null; }
return r.ok ? r.json() : null;
})
.then(function (d) {
if (!d) return;
catalog = d.catalog || {};
devices = d.devices || [];
values = {};
(d.thresholds || []).forEach(function (t) {
if (t.camera_id) return; // 카메라별 재정의는 이 화면의 범위 밖
if (!values[t.device_id]) values[t.device_id] = {};
values[t.device_id][t.key] = t.value;
});
var keep = thrDevice.value;
thrDevice.textContent = '';
var first = document.createElement('option');
first.value = '';
first.textContent = devices.length ? '장치를 선택하세요' : '등록된 장치가 없습니다';
thrDevice.appendChild(first);
devices.forEach(function (dev) {
var o = document.createElement('option');
o.value = dev.device_id;
o.textContent = (dev.name || dev.device_id) + ' · ' + dev.device_id;
thrDevice.appendChild(o);
});
if (keep) thrDevice.value = keep;
renderThresholds();
})
.catch(function () { thrList.textContent = '임계값을 불러오지 못했습니다.'; });
}
if (thrDevice) thrDevice.addEventListener('change', renderThresholds);
loadCsrf().then(function () {
loadChannels();
loadThresholds();
});
})();