웹이 계약 다섯을 받았다 (2026-09-10)
main 을 받아 얹으니 백엔드가 어제(09-09) 한꺼번에 열어 둔 것이 들어와 있었다 — client-contract-changes.md 25~29번. 다섯 다 「백엔드는 됐고 화면만 반영하면 되는」 상태라 이번 회차에 한데 붙였다.
무엇이 달라졌나
가장 크게 달라진 것은 브라우저에만 있던 것이 서버로 갔다는 점이다. 그동안 계약에 자리가 없어 localStorage 로 버티던 값들이라, 다른 기기로 로그인하면 늘 처음 상태로 열렸다.
| 무엇 | 전 | 후 |
|---|---|---|
| 스쿼드 판 배치 | 그 브라우저에만 | 판 크기 · 칸 · 포지션 셋이 서버에 |
| 나를 보여주는 대표 영상 | 그 브라우저에만 · 남의 것은 못 읽음 | 서버가 쥐고, 남의 것도 카드 슬러그로 읽는다 |
| 「이 사람으로 분석」 박스 | 보낼 자리가 없었다 | 등록할 때 함께 올라간다 |
| 집중해서 볼 항목 | 〃 | 〃 |
| 포지션 목록 | 화면 세 곳이 각자 하드코딩 | 서버 하나가 정본 |
판단이 갈렸던 자리 하나 — 알려 둔다
계약대로면 판 칸(grid_col·grid_row)이 비어 있는 등재는 「판에 안 올린 것」이라 안 그리는 게 맞다. 그런데 서버의 기존 행이 전부 비어 있어서 그대로 하면 판이 통째로 비어 보인다. 등재된 사람이 화면에서 사라지는 쪽이 더 나쁘다고 보고, 포메이션 기본 자리에 앉혀서 보여 주되 그것만으로는 저장하지 않기로 했다. 판을 여는 것만으로 서버가 바뀌면 안 되기 때문이다. 한 번 옮기면 그때 칸이 생긴다.
다르게 볼 여지가 있어 미결 항목(paik 9번)에 적어 두었다.
시험이 먼저 잡아 준 것
rubricFocus.test.ts 가 이번 병합 직후부터 빨간색이었다. 그 시험은 agent/rubrics/*.yaml 을 실제로 읽어 화면의 사본과 대조하는데, 정상호 님이 채점 항목 이름에서 해부학 용어를 걷어내면서(「신전」·「굴곡」) 두 벌이 갈린 것이다 — 설계대로 먼저 빨개졌다. 사본을 손으로 옮기지 않고 루브릭 파일에서 직접 뽑아 맞췄다(미결 ho 29번).
같은 날 오후 — 남을 안 기다려도 되는 넷도 붙였다
이어서 막혀 있지 않은 것을 마저 했다.
| 무엇 | 달라진 것 |
|---|---|
| 429 재요청 억제 | 요청이 너무 잦아 거부되면 서버가 준 시간만큼 잠긴다. 그 값이 중간에서 사라지던 것을 이었다 |
| 경기 찾기 거르기 | 종목·지역으로 고를 수 있다. 거르기는 서버가 한다 — 화면에서 걸러 봐야 첫 페이지 안에서만 걸러진다 |
flutter/ 안내 문서 | 네 폴더가 다 찼다. 그 폴더에서만 통하는 관례를 적었다 |
| 공개 여부를 서버로 | 🔴 남이 공개한 영상이 처음으로 보인다. 그전에는 브라우저에만 남아서 다른 기기에서도 남에게도 안 보였다 |
시험이 잡아 준 것 하나
공개 여부를 서버로 옮기고 나니 삭제 시험이 「요청이 두 번 나갔다」고 빨개졌다. 영상을 지운 뒤에도 공개를 내리는 요청을 보내고 있었다 — 저장소를 쓰던 때는 로컬 정리라 맞았지만, 이제는 방금 지운 영상을 고치려 드는 것이다. 공개도 대표도 클립의 성질이라 클립이 사라지면 같이 없어진다.
다음
남은 한 칸은 분석 리포트다. 에이전트가 진짜 결과를 내고 있고 완료 보고에 자리(report_key)도 실리는데, 그것을 읽는 경로가 아직 계약에 없다 — 화면은 그대로 하드코딩된 리포트를 그린다. 이제 이것 하나가 남았다.
저녁 — 「팀 매칭」을 만들었다
스쿼드 판이 다 차면 팀 매칭 단추가 깜빡이고, 누르면 조건(어느 동네 · 언제)을 묻는다. 조건에 맞는 팀 명단에서 경기를 신청하고, 수락되면 경기장 사진 위로 대기 화면이 올라오며 잡힌 경기가 내 프로필에 붙는다.
🔴 전부 데모다. RAG 추천 · 신청 · 알림 · 수락 · 조건 저장 · 지역 목록 여섯이 다 계약에 없다 — 화면은 끝까지 도는데 서버로 나가는 것이 하나도 없다. 그래서 화면 네 곳에 「데모입니다」를 적어 두었고, 여섯을 미결 항목으로 올렸다.
한 가지는 지켰다 — 「왜 이 팀이 비슷한가」를 지어내지 않는다. 적어 둔 조건과 대조해서 실제로 겹치는 것만 적는다. 손으로 적어 뒀다가 「토요일」이라 해 놓고 날짜가 일요일이었던 적이 있어서다.
- 처리한 항목: 미결 항목 의
paik5 · 6 · 8 · 9 · 10번,jin2 · 9 · 13 · 15 · 26번,ho29번 - 새로 올린 것:
paik15 · 16번(공개 클립의 화면 비율 · 올린 사람) · 17~22번(팀 매칭의 계약 여섯) - 아직 열린 것:
paik7번(리포트 읽는 경로)