Merge pull request 'docs(cloud): 클라우드 서버 도메인 가상 호스트 및 HTTPS 설정 지침 반영' (#13 ) from chore/gitignore-dotnet-build-artifacts into main

Reviewed-on: #13
Merge pull request 'chore(git): .NET 빌드 산출물 추적 제거 및 .gitignore 정비 (WBS-P0.1)' (#12 ) from chore/gitignore-dotnet-build-artifacts into main
2026-07-01 10:46:06 +09:00 · 2026-06-30 18:20:20 +09:00 · 2026-06-30 18:20:12 +09:00 · 2026-06-30 18:03:26 +09:00
30 changed files with 294 additions and 690 deletions
@@ -135,7 +135,8 @@
 - **임시 파일 관리**: 개발/디버깅 목적의 모든 휘발성 임시 파일 및 로그는 반드시 `Temp/` 디렉토리 하위에서만 생성해야 하며, 루트나 다른 패키지 경로에 임시 파일을 만드는 것은 금지한다. 불가피하게 생성할 경우 반드시 접두사/접미사 규칙(`debug_*`, `tmp_*`, `mock_*`, `*_temp.*`)을 준수하여 `.gitignore`에 필터링되도록 한다.

 ## 5b. Blazor & API-First 개발 규칙 (TaxBaik 참조 모델 적용)
- **API-First 아키텍처**: Blazor Server UI 계층은 비즈니스 로직이나 DB에 직접 결합되지 않고, `IXxxBrowserClient` 등의 추상화된 API 클라이언트(HTTP/RESTful)를 통해서만 백엔드 API와 통신한다.
+- **렌더 모드 표준**: Blazor **Interactive WebAssembly** 를 기본 렌더 모드로 한다. InteractiveServer 는 사용하지 않으며, UI 컴포넌트는 **MudBlazor** 로 통일한다 (Fluent UI 는 폐기).
+- **API-First 아키텍처**: Blazor Interactive WebAssembly UI 계층은 비즈니스 로직이나 DB에 직접 결합되지 않고, `IXxxBrowserClient` 등의 추상화된 API 클라이언트(HTTP/RESTful)를 통해서만 백엔드 API와 통신한다.
 - **이중 토큰 인증 패턴**: Access Token(15분) 및 Refresh Token(7일) 이중 토큰 패턴을 적용하며, HttpClient 요청 시 401 Unauthorized를 가로채어 자동으로 localStorage의 Refresh Token으로 토큰을 자동 갱신 및 재시도하는 `TokenRefreshHandler` (DelegatingHandler) 구조를 준수한다.
 - **실시간 알림 (SignalR)**: 실시간 알림 기능은 상태를 직접 동기화하는 용도가 아닌 단순 Event-driven 브로드캐스트 알림으로 설계하며, 클라이언트는 알림 수신 후 API 호출을 통해 최종 데이터를 검증 및 동기화한다.
 - **UI/UX 구현**:
@@ -7,18 +7,18 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 **QuantEngine v0.1** — A comprehensive quantitative analysis and data collection system for retirement asset portfolio management.

 - **Architecture**: .NET 9 + C# (web UI + APIs), Python (legacy data collection/analysis)
- **Web UI**: Blazor WebAssembly (Fluent UI Blazor v5) + ASP.NET Core Web API
+- **Web UI**: Blazor Interactive WebAssembly (MudBlazor) + ASP.NET Core Web API (API-First)
 - **Database**: PostgreSQL (Npgsql 8.0), single unified database
 - **Data Source**: KIS Open API (quotations/ranking read-only), with fallbacks
 - **Key Runtimes**: .NET 9, Python 3.9+, Node.js 16+

 ### Migration Phases Status (2026-06-29)

-**Phase 1: Web UI Migration** ✅ COMPLETE
- Blazor WebAssembly with Fluent UI v5 (RC: 5.0.0-rc.4-26177.1)
- MudBlazor completely deprecated (0% remaining)
+**Phase 1: Web UI Migration** 🔄 정책 전환 (2026-06-30)
+- **신규 표준**: Blazor **Interactive WebAssembly** 렌더 모드 + **MudBlazor** 컴포넌트 + API-First
+- **이전 표준(폐기)**: Fluent UI Blazor v5 / InteractiveServer 렌더 모드는 더 이상 사용하지 않음
 - Pages: Home, Workspace, Collection, Tables, MainLayout
- Build: 0 errors, 6 Razor RC warnings (acceptable)
+- 코드 전환 작업은 `docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md` 의 **WBS-A7** 로 추적

 **Phase 2: KIS Data Collection Pipeline** ✅ 95% COMPLETE
 - ✅ KIS API Client: Full implementation complete
@@ -84,22 +84,24 @@ sudo systemctl restart quantengine-api

 ### Framework & Design System

- **Primary Framework**: [Fluent UI Blazor v5](https://v5.fluentui-blazor.net/)
- **Design System**: Microsoft Fluent Design System (WCAG 2.1 AA)
- **Deprecation**: MudBlazor is deprecated. Migrate all existing pages to Fluent UI v5 progressively.
+- **Primary Framework**: [MudBlazor](https://mudblazor.com/)
+- **Design System**: Material Design (MudBlazor), 고밀도/대량 데이터 성능 우선
+- **Render Mode**: **Interactive WebAssembly** 를 기본 렌더 모드로 한다 (API-First). InteractiveServer 는 사용하지 않는다.
+- **Deprecation**: **Fluent UI Blazor v5 는 폐기**한다. 기존 Fluent UI 페이지는 MudBlazor 로 점진 이전한다.

 ### Component Development Rules

 1. **All UI Development** (New + Refactored):
-   - Use Fluent UI Blazor v5 components exclusively
-   - Fall back to pure HTML/CSS if Fluent v5 doesn't provide
-   - **Never introduce MudBlazor components** (deprecated)
-   - Progressively migrate existing MudBlazor to Fluent v5
+   - Use **MudBlazor** components exclusively
+   - Fall back to pure HTML/CSS if MudBlazor doesn't provide
+   - **Never introduce Fluent UI components** (deprecated)
+   - Progressively migrate existing Fluent UI to MudBlazor
+   - **API-First**: UI 는 DB/비즈니스 로직에 직접 결합하지 않고 추상화된 API 클라이언트(HTTP)로만 통신 (AGENTS.md §5b 준수)

 2. **Loading States** (Priority order):
-   - `<FluentSkeleton>` — **Default** for lists, cards, dashboards, detail pages
+   - `<MudSkeleton>` — **Default** for lists, cards, dashboards, detail pages
   - Pure HTML `<div class="skeleton">` — For custom layouts
-   - `MudProgressCircular` / `MudProgressLinear` — Exception only (existing legacy)
+   - `<MudProgressCircular>` / `<MudProgressLinear>` — 명시적 진행 표시가 필요한 경우
   - Blocking spinners — **Avoid**

 3. **Data Rendering Pattern**:
@@ -107,21 +109,22 @@ sudo systemctl restart quantengine-api
   - On data arrival: Replace skeleton with actual UI
   - Never show blank states while loading

-4. **Component Mapping** (Fluent UI v5):
+4. **Component Mapping** (MudBlazor):

-| UI Element | Fluent UI Component | Alternative |
+| UI Element | MudBlazor Component | Alternative |
 |-----------|-------------------|-------------|
-| Button | `<FluentButton>` | - |
-| Input field | `<FluentTextField>` | HTML `<input>` |
-| Dropdown | `<FluentSelect>` | HTML `<select>` |
-| Data grid | `<FluentDataGrid>` | HTML `<table>` |
-| Card | `<FluentCard>` | HTML `<div class="card">` |
-| Badge/Status | `<FluentBadge>` | HTML `<span>` |
-| Layout container | `<FluentStack>` | HTML `<div>` |
-| Accordion | `<FluentAccordion>` | HTML `<details>` |
-| Navigation | `<FluentNavMenu>` | HTML `<nav>` |
-| Loading | `<FluentSkeleton>` | CSS skeleton animation |
-| Icons | `<FluentIcon>` | SVG inline |
+| Button | `<MudButton>` | - |
+| Input field | `<MudTextField>` | HTML `<input>` |
+| Dropdown | `<MudSelect>` | HTML `<select>` |
+| Data grid | `<MudDataGrid Dense Virtualize>` | HTML `<table>` |
+| Card | `<MudCard>` | HTML `<div class="card">` |
+| Badge/Status | `<MudBadge>` / `<MudChip>` | HTML `<span>` |
+| Layout container | `<MudStack>` / `<MudGrid>` | HTML `<div>` |
+| Accordion | `<MudExpansionPanels>` | HTML `<details>` |
+| Navigation | `<MudNavMenu>` | HTML `<nav>` |
+| Loading | `<MudSkeleton>` | CSS skeleton animation |
+| Icons | `<MudIcon>` | SVG inline |
+| Modal/Dialog | `<MudDialog>` (CRUD: 모달 패턴, 삭제: ConfirmDialog) | - |

 ## Development Commands (Phase 1 + 2)

@@ -1378,6 +1378,8 @@ WBS-8.8 (KIS 리팩터) — 독립적 (원격 병행)

 ### WBS-10: C#/.NET 엔진 고도화 (Phase 10, 2026-06~12)

+> **📌 보강 문서(2026-06-30):** 본 WBS-10 의 다수 항목이 `완료` 표기되어 있으나 실측 결과 일부 괴리(10.6 파이프라인·10.9 보안 실질 미완성)가 확인되었다. 마이그레이션 완성 우선 + 상용화 잔여 작업의 재정의는 [WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md](./WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md) 참조.
+
 > 현황 진단(2026-06-26): .NET 프로젝트는 Python 엔진(41 모듈, 14,500 LOC) 대비 5~10%(~1,400 LOC) 수준.
 > Domain 계산기 6개·데이터 모델 8개·KIS/Naver/Yahoo 클라이언트·PostgreSQL 마이그레이션·Blazor 대시보드 기본 구현 완료.
 > **미구현**: Application 서비스 일부, 공식 엔진, 하네스 주입, 파이프라인 오케스트레이터.
@@ -0,0 +1,190 @@
+# WBS-10 보강: .NET Core 마이그레이션 완성 & 상용화 로드맵 (2026-06-30)
+
+> 본 문서는 [docs/ROADMAP_WBS.md](./ROADMAP_WBS.md) 의 **WBS-10(.NET 엔진 고도화)** 을 현 시점 실측 기준으로 재진단하고, 마이그레이션 완성과 단일 사용자 상용 운영에 필요한 잔여 작업을 재정의한다.
+>
+> **작성 배경:** 기존 WBS-10 의 다수 항목이 `완료` 로 표기되어 있으나, 2026-06-30 소스 실측 결과 **표기와 실제 상태 간 괴리**가 확인되었다. 본 문서는 그 괴리를 정리하고 실제 잔여 작업을 추적한다.
+>
+> **의사결정(사용자 확정):** ① 우선순위 = **마이그레이션 완성 우선**, ② 산출물 = **로드맵/WBS 문서**, ③ 인증 모델 = **단일 사용자 + 기본 보호**.
+
+---
+
+## 1. Context — 왜 이 보강이 필요한가
+
+QuantEngine 은 은퇴자산 포트폴리오 운용을 위한 결정론적 퀀트 엔진이다. canonical 권위는 여전히 **Python 구현(219 파일, 24,683 lines)** 에 있고, `.NET 10` 마이그레이션은 Core / Application / Infrastructure / Web / Tools / Tests 6개 프로젝트로 구조화되어 Phase 1(Web UI)·Phase 2(KIS 수집)까지 도달했다.
+
+그러나 다음 세 가지 근본 결손으로 마이그레이션 완료 및 상용 기준에 미달한다.
+
+1. **마이그레이션 미완성** — 도메인 단일 권위가 Python 에 잔존. `PipelineOrchestrator` 가 실제 로직이 아닌 시뮬레이션 스텁. Python↔.NET 패리티가 일부 도메인 계산기에만 존재. GAS 공식 14건 미이관.
+2. **상용 운영 결손** — 소스에 하드코딩 시크릿 잔존, `.gitignore` 의 `bin/obj` 누락으로 빌드 산출물 git 추적, 헬스체크·메트릭·재시도·스케줄러·운영 구성(`appsettings.Production.json`) 부재.
+3. **검증 공백** — KIS→스냅샷→정성매도 전 구간 E2E 와 CI 커버리지 게이트 부재.
+
+---
+
+## 2. 표기 vs 실제 괴리 정리 (2026-06-30 실측)
+
+| 기존 WBS | 기존 표기 | 실측 상태 | 괴리 / 조치 |
+|---|---|---|---|
+| WBS-10.6 파이프라인 오케스트레이터 | **완료** | `PipelineOrchestrator.cs` 가 각 단계를 `Task.Delay(10)` 로만 시뮬레이션. 실제 서비스 호출 없음 | 🔴 **실질 미완성.** → 본 문서 **A1** 로 재추적 |
+| WBS-10.9 보안 강화 | **완료** | `appsettings.json` 은 `Password=;` 처리됨. 그러나 `Program.cs:19` 텔레그램 토큰 평문, `Program.cs:34` DB 패스워드 폴백 평문 잔존. `.gitignore` 에 `bin/obj` 없음 → 산출물 git 추적 | 🔴 **부분 완료(핵심 누락).** → 본 문서 **P0** 로 재추적 |
+| WBS-10.8 데이터 수집 오케스트레이터 | **TODO** | 실제로는 `DataCollectionService.cs`(KIS 수집 오케스트레이션) 구현·커밋됨. 단 파일명/구조가 WBS 기재(`DataCollectionOrchestrator.cs`)와 불일치 | 🟡 **표기 미갱신.** → 본 문서 **A3** 로 정합화 |
+| WBS-10.3~10.5 도메인/공식/하네스 패리티 | 완료 | `DomainParityTests`, `FormulaEngineTests`, `HarnessInjector` 패리티 존재 확인 | ✅ 유효. 단 패리티 범위가 도메인 계산기에 한정 → 수집/정성매도/스냅샷은 미커버 (**A2** 확장) |
+| WBS-10.7 Application 서비스 | 부분 완료 | 4개 서비스 구현 확인 | ✅ 유효 |
+
+> **핵심 시사점:** 기존 WBS-10 은 "완료" 표기가 실제보다 앞서 있다. 특히 보안(10.9)과 파이프라인(10.6)은 표기와 달리 **실질 미완성**이므로, 후속 작업은 표기를 신뢰하지 말고 본 문서의 실측 기준을 따른다.
+
+---
+
+## 3. 로드맵 (마이그레이션 완성 우선)
+
+```
+[P0 선행 게이트] 보안·위생 차단  ──►  반드시 먼저
+        │
+        ▼
+[Track A] 마이그레이션 완성 (PRIMARY)        [Track B] 상용 안정화 (SECONDARY, 병행)
+  A1 PipelineOrchestrator 실구현               B1 구성/시크릿 체계화
+  A2 패리티 하네스 확장(수집·정성매도)          B2 기본 인증(단일 사용자)
+  A3 데이터 수집 파이프라인 E2E 정합화          B3 헬스체크·메트릭
+  A4 정성매도/스냅샷 어드민 포팅                B4 재시도(Polly)·스케줄러
+  A5 GAS 잔여 14개 공식 이관                    B5 배포(Docker/CI 게이트)
+  A6 SQLite→PostgreSQL 단일화 + Python 폐기     B6 통합/E2E 테스트·커버리지 게이트
+```
+
+### 마일스톤
+
+| 마일스톤 | 구성 | 완료 기준 |
+|---|---|---|
+| **M1 위생 확보** | P0 | git 에서 시크릿/산출물 제거, 시크릿 외부화·회전 |
+| **M2 패리티 기반** | A1·A2 | `.NET` 도메인이 Python 골든 벡터와 1:1 일치, 실 파이프라인 산출 |
+| **M3 수집 자립** | A3·A4·B4 | `.NET` 단독 KIS→스냅샷→정성매도 무인 실행 |
+| **M4 단일 권위 전환** | A5·A6 | Python 런타임 의존 제거, `.NET` canonical 승격 |
+| **M5 상용 운영** | B1~B6 | 단일 사용자 보호·관측·배포 체계 가동 |
+
+---
+
+## 4. WBS (작업 분해 구조)
+
+각 항목: **목표 / 완료 판정(Acceptance) / 주요 파일 / 검증 명령**.
+
+### P0 — 선행 보안·위생 게이트 (🔴 Critical, 최우선)
+
+#### WBS-P0.1 빌드 산출물 git 추적 제거
+- **목표:** `.gitignore` 에 .NET 표준 패턴(`bin/`, `obj/`, `publish-output/`, `*.user`) 추가, 추적 중 산출물 `git rm -r --cached` 처리.
+- **판정:** `git status` 에 `bin/obj` 변경 미표시.
+- **파일:** `.gitignore`.
+- **검증:** `git status --porcelain | grep -E 'bin/|obj/'` → 0건.
+
+#### WBS-P0.2 하드코딩 시크릿 제거·회전
+- **목표:** `Program.cs:19` 텔레그램 토큰·채팅ID, `Program.cs:34` DB 패스워드 폴백을 환경변수/`dotnet user-secrets`/`appsettings.Production.json`(비추적)로 이전. 노출 토큰·DB 비밀번호 **회전**.
+- **판정:** 소스 전역 시크릿 평문 0건, 구성 누락 시 앱 기동 거부(fail-fast).
+- **파일:** `Program.cs`, `appsettings*.json`, `Infrastructure/TelegramSink.cs`.
+- **검증:** `Select-String -Pattern '8734507814|C8RFlZ9f' src/dotnet -Recurse` → 0건.
+
+#### WBS-P0.3 git 이력 시크릿 정리 (선택)
+- **목표:** 노출 토큰 회전 완료 시 이력 재작성 생략 가능. 회전 불가 시 `git filter-repo` 로 이력 제거 검토.
+- **판정:** 회전 완료 또는 이력 정리 완료 중 택1 기록.
+
+> **주의:** WBS-10.9 가 `완료` 로 표기되어 있으나 위 P0.1·P0.2 는 미해결 상태다. 본 게이트 완료 전까지 후속 트랙 착수를 보류한다.
+
+### Track A — 마이그레이션 완성 (PRIMARY)
+
+#### WBS-A1 PipelineOrchestrator 실제 구현
+- **목표:** `Task.Delay` 시뮬레이션 제거. 7단계(수집→정규화→팩터→결정→리스크게이트→리포트→영속화)를 실제 서비스 호출로 연결.
+- **판정:** 입력 스냅샷에 대해 결정 패킷 산출, 각 단계 결과가 `engine_history` 에 기록.
+- **파일:** `QuantEngine.Application/Services/PipelineOrchestrator.cs`, 관련 `Services/*`.
+- **검증:** `dotnet test --filter Pipeline` → 실데이터 기반 산출물 `gate: PASS`.
+
+#### WBS-A2 패리티 하네스 확장 (수집·정성매도)
+- **목표:** 기존 도메인 계산기 패리티(10.3~10.5)를 **수집 정규화·정성매도·하네스 주입 전체**로 확장. `spec/13_formula_registry.yaml`(149 공식) 기준 골든 벡터를 Python 에서 추출해 `.NET` 결과와 비교.
+- **판정:** 핵심 공식 전부 Python 과 동일 출력(부동소수 허용오차 내), 패리티 리포트 JSON 생성.
+- **파일:** `QuantEngine.Core.Tests/ParityTests/`, `tests/golden/`.
+- **검증:** `dotnet test --filter Parity` → 전건 PASS.
+
+#### WBS-A3 데이터 수집 파이프라인 E2E 정합화
+- **목표:** `DataCollectionService.cs`(구현됨)를 기준으로 WBS 표기 정합화, `kis_data_collection_v1.py` 잔여 로직 완전 이관, KIS→PostgreSQL 스냅샷 E2E 검증. Naver/Yahoo 폴백 다중화 명문화.
+- **판정:** `.NET` 단독 실데이터 수집·저장 성공, 폴백 동작 확인.
+- **파일:** `Application/Services/DataCollectionService.cs`, `Infrastructure/External/*`.
+
+#### WBS-A4 정성매도·스냅샷 어드민 포팅
+- **목표:** `qualitative_sell_strategy_v1.py`, `snapshot_admin_*_v1.py` 를 `.NET` 서비스/엔드포인트로 이관.
+- **판정:** 정성매도 5팩터 confluence 결과 Python 일치, 스냅샷 승인 워크플로우가 Web UI 에서 동작.
+- **파일:** `QuantEngine.Core/Domain/`, `QuantEngine.Web/Endpoints/`, `Components/Pages/`.
+
+#### WBS-A5 GAS 잔여 14개 공식 이관
+- **목표:** `governance/gas_logic_migration_ledger_v1.yaml` 의 TODO 14건을 `.NET` 포팅 + parity.
+- **판정:** 원장 전 항목 `status: DONE`, parity 통과.
+- **파일:** `QuantEngine.Core/Domain/`, `governance/gas_logic_migration_ledger_v1.yaml`.
+
+#### WBS-A6 SQLite→PostgreSQL 단일화 및 Python 런타임 폐기
+- **목표:** canonical DB 를 PostgreSQL 로 일원화, `src/quant_engine/*.db` 의존 제거, Python 런타임 도구를 `.NET`/`Tools` 로 대체.
+- **판정:** 운영 경로 Python 호출 0건, 모든 데이터 PostgreSQL 단일 소스.
+- **파일:** `Infrastructure/Data/DbMigrator.cs`, `Makefile`, `tools/`.
+
+#### WBS-A7 UI 프레임워크 전환 — Fluent UI → MudBlazor + Interactive WebAssembly (2026-06-30 방침)
+- **배경:** UI 표준을 **MudBlazor** 컴포넌트 + **Interactive WebAssembly** 렌더 모드 + **API-First** 로 전환(방침 확정). 기존 Fluent UI v5 / InteractiveServer 는 폐기. 정책은 [CLAUDE.md](../CLAUDE.md) 및 [AGENTS.md](../AGENTS.md) §5b 에 반영 완료.
+- **목표:**
+  - csproj 패키지 교체: `Microsoft.FluentUI.AspNetCore.Components*` 제거 → `MudBlazor` 추가.
+  - 렌더 모드 전환: `Program.cs` 의 `AddInteractiveServerComponents`/`AddInteractiveServerRenderMode` → `AddInteractiveWebAssemblyComponents`/`AddInteractiveWebAssemblyRenderMode`, 클라이언트 프로젝트(`QuantEngine.Web.Client`) 분리.
+  - `App.razor`: Fluent CSS/JS·`FluentDesignSystemProvider` 제거 → MudBlazor `<MudThemeProvider>`/`<MudDialogProvider>`/`<MudSnackbarProvider>` + `MudBlazor.min.css/js` 삽입.
+  - 전체 `.razor` 컴포넌트의 `Fluent*` → `Mud*` 치환(매핑표는 [CLAUDE.md](../CLAUDE.md) Component Mapping 참조).
+  - API-First: UI 의 직접 DI 호출을 `IXxxBrowserClient`(HTTP) 경유로 전환, `TokenRefreshHandler` 패턴 적용.
+- **판정:** Fluent UI 패키지/참조 0건, `dotnet build` 오류 0, WASM 로드 후 `/quant/` 및 주요 페이지 정상 렌더, 비-API 라우트 동작 확인.
+- **주요 파일:** `QuantEngine.Web/QuantEngine.Web.csproj`, `Program.cs`, `Components/App.razor`, `Components/Layout/*.razor`, `Components/Pages/*.razor`, 신규 `QuantEngine.Web.Client/`.
+- **검증:** `Select-String -Pattern 'Fluent' src/dotnet/QuantEngine.Web -Recurse` → 0건; 브라우저에서 WASM 모드 동작 확인.
+
+### Track B — 상용 안정화 (SECONDARY, 단일 사용자)
+
+#### WBS-B1 구성·시크릿 체계화
+- **목표:** `appsettings.Production.json`(비추적), `IOptions<T>` + 시작 시 구성 검증(fail-fast), 연결 문자열/토큰 환경변수 표준화.
+- **판정:** 개발/운영 구성 분리, 필수 구성 누락 시 명확 오류로 기동 중단.
+
+#### WBS-B2 기본 인증 (단일 사용자 보호)
+- **목표:** 공개 서버 노출 방어용 최소 인증 — 리버스 프록시 Basic Auth 또는 API Key 미들웨어 1종(`/api/*`·UI 보호). 본격 Identity/JWT 는 범위 외.
+- **판정:** 비인증 요청 401, 인증 요청만 수집/조회 가능.
+- **파일:** `Program.cs`, `Endpoints/CollectionEndpoints.cs`, Nginx 구성.
+
+#### WBS-B3 헬스체크·메트릭
+- **목표:** `MapHealthChecks("/health")`(liveness) + `/health/ready`(PostgreSQL/KIS 토큰 점검), `prometheus-net` 기반 기본 메트릭.
+- **판정:** 배포 스크립트 헬스체크가 `/health/ready` 사용, 메트릭 엔드포인트 응답.
+- **파일:** `Program.cs`, `.gitea/workflows/deploy-prod.yml`.
+
+#### WBS-B4 재시도(Polly)·백그라운드 스케줄러
+- **목표:** KIS/Naver/Yahoo HTTP 호출에 Polly 재시도·서킷브레이커, 주기적 수집을 `BackgroundService`(또는 systemd timer 연계)로 자동화.
+- **판정:** 일시적 5xx/네트워크 오류 자동 복구, 정해진 스케줄 무인 수집.
+- **파일:** `Program.cs`(HttpClient+Polly), 신규 `Application/Services/*BackgroundService.cs`.
+
+#### WBS-B5 배포 (Docker/CI 게이트)
+- **목표:** 멀티스테이지 `Dockerfile` + `docker-compose.yml`(app+PostgreSQL), `.gitea` CI 에 `dotnet build`+`dotnet test` 게이트 추가.
+- **판정:** 컨테이너 로컬 기동 성공, CI 에서 테스트 실패 시 배포 차단.
+- **파일:** 신규 `Dockerfile`, `docker-compose.yml`, `.gitea/workflows/ci.yml`.
+
+#### WBS-B6 통합·E2E 테스트 및 커버리지 게이트
+- **목표:** Testcontainers(PostgreSQL) 통합테스트, KIS→스냅샷→정성매도 E2E, coverlet 커버리지 임계값을 CI 게이트로 연결.
+- **판정:** E2E 1건 이상 그린, 커버리지 임계 미달 시 CI 실패.
+- **파일:** `QuantEngine.Core.Tests/`(통합/E2E), `.gitea/workflows/ci.yml`.
+
+---
+
+## 5. 개선·보완·고도화 제안 (Track A/B 외 권고)
+
+- **결정 재현성 감사:** 동일 입력 → 동일 출력 결정론 검증을 CI 상시 게이트로 편입 ([governance/adr/0003-no-llm-numeric-generation.md](../governance/adr/0003-no-llm-numeric-generation.md) 정신 계승).
+- **캘리브레이션 실증 연계:** [spec/27_bch_calibration_runbook.yaml](../spec/27_bch_calibration_runbook.yaml) 의 `0/190 CALIBRATED` 문제를 마이그레이션과 분리된 데이터 트랙으로 별도 추적(본 WBS 범위 밖, 링크 유지).
+- **장애 단일점 보강:** Naver Cloudflare 403 폴백 경로를 Yahoo/KIS 다중화로 명문화(WBS-A3 연동).
+- **운영 가시성:** 구조화 로깅에 상관관계 ID(correlation id) 추가, 수집 실행별 추적 가능화.
+- **비밀 회전 정책:** KIS appkey/secret, 텔레그램 토큰, DB 비밀번호의 주기적 회전 절차를 [docs/runbook.md](./runbook.md) 에 문서화.
+- **WBS 표기 정합성 거버넌스:** 본 문서에서 드러난 "완료 표기 vs 실측" 괴리 재발 방지를 위해, 각 WBS 완료 시 **검증 명령 출력 캡처를 증빙으로 첨부**하는 규칙을 강화([AGENTS.md](../AGENTS.md) 의 검증·증빙 강제 원칙 적용).
+
+---
+
+## 6. 검증 방법 (각 단계 실행 시)
+
+- **P0:** `git status` 산출물 미추적 확인, 시크릿 평문 grep 0건, 회전된 자격증명으로 정상 기동.
+- **Track A:** `cd src/dotnet && dotnet test` 로 패리티/단위/E2E 그린. 패리티 리포트 JSON 을 Python 출력과 diff. 운영 경로 Python 호출 0건.
+- **Track B:** `curl /health/ready` 200, 비인증 요청 401, `docker compose up` 기동, CI 테스트/커버리지 게이트 동작. Polly 재시도는 장애 주입 테스트로 검증.
+
+---
+
+## 7. 실행 순서 요약
+
+1. **P0 선행 게이트** (WBS-P0.1~P0.3) — 보안·위생 차단. **(기존 10.9 完了 표기 무시, 실측 기준 처리)**
+2. **Track A** (A1→A2→A3→A4→A5→A6) — 마이그레이션 완성(우선).
+3. **Track B** (B1~B6) — 단일 사용자 상용 안정화(A 와 병행, B1·B3 조기 착수 권장).
@@ -1,63 +0,0 @@
-using System.Security.Claims;
-using Microsoft.AspNetCore.Components.Authorization;
-using QuantEngine.Web.Client.Services;
-
-namespace QuantEngine.Web.Client.Infrastructure
-{
-    public class CustomAuthenticationStateProvider : AuthenticationStateProvider
-    {
-        private readonly LocalStorageService _localStorage;
-        private readonly ClaimsPrincipal _anonymous = new ClaimsPrincipal(new ClaimsIdentity());
-        private const string StorageKey = "quant_admin_session";
-
-        public CustomAuthenticationStateProvider(LocalStorageService localStorage)
-        {
-            _localStorage = localStorage;
-        }
-
-        public override async Task<AuthenticationState> GetAuthenticationStateAsync()
-        {
-            try
-            {
-                var username = await _localStorage.GetAsync<string>(StorageKey);
-                if (!string.IsNullOrEmpty(username))
-                {
-                    var identity = new ClaimsIdentity(new[]
-                    {
-                        new Claim(ClaimTypes.Name, username),
-                        new Claim(ClaimTypes.Role, "Admin")
-                    }, "QuantAdminAuth");
-
-                    var user = new ClaimsPrincipal(identity);
-                    return new AuthenticationState(user);
-                }
-            }
-            catch
-            {
-                // Return anonymous if localStorage isn't ready
-            }
-
-            return new AuthenticationState(_anonymous);
-        }
-
-        public async Task MarkUserAsAuthenticatedAsync(string username)
-        {
-            await _localStorage.SetAsync(StorageKey, username);
-
-            var identity = new ClaimsIdentity(new[]
-            {
-                new Claim(ClaimTypes.Name, username),
-                new Claim(ClaimTypes.Role, "Admin")
-            }, "QuantAdminAuth");
-
-            var user = new ClaimsPrincipal(identity);
-            NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(user)));
-        }
-
-        public async Task MarkUserAsLoggedOutAsync()
-        {
-            await _localStorage.DeleteAsync(StorageKey);
-            NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(_anonymous)));
-        }
-    }
-}
@@ -1,6 +1,5 @@
@page "/collection"
-@attribute [Authorize]
-@using QuantEngine.Web.Client.Services
+@using QuantEngine.Web.Services
@inject ApiClient ApiClient
@inject ILogger<Collection> Logger

