{body}'
for scenario,version,ko in [('FIGHT','R5','싸움'),('FALL','R2','쓰러짐')]:
fight=scenario=='FIGHT';block='fight_r5' if fight else 'fall_r2';engine=version.lower()
title=f'{scenario} {version} Web 연계 안내'
common=[['사람 score','숫자 입력','person_confidence','number 0~1','0.25 / 하한0.25'],['관절 score','숫자 입력','pose_confidence','number 0~1','0.10 / 하한0.10'],['알람 간격(초)','숫자 입력','cooldown_seconds','number 0~300','10초']]
extra=[['관측창(초)','숫자 입력',block+'.window_seconds','number 0.3~3.0','1.0초'],['일반 유효 관측 수','정수 stepper',block+'.min_samples','integer 1~16','2'],['근접 유효 관측 수','정수 stepper',block+'.contact_min_samples','integer 1~16','3']] if fight else []
cfg={'schema_version':1}
if fight:cfg.update(window_seconds=1.0,min_samples=2,contact_min_samples=3)
request={'scenarioCode':scenario,'enabled':True,'rois':[],'parameters':{'person_confidence':.25,'pose_confidence':.1,'cooldown_seconds':10,block:cfg}}
reset={block:{'schema_version':1,'reset_to_defaults':True}}
legacy='pair_distance_ratio · pair_close_hold_seconds · arm_motion_ratio · required_bursts' if fight else 'down_angle_deg · recovery_hold_seconds'
status='AI 적용 완료 · camera24의 짧은 알람/미디어 사용자 확인 완료 · 추가 고도화 보류' if fight else 'AI 적용 완료 · 36입력 재현 일치 · 브라우저 수용은 사용자 확인 전까지 미확인'
intro='상대와 관련된 실제 손·발·근접 동작 근거를 최근 관측과 함께 판단합니다. 단순 근접이나 빠른 움직임만을 싸움으로 확정하지 않습니다.' if fight else '현재 사람별 Pose에서 가로형 R1과 깊이 방향 D1/D2 근거를 확인합니다. 같은 Tracking ID로 넘어지는 과정을 끝까지 보아야만 동작하는 방식은 아닙니다.'
source=f'docs/integration/{scenario}_{version}_WEB_CONFIG.ko.md'
body=f'
CONTEXTRA / 동료 전달용 설정 계약
{title}
{intro}
검토 {now} · presentation snapshot · 원문 Markdown 우선
'
body+=''
body+=section('overview','1. Web을 먼저 고치지 않아도 동작합니다',f'
{status}
1 / Web Start기존 6개 시나리오·On/Off·ROI·입력
2 / AI 검증·저장구형값 무시, 새 설정 검증, 실효값 비교
3 / 고정 엔진현재 판정과 표시 유지 분리
4 / Redis·Event그리기와 새 알람은 별도 경로
'+ul([
f'AI가 소유하는 {scenario.lower()}.engine={engine} 선택을 Web이 바꾸지 않습니다. 새 블록은 설정 버전이며 엔진 전환 명령이 아닙니다.',
'기존 저장 채널과 신규 등록 template에 기본 엔진을 적용했습니다. 모든 채널 강제 Start나 시나리오 강제 On은 아닙니다.',
'기존 권한·전송·ROI·다른 시나리오·모델·Tracker를 보존합니다. Web 반복 Start 정책과 실제 입력 변경 의미도 그대로입니다.']))
controls=table(['브라우저 항목','권장 컨트롤','parameters 경로','유효 타입·범위','최초 기본'],common+extra)
controls+=ul(['On/Off는 기존 toggle, ROI는 기존 편집 도구를 유지합니다. 저장값이 있으면 기본값보다 우선 표시합니다.',
'score는 행동 확률이 아닙니다. 사람0.15/관절0.05 같은 유효한 낮은 값은 AI에서0.25/0.10으로 보정하고,0.35/0.30처럼 높은 값은 유지합니다.',
'bool·문자·null은 숫자가 아닙니다. UI의 빈 입력을0이나 기본값으로 몰래 변환하지 않습니다. NaN/Infinity는 유효 JSON 숫자가 아닙니다.',
'계산과 기여 빨강은 해당 시나리오 score를 따릅니다. 공유 원시 Pose/Tracker와 별도 raw skeleton 표시 설정은 일괄 변경하지 않습니다.'])
controls+=('
두 관측 수는 각각 floor(window_seconds × 10) + 1 이하여야 합니다. 관측 수는 펀치 횟수나 행동 종류 수가 아니며, 현재의 방향·거리·억제 조건도 통과해야 합니다.
' if fight else '
공개 조작은 위 세 값뿐입니다. D1/D2 각도·길이 비율·관측 수·재무장·표시 유지 시간을 UI로 노출하지 않습니다.
다음은 scenarios 배열의 항목 하나입니다. 전체 Start가 아닙니다. 나머지5개 항목과 cameraId·rtspUrl·startWallTimeMs·rtpClockRate, 기존 선택 녹화 식별자를 보존합니다.
'+sample(request)+'
rois: []는 전체화면 예시입니다. 사용 중인 ROI를 지우지 마세요. 공통 세 값은 parameters 바로 아래, 전용 블록은 그 안에 둡니다. schema_version은 블록이 있으면 정수1 필수입니다.
')
reset_scope='관측창1.0초·일반2·근접3만 초기화합니다. 사람/관절 score·cooldown은 초기화하지 않습니다.' if fight else 'FALL 사람0.25·관절0.10·cooldown10초만 초기화합니다.'
initial='R5 관측 설정 초기화' if fight else 'FALL 공통 설정 초기화'
reset_caution='초기화 블록 내부에 다른 조작 키를 함께 보내지 않습니다. 공통값의 별도 변경과 초기화 범위를 혼동하지 않습니다.' if fight else '초기화 요청에 공통 세 필드를 함께 보내면 거부합니다. reset:false도 오류이며 키를 생략해야 합니다.'
rules=table(['상황','AI 처리'],[['공통값 또는 블록 생략','저장값 유지. 최초 미설정만 승인 기본값'],['구형 요청의 잘못된 optional 값','해당 값 무시·저장값 유지·사유 기록'],['새 블록 명시 후 잘못된 값/버전/키','저장·실행 변경 전에 전체 거부'],['유효한 낮은 score','하한 보정. 오류와 구분'],['동일 실효 Start 반복','불필요한 run 교체 없음'],['실제 URI·시간 anchor·ROI·설정 변경','기존 controlled restart/적용 계약 유지']])
rules+=f'
{initial}
{reset_scope} On/Off·ROI·engine·다른 시나리오는 그대로입니다.
'+sample(reset)+f'
{reset_caution}
'
rules+='
FIGHT reset은 내부 관측 설정, FALL reset은 공통 세 설정입니다. 공통 초기화 버튼 하나로 같은 범위를 적용하지 마세요.
'
rules+='오류·반복 요청 구현 시 주의'+ul([
'parameters 자체가 구형 null/문자/배열이면 optional 무시입니다. 전용 새 블록의 null·배열·빈 객체·버전 오류는 엄격 거부입니다.',
f'대표 오류는 {scenario}_{version}_NOT_ENABLED, SCHEMA_VERSION_REQUIRED/UNSUPPORTED, FIELDS_INVALID, SCORE_INVALID, COOLDOWN_INVALID, RESET_INVALID입니다. 각 코드는 같은 시나리오 prefix를 가집니다.'+(' R5에는 WINDOW_INVALID·SAMPLE_COUNT_INVALID도 있습니다.' if fight else ''),
'기존 비동기 operation에서 최종 결과를 확인합니다. 접수 응답만으로 성공을 표시하거나 잘못된 값을 보정 성공으로 처리하지 않습니다.',
'Web이 같은 Start를 반복해도 무관합니다. 단, polling마다 새 startWallTimeMs를 만들거나 다른 시나리오 설정을 초기화하면 같은 요청이 아닙니다.'])+''
body+=section('rules','4. 저장값 유지와 명시적 변경',rules)
state='FIGHT' if fight else 'FALL_CONFIRMED'
display=f'
빨강: 현재 충족 또는 1초 표시 유지옛 위치 유지 없음
'
display+=ul([f'기존 objects의 bbox·color·labelText·trackId·scenarioResults·eventIds를 소비합니다. scenario={scenario}, state={state}, color=#FF3030입니다.',
'빨강이 새 알람이라는 뜻은 아닙니다. Web은 빨강으로 별도 알람을 만들지 않고 기존 Event 수신을 사용합니다. 실시간과 Event 아티팩트에서는 유지도 빨강이며 오프라인 노랑과 다릅니다.',
'현재 객체 대응이 확인될 때만 유지합니다. 미관측·연결 불확실에는 이전 bbox를 덧그리지 않습니다. 원래 미추적 객체의 ID는 null입니다.',
'마지막 실제 최종 충족 이후2초 동안 다시 충족하지 않으면 재무장합니다. 부분 조건·자료 부족·유지로 연장하지 않으며 정상 회복 분류도 아닙니다.',
'지속 충족도 기존 cooldown 이후 현재 충족이면 재알림합니다. 2초마다 알람을 뜻하지 않습니다. 차단된 과거 판정을 나중에 예약 발급하지 않습니다.',
'새 알림은 새ID와 현재 썸네일·클립입니다. 같은 Event 전송 재시도는 같은ID를 유지합니다. 여러 기여 사람을 표시하더라도 사람별 알람을 강제하지 않습니다.',
'Runtime 발급 → 아티팩트 접수 → 미디어 생성 → HTTP 전달 → 브라우저 표시를 구분합니다. 접수 실패도 발급 cooldown은 소비하며 성공으로 꾸미지 않습니다.'])
body+=section('display','5. 빨강과 알람은 서로 다른 정보입니다',display)
check=ul([f'기존 AI 관리 설정 조회에서 configured.{scenario.lower()}, effective.{scenario.lower()}, restart_pending을 확인합니다. engine과 score, 전용 설정이 실효값입니다.',
'현행 설정 조회 응답에 cooldown 필드는 없습니다. AI 처리 로그와 담당자의 persistent/실행 진단으로 확인합니다. 자동 실효값 조회가 이미 있는 것처럼 UI를 만들지 않습니다.',
f'요청·보정·무시 사유는 {block}_parameter, {block}_parameter_ignored, {block}_effective 로그에 있습니다. 브라우저에 AI 인증정보나 직접 접근을 새로 열지 않습니다.',
'구형/신형 Start, 낮은/높은 score, 생략·초기화·오류, 저장 실패 보존, 반복 no-op과 실제 변경을 자동검사합니다.',
'사용자가 기존 Web에서 자연 실행의 표시·알람·썸네일·클립을 확인합니다. AI가 별도 Start·mock Event·과거 Event 재전송으로 알람을 유도하지 않습니다.',
'현재 샘플 수용을 전체 채널 정확도·장시간 안정성·라이브10FPS 보장으로 확대하지 않습니다. 군중/가림/미탐과 입력 차이에 따른 한계는 남습니다.'])
evidence='FIGHT는 camera24의 짧은 실제 알람·미디어 사용자 확인 근거가 있습니다. 후속 군중 고도화는11/3 시연 이후 별도 요청까지 보류입니다.' if fight else 'FALL R2는36입력20,145표시관측의 현재 판정·기여/유지·Event 위치 재현이 일치했습니다. 운영 모델 재추론 시험·브라우저 수용·장시간 일반화는 이번 검증에 포함되지 않습니다. 높은 저장 관절 score0.30은 그대로 유지됐습니다.'
body+=section('check','6. 동료와 확인할 순서',f'
{evidence}
'+check)
body+=f''
html=''+escape(title)+''+body+''
name=f'{scenario}_{version}_WEB_GUIDE.html';(PRESENT/name).write_text(html)
md=f'{scenario}_{version}_WEB_HANDOFF.md';shutil.copy2(REPO/'docs/integration'/md,PRESENT/md)
for name in (name,md):shutil.copy2(PRESENT/name,EXPORT/name)
manifest={p.name:hashlib.sha256(p.read_bytes()).hexdigest() for p in EXPORT.iterdir()}
(ROOT/'web-packet-manifest.json').write_text(json.dumps(dict(created=now,presentation=str(PRESENT),export=str(EXPORT),files=manifest),indent=2))
print(EXPORT)