데모 홈

동시 탭과 대기 중 호출자의 역할 경계

검증일: 2026-10-03 UTC. 판정: 수정 후 단위·실제 release 통과 — 최초 red 2건 → actor 6건 green.

이관 뒤 위치(번들 이관, 2026-10-09) — 아래 vet_care 경로 · VetPersistence 는 이관 전 기록이다. 같은 경계는 app/shell/test/src/world/vet_actor_boundary_test.dart 가 지키고, 세션 actor 원본은 DemoStore.actor · setActor (sessionStorage demo-healthcare-vet:session-actor, package/demo_runtime)다. 명령은 호출 시점의 actor 를 잠금 전에 고정한다(DemoStore.write). 직원 actor 에는 보호자 코드가 없다 — fullstack-feature-layout.md §5.

요구 근거

  • coco-de/cocode#653 FR-008: 보호자 전이는 booked → canceled만 허용한다.
  • 같은 PRD FR-015와 §8 상태머신: arrived는 vet.front, in_treatment/awaiting_payment는 vet.doctor 호출자 범위다.
  • §5 투어는 방문자의 역할 전환을 요구한다. §11은 같은 브라우저에서 업무 레코드를 함께 읽고 쓰도록 요구한다.
  • 그 문구는 탭별 독립 페르소나를 명시하지 않는다. 현재 구현도 독립 탭별 actor를 지원하지 않으며, 공유 레코드만으로 대기 중 명령의 호출자를 바꿀 수 있다는 근거는 없다.

구현과 실제 관측

BrowserVetPersistence.locked는 demo-healthcare-vet:mutation Web Lock을 사용한다. LocalVetRepository._write는 그 안에서 최신 저장 레코드를 다시 읽는다. 용량의 read–check–write를 직렬화하는 이 부분은 실제 구현이다.

최초 구현의 LocalVetRepository.setRole은 선택 역할을 world-v1의 공유 role에 저장했고, _write의 권한 검사는 잠금 획득 뒤 다시 읽은 s.role을 사용했다. 호출 당시 actor를 별도로 붙잡지 않았다.

독립 Playwright context의 /app/ 보호자 탭과 /console/ 탭을 동시에 열었다. 보호자 갤러리는 처음 소유 동물 2마리였다. 콘솔에서 일반 포인터로 「접수 데스크」를 선택하자 공유 role이 frontdesk가 되고, 보호자 탭도 staff 범위의 42마리 갤러리로 바뀌었다. 이는 전역 데모 페르소나 전파이며 독립 per-tab actor 증거가 아니다.

결정적 대기열 재현

테스트: feature/application/vet_care/test/vet_actor_boundary_test.dart.

  1. 실제 MemoryVetPersistence.locked를 잠시 잡는다.
  2. 콘솔 setRole(frontdesk)를 먼저 대기열에 넣는다.
  3. 여전히 guardian인 앱 repository에서 명령을 호출한다.
  4. 잠금을 풀어 앞의 역할 변경과 보호자 명령을 차례로 실행한다.
호출 기대 실제
보호자의 보리 15:30 예약 소유 보호자 예약 성공 최신 공유 role을 staff로 해석해 forbidden
보호자의 today-0 → arrived 호출자의 staff 권한 없음으로 forbidden 앞선 콘솔 역할을 획득해 성공

명령: fvm flutter test test/vet_actor_boundary_test.dart --no-pub --reporter expanded (vet_care 디렉터리). 최초 결과: 0 통과 / 2 실패, exit 1. 컴파일 오류를 수정한 뒤 위 도메인 실패를 확인했다.

승인된 수정과 회귀

  • VetPersistence.selectedRole/selectRole가 유일한 세션 actor 원본이다. 브라우저는 sessionStorage['demo-healthcare-vet:session-role'], native memory는 인스턴스별 세션 공간이다.
  • MemoryVetPersistence(sharedWith: …)는 업무 저장소/직렬 잠금/업무 변화만 공유하고 페르소나는 공유하지 않는다.
  • VetSnapshot.encode는 role을 제외한다. schema-1의 과거 role은 decode에서 무시하고 initialize에서 제거해 정규화한다. 과거 staff role을 세션 권한으로 이식하지 않으며 레코드·clock·sequence는 보존한다.
  • _write는 잠금 await 전에 typed actor를 고정한다. 기존 잠금 안에서 최신 업무 레코드를 읽고 고정 actor로 owner/FSM 검증을 한다.
  • _publish/refresh는 지금 선택한 로컬 actor를 읽기 뷰에 적용한다. 오래된 명령 완료가 현재 페르소나를 되돌리지 않는다. 페르소나 변경은 업무 직렬화/sequence/DemoWorld 신호를 바꾸지 않는다.
  • reset은 공유 업무 prefix와 호출 세션 prefix만 지운다. 다른 탭의 역할과 다른 데모 prefix는 보존한다.

actor 테스트 6건 통과: 원래 red 2건, 재로딩/논리 세션 분리/업무 신호0, legacy 권한 무시, 같은 세션의 대기 중 역할 변경, prefix-only reset. 도메인7·notice/validation3을 합친 targeted 16건 통과. 이후 전체 client 16패키지 통과, veterinary 128건 통과(골든480는 별도 capture).

수정 뒤 실제 release 탭 검증

  • fresh 보호자 /app/와 /console/를 같은 독립 browser context에서 열었다. 콘솔 frontdesk→doctor와 재로딩 동안 보호자 프로필 노드는 계속2개, console session doctor는 유지되며 업무 JSON에는 role이 없다.
  • 실제 navigator.locks로 mutation lock을 잡고 일반 「예약 확인」 포인터 입력을 대기시켰다. query에서 held1/pending1을 확인하고 콘솔을 frontdesk→doctor로 바꿨다. 대기 중 업무 JSON은 그대로였다.
  • 잠금 해제 후 visit-1이 guardian-demo 소유로 정상 생성되고 reserved1→2, sequence1이 됐다. 명령이 호출자 권한을 보존했고 console role을 빌리지 않았다. 업무 상태를 직접 주입하지 않았다.
  • 같은 탭으로 문진→내원→진료→정확한 note-5→수납대기→완료(sequence7)까지 일반 입력을 수행했다. 보호자 view는 유지되고 새 기록/알림4가 보였다. 양쪽 error0/외부 요청0.
  • app reset 후 sequence0/visits60/notes80/intakes0와 고지1회가 복원되고, 다른 console 탭의 frontdesk session은 유지됐다. reset 취소는 업무 JSON을 바꾸지 않았다.

완료 경계

권한 guard를 완화하거나 red acceptance probe를 skip하지 않았다. 원래 두 명령 테스트를 그대로 green으로 만들고 새 actor 회귀를 추가했다. 기존 폰트·면책·FR 투어 구현은 보존한다. 로컬 단위 통과는 Linux baseline 또는 공개 배포 완료를 뜻하지 않는다.