@@ -1,308 +0,0 @@
-@page "/login"
-@attribute [AllowAnonymous]
-@inject AuthenticationStateProvider AuthStateProvider
-@inject NavigationManager NavigationManager
-@inject HttpClient Http
-
-<PageTitle>로그인 - QuantEngine</PageTitle>
-
-<div class="auth-container">
-    <div class="auth-card">
-        <div class="brand-section">
-            <img src="images/quant_engine_logo.jpg" alt="QuantEngine Logo" class="brand-logo" />
-            <h1 class="brand-title">QuantEngine</h1>
-            <p class="brand-subtitle">은퇴자산포트폴리오 투자 관리 시스템</p>
-        </div>
-
-        <form @onsubmit="HandleLoginAsync" class="auth-form">
-            <div class="form-group">
-                <label for="username">관리자 아이디</label>
-                <input type="text" id="username" class="form-control" @bind="Username" placeholder="아이디를 입력하세요" autocomplete="username" />
-            </div>
-
-            <div class="form-group">
-                <label for="password">비밀번호</label>
-                <input type="password" id="password" class="form-control" @bind="Password" placeholder="비밀번호를 입력하세요" autocomplete="current-password" />
-            </div>
-
-            @if (!string.IsNullOrEmpty(ErrorMessage))
-            {
-                <div class="error-message">
-                    <svg class="error-icon" fill="none" viewBox="0 0 24 24" stroke="currentColor">
-                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
-                    </svg>
-                    <span>@ErrorMessage</span>
-                </div>
-            }
-
-            <button type="submit" class="btn-submit" disabled="@IsSubmitting">
-                @if (IsSubmitting)
-                {
-                    <span class="spinner"></span>
-                    <span>인증 중...</span>
-                }
-                else
-                {
-                    <span>로그인</span>
-                }
-            </button>
-        </form>
-    </div>
-</div>
-
-<style>
-    .auth-container {
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        min-height: 100vh;
-        width: 100vw;
-        background: linear-gradient(135deg, #090a15 0%, #12142d 100%);
-        font-family: 'Roboto', 'Inter', sans-serif;
-        color: #ffffff;
-        position: fixed;
-        top: 0;
-        left: 0;
-        z-index: 9999;
-        overflow: hidden;
-    }
-
-    /* Ambient background glow */
-    .auth-container::before {
-        content: "";
-        position: absolute;
-        width: 600px;
-        height: 600px;
-        background: radial-gradient(circle, rgba(0, 242, 254, 0.08) 0%, rgba(79, 172, 254, 0) 70%);
-        top: -10%;
-        left: -10%;
-        pointer-events: none;
-    }
-
-    .auth-container::after {
-        content: "";
-        position: absolute;
-        width: 600px;
-        height: 600px;
-        background: radial-gradient(circle, rgba(79, 172, 254, 0.08) 0%, rgba(0, 242, 254, 0) 70%);
-        bottom: -10%;
-        right: -10%;
-        pointer-events: none;
-    }
-
-    .auth-card {
-        background: rgba(255, 255, 255, 0.02);
-        backdrop-filter: blur(25px);
-        -webkit-backdrop-filter: blur(25px);
-        border: 1px solid rgba(255, 255, 255, 0.06);
-        border-radius: 20px;
-        padding: 48px;
-        width: 440px;
-        box-shadow: 0 20px 50px rgba(0, 0, 0, 0.4);
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-        z-index: 10;
-        animation: fadeIn 0.8s cubic-bezier(0.16, 1, 0.3, 1);
-    }
-
-    .brand-section {
-        text-align: center;
-        margin-bottom: 36px;
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-    }
-
-    .brand-logo {
-        width: 80px;
-        height: 80px;
-        border-radius: 50%;
-        object-fit: cover;
-        border: 2px solid rgba(0, 242, 254, 0.3);
-        box-shadow: 0 0 20px rgba(0, 242, 254, 0.15);
-        margin-bottom: 16px;
-        transition: transform 0.3s ease;
-    }
-
-    .brand-logo:hover {
-        transform: rotate(5deg) scale(1.05);
-    }
-
-    .brand-title {
-        font-size: 26px;
-        font-weight: 700;
-        margin: 0;
-        background: linear-gradient(90deg, #00f2fe 0%, #4facfe 100%);
-        -webkit-background-clip: text;
-        -webkit-text-fill-color: transparent;
-        letter-spacing: 0.5px;
-    }
-
-    .brand-subtitle {
-        font-size: 13px;
-        color: rgba(255, 255, 255, 0.5);
-        margin: 6px 0 0 0;
-        font-weight: 300;
-    }
-
-    .auth-form {
-        width: 100%;
-        display: flex;
-        flex-direction: column;
-        gap: 20px;
-    }
-
-    .form-group {
-        display: flex;
-        flex-direction: column;
-        gap: 8px;
-    }
-
-    .form-group label {
-        font-size: 13px;
-        font-weight: 500;
-        color: rgba(255, 255, 255, 0.8);
-        padding-left: 2px;
-    }
-
-    .form-control {
-        background: rgba(255, 255, 255, 0.04);
-        border: 1px solid rgba(255, 255, 255, 0.1);
-        border-radius: 10px;
-        padding: 14px 16px;
-        color: #ffffff;
-        font-size: 14px;
-        transition: all 0.3s ease;
-        outline: none;
-    }
-
-    .form-control:focus {
-        border-color: rgba(0, 242, 254, 0.6);
-        background: rgba(255, 255, 255, 0.08);
-        box-shadow: 0 0 12px rgba(0, 242, 254, 0.15);
-    }
-
-    .form-control::placeholder {
-        color: rgba(255, 255, 255, 0.25);
-    }
-
-    .error-message {
-        display: flex;
-        align-items: center;
-        gap: 10px;
-        background: rgba(239, 68, 68, 0.08);
-        border: 1px solid rgba(239, 68, 68, 0.2);
-        border-radius: 10px;
-        padding: 12px 16px;
-        color: #f87171;
-        font-size: 13px;
-    }
-
-    .error-icon {
-        width: 18px;
-        height: 18px;
-        flex-shrink: 0;
-    }
-
-    .btn-submit {
-        background: linear-gradient(90deg, #00f2fe 0%, #4facfe 100%);
-        border: none;
-        border-radius: 10px;
-        padding: 14px;
-        color: #0b0c15;
-        font-size: 15px;
-        font-weight: 700;
-        cursor: pointer;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        gap: 10px;
-        transition: all 0.3s ease;
-        box-shadow: 0 4px 15px rgba(0, 242, 254, 0.2);
-    }
-
-    .btn-submit:hover:not(:disabled) {
-        transform: translateY(-2px);
-        box-shadow: 0 6px 20px rgba(0, 242, 254, 0.35);
-    }
-
-    .btn-submit:active:not(:disabled) {
-        transform: translateY(0);
-    }
-
-    .btn-submit:disabled {
-        opacity: 0.6;
-        cursor: not-allowed;
-        box-shadow: none;
-    }
-
-    .spinner {
-        width: 16px;
-        height: 16px;
-        border: 2px solid rgba(11, 12, 21, 0.25);
-        border-top-color: #0b0c15;
-        border-radius: 50%;
-        animation: spin 0.8s linear infinite;
-    }
-
-    @@keyframes spin {
-        to { transform: rotate(360deg); }
-    }
-
-    @@keyframes fadeIn {
-        from {
-            opacity: 0;
-            transform: translateY(20px);
-        }
-        to {
-            opacity: 1;
-            transform: translateY(0);
-        }
-    }
-</style>
-
-@code {
-    private string Username { get; set; } = string.Empty;
-    private string Password { get; set; } = string.Empty;
-    private string ErrorMessage { get; set; } = string.Empty;
-    private bool IsSubmitting { get; set; } = false;
-
-    private async Task HandleLoginAsync()
-    {
-        ErrorMessage = string.Empty;
-        if (string.IsNullOrWhiteSpace(Username) || string.IsNullOrWhiteSpace(Password))
-        {
-            ErrorMessage = "아이디와 비밀번호를 모두 입력해 주세요.";
-            return;
-        }
-
-        IsSubmitting = true;
-
-        try
-        {
-            var response = await Http.PostAsJsonAsync("api/auth/login", new { Username, Password });
-
-            if (response.IsSuccessStatusCode)
-            {
-                var customProvider = (CustomAuthenticationStateProvider)AuthStateProvider;
-                await customProvider.MarkUserAsAuthenticatedAsync(Username);
-                
-                // Redirect back to home dashboard
-                NavigationManager.NavigateTo("");
-            }
-            else
-            {
-                ErrorMessage = "아이디 또는 비밀번호가 올바르지 않습니다.";
-            }
-        }
-        catch (Exception ex)
-        {
-            ErrorMessage = $"로그인 중 오류가 발생했습니다: {ex.Message}";
-        }
-        finally
-        {
-            IsSubmitting = false;
-        }
-    }
-}
@@ -1,23 +0,0 @@
-using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
-using Microsoft.FluentUI.AspNetCore.Components;
-using Microsoft.AspNetCore.Components.Authorization;
-using QuantEngine.Web.Client.Services;
-using QuantEngine.Web.Client.Infrastructure;
-
-var builder = WebAssemblyHostBuilder.CreateDefault(args);
-
-// Register Fluent UI
-builder.Services.AddFluentUIComponents();
-
-// Register LocalStorage for cross-platform session persistence
-builder.Services.AddScoped<LocalStorageService>();
-
-// Authentication setup in WebAssembly client
-builder.Services.AddAuthorizationCore();
-builder.Services.AddCascadingAuthenticationState();
-builder.Services.AddScoped<AuthenticationStateProvider, CustomAuthenticationStateProvider>();
-
-// HttpClient register (API-First standard)
-builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) });
-
-await builder.Build().RunAsync();
@@ -1,23 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
-
-  <PropertyGroup>
-    <TargetFramework>net10.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <NoDefaultLaunchSettingsFile>true</NoDefaultLaunchSettingsFile>
-    <StaticWebAssetProjectMode>Default</StaticWebAssetProjectMode>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <ProjectReference Include="..\..\QuantEngine.Core\QuantEngine.Core.csproj" />
-    <ProjectReference Include="..\..\QuantEngine.Application\QuantEngine.Application.csproj" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="10.0.0-preview.2.25120.18" />
-    <PackageReference Include="Microsoft.AspNetCore.Components.Authorization" Version="10.0.0-preview.2.25120.18" />
-    <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components" Version="5.0.0-rc.4-26177.1" />
-    <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components.Icons" Version="5.0.0-rc.4-26177.1" />
-  </ItemGroup>
-
-</Project>
@@ -1,8 +0,0 @@
-@inject NavigationManager NavigationManager
-
-@code {
-    protected override void OnInitialized()
-    {
-        NavigationManager.NavigateTo("login");
-    }
-}
@@ -1,43 +0,0 @@
-using Microsoft.JSInterop;
-using System.Text.Json;
-
-namespace QuantEngine.Web.Client.Services
-{
-    public class LocalStorageService
-    {
-        private readonly IJSRuntime _js;
-
-        public LocalStorageService(IJSRuntime js)
-        {
-            _js = js;
-        }
-
-        public async Task SetAsync<T>(string key, T value)
-        {
-            var json = JsonSerializer.Serialize(value);
-            await _js.InvokeVoidAsync("localStorage.setItem", key, json);
-        }
-
-        public async Task<T?> GetAsync<T>(string key)
-        {
-            try
-            {
-                var json = await _js.InvokeAsync<string?>("localStorage.getItem", key);
-                if (string.IsNullOrEmpty(json))
-                {
-                    return default;
-                }
-                return JsonSerializer.Deserialize<T>(json);
-            }
-            catch
-            {
-                return default;
-            }
-        }
-
-        public async Task DeleteAsync(string key)
-        {
-            await _js.InvokeVoidAsync("localStorage.removeItem", key);
-        }
-    }
-}
@@ -8,10 +8,7 @@
@using Microsoft.JSInterop
@using Microsoft.FluentUI.AspNetCore.Components
@using Microsoft.FluentUI.AspNetCore.Components.Icons
-@using QuantEngine.Web.Client
-@using QuantEngine.Web.Client.Pages
-@using QuantEngine.Web.Client.Layout
-@using QuantEngine.Web.Client.Infrastructure
-@using QuantEngine.Web.Client.Services
-@using Microsoft.AspNetCore.Components.Authorization
-@using Microsoft.AspNetCore.Authorization
+@using QuantEngine.Web
+@using QuantEngine.Web.Components
+@using QuantEngine.Web.Components.Layout
+@using QuantEngine.Web.Services
@@ -13,12 +13,12 @@
    <link rel="stylesheet" href="@Assets["QuantEngine.Web.styles.css"]" />
    <ImportMap />
    <link rel="icon" type="image/png" href="favicon.png" />
