formula_id: WBS_10_DOTNET_MIGRATION_ROADMAP_V1
title: "WBS-10 .NET 엔진 고도화 상세 로드맵"
owner: "QuantEngine"
source_of_truth:
  - docs/ROADMAP_WBS.md
  - spec/60_quant_engine_wbs.yaml
  - spec/41_release_dag.yaml
  - spec/00_execution_contract.yaml

scope:
  goal: "Python 검증/보조 도구는 유지하고, 운영 엔진은 .NET으로 수렴시키며, 테이블 구조와 스케줄러를 서비스 수준으로 고도화한다."
  non_goals:
    - "가격/수량/임계값의 LLM 즉석 계산"
    - "운영 경로의 Python 재도입"
    - "원천 데이터의 무분별한 중복 저장"

principles:
  - "Python은 harness, verification, conversion tooling에 집중한다."
  - ".NET은 runtime engine, scheduler, API, operational read model을 담당한다."
  - "쓰기 경로는 정규화, 읽기 경로는 의도된 역정규화로 분리한다."
  - "모든 숫자는 provenance와 검증 아티팩트를 가져야 한다."
  - "스케줄러는 단순 cron이 아니라 상태/의존성/재시도/감사 추적을 갖는 서비스로 취급한다."

roadmap:
  phase_name: "WBS-10 .NET 엔진 고도화"
  phase_goal: "Python-to-.NET 전환, 테이블 정규화/역정규화, 서비스급 스케줄러, parity harness 정착"
  exit_gate: "dotnet runtime parity PASS + scheduler observability PASS + normalized/denormalized schema contract PASS + evidence artifacts recorded"
  execution_order:
    - WBS-10-A1
    - WBS-10-B1
    - WBS-10-C1
    - WBS-10-A2
    - WBS-10-B2
    - WBS-10-C2
    - WBS-10-A3
    - WBS-10-B3
    - WBS-10-C3
  tracks:
    - track_id: WBS-10-A
      name: "Python → .NET 전환"
      description: "운영 경로에서 Python 의존을 제거하고, 동일 결과를 내는 .NET canonical 구현으로 이식한다."
      tasks:
        - task_id: WBS-10-A1
          title: "실행 경로 인벤토리 및 전환 우선순위 확정"
          status: PENDING
          depends_on: []
          owner_files:
            - src/quant_engine/
            - tools/
            - spec/60_quant_engine_wbs.yaml
          success_data_guide:
            required_inputs:
              - "운영 진입점 목록"
              - "Python CLI/모듈 호출 지점"
              - "배포/스케줄러 호출 경로"
            expected_outputs:
              - "전환 우선순위 표"
              - "운영 경로 / 보조 경로 분리 결과"
            expected_artifact_schema:
              format: markdown
              fields:
                - route
                - owner
                - runtime
                - keep_or_migrate
                - notes
            failure_conditions:
              - "운영 경로와 보조 경로가 섞여 있으면 FAIL"
              - "Python 운영 경로가 누락 없이 남아 있지 않으면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-A1/verdict.json"
          done_when:
            - "운영 경로와 보조 경로가 문서화됨"
            - "전환 대상/비대상 경로가 분리됨"

        - task_id: WBS-10-A2
          title: ".NET 도메인 서비스로 Python 계산 로직 이식"
          status: PENDING
          depends_on:
            - WBS-10-A1
          owner_files:
            - src/dotnet/QuantEngine.Core/
            - src/dotnet/QuantEngine.Application/
          success_data_guide:
            required_inputs:
              - "Python reference result"
              - "현재 .NET implementation"
              - "golden parity dataset"
            expected_outputs:
              - "동일 입력에 대한 .NET 결과"
              - "Python 대비 parity diff 0 또는 허용오차 내"
            expected_artifact_schema:
              format: json
              fields:
                - formula_id
                - input_digest
                - python_output
                - dotnet_output
                - diff
                - tolerance
                - gate
            failure_conditions:
              - "diff가 tolerance를 초과하면 FAIL"
              - "입력 digest가 없으면 FAIL"
            verification_commands:
              - "dotnet test src/dotnet/QuantEngine.Core.Tests/QuantEngine.Core.Tests.csproj -c Release"
              - "python tools/verify_wbs_task_v1.py --task WBS-10-A2"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-A2/verdict.json"
          done_when:
            - "Python reference와 .NET output이 parity를 만족"
            - "핵심 계산이 서비스 계층으로 이동됨"

        - task_id: WBS-10-A3
          title: "Python thin-wrapper 정리 및 운영 금지 경로 분리"
          status: PENDING
          depends_on:
            - WBS-10-A2
          owner_files:
            - tools/
            - src/quant_engine/
          success_data_guide:
            required_inputs:
              - "현재 Python script 목록"
              - "runtime entrypoint 목록"
            expected_outputs:
              - "운영용 thin wrapper만 남김"
              - "직접 운영 경로 금지 목록"
            expected_artifact_schema:
              format: yaml
              fields:
                - wrapper_path
                - purpose
                - runtime_usage
                - allowed_or_disallowed
            failure_conditions:
              - "운영용으로 직접 호출 가능한 Python entrypoint가 남아 있으면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-A3/verdict.json"
          done_when:
            - "운영 진입점이 .NET 또는 thin wrapper로만 남음"

    - track_id: WBS-10-B
      name: "테이블 정규화 + 역정규화"
      description: "원천/원장/배포 이력을 정규화하고, UI/대시보드용 읽기 모델은 역정규화한다."
      tasks:
        - task_id: WBS-10-B1
          title: "정규화 기준 테이블 계약 확정"
          status: PENDING
          depends_on: []
          owner_files:
            - spec/
            - src/dotnet/QuantEngine.Infrastructure/
          success_data_guide:
            required_inputs:
              - "source table 목록"
              - "primary key / foreign key 정의"
              - "중복 제거 대상"
            expected_outputs:
              - "canonical normalized schema"
              - "table ownership map"
            expected_artifact_schema:
              format: yaml
              fields:
                - table
                - keys
                - cardinality
                - owner
                - write_path
            failure_conditions:
              - "canonical table이 둘 이상이면 FAIL"
              - "정규화 대상과 읽기 모델이 혼동되면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-B1/verdict.json"
          done_when:
            - "쓰기 경로의 canonical table contract가 문서화됨"

        - task_id: WBS-10-B2
          title: "운영 조회용 역정규화 read model 설계"
          status: PENDING
          depends_on:
            - WBS-10-B1
          owner_files:
            - src/dotnet/QuantEngine.Web/
            - src/dotnet/QuantEngine.Application/
          success_data_guide:
            required_inputs:
              - "대시보드/운영 화면 요구사항"
              - "조회 성능 목표"
            expected_outputs:
              - "읽기 전용 denormalized projection"
              - "refresh/update strategy"
            expected_artifact_schema:
              format: yaml
              fields:
                - projection_name
                - source_tables
                - refresh_mode
                - staleness_budget
                - consumers
            failure_conditions:
              - "읽기 모델이 원천 원장과 직접 동일하면 FAIL"
              - "staleness_budget 미정이면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-B2/verdict.json"
          done_when:
            - "읽기 모델이 원천 원장과 분리됨"
            - "운영 화면이 read model만 참조함"

        - task_id: WBS-10-B3
          title: "중복/파생 데이터 경계 및 기술부채 방지 계약"
          status: PENDING
          depends_on:
            - WBS-10-B1
            - WBS-10-B2
          owner_files:
            - spec/
            - governance/
          success_data_guide:
            required_inputs:
              - "allowed denormalization cases"
              - "forbidden duplication cases"
            expected_outputs:
              - "파생 데이터 허용 규칙"
              - "canonical source 정의"
            expected_artifact_schema:
              format: yaml
              fields:
                - source_of_truth
                - derived_table
                - allowed_reason
                - forbidden_reason
            failure_conditions:
              - "source_of_truth가 명시되지 않으면 FAIL"
              - "금지 사유가 없는 중복이면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-B3/verdict.json"
          done_when:
            - "역정규화가 의도된 캐시/서빙으로만 허용됨"

    - track_id: WBS-10-C
      name: "서비스 수준 스케줄러"
      description: "cron 수준을 넘어 상태 머신, idempotency, dependency, audit, retry를 갖는 스케줄러로 강화한다."
      tasks:
        - task_id: WBS-10-C1
          title: "스케줄러 상태 머신 및 실행 이력 계약"
          status: PENDING
          depends_on: []
          owner_files:
            - src/dotnet/QuantEngine.Application/
            - src/dotnet/QuantEngine.Web/Services/
          success_data_guide:
            required_inputs:
              - "job state list"
              - "transition rule"
              - "run id / lease key"
            expected_outputs:
              - "pending/running/succeeded/failed/retrying/blocked 상태 정의"
              - "audit trail schema"
            expected_artifact_schema:
              format: yaml
              fields:
                - state
                - allowed_transitions
                - lease_owner
                - timeout_policy
                - audit_fields
            failure_conditions:
              - "상태 전이표가 없으면 FAIL"
              - "lease_owner 또는 timeout_policy가 없으면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-C1/verdict.json"
          done_when:
            - "스케줄러의 상태 전이가 데이터로 설명됨"

        - task_id: WBS-10-C2
          title: "idempotency 및 concurrency control"
          status: PENDING
          depends_on:
            - WBS-10-C1
          owner_files:
            - src/dotnet/QuantEngine.Application/
            - spec/41_release_dag.yaml
          success_data_guide:
            required_inputs:
              - "중복 실행 시나리오"
              - "동시 실행 금지 자원 목록"
            expected_outputs:
              - "중복 적재 방지"
              - "자원별 lock/lease 정책"
            expected_artifact_schema:
              format: yaml
              fields:
                - resource
                - lock_key
                - idempotency_key
                - retry_policy
            failure_conditions:
              - "idempotency_key가 없으면 FAIL"
              - "동시 실행 금지 자원 목록이 비어 있으면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-C2/verdict.json"
          done_when:
            - "같은 run이 두 번 실행돼도 결과가 중복되지 않음"

        - task_id: WBS-10-C3
          title: "health gate + retry policy + dependency graph"
          status: PENDING
          depends_on:
            - WBS-10-C1
            - WBS-10-C2
          owner_files:
            - .gitea/workflows/
            - src/dotnet/QuantEngine.Web/
          success_data_guide:
            required_inputs:
              - "업스트림 의존성 목록"
              - "retry 가능한 failure 유형"
              - "health check 대상"
            expected_outputs:
              - "ci -> prepare-release -> deploy-prod 순차 게이트"
              - "transient failure만 재시도"
            expected_artifact_schema:
              format: yaml
              fields:
                - upstream_workflow
                - downstream_workflow
                - retryable_errors
                - health_checks
            failure_conditions:
              - "순차 게이트가 아닌 병렬 실행이면 FAIL"
              - "retryable_errors가 비어 있으면 FAIL"
            verification_commands:
              - "python tools/validate_quant_engine_wbs_v1.py"
            evidence_artifacts:
              - "Temp/evidence/WBS-10-C3/verdict.json"
          done_when:
            - "스케줄러가 선행 성공 없이는 후속 실행을 시작하지 않음"

