659 S4 W4-04 — login 부분 재사용
# #659 S4 W4-04 — login 부분 재사용
2026-10-10 PC-A 임시 writer. [설계 §8·§12](s3-design-record.md)와 [W4-01 계획](s4-integration-plan.md)을 따라 **W4-03 PR5 head `07876163f6e1c9fcc2fe39213ffa3d2fb3b1b282`**에서 `story/cocode-659-s4-login`을 만들었다. PR base는 `main`, 선행은 PR5다. PR2/3/4/5·wip·salvage를 머지하거나 변경하지 않았다.
## 원본 결합과 bootstrap 선행 계획
login 후보 `40e95a32`·`464762db`·`677a294c`·`2e821d1e`의 **원본 85경로**를 선별 적용했다. 생성 SDK/Slang/test tools와 후보의 baseline 교체는 제외했다. 시험 seed의 production 이동은 별도로 결합하며 **W4-03의 7종 revision 필드**를 모두 보존했다. pubspec 충돌은 공식 `profile.py apply stable --version 4.0.3`로 정렬했고 SUB의 async caller 변경과 기존 revision/같은 설정 no-op를 함께 유지했다.
원본 적용 전에 [login/locale bootstrap 계획](s4-w4-04-bootstrap-plan.md)을 기록했다. 실제 후보 교집합은 8경로(README·CLAUDE·두 bootstrap·grocery_host ko/en JSON 및 생성물)이다. locale/prefs/query 첫 선택은 초기 투영·runApp 앞단, login connection은 SDK 초기화 뒤 후단으로 소유를 나눈다. 이번에는 기존 LocaleSettings 초기화를 유지하며 locale 후보 전체를 가져오지 않았다.
## 실제 인증과 업무 신원
| 경계 | 구현 |
|---|---|
| 이메일 IdP→JWT | 실행 서버와 실제 인증 시험이 같은 `configureGroceryAuth`를 사용. 실제 IdP 로그인이 발급한 JWT로 SDK 요청을 인증 |
| AuthUser→업무 계정 | 호스트 `GroceryAccount`: AuthUser UUID와 데모 업무 principal을 각각 unique로 매핑. serverOnly 모델이며 클라이언트가 매핑을 쓰는 endpoint는 없다 |
| `groceryAccount.me()` | 로그인 필수. 매핑 principal(nullable)과 정렬된 업무 scopes만 반환. 매핑 없음은 업무 모듈이 거부 |
| 7개 caller 포트 | GP·DS·GO·SH·AL·SUB·RV 각각 호출자가 소유하는 port를 호스트 인스턴스에 바인딩. 기능 service는 AuthUser UUID를 owner로 쓰거나 `session.authenticated`를 직접 읽지 않는다 |
| 권한/격리 | JWT scopes에서 이 데모의 10개 업무 scope만 인정. 각 모듈은 principal·scope·owner를 다시 검사. 미바인딩은 fail-closed이며 공개 카탈로그만 신원을 요구하지 않는다 |
| 비운영 seed/계정 | production에서는 실행하지 않는다. 업무 표가 비었을 때만 같은 A seed를 넣고, `demoAccountPassword`가 있을 때만 기존 계정을 덮지 않고 데모 계정 생성. 비밀 값 출력 없음 |
scope/타인 거부·다른 scope 제거·매핑 없음·미바인딩을 실제 JWT SDK로 검증했다. 실제 매니저의 슬롯 마감/해제, 피커의 슬롯 쓰기 거부, 매핑 없는 사용자의 슬롯 관리 거부 단언도 추가해 7개 기능 경계를 대조했다. W4-03의 expectedRevision 요청과 충돌 처리는 유지한다.
## 앱/콘솔 gate와 오류
server 모드만 `GroceryServerConnection`을 등록한다. gate는 **restore→로그인→me→구매자/직원 audience 검사→셸** 순서이며, 셸을 열기 전에 신원을 확인한다. 로그아웃/401은 신원과 로그인 상태를 지우고 로그인 화면으로 돌아간다. 틀린 비밀번호·매핑 없음·잘못된 역할·연결 실패·서버 설정 누락은 명시 화면이다.
후보에서 로그인 상태를 알기 전 restore 연결 실패가 로그인 화면에 가려질 수 있던 분기를 고쳤다. 명시 오류→복원 재시도와 오류 화면에서 로그아웃→로그인 화면 복귀를 **위젯 단언 2개**로 보강했다. localOnly bootstrap은 connection을 등록하지 않고 기존 배너·세계·셸을 유지한다. server 설정 누락은 localOnly 또는 mock으로 폴백하지 않는다.
검증 경계는 구분한다:
- **실제 backend IdP SDK 시험 8개**: 생성 SDK→실제 이메일 로그인→JWT→me 매핑→기능 service/격리 DB. 4페르소나·scopes·본인/타인·틀린 비밀번호·매핑 없음·미바인딩·비운영 준비·JWT 복원/로그아웃 단언을 실행했다.
- **실제 앱 연결 시험 2개**: 실제 JWT 서버에 production `GroceryServerSession`과 `FlutterAuthSessionManager`를 연결했다. 잘못된 비밀번호 거부→로그인/업무 신원→저장된 JWT 복원→로그아웃/저장소 제거→재복원 false, client 없는 serverMissing을 단언했다. 상태만 흉내 내는 연결로 대체하지 않았다.
- **위젯 gate 13개 + 앱/콘솔 셸 2개**: 연결 상태만 `FakeGroceryServerConnection`으로 제어하며 실제 위젯을 mount했다. loading/로그인/복원/오류/재시도/로그아웃/역할/만료/localOnly bypass를 단언했다. 이 UI 시험을 실제 JWT 통합 시험으로 세지 않는다.
실제 앱 연결 시험은 저장소 밖의 durable probe를 잠시 backend test 경로에서 `dart run`으로 실행해 native assets와 패키지 해석을 사용했다. 초기 직접 Dart 실행의 Argon2 native assets 누락, 저장소 밖 `dart run`의 package 해석 실패 로그를 보존했다. 실행 방식 수정 후 2개가 통과했고 임시 source·격리 DB를 정리했다. 임의 자격 증명은 실행 환경에만 넣었고 산출물/로그에 쓰지 않았다.
## migration과 DB 두 경로
고정 Serverpod **4.0.3** 공식 generate→`create-migration -- --tag login`으로 host **`20261010031535346-login`** 한 개(5파일)를 append했다. DDL은 `grocery_accounts` 테이블과 authUserId/principal unique index뿐이다. 기존 baseline+revision 정의 **70파일 hash diff0**, registry 8개 중 **host 1개만 append·7개 byte 동일**, 모든 이전 registry 내용이 prefix로 보존된다. 기존 업무 표/행/판을 재작성하지 않았다.
**Fresh DB:** official 전체 migration으로 새 격리 DB를 초기화하고 host 시험 **74개 / skip0 / 실패0**을 실행했다. `grocery_accounts`를 포함해 live 컬럼↔생성 protocol 모델을 비교했고 원래 baseline+append 순서를 단언했다. 위 실제 IdP 시험과 revision·멱등·원자성·권한·교차 기능 시험을 포함한다.
**기존 fixture upgrade:** PR5의 **4.0.3 revision 모델**로 seed와 실제 SDK 주문 생성/모의결제를 저장한 같은 DB에 login migration을 적용했다. **18업무 테이블·429행 모든 기존 컬럼값(기존 revision 포함) 동일**, seed 업무 값/순서 동일, ko/en 상품명 투영 동일을 단언했다. 새 host 신원 매핑 표는 fresh 실제 인증 시험으로 따로 검증한다. 성공 후 이 실행이 만든 DB만 정리했다.
## 로컬 검증과 공급 영향
Flutter3.47.6 / Dart3.13.5 / macOS arm64. 무거운 작업은 순차 실행했다. 확인한 디스크 Available은 약63GiB로 40GB 이상이다. Serverpod profile/CLI/전체 의존은 **4.0.3**, co-package **c003ca2c**, CoUI **v0.158.0**을 유지한다. 공급 ref 상향0, 공용 저장소 쓰기0이다.
| 검증 | 결과 |
|---|---|
| workspace flutter pub get | exit0 · 2.188s |
| module7→host Serverpod generate | exit0 · 156.053s |
| 공식 login migration 생성 | exit0 · 96.213s |
| Flutter Slang/build_runner codegen | exit0 · 29.004s |
| fixture 준비→upgrade | exit0 · 8.620s / 8.584s |
| dart analyze --fatal-infos | exit0 · 최초7.645s; 마지막 단언 후 최종 재검사 수행 |
| 계약 게이트 check_all.sh | exit0 · 4.415s; 보고서 결합 후 재검사 수행 |
| TZ=UTC 전체 workspace 시험 | exit0 · 168.259s · **34패키지 / 524성공 / 625skip / 0실패** |
| 마지막 실제 IdP/슬롯 권한 시험 | exit0 · 5.248s · **8성공 / skip0 / 실패0** |
| 실제 앱 GroceryServerSession | exit0 · 13.275s · **2성공 / skip0 / 실패0** |
| 필수 SDK/localOnly contract | exit0 · 14.301s · **2성공 / skip0 / 실패0**, 같은83단계씩 |
| Serverpod→Flutter 반복 생성 | exit0 · 93.664s / 19.981s · **251생성물 hash diff0** |
workspace의 마지막 슬롯 권한 단언 추가 이후 해당 IdP 파일 8개를 재검증했다. 추가 실제 앱 연결 시험과 필수 contract는 workspace 수와 별도로 보고한다. 일반 workspace의 **625skip = 골든624(11파일·27그룹) + 서버 URL 없는 contract1** 분류는 [W4-03 보고](s4-w4-03-revision.md)와 동일하다. 필수 contract는 서버를 띄우고 `GROCERY_CONTRACT_REQUIRED=1`로 조건부 skip을 허용하지 않았다. skip을 성공/완료로 세지 않는다.
co-package 소비 ref는 W4-02와 같으며 DisplayProjector/11언어 이관은 없다. 번역 변화는 grocery_host의 **ko/en login 관련17키씩**과 공식 Slang 출력이다. 기존 투영 원본·ko/en 상품명 비교·골든 PNG 변화0이고 기존 seed·fixture의 돈/수량/FK/owner/순서/C 입력/판은 보존한다. Linux golden capture/compare를 수행하지 않았으며 local UI 성공이 공개 브라우저 smoke나 11언어 완료 증거는 아니다.
원본 선별 목록/패치·locale 교집합·fixture/이력 비교·명령 exit/시간·실패/재실행·실제 앱 세션 probe·시험 집계·251파일 반복 생성 해시는 `/Users/dongwoo/orca/toolchains/637/xhost/s4-659-w4-04/`에 보존하며 `artifact-sha256.json`으로 해시를 기록한다. 생성 SDK import/Slang/test tools/migration history 수기 편집0이다.
## FR 상태와 남은 BLOCKED / next
설계 §1 대비 **FR 상태 변화0: 구현+검증17·부분8**. server login의 로컬 결합을 검증했으며 FR-001의 localOnly 첫 방문 역할 선택 등 W4-05 빈틈은 그대로 남는다. 공개 Pages는 localOnly·업무 네트워크0 배선을 유지하지만 이번 묶음에서 게시/공개 browser smoke를 새로 실행하지 않았다. 같은 main SHA의 13게이트/verified/앱 전체/갤러리 체험 가능을 선언하지 않는다.
| 남은 BLOCKED / issue | next |
|---|---|
| Actions 예산 / cocode#637 | 조사·재실행·workflow 수정 없음. 예산 복구 뒤 coordinator PR2→3→4→5→이번 PR 머지 열차와 같은 main SHA 검증 |
| Linux golden / cocode#659 S-14 | W4-08 capture·compare. 624 skip은 완료가 아님 |
| bundle profile/verified / co-bricks#830/#831/#764, generation-lock/#860 | 승인 소유자 공급 뒤 W4-12 full cleanbase·diff0, legacy stamp 수기 승격 금지 |
| v3 option_sheet / cocode#638 F3 · 아이콘 / coui#5149 | 승인 해결 ref 후 소비. 진행 중 coui#5354 임의 소비 없음 |
| Patrol / cocode#659 AC12 · Mobbin / AC15 · 공개6표면 / AC16 | W4-09~12 실제 runner/실측/공개 검증. 접근·runner 부재는 BLOCKED 유지 |
이번 세션은 W4-03·04의 두 구현/검증 PR까지 제출한다. 다음 세션은 이 PR head에서 **W4-05 FR 보강→W4-06~07 locale→W4-08 검증→W4-09~13 앱 여정·브랜드·6표면·full 재현·증거** 순서다. §14 PG/실환불·배송기사API·주소검색·push·billing/scheduling·쿠폰/적립·WMS·media_upload의 capability 경계를 유지하며 실제 외부 capability 구현/covered를 선언하지 않는다.