-    <HeadOutlet @rendermode="InteractiveWebAssembly" />
+    <HeadOutlet />
 </head>

 <body>
    <FluentDesignSystemProvider>
-        <Routes @rendermode="InteractiveWebAssembly" />
+        <Routes />
        <ReconnectModal />
    </FluentDesignSystemProvider>

@@ -1,10 +1,8 @@
@inherits LayoutComponentBase
-@inject HttpClient Http
-@inject AuthenticationStateProvider AuthStateProvider
-@inject NavigationManager NavigationManager
-@using System.Net.Http.Json
+@inject Microsoft.AspNetCore.Hosting.IWebHostEnvironment WebHostEnvironment
+@using System.IO
+@using System.Text.Json
@using Microsoft.FluentUI.AspNetCore.Components
-@using QuantEngine.Web.Client.Infrastructure

 <FluentStack Orientation="Orientation.Vertical" Class="h-100 w-100">
    <!-- Header -->
@@ -17,16 +15,6 @@
                ☰
            </FluentButton>
            <h1 style="margin: 0; font-size: 20px; font-weight: 600;">QuantEngine v@appVersion</h1>
-            <AuthorizeView>
-                <Authorized>
-                    <div style="margin-left: auto; display: flex; align-items: center; gap: 12px;">
-                        <span style="font-size: 13px; color: var(--neutral-foreground-hint);">관리자 (@context.User.Identity?.Name)</span>
-                        <FluentButton OnClick="HandleLogoutAsync" Style="color: #ff5252; background: transparent; border: 1px solid rgba(255, 82, 82, 0.2); cursor: pointer; padding: 4px 12px; border-radius: 4px;">
-                            로그아웃
-                        </FluentButton>
-                    </div>
-                </Authorized>
-            </AuthorizeView>
        </FluentStack>
    </FluentHeader>