deliverables:
  - "docs/WBS_10_DOTNET_MIGRATION_ROADMAP.yaml"
  - "AGENTS.md routing update"
  - "필요 시 docs/ROADMAP_WBS.md에 pointer 추가"

alignment:
  canonical_status: "supplementary"
  canonical_note: "이 YAML은 기존 WBS-10의 상세 실행 가이드이며, 권위는 docs/ROADMAP_WBS.md와 spec/60_quant_engine_wbs.yaml에 남긴다."
  spec_task_map:
    WBS-10.1: WBS-10-A1
    WBS-10.2: WBS-10-C1
    WBS-10.3: WBS-10-A2
    WBS-10.4: WBS-10-A2
    WBS-10.5: WBS-10-A2
    WBS-10.6: WBS-10-C2
    WBS-10.7: WBS-10-B2
    WBS-10.8: WBS-10-C3
    WBS-10.9: WBS-10-B3
    WBS-10.10: WBS-10-B2
    WBS-10.11: WBS-10-A3
    WBS-10.12: WBS-10-C3
  roadmap_section_map:
    WBS-10.1: "기반 결함 수정"
    WBS-10.2: "테스트 인프라 구축"
    WBS-10.3: "Domain 계산기 Parity 검증 (Python ↔ C# 동등성)"
    WBS-10.4: "공식 계산 엔진 C# 포팅 (compute_formula_outputs.py 대응)"
    WBS-10.5: "하네스 주입 엔진 C# 포팅 (inject_computed_harness.py 대응)"
    WBS-10.6: "파이프라인 오케스트레이터"
    WBS-10.7: "Application 서비스 레이어 구축"
    WBS-10.8: "데이터 수집 오케스트레이터"
    WBS-10.9: "보안 강화"
    WBS-10.10: "Razor Pages 어드민 대시보드 고도화"
    WBS-10.11: "Razor Pages 개발 가이드라인 수립"
    WBS-10.12: "Playwright 기반 Razor Pages 어드민 UI E2E 자동화"