TwinCity 매장 관제
매장 상황을 누구나 쉽게 보는 화면
복잡한 용어를 줄이고, 필요한 정보만 크게 보여주도록 화면을 구성했습니다. 점주님과 경비원분이 바로 보고 바로 대응할 수 있게 만든 운영 화면입니다.
첫 화면 체크포인트
운영 계약과 리포트 근거를 1분 안에 확인합니다
처음 보는 사람도 ingest → triage → timeline → SLA proof 순서를 바로 읽을 수 있도록, 핵심 운영 루프를 한 보드에 압축해 보여줍니다.
실시간 알림 보기지금 들어온 이벤트와 처리 기록을 바로 확인리포트 열기handoff, dispatch, export 흐름을 빠르게 검토운영 계약 확인reviewer가 바로 읽을 수 있는 JSON 근거 surface
검토 시작 경로
처음 30초에 확인할 항목Open /api/health to confirm whether the control tower is demo-first or live-wired.
Read /api/meta for trust boundary, stage ownership, and review artifacts.
Use /api/reports/summary to validate spotlight incidents and SLA posture via API.
운영자 관점
실시간 알림 → 리포트 → 운영 계약 순으로 읽으면 현장 판단 루프가 가장 빨리 보입니다.01 · 알림 우선
이벤트와 triage 흐름부터 보고 현재 주의 포인트를 확인합니다.
02 · 리포트 확인
dispatch / handoff / export가 같은 이야기인지 바로 검토합니다.
03 · 계약 확인
runtime brief와 schema surface로 근거를 잠급니다.
control-tower-readiness-v1ops-envelope-v1twincity-report-v1
ingest: browser-local demo transportnormalize: provider payloads converge into EventItemstate: browser-local replay and timeline persistencehandoff: status bundles carry a deterministic digest before export approvalmap: floorplan + zone polygons + optional homographyvalidation: 3D probe routes stay optional and review-only
처음 확인할 순서
처음 보는 사람도 바로 따라갈 수 있는 흐름Open /api/health to confirm ingest mode and review links.
Read /api/meta to see trust boundary, stages, and evidence counts.
Use /api/reports/summary to verify a deterministic SLA snapshot before UI review.
Use /api/reports/dispatch-board to isolate attention and dispatch lanes before opening exports.
Use /api/reports/assignment-history to verify current owner and handoff chain before shift changes.
Use /api/reports/handoff to verify the next-shift digest before copying or exporting reviewer artifacts.
Use /api/reports/response-playbook to review escalation drills, checkpoint timing, and reviewer-safe action gates.
Use /api/reports/export to validate server-generated JSON or CSV handoff payloads.
Use /api/reports/reviewer-bundle when a reviewer needs a digest-backed export bundle.
Use /events or / to exercise triage and timeline handling.
Open /reports for SLA proof and exported summary paths.
운영 원칙
판단 전에 꼭 지켜야 할 기준Keep the operator loop visible before any deep-dive debugging.
Treat replay and live transport as separate trust domains.
Prefer schema-backed summaries over free-form screenshots.
2분 빠른 검토
핵심 화면만 빠르게 훑는 경로Open /api/health to confirm whether the control tower is demo-first or live-wired.
Read /api/meta for trust boundary, stage ownership, and review artifacts.
Use /api/reports/summary to validate spotlight incidents and SLA posture via API.
Use /api/reports/dispatch-board to confirm unresolved queue posture and latest action lanes.
Use /api/reports/assignment-history to confirm queue owner and operator handoff lineage.
Use /api/reports/handoff to confirm the top next-shift priorities and overdue queue risk.
Use /api/reports/response-playbook to confirm who escalates next and when the next checkpoint should happen.
Use /api/reports/export to validate server-side handoff payloads before sharing a report.
Use /api/reports/reviewer-bundle/verify to confirm bundle integrity before external handoff.
Open /reports to validate SLA proof and export posture.
Use /events to inspect one alert through triage, dispatch, and timeline state.
Detect
transport layer카메라/연동 이벤트를 실시간 또는 데모 피드로 수집
WS -> SSE -> HTTP polling fallbackNormalize
event adapter이기종 payload를 하나의 EventItem schema로 정규화
eventAdapter + signalChecks testsTriage
ops console맵, 리스트, 상세 패널을 동기화해 운영자가 우선순위를 판단
events page + SLA alert panelDispatch
timeline workflowACK / dispatch / resolve timeline으로 현장 대응을 기록
IncidentTimeline + local timeline persistenceReport
reports surfaceSLA, top zones, type distribution을 CSV와 summary로 내보냄
/reports + twincity-report-v1 schema증거 묶음
route, 문서, 테스트, 화면 근거Proof Route Map
front-door route chooser for reviewer proof order
경로/api/proof-route-map
Health API
ingest mode, readiness, review links
경로/api/health
Service Meta
control tower posture and trust boundary
경로/api/meta
Runtime Brief
review-first contract for reports and operator proof
경로/api/runtime-brief
Runtime Scorecard
ingest posture, export auth, and SLA snapshot in one compact contract
경로/api/runtime-scorecard
Report Schema
incident report contract for reviewers
경로/api/schema/report
Reports View
SLA metrics, exports, replay summary
경로/reports
Report Summary API
deterministic SLA and spotlight summary contract
경로/api/reports/summary
Dispatch Board API
attention / dispatch / resolved queue snapshot for reviewers
경로/api/reports/dispatch-board
Assignment History API
operator ownership and handoff chain for reviewer-safe shift transfer
경로/api/reports/assignment-history
Shift Handoff API
deterministic shift handoff digest with overdue queue risk
경로/api/reports/handoff
Response Playbook API
response drills, escalation gates, and next checkpoints for active incidents
경로/api/reports/response-playbook
Report Export API
server-generated JSON and CSV report snapshots
경로/api/reports/export
Reviewer Bundle API
digest-backed reviewer handoff bundle for export-safe review
경로/api/reports/reviewer-bundle
Reviewer Bundle Verify API
recomputes the bundle digest before handoff approval
경로/api/reports/reviewer-bundle/verify
README
repo entry point, review path, and local verification commands
문서README.md
Portfolio Review Guide
2-minute reviewer path and role-fit evidence map
문서docs/PORTFOLIO_REVIEW_GUIDE.md
Live Integration Guide
payload examples and transport fallbacks
문서docs/LIVE_INTEGRATION.md
Runbook
operator and release guidance
문서docs/ops/RUNBOOK.md
Runtime Route Tests
route contract verification
테스트tests/runtimeRoutes.test.ts
Landing Page Tests
front-door proof copy stays anchored
테스트tests/landingPage.test.ts
Ops Console Screenshot
reviewable operator UI proof
화면public/screenshots/ops_console.png
함께 보면 좋은 파일
첫 검토 때 바로 열어볼 묶음Proof Route Map -> /api/proof-route-map
Health API -> /api/health
Service Meta -> /api/meta
Runtime Scorecard -> /api/runtime-scorecard
Report Summary API -> /api/reports/summary
Dispatch Board API -> /api/reports/dispatch-board
Assignment History API -> /api/reports/assignment-history
Shift Handoff API -> /api/reports/handoff
Response Playbook API -> /api/reports/response-playbook
Report Export API -> /api/reports/export
Reviewer Bundle API -> /api/reports/reviewer-bundle
Portfolio Review Guide -> docs/PORTFOLIO_REVIEW_GUIDE.md
Runtime Route Tests -> tests/runtimeRoutes.test.ts
Ops Console Screenshot -> public/screenshots/ops_console.png
지금 알아둘 점
범위와 한계를 먼저 공유합니다Demo mode can hide auth, backpressure, and noisy provider payloads.
Reports currently summarize browser-local state, not a central incident store.
3D validation routes are for geometry checks, not production rendering.
지금 상태
핵심 숫자 한눈에 보기
실시간 확인 구역
12
조용한 구역 7 · 관찰 구역 4 · 즉시 확인 1
평균 대응 시간
3분 08초
지난 30분 기준 평균 대응 시간
유효 알림 비율
92%
중복 알림 제거 후 유효 신호 비율
화면 바로가기
필요한 화면으로 빠르게 이동
✶ 화면 분위기: 따뜻함
한눈에 상황을 파악하고, 바로 대응할 수 있게 만든 화면입니다.
“쉽게 보이면, 빠르게 움직일 수 있습니다.”
“쉽게 보이면, 빠르게 움직일 수 있습니다.”