@@ -76,15 +64,25 @@
    private string appVersion = "Local Debug";
    private string buildTime = "N/A";

-    protected override async Task OnInitializedAsync()
+    protected override void OnInitialized()
    {
        try
        {
-            var versionInfo = await Http.GetFromJsonAsync<VersionInfo>("version.json");
-            if (versionInfo != null)
+            var versionFilePath = Path.Combine(WebHostEnvironment.WebRootPath, "version.json");
+            if (File.Exists(versionFilePath))
            {
-                appVersion = versionInfo.Version ?? "Local Debug";
-                buildTime = versionInfo.Built ?? "N/A";
+                var jsonContent = File.ReadAllText(versionFilePath);
+                using var doc = System.Text.Json.JsonDocument.Parse(jsonContent);
+                var root = doc.RootElement;
+
+                if (root.TryGetProperty("version", out var versionProp))
+                {
+                    appVersion = versionProp.GetString() ?? "Local Debug";
+                }
+                if (root.TryGetProperty("built", out var builtProp))
+                {
+                    buildTime = builtProp.GetString() ?? "N/A";
+                }
            }
        }
        catch
@@ -92,18 +90,5 @@
            // Fail-safe default fallback values
        }
    }
-
-    private async Task HandleLogoutAsync()
-    {
-        var customProvider = (CustomAuthenticationStateProvider)AuthStateProvider;
-        await customProvider.MarkUserAsLoggedOutAsync();
-        NavigationManager.NavigateTo("login");
-    }
-
-    private class VersionInfo
-    {
-        public string? Version { get; set; }
-        public string? Built { get; set; }
-    }
 }

