[A23] 계정·알림·권한별 운영 UI 실제 API 연결

[Juwon-Na]

연결

• 상위: [A] 계정·운영 전체 흐름 Idea2Strategy#23
• 정본: docs/backend-implementation-master-checklist.md A23, specs/ui/ui.operator.work.md
• 후속: A90, A91

목적

계정·알림·사건과 권한별 운영 화면을 실제 backend 계약에 연결하고 권한 부족·세션 만료·오류를 숨기지 않는다.

병합 완료

• 계정/세션/복구/설정/알림/user-case typed client·UI — PR feat: connect account and operations UI APIs #116
• Chromium→Vite proxy→production backend→PostgreSQL 실제 account/user-case E2E — PR test: exercise account UI against real backend #117
• operator /me·catalog·assignment typed client와 permission별 visibility/route/error mapping — PR feat: add operator RBAC read workspace #118 (4e92b33d)
• operator 요청은 전용 Bearer와 credentials: omit; raw identity header/cookie 미사용
• production token provider 미주입 시 operator route dormant fail-closed
• unit 409 tests, typecheck, build, GitHub CI 성공
• root UI pointer는 후속 root develop에 통합 완료

남은 범위

• 실제 operator OIDC provider/ALB token source를 전용 client에 주입
• real browser에서 permission/forbidden/stale MFA/revoke/retire/disable E2E
• 제재·운영 사건 command UI와 high-risk reason/correlation 확인 흐름
• A21/A22 최종 전체 account/operations browser journey

병합 판정

서버 검증을 우회하지 않는 merge-safe dormant UI 경계까지 완료했습니다. 실제 배포 token provider와 browser E2E가 남아 있어 이슈는 open 유지합니다.

[Juwon-Na]

A23 incremental A07-A12 API shell is pushed without a PR because A13-A22 APIs are not fixed yet. Branch codex/110-account-api-shell, exact commit is the branch head. Added typed signup/email verification/login/session logout/preferences/withdrawal cancellation/reactivation client, cookie+Bearer support, correlation and idempotency headers, stable error code/correlation mapping, and token clear only after successful logout. Focused tests, typecheck, and production build passed. Screens, notifications/cases/operator APIs and browser E2E remain gated; no PR was opened.

[Juwon-Na]

A23 incremental UI 연결 — account panels

A07–A12 account API client shell을 기존 AccountView에 주입 가능한 panel로 연결했습니다.

• 브랜치: codex/110-account-api-shell
• HEAD: 1e590cf
• PR: 생성하지 않음 (backend A13–A22 고정 통합 전)

이번 연결 범위

• 실제 sessions + preferences 동시 loading 및 현재 세션 표시
• 서버 언어/시간대/테마 설정 조회·수정
• 탈퇴 요청·취소·password 재활성화 lifecycle 명령
• 401 로그인 안내, 403 권한 부족, network/server 오류 구분
• 서버 correlation ID 표시 및 실패 요청 retry
• lifecycle retry에서 최초 Idempotency-Key를 그대로 재사용하여 중복 제출 방지
• App에서 defaultAccountClient를 사용하고 component test에서는 AccountClient 주입 가능
• 기존 AccountView의 브라우저 전용 화면 설정과 Notifications mock 흐름은 전면 교체하지 않고 유지
• backend A13–A22에 의존하는 운영자·알림·사건 화면은 변경하지 않음

검증

• pnpm test --run: 19 files / 302 tests PASS
• pnpm typecheck: PASS
• pnpm build: PASS
• 신규 component tests: loading, API success, 401, 403, correlation ID, retry, idempotency reuse, preference save

남은 gate

backend A13–A22의 고정 API/권한/알림/사건 계약과 merge commit을 받은 뒤 운영 화면·알림·사건 연결 및 실제 API browser E2E를 이어서 통합해야 합니다.

[Juwon-Na]

A23 계정·운영 API 연결 갱신

브랜치 codex/110-account-api-shell에 backend 후보 계약을 기준으로 다음 UI 연결을 추가했습니다.

• HEAD: 280668c
• PR: 생성하지 않음 (backend 및 canonical 계약이 아직 merge-ready 상태가 아님)
• 기준 backend 후보: A13 105d607, A14 af2c08c, A16 e817018, A18 376d92b, A19 e4fa03b, A20 76daffc

완료한 범위

• /api/v1/cases 사용자 문의·신고·이의 제기 typed client 및 Account 화면 접수/조회 UI
• /api/v1/operations/cases 운영 케이스 대기열·상세·상태 명령 typed client 및 /operations/cases UI
• 운영 명령의 확인 → 처리 중 → 성공/실패 상태, expected version, Idempotency-Key, correlation ID 처리
• A13 RBAC grant/revoke, A14 sanction apply/lift, A16 Admin MCP invoke typed client
• 401/403 권한 실패, 409 stale/idempotency 충돌, 429/5xx/network 재시도 가능 오류 구분
• ProblemDetail 및 {code, correlationId} 두 오류 형식을 모두 정규화
• high-impact RBAC/sanction/Admin MCP는 typed boundary만 제공하고 일반 사용자 내비게이션에는 노출하지 않음
• 브라우저가 임의 서버 상태를 추정하지 않고 응답 DTO의 type/status/version/evidence만 검증하여 표시

