WORKSPACE GUIDE · VERSION 2.0
한 장면에서 시작하는
분석 작업실 이용 안내
보고, 기록하고, 검토하고, 다음 훈련으로 이어가는 방법을 안내합니다.
1. 샘플로 먼저 둘러보기
처음 열면 ‘블루 U15 vs 화이트 U15’라는 체험용 가상 경기가 나타납니다. 경기·선수·장면·검토 표시는 모두 사용법을 보여주는 예시입니다. 실제 경기에서 자동 추출한 결과가 아닙니다.
- ‘작업실 홈’에서 기록한 장면과 검토 상태를 확인합니다.
- ‘영상 · 장면 태깅’에서 샘플 장면을 수정해봅니다.
- ‘지도자 리포트’와 ‘선수 전술 카드’에 바뀐 기록이 반영되는지 확인합니다.
- 자신의 경기를 기록하려면 위쪽 ‘새 경기’를 선택합니다.
2. 내 경기와 선수 명단 만들기
- ‘새 경기’에서 우리 팀, 상대 팀과 경기일을 입력합니다. 경기 이름은 선택사항입니다.
- ‘경기 · 선수 · 데이터’의 선수 명단에서 이름·별칭, 등번호와 포지션을 추가합니다.
- 위쪽 ‘현재 경기’ 선택란으로 여러 경기 사이를 이동합니다.
선수 이름 대신 ‘선수 08’처럼 별칭을 사용해도 됩니다. 샘플 경기를 남겨두고 자신의 경기를 별도로 관리할 수 있습니다.
3. 영상 재생과 장면 기록
- ‘영상 · 장면 태깅’에서 ‘내 영상 열기’를 선택합니다. 기기에 있는 동영상 파일을 엽니다.
- 중요한 장면에서 영상을 멈추고 ‘현재 시각 가져오기’를 누릅니다. 시작 시각을 직접 입력할 수도 있습니다.
- 전술 유형, 선수, 중심 행동과 직접적인 결과를 고릅니다.
- ‘관찰한 사실’에는 실제 영상에서 보인 위치·움직임·행동을 적습니다.
- ‘전술 해석’에는 의미와 질문을, ‘다음 훈련 행동’에는 실천할 한 가지 행동을 따로 적습니다.
- 원본과 해석을 코치가 검토했다면 검토 완료를 표시하고 저장합니다.
시각은 12:35처럼 분:초 형식입니다. 종료 시각은 선택사항이며 시작 시각 이후로 입력합니다. 장면 기록은 한 장면의 중심 행동 하나와 직접적인 결과를 기준으로 합니다.
여섯 전술 유형
| 유형 | 관찰할 내용 |
|---|---|
| 빌드업 | 후방·중원에서 전진 경로를 만드는 전개 |
| 압박 | 상대의 패스 선택지를 제한하는 움직임과 동료의 커버 |
| 공수 전환 | 공을 얻거나 잃은 직후의 공격·수비 역할 변화 |
| 세트피스 | 코너킥·프리킥의 약속된 위치와 역할 |
| 기회 | 슈팅·문전 패스 등 득점으로 이어질 수 있는 선택 |
| 위험 | 압박에 갇힘·위험 공간·세컨드볼 대응 등 |
영상 재생이 되지 않을 때
브라우저가 지원하는 코덱의 MP4 또는 WebM 파일을 사용해주세요. 같은 MP4 확장자여도 인코딩에 따라 재생이 달라질 수 있습니다. 이 앱은 영상 변환을 하지 않습니다. 전체 경기와 편집한 영상을 바꿔 연결할 때에는 태깅 시각이 같은 기준인지 확인해주세요.
4. 리포트와 전술 카드 활용
지도자 리포트는 입력한 기록의 개수·분류·검토 상태와 관찰·해석을 정리합니다. ‘검토 완료만’을 선택하면 미검토 장면을 제외할 수 있습니다. ‘코치의 종합 메모’를 저장해 다음 훈련의 질문을 남기세요.
전술 카드에서는 선수와 전술 유형을 선택합니다. 해당 선수에게 연결된 근거 장면, 질문, 훈련 행동과 재관찰 질문을 함께 봅니다. 그림은 설명을 위한 전술 개념도이며 자동 추적 좌표가 아닙니다.
- 카드 PNG 저장: 선수의 질문과 다음 행동을 이미지 파일로 받습니다.
- 인쇄 · PDF 저장: 브라우저 인쇄 화면에서 인쇄하거나 ‘PDF로 저장’을 선택합니다. 기기에 따라 메뉴 이름이 다를 수 있습니다.
- 근거 시각: 장면의 시간 버튼을 누르면 영상 태깅 화면으로 이동합니다. 같은 원본 영상이 연결되어 있어야 정확한 시각을 확인할 수 있습니다.
현재 버전의 요약과 훈련 제안은 태깅 기록과 유형별 기본 문안을 조합한 초안입니다. 외부 AI 호출·자동 선수 추적·xG·이동 거리 측정은 구현되어 있지 않습니다.
5. 저장과 다른 기기로 이동하기
영상 파일: 기기 안에서만 재생하며 서버로 업로드하지 않습니다. 영상 자체를 브라우저에 영구 저장하지 않으므로 다시 방문하면 파일을 다시 선택해야 합니다.
장면·선수·메모: 현재 사이트 주소와 브라우저의 저장 공간에 보관합니다. 기기·브라우저·사이트 주소가 다르면 저장 공간도 다릅니다. 시크릿 모드, 브라우저 데이터 삭제 또는 저장 공간 제한에 따라 기록이 보존되지 않을 수 있습니다.
- 작업한 기기에서 ‘데이터 → 전체 작업 JSON 내보내기’를 선택합니다.
- 내려받은 JSON을 자신이 사용하는 방법으로 다른 기기에 옮깁니다.
- 다른 기기의 작업실에서 ‘작업 JSON 불러오기’를 선택합니다.
- 가져온 경기는 복사본으로 추가됩니다. 기존 경기를 덮어쓰지 않습니다.
- 원본 영상이 필요하면 해당 영상 파일도 별도로 준비하고 연결합니다.
작업이 끝날 때 JSON을 내보내 보관하는 것을 권장합니다. JSON에는 경기·선수·관찰·해석·검토 상태와 메모가 포함되지만 영상 원본은 포함되지 않습니다. 자동 계정 동기화나 여러 사람이 동시에 편집하는 기능은 제공하지 않습니다.
주소 변경 시
tacticaltwinai.pages.dev와 tacticaltwin.com은 브라우저에서 서로 다른 사이트로 취급합니다. 한쪽 주소에 저장한 기록은 JSON으로 내보내 다른 쪽에서 불러오세요.
6. CSV와 데이터 형식
CSV는 현재 경기의 장면 목록을 스프레드시트에서 살펴볼 때 사용합니다. 전체 경기·선수 명단·종합 메모의 백업과 기기 이동에는 JSON이 적합합니다.
‘입력용 CSV 양식 받기’를 내려받아 같은 열 이름을 사용해주세요. 필수 열은 time, category, observation입니다. 전술 유형에는 Build-up, Pressing, Transition, Set-piece, Chance, Risk 또는 대응하는 한국어를 사용합니다.
CSV를 불러오면 현재 경기에 장면을 추가합니다. 같은 파일을 반복해서 불러오면 기록이 중복될 수 있습니다. 불러오기 후 선수 연결·분류·검토 상태를 확인하세요.
이 버전의 데이터 관리 범위는 최대 100경기, 경기당 10,000장면, 선수 200명입니다. 데이터 파일 불러오기는 5MB 이내이며 실제 브라우저 저장 가능 용량은 기기 환경에 따라 다릅니다.
7. 노트북·태블릿·휴대폰
| 화면 너비 | 작업 화면 |
|---|---|
| 1,180px 이상 | 왼쪽 작업 메뉴와 넓은 다열 화면 |
| 768–1,179px | 위쪽 메뉴, 화면 공간에 맞춘 유연한 2열 배치 |
| 767px 이하 | 1열 배치와 하단 메뉴, 터치 입력에 맞춘 버튼 |
분석 작업실은 브라우저 화면 너비에 따라 배치가 자동으로 바뀝니다. 휴대폰 가로·세로 전환과 태블릿 분할 화면에도 같은 기준이 적용됩니다.
프로젝트 자료와 구현 범위
콘텐츠는 기존 Tactical Twin AI 리플렛, 최종 발표 대본, 작동 흐름·사업개요 설명 자료, 4경기 핵심 산출물과 경기 장면 태깅 기준을 바탕으로 구성했습니다. 홈페이지의 연구 사례는 기존 문안에 기반하며 실전 자동 분석 성능이나 훈련 효과를 증명하는 자료가 아닙니다.
현재 구현: 영상의 기기 내 재생, 직접 장면 기록과 수정, 코치 검토 상태, 태깅 기반 리포트, 전술 카드, JSON·CSV 입출력.
후속 개발·검증 계획: AI 요약 모델 연동, 자동 선수 추적·장면 분류, 계정과 팀 공유·동기화, 대용량 영상 서버 처리.