@@ -1,7 +1,6 @@
@page "/"
-@attribute [Authorize]
@using QuantEngine.Core.Infrastructure
-@inject HttpClient Http
+@inject IWebHostEnvironment Environment

 <PageTitle>Quant Engine - Dashboard</PageTitle>

@@ -97,26 +96,15 @@
    private string RawFeedLabel = "DISCONNECTED";
    private string ReportPath = "n/a";

-    protected override async Task OnInitializedAsync()
+    protected override void OnInitialized()
    {
-        try
-        {
-            var report = await Http.GetFromJsonAsync<OperationalReportData>("api/operational-report");
-            if (report != null)
-            {
-                Sections.Clear();
-                Sections.AddRange(report.Sections);
-                SectionCountLabel = report.SectionCount.ToString();
-                GeneratedAtLabel = report.GeneratedAt;
-                SourceLabel = report.SourceJson;
-                ReportStateLabel = Sections.Count > 0 ? "READY" : "DATA_MISSING";
-                ReportChipLabel = Sections.Count > 0 ? "READY" : "DATA_MISSING";
-            }
-        }
-        catch
-        {
-            ReportStateLabel = "DATA_MISSING";
-            ReportChipLabel = "DATA_MISSING";
-        }
+        ReportPath = Path.GetFullPath(Path.Combine(Environment.ContentRootPath, "..", "..", "..", "Temp", "operational_report.json"));
+        var report = OperationalReportLoader.Load(ReportPath);
+        Sections.AddRange(report.Sections);
+        SectionCountLabel = report.SectionCount.ToString();
+        GeneratedAtLabel = report.GeneratedAt;
+        SourceLabel = report.SourceJson;
+        ReportStateLabel = Sections.Count > 0 ? "READY" : "DATA_MISSING";
+        ReportChipLabel = Sections.Count > 0 ? "READY" : "DATA_MISSING";
    }
 }