검증

• pnpm test -- --run: 21 files / 314 tests PASS
• pnpm typecheck: PASS
• pnpm build: PASS

남은 hard gate

• A18에는 notification query/application/persistence는 있지만 browser가 호출할 HTTP controller 계약이 없어 Notifications mock을 실제 API로 교체하지 않음
• A13–A22 후보가 backend develop에 통합되기 전에는 실제 인증/RBAC/동시성 browser E2E를 확정할 수 없음
• backend 통합 후 실제 API E2E와 알림 HTTP 계약 연결을 완료한 뒤에만 PR 생성 가능

[Juwon-Na]

A23 알림 API 연결 완료

A18 HTTP API 후보 abbc50a36e5658e51822ea0292cc893c9ead4ec9를 기준으로 알림 화면과 계정 알림 설정을 연결했습니다.

• UI 브랜치: codex/110-account-api-shell
• UI HEAD: 5baba90
• PR: 생성하지 않음 (backend A13–A22 통합 전)

완료한 범위

• GET /api/v1/account/notifications 목록 및 paired cursor pagination
• PUT /api/v1/account/notifications/{notificationId}/read 읽음 처리
• GET /api/v1/account/notifications/preferences 설정 조회
• PUT /api/v1/account/notifications/preferences/{typeCode} 채널 교체
• Bearer session token을 계정 로그인 client와 알림/운영 client가 메모리에서 공유하고 로그아웃 시 제거
• 토큰이 없으면 네트워크 요청 전에 로그인 필요 상태로 fail-closed
• loading, empty, unread filter, pagination, read processing, authentication error, retryable error, correlation ID 상태
• typeCode/templateVersion/locale/templateArguments만 표시하여 미확정 템플릿 문구나 목적 화면을 추정하지 않음
• 필수 채널은 변경 불가, optional 현재 EMAIL 채널은 APP-only로 안전하게 변경
• pagination 경계 중복 알림 제거 및 불완전 cursor 응답 거부

검증

• pnpm test -- --run: 24 files / 325 tests PASS
• pnpm typecheck: PASS
• pnpm build: PASS

남은 통합 gate

• 실제 backend 통합 SHA에서 로그인 → 알림 목록/읽음/설정 → 운영 케이스 browser E2E 실행
• 현재 preference 응답은 enabledChannels만 제공하고 availableChannels는 제공하지 않으므로, UI가 EMAIL 비활성 상태에서 EMAIL 사용 가능 여부를 추정하지 않도록 재활성화 버튼은 노출하지 않음
• backend A13–A22 및 root pointer 통합 전에는 PR을 생성하지 않음

[Juwon-Na]

A23 안전한 incremental UI 통합 — 2026-08-03

• UI PR feat: connect account and operations UI APIs #116 병합: c0095f1c
• PR CI 및 develop push CI 성공
• backend ef15283 exact DTO에 맞춘 session client (sessionId / issuedAt)
• signup·email verification/resend·password reset·session rotate/revoke·preferences UI/client
• notification 및 user-case UI/client, lost-response retry 시 최초 Idempotency-Key 재사용
• operator API/Admin MCP는 독립 operator credential 없으면 요청 전 fail-closed
• unit 386 tests, typecheck, build, Playwright 6/6

이 PR은 #110을 닫지 않습니다. 남은 hard gate는 backend production principal/operator-context binding, operator permission read/bootstrap, 그리고 그 exact backend 조합에서의 실제 API browser E2E입니다. UI는 해당 서버 신뢰 경계를 임의 header로 대체하지 않았습니다.

[Juwon-Na]

A23 실제 backend browser E2E 통합 — 2026-08-03

• UI PR test: exercise account UI against real backend #117 병합: 9e7f623d
• PR CI 및 develop push CI 성공: https://github.com/Idea2Strategy/Idea2Strategy-ui/actions/runs/30784099437
• Chromium → Vite socket proxy → production backend-api → ephemeral PostgreSQL 실제 경로
• signup → verification fixture → verify → login → bearer session/preferences → preference update → user-case POST/GET
• HTTP mock 미사용, backend 65e6426b 및 root e259a837 exact revision 고정
• root canonical Flyway CI bundle migrate/validate 사용
• unit 391 tests, typecheck, build, 기본 Playwright 6/6, 실제 backend Playwright 1/1
• atomic Docker run lock 및 실행 후 ephemeral container/network cleanup 검증

자동 close되었던 #110은 완료 조건이 아직 전부 충족되지 않아 다시 열었습니다. 남은 범위는 독립 operator credential/provenance와 permission bootstrap/read API가 확정된 뒤 운영자 RBAC·제재·사건 처리 화면 및 실제 API browser E2E를 완성하는 것입니다. UI는 신뢰되지 않은 임의 header를 operator identity로 사용하지 않고 fail-closed를 유지합니다.