# FIGHT/FALL Web 설정 전달 초안

작성: 2026-11-02 11:32:00 KST. profile: ltb1021. 담당: 사이드 질답·문서 작업.
상태: **1차 문서 초안 / FIGHT 현행 지원 / FALL 새 세 필드 미구현**.
이 폴더는 메인 소스·공용 명세를 대체하지 않는 별도 전달 snapshot이다. 현장 서버·Web을 조회하거나 변경하지 않았다.

## 읽는 순서

1. Web 동료: [FIGHT 현행 계약](FIGHT_R5_WEB_CONFIG_DRAFT.ko.md) → [FALL 현재/예정 계약](FALL_R2_WEB_CONFIG_PROPOSAL.ko.md).
2. JSON: [예시 안내](examples/README.ko.md). `CURRENT`는 현재 로컬 코드의 지원 계약, `PLANNED_DO_NOT_SEND`는 **AI 지원 전 전송 금지**다.
3. 내부 검토: [설정 제외 결정·포즈 설명](INTERNAL_RULE_NOTES.ko.md). 이 파일의 D 상세는 브라우저 설정이나 외부 시연 자료에 넣지 않는다.
4. 메인 세션: [구현·검증·승인된 반영의 전달문](MAIN_HANDOFF.ko.md).
5. 검증: [검증 범위](validation/README.ko.md), [소스 기준](validation/context.json), [결과](validation/result.json), [지문 목록](manifest.json).
6. 마감: [이번 작업 Report](REPORT.ko.md). Report 원문은 이 폴더에 준비했고 별도 Inbox에는 등록하지 않았다.

## 현재 지원과 제안

| 대상 | UI에서 다룰 값 | 현재 상태 | 전송 시점 |
| --- | --- | --- | --- |
| FIGHT 전용 | min_samples=2, window_seconds=1.0 | 현행 코드 지원. 이번에 새 엔진을 구현한 것이 아님 | AI 엔진 선택이 R5임을 기존 담당 경로로 확인한 뒤 |
| FIGHT 내부 | contact_min_samples, 최초3 | 현행 지원은 존재하지만 이번 UI·요청에서 생략; 저장값 유지 | 새 UI가 임의 전송·초기화하지 않음 |
| FALL 공통 | 사람/관절 score, cooldown | 현행 코드 지원 | 기존 계약대로 |
| FALL 전용 B/C/E | 몸통50~60, 다리50~60, 무릎140~160 | **미구현 확장안**, 기본50/50/140 | 메인의 구현·검증·승인된 AI 반영 완료 후 |
| 제외 A/D | 분기 선택 / bbox 비율 조절 | 이번 공개 대상 아님 | 전송 금지 |

`CURRENT`는 소스·명세·일부 순수 validator 확인을 뜻한다. 현재 현장의 실행 설정이나 Web 패치 완료를 새로 확인했다는 뜻이 아니다. 기존 11/1 배포 근거와 11/2 Owner의 사용자 시각 수용을 이번 검증 결과로 바꾸지 않는다.

## 기본값과 시연 권장값

| 구분 | 사람 score | 관절 score | cooldown |
| --- | ---: | ---: | ---: |
| AI 최초 기본값 / score 하한 | 0.25 | 0.10 | 소스 기본10초 |
| 문서상 운영 추천 | **0.35 시작, 0.35~0.45 비교** | **0.10** | **10초** |

FIGHT cooldown은 환경의 공통 기본값 override가 있을 수 있고 저장된 시나리오 값이 우선한다. 이 작업에서는 환경을 조회하지 않았다. 추천값 표시는 AI·Web 초기값이나 기존 채널 저장값의 자동 변경 승인이 아니다. 실제 저장값이 있으면 화면을 열 때 그 값을 먼저 표시한다.

사람 score 추천은 사용자 관찰에 따른 절충이다. 낮은 score의 중복 후보가 시나리오 판단에 포함되는 영향을 줄이려0.35 이상을 권장하지만, 실제 쓰러짐·싸움 중인 대상도 낮은 score로 검출될 수 있어 지나친 상향은 대상 누락을 늘릴 수 있다. 0.45는 권장 상단이지 API 최대값이 아니다. 구조적 원인·보편적 최적값·중복 bbox 생성 원인 해결로 단정하지 않는다.

## 고정된 작업 순서

| 단계 | 범위 | 종료 경계 |
| --- | --- | --- |
| 1차, 이번 | 스키마 초안·예시·내부 설명·메인 전달 | 문서와 로컬 문서 검증까지 |
| 2차, 메인 | 선택된 FALL 설정 구현·격리 검증·별도 승인된 현장 반영 | 지원 결과를 공용 명세에 반영; 실패 시 배포 전 중단 |
| 3차 | 추가 질답 후 아이서티 전달용 단일 HTML 초안 | 사용자 초안 검토까지 |
| 4차 | 피드백 반영·정합·가독성 확인 | 최종 전달본; 추가 엔진 튜닝 없음 |

Web 동료는 FIGHT 작업을 먼저 진행할 수 있지만 FALL 예정 필드가 섞인 Start를 미지원 AI로 보내면 변경이 거부될 수 있다. 두 설정의 배포 시점을 분리한다. 메인의 고도화 보류 상태는 이 초안만으로 해제되지 않는다. 탑뷰/공간 이력 개선은 이번 설정 공개 제안과 별개다.

## 보관·권한

- Source of truth: 기존 repository 코드·공용 Markdown. 이번 합의는 이 패킷의 제안 상태로 보존하며 메인 수락 후 승격한다.
- 기존 코드·Owner·명세·전달본은 수정하지 않았다. Git 저장소 변경과 Git Closeout은 해당 없음이다.
- 인증정보·현장 URI·private endpoint·원본 영상·cache·가중치는 포함하지 않는다. 삭제/자동 정리 정책은 만들지 않는다.
- 시연용 HTML, AI/Web 패치, SSH, 모델/Pose/Tracking, Runtime·실제 Event 시험은 이번 범위가 아니다.

## 원문 경로

- [FIGHT 공용 명세](/workspace/contextra-analytics-runtime-lifecycle-refactor/docs/integration/FIGHT_R5_WEB_CONFIG.ko.md)
- [FALL 공용 명세](/workspace/contextra-analytics-runtime-lifecycle-refactor/docs/integration/FALL_R2_WEB_CONFIG.ko.md)
- [메인 Owner](/workspace/contextra-analytics-runtime-lifecycle-refactor/docs/profiles/ltb1021/topics/runtime-lifecycle/README.ko.md)

위 절대경로는 AI 저장소의 근거 locator다. Web 동료가 별도 PC에서 열 때도 이 폴더의 상대 링크와 설명만으로 계약을 읽을 수 있도록 본문에 핵심을 포함했다.