@@ -1,7 +1,6 @@
@page "/operations"
-@attribute [Authorize]
@using QuantEngine.Core.Infrastructure
-@inject HttpClient Http
+@inject IWebHostEnvironment Environment

 <PageTitle>Quant Engine - Operations</PageTitle>

@@ -98,29 +97,19 @@

    protected override async Task OnInitializedAsync()
    {
-        try
-        {
-            var report = await Http.GetFromJsonAsync<OperationalReportData>("api/operational-report");
-            if (report != null)
-            {
-                SchemaVersion = report.SchemaVersion;
-                SourceJson = report.SourceJson;
-                GeneratedAt = report.GeneratedAt;
-                
-                Sections.Clear();
-                Sections.AddRange(report.Sections);
+        ReportPath = Path.GetFullPath(Path.Combine(Environment.ContentRootPath, "..", "..", "..", "Temp", "operational_report.json"));

-                HighlightSections.Clear();
-                HighlightSections.AddRange(Sections.Take(4));
+        var report = OperationalReportLoader.Load(ReportPath);
+        SchemaVersion = report.SchemaVersion;
+        SourceJson = report.SourceJson;
+        GeneratedAt = report.GeneratedAt;
+        Sections.AddRange(report.Sections);

-                SectionCountLabel = report.SectionCount.ToString();
-                RenderedSectionCountLabel = Sections.Count.ToString();
-                HealthLabel = Sections.Count > 0 ? "PASS" : "DATA_MISSING";
-            }
-        }
-        catch
-        {
-            HealthLabel = "DATA_MISSING";
-        }
+        HighlightSections.Clear();
+        HighlightSections.AddRange(Sections.Take(4));
+
+        SectionCountLabel = report.SectionCount.ToString();
+        RenderedSectionCountLabel = Sections.Count.ToString();
+        HealthLabel = Sections.Count > 0 ? "PASS" : "DATA_MISSING";
    }
 }
@@ -1,16 +1,6 @@
-@using QuantEngine.Web.Client
-@using QuantEngine.Web.Client.Pages
-@using QuantEngine.Web.Client.Layout
-
-<CascadingAuthenticationState>
-    <Router AppAssembly="typeof(Dashboard).Assembly" NotFoundPage="typeof(NotFound)">
-        <Found Context="routeData">
-            <AuthorizeRouteView RouteData="routeData" DefaultLayout="typeof(MainLayout)">
-                <NotAuthorized>
-                    <RedirectToLogin />
-                </NotAuthorized>
-            </AuthorizeRouteView>
-            <FocusOnNavigate RouteData="routeData" Selector="h1" />
-        </Found>
-    </Router>
-</CascadingAuthenticationState>
+<Router AppAssembly="typeof(Program).Assembly" NotFoundPage="typeof(Pages.NotFound)">
+    <Found Context="routeData">
+        <RouteView RouteData="routeData" DefaultLayout="typeof(Layout.MainLayout)" />
+        <FocusOnNavigate RouteData="routeData" Selector="h1" />
+    </Found>
+</Router>
@@ -1,4 +1,4 @@
-@using System.Net.Http
+@using System.Net.Http
@using System.Net.Http.Json
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@@ -11,6 +11,3 @@
@using QuantEngine.Web
@using QuantEngine.Web.Components
@using QuantEngine.Web.Components.Layout
-@using Microsoft.AspNetCore.Components.Authorization
-@using Microsoft.AspNetCore.Authorization
-@using QuantEngine.Web.Infrastructure
@@ -118,7 +118,7 @@ public static class CollectionEndpoints
            var runId = Guid.NewGuid().ToString("N");
            var now = DateTime.UtcNow.ToString("o");

-            var body = await request.ReadFromJsonAsync<CollectionRunRequest>();
+            var body = await request.ReadAsAsync<CollectionRunRequest>();
            var account = body?.Account ?? "real";
            var tickers = body?.Tickers ?? new List<string> { "005930", "000660" };

@@ -1,7 +1,6 @@
 using QuantEngine.Web.Components;
+using QuantEngine.Web.Services;
 using QuantEngine.Infrastructure.Data;
-using Microsoft.AspNetCore.Components.Authorization;
-using QuantEngine.Web.Infrastructure;
 using QuantEngine.Infrastructure.Repositories;
 using QuantEngine.Infrastructure.Services;
 using QuantEngine.Core.Interfaces;
@@ -10,8 +9,7 @@ using System.Text.Json;
 using static QuantEngine.Application.Services.DataCollectionService;
 using Microsoft.FluentUI.AspNetCore.Components;
 using Serilog;
-using QuantEngine.Web.Client.Infrastructure;
-using QuantEngine.Web.Client.Services;
+using QuantEngine.Web.Infrastructure;
 using QuantEngine.Web.Endpoints;

 // Serilog Configuration with Telegram Sink
@@ -26,13 +24,7 @@ builder.Host.UseSerilog();

 // Add services to the container.
 builder.Services.AddRazorComponents()
-    .AddInteractiveWebAssemblyComponents();
-
-// Authentication and Custom State Provider (Shared client components)
-builder.Services.AddCascadingAuthenticationState();
-builder.Services.AddScoped<LocalStorageService>();
-builder.Services.AddScoped<AuthenticationStateProvider, CustomAuthenticationStateProvider>();
-builder.Services.AddAuthorizationCore();
+    .AddInteractiveServerComponents();

 // Fluent UI Services
 builder.Services.AddFluentUIComponents();
@@ -102,32 +94,6 @@ app.MapStaticAssets();
 // Collection API Endpoints (must be before MapRazorComponents)
 app.MapCollectionEndpoints();

-// Login API (API-First for Blazor WASM client authentication)
-app.MapPost("/api/auth/login", (LoginRequest request, IConfiguration config) =>
-{
-    var expectedUser = config["AdminSettings:Username"] ?? "admin";
-    var expectedPass = config["AdminSettings:Password"] ?? "quant123!";
-    
-    if (request.Username == expectedUser && request.Password == expectedPass)
-    {
-        return Results.Ok(new { success = true, username = request.Username });
-    }
-    return Results.Json(new { success = false, error = "invalid_credentials" }, statusCode: 401);
-});
-
-// Operational Report serving API (WASM safe file loading substitute)
-app.MapGet("/api/operational-report", async (IWebHostEnvironment env) =>
-{
-    var path = Path.GetFullPath(Path.Combine(env.ContentRootPath, "..", "..", "..", "Temp", "operational_report.json"));
-    if (!File.Exists(path))
-    {
-        return Results.NotFound(new { gate = "FAIL", error = "operational_report_missing" });
-    }
-    var json = await File.ReadAllTextAsync(path);
-    using var doc = JsonDocument.Parse(json);
-    return Results.Ok(doc.RootElement);
-});
-
 app.MapGet("/api/history/{domain}", async (string domain, int? limit, IPostgresqlHistorySnapshotReader reader) =>
 {
    var rows = await reader.ReadAsync(domain, limit ?? 500);
@@ -172,14 +138,7 @@ app.MapPost("/api/history/{domain}", async (string domain, JsonElement payload,
 });

 app.MapRazorComponents<App>()
-    .AddInteractiveWebAssemblyRenderMode()
-    .AddAdditionalAssemblies(typeof(QuantEngine.Web.Client._Imports).Assembly);
+    .AddInteractiveServerRenderMode();

 app.Run();

-public class LoginRequest
-{
-    public string Username { get; set; } = "";
-    public string Password { get; set; } = "";
-}
-
@@ -4,22 +4,12 @@
    <ProjectReference Include="..\QuantEngine.Infrastructure\QuantEngine.Infrastructure.csproj" />
    <ProjectReference Include="..\QuantEngine.Application\QuantEngine.Application.csproj" />
    <ProjectReference Include="..\QuantEngine.Core\QuantEngine.Core.csproj" />
-    <ProjectReference Include="Client\QuantEngine.Web.Client.csproj" />
  </ItemGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components" Version="5.0.0-rc.4-26177.1" />
    <PackageReference Include="Microsoft.FluentUI.AspNetCore.Components.Icons" Version="5.0.0-rc.4-26177.1" />
    <PackageReference Include="Serilog.AspNetCore" Version="10.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.Server" Version="10.0.0-preview.2.25120.18" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <!-- Exclude client project files from server build to avoid duplicate compilations -->
-    <Compile Remove="Client\**" />
-    <Content Remove="Client\**" />
-    <EmbeddedResource Remove="Client\**" />
-    <None Remove="Client\**" />
  </ItemGroup>

  <PropertyGroup>
@@ -2,16 +2,19 @@ using System.Net.Http.Json;
 using System.Text.Json.Serialization;
 using QuantEngine.Core.Interfaces;

-namespace QuantEngine.Web.Client.Services;
+namespace QuantEngine.Web.Services;

 public class ApiClient
 {
    private readonly HttpClient _http;
    private readonly ILogger<ApiClient> _logger;
+    private string BaseUrl { get; set; }
+
    public ApiClient(HttpClient http, ILogger<ApiClient> logger)
    {
        _http = http;
        _logger = logger;
+        BaseUrl = "http://localhost:5001"; // Default for Blazor Server
    }

    // Collection API Methods
@@ -20,7 +23,7 @@ public class ApiClient
    {
        try
        {
-            return await _http.GetFromJsonAsync<CollectionDashboardStateDto>("api/collection/state");
+            return await _http.GetFromJsonAsync<CollectionDashboardStateDto>($"{BaseUrl}/api/collection/state");
        }
        catch (Exception ex)
        {
@@ -33,7 +36,7 @@ public class ApiClient
    {
        try
        {
-            return await _http.GetFromJsonAsync<CollectionRunsResponse>($"api/collection/runs?limit={limit}");
+            return await _http.GetFromJsonAsync<CollectionRunsResponse>($"{BaseUrl}/api/collection/runs?limit={limit}");
        }
        catch (Exception ex)
        {
@@ -46,7 +49,7 @@ public class ApiClient
    {
        try
        {
-            return await _http.GetFromJsonAsync<CollectionRunSnapshotsResponse>($"api/collection/runs/{runId}/snapshots");
+            return await _http.GetFromJsonAsync<CollectionRunSnapshotsResponse>($"{BaseUrl}/api/collection/runs/{runId}/snapshots");
        }
        catch (Exception ex)
        {
@@ -59,7 +62,7 @@ public class ApiClient
    {
        try
        {
-            return await _http.GetFromJsonAsync<CollectionRunErrorsResponse>($"api/collection/runs/{runId}/errors?limit={limit}");
+            return await _http.GetFromJsonAsync<CollectionRunErrorsResponse>($"{BaseUrl}/api/collection/runs/{runId}/errors?limit={limit}");
        }
        catch (Exception ex)
        {
@@ -72,7 +75,7 @@ public class ApiClient
    {
        try
        {
-            var response = await _http.PostAsJsonAsync("api/collection/run", new { });
+            var response = await _http.PostAsJsonAsync($"{BaseUrl}/api/collection/run", new { });
            if (response.IsSuccessStatusCode)
            {
                return await response.Content.ReadFromJsonAsync<CollectionRunStartResponse>();
@@ -8,9 +8,5 @@
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "DefaultConnection": "Host=127.0.0.1;Database=giteadb;Username=gitea;Password=;Search Path=quantengine;"
-  },
-  "AdminSettings": {
-    "Username": "admin",
-    "Password": "quant123!"
  }
 }
@@ -1,4 +1,4 @@
-
+
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.0.31903.59
@@ -15,9 +15,6 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "QuantEngine.Core.Tests", "Q
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "QuantEngine.Tools", "QuantEngine.Tools\QuantEngine.Tools.csproj", "{E2B1A0A1-7B13-4A4D-9B31-9C7F4F27A6A1}"
 EndProject
-
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "QuantEngine.Web.Client", "QuantEngine.Web\Client\QuantEngine.Web.Client.csproj", "{C5F2F3BD-1258-40FC-803A-EE7EEC928107}"
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -100,21 +97,8 @@ Global
 		{E2B1A0A1-7B13-4A4D-9B31-9C7F4F27A6A1}.Release|x64.Build.0 = Release|Any CPU
 		{E2B1A0A1-7B13-4A4D-9B31-9C7F4F27A6A1}.Release|x86.ActiveCfg = Release|Any CPU
 		{E2B1A0A1-7B13-4A4D-9B31-9C7F4F27A6A1}.Release|x86.Build.0 = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|x64.Build.0 = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Debug|x86.Build.0 = Debug|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|Any CPU.Build.0 = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|x64.ActiveCfg = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|x64.Build.0 = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|x86.ActiveCfg = Release|Any CPU
-		{C5F2F3BD-1258-40FC-803A-EE7EEC928107}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
-
 EndGlobal
@@ -29,7 +29,6 @@ def _request_json(url: str, token: str, method: str = "GET", body: dict[str, Any
    headers = {
        "Authorization": f"token {token}",
        "Accept": "application/json",
-        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    }
    if body is not None:
        headers["Content-Type"] = "application/json"
Author	SHA1	Message	Date
kjh2064	8bd678c7c7	Merge pull request 'docs(cloud): 클라우드 서버 도메인 가상 호스트 및 HTTPS 설정 지침 반영' (#13 ) from chore/gitignore-dotnet-build-artifacts into main Quant Engine CI/CD Pipeline / validate-core (push) Failing after 10s Details Snapshot Admin Deployment / build-and-deploy (push) Failing after 1m1s Details Quant Engine CI/CD Pipeline / validate-ui-and-storage (push) Has been skipped Details Deploy to Production / Build & Deploy to Production (push) Failing after 1m33s Details Reviewed-on: #13	2026-07-01 10:46:06 +09:00
kjh2064	1255e67765	Merge pull request 'chore(git): .NET 빌드 산출물 추적 제거 및 .gitignore 정비 (WBS-P0.1)' (#12 ) from chore/gitignore-dotnet-build-artifacts into main Quant Engine CI/CD Pipeline / validate-core (push) Failing after 12s Details Snapshot Admin Deployment / build-and-deploy (push) Failing after 1m7s Details WBS-9.3 - NULL Policy CI Gate / NULL Policy Validation (push) Failing after 6s Details Quant Engine CI/CD Pipeline / validate-ui-and-storage (push) Has been skipped Details Deploy to Production / Build & Deploy to Production (push) Failing after 1m40s Details Reviewed-on: http://178.104.200.7/kjh2064/QuantEngineByItz/pulls/12	2026-06-30 18:20:20 +09:00
kjh2064	a02543981e	Merge pull request 'docs(ui): UI 표준을 MudBlazor + Interactive WebAssembly + API-First 로 전환' (#11 ) from docs/ui-framework-policy-mudblazor-wasm into main Quant Engine CI/CD Pipeline / validate-core (push) Failing after 10s Details Snapshot Admin Deployment / build-and-deploy (push) Has been cancelled Details Quant Engine CI/CD Pipeline / validate-ui-and-storage (push) Has been skipped Details Deploy to Production / Build & Deploy to Production (push) Failing after 1m46s Details Reviewed-on: http://178.104.200.7/kjh2064/QuantEngineByItz/pulls/11	2026-06-30 18:20:12 +09:00
kjh2064	227b563ba2	docs(ui): UI 표준을 MudBlazor + Interactive WebAssembly + API-First 로 전환 WBS-9.3 - NULL Policy CI Gate / NULL Policy Validation (pull_request) Failing after 5s Details Quant Engine CI/CD Pipeline / validate-core (pull_request) Failing after 8s Details Quant Engine CI/CD Pipeline / validate-ui-and-storage (pull_request) Has been skipped Details Fluent UI Blazor v5 / InteractiveServer 방침을 폐기하고 MudBlazor 컴포넌트 + Interactive WebAssembly 렌더 모드 + API-First 를 신규 표준으로 확정한다. 기존 CLAUDE.md(Fluent UI)와 AGENTS.md §5b(MudBlazor)의 상충을 해소한다. - CLAUDE.md: Framework & Design System, Component Rules, 매핑표를 MudBlazor 로 갱신 - AGENTS.md §5b: 렌더 모드 표준(Interactive WebAssembly) 신설, Server 표기 정렬 - ROADMAP_WBS.md: WBS-10 보강 문서 상호 참조 링크 추가 - WBS_10_DOTNET_MIGRATION_HARDENING: 마이그레이션 완성/상용화 로드맵 신규, UI 코드 전환을 WBS-A7 로 등록 코드 전환(csproj/Program.cs/.razor)은 미수행, 본 커밋은 방침 문서만 수정. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 18:03:26 +09:00