Aislo/B06_wf3_ProfileCross/B06_wf3_ProfileCross_Api_Fetch.ts

/* =============================================================================
 * B06_wf3_ProfileCross_Api_Fetch.ts
 * 3차 워크플로우(종·횡단 생성) API 클라이언트
 *
 * 백엔드 계약 (B06_wf3_ProfileCross_Router.py):
 *   GET  /api/projects/{project_id}/sections/context           → 확정 경로 + 기본 옵션
 *   GET  /api/projects/{project_id}/sections/{route_id}        → 종단 요약 조회
 *   GET  /api/projects/{project_id}/sections/{route_id}/detail → 종횡단 원시 샘플 조회
 *   POST /api/projects/{project_id}/sections/{route_id}/regenerate → 횡단 반폭 재생성
 *   POST /api/projects/{project_id}/sections/{route_id}/confirm → 종횡단 확정
 *
 * 규칙:
 *   - 모든 제어 상수는 config_frontend에서 참조 (하드코딩 금지).
 *   - 오류 응답 형식 {status:"error", message:"..."}을 Error로 변환.
 * ========================================================================== */

import { API_BASE_URL, API_TIMEOUT_MS } from "@config/config_frontend";

export interface SectionOptionDefaults {
  station_interval_m: number;
  cross_half_width_m: number;
  cross_sample_interval_m: number;
  long_sample_interval_m: number;
  vertical_exaggeration: number;
}

/** 측구 규격(상단폭/저폭/깊이, m). */
export interface DitchSpec {
  top_width_m: number;
  bottom_width_m: number;
  depth_m: number;
}

/** 지반그룹 하나의 표준 횡단면 기본값 (config STANDARD_CROSS_SECTION 사본). */
export interface StandardCrossGroup {
  road_width_m: number;
  shoulder_left_m: number;
  shoulder_right_m: number;
  ditch: DitchSpec;
  /** 암 그룹만 존재: L형 측구(폭/깊이, m). */
  ditch_l_type?: { width_m: number; depth_m: number };
  cross_slope_pct: { min: number; max: number };
  fill_slope_ratio: number;
  cut_slope_ratio: number;
  /** 포장 그룹만 존재: 포장층 두께(m). */
  pavement_thickness_m?: number;
}

/** 표준 횡단면 설정 패널 그룹 키. */
export type StandardCrossKey = "soil" | "rock" | "paved";

export type StandardCrossSection = Record<StandardCrossKey, StandardCrossGroup>;

export interface SectionContextResponse {
  project_id: string;
  route_id: number | null;
  filter_key: string | null;
  method: string | null;
  smooth: boolean | null;
  crs_epsg: number | null;
  defaults: SectionOptionDefaults;
  /** 표준 횡단면 설정 패널(토사/암/포장) 기본값. */
  standard_cross_section: StandardCrossSection;
  /** 암 경계선 기본 오프셋(m)과 상/하 제어 스텝(m). */
  rock_boundary_default_offset_m: number;
  rock_boundary_step_m: number;
}

/** 종단 요약 조회 결과 (SectionSummaryResponse) */
export interface SectionSummaryResponse {
  status: string;
  project_id: string;
  route_id: number;
  longitudinal: Record<string, unknown> | null;
  length_m: number | null;
  cross_section_count: number;
}

export interface SectionSample {
  chainage_m?: number;
  offset_m?: number;
  elevation_m?: number | null;
  z?: number | null;
  valid: boolean;
}

export interface SectionStation {
  station_id: string;
  chainage_m: number;
  label: string;
  /** irregular = 사용자가 구조물용으로 추가한 비정규 측점(프론트 주입, 백엔드 미영속). */
  kind: "bp" | "ep" | "regular" | "irregular";
  /** 비정규 측점의 구조물 설명(백엔드가 확정 시 부여). 복귀 시 사이드바 목록 복원에 쓴다. */
  structure?: string;
  center_z: number | null;
  azimuth_deg: number | null;
  center_x: number;
  center_y: number;
  /** 횡단 기준 등고가 높은 쪽(측구 설계 기본 방향). B05 solve 자동 판정 + 사용자 변경. */
  uphill_side?: "left" | "right" | null;
  frame: { left_xy: [number, number] };
}

/** 계획선 샘플 (계획고와 지반고, 그 차이). */
export interface DesignProfileSample {
  chainage_m: number;
  elevation_m: number;
  ground_elevation_m: number;
  difference_m: number;
}

/** 절·성토 균형을 판정하는 구역 단위 결과. */
export interface DesignProfileSegment {
  index: number;
  start_chainage_m: number;
  end_chainage_m: number;
  cut_area_m2: number;
  fill_area_m2: number;
  balance_error_m2: number;
}

export interface DesignProfileSummary {
  cut_area_m2: number;
  fill_area_m2: number;
  balance_error_m2: number;
  max_grade_pct: number;
  vertical_curve_count: number;
  pvi_count: number;
  balance_segment_count: number;
  balanced: boolean;
  main_direction: string;
  suggested_elevation_offset_m: number | null;
  warnings: string[];
}

/**
 * 종단 계획선. 횡단 설계 기반 계획선이 추가될 수 있어 배열로 전달된다.
 */
export interface DesignProfile {
  id: string;
  name: string;
  basis: string;
  samples: DesignProfileSample[];
  balance_segments: DesignProfileSegment[];
  summary: DesignProfileSummary;
}

export interface LongitudinalSection {
  length_m: number;
  samples: SectionSample[];
  stations: SectionStation[];
  design_profiles?: DesignProfile[];
  /**
   * 계획선 변화점(PVI) 구조. B05가 편집 기준선으로 사용하며 `design_profiles`는
   * 여기서 파생된다. 구 데이터에는 없을 수 있어 optional이다.
   * 구조는 `B05_wf2_Route_UI_Profile_Alignment.ProfileAlignment`.
   */
  profile_alignment?: unknown;
}

export interface CrossSection extends SectionStation {
  samples: SectionSample[];
  /** DB에 저장된 잠정 설계 지정(있을 때만). 상세 조회 시 얹혀 온다. */
  design?: CrossDesign;
}

export interface SectionDetailResponse {
  longitudinal: LongitudinalSection;
  cross_sections: CrossSection[];
}

/** 종횡단 확정 결과 (SectionConfirmResponse) */
export interface SectionConfirmResponse {
  status: string;
  project_id: string;
  route_id: number;
  confirmed: boolean;
}

/** 측점 표준횡단 설계 지정값 (버튼 상태). */
export type GroundType = "soil" | "ripping_rock" | "blasting_rock";
export type SectionMode = "left_cut" | "right_cut" | "both_cut" | "both_fill";
export type DitchSide = "left" | "right";
export type DitchType = "standard" | "l_type";

/** 측점 표준횡단 설계 계산 결과(잠정치). data.design에 저장되는 구조와 동일. */
export interface CrossDesign {
  ground_type: GroundType;
  geometry_preset: "soil" | "rock";
  section_mode: SectionMode;
  ditch_side: DitchSide;
  /** 측구 형식(일반/L형). 양성(측구 없음)은 null. */
  ditch_type: DitchType | null;
  cut_slope_ratio: number;
  /** 2단계 절토의 토사(상단) 경사비. 암 지반에서만 의미. */
  soil_cut_slope_ratio?: number;
  /** 암반 경계 기준 2단계 경사 적용 여부(엔진이 실제 적용했는지). */
  two_stage_slope?: boolean;
  fill_slope_ratio: number;
  roadbed_width_m: number;
  carriageway_width_m: number;
  cross_slope_pct: number;
  ditch:
    | { type: "standard"; top_width_m: number; bottom_width_m: number; depth_m: number }
    | { type: "l_type"; width_m: number; depth_m: number }
    | { type: "none" };
  /** 측구 생성 여부(엔진이 자동/override 반영해 실제 적용한 결과). */
  ditch_enabled?: boolean;
  /** 포장 중첩 여부와 포장층 두께(포장 시). */
  paved: boolean;
  pavement_thickness_m?: number;
  /** B05 법정 경사 분석의 포장 제안 여부(사용자 토글과 무관하게 유지). */
  pavement_suggested?: boolean;
  /** 노면(노견 포함) 양 끝점 — 노면 렌더링 기준. */
  road_edges: {
    left: { offset_m: number; elevation_m: number };
    right: { offset_m: number; elevation_m: number };
  };
  /** 차도(노견 제외) 양 끝점 — 포장 범위 기준. */
  carriageway_edges?: {
    left: { offset_m: number; elevation_m: number };
    right: { offset_m: number; elevation_m: number };
  };
  design_elevation_m: number;
  cut_area_m2: number;
  fill_area_m2: number;
  ditch_area_m2: number;
  design_line: Array<{ offset_m: number; elevation_m: number }>;
  /** 확정 시 병합되는 암 경계선 오프셋(m). 세션 값이 우선이며 복원 폴백으로 쓴다. */
  rock_boundary_offset_m?: number;
}

export interface CrossDesignResponse {
  status: string;
  chainage_m: number;
  design: CrossDesign;
}

export interface CrossDesignRequest {
  chainage_m: number;
  ground_type: GroundType;
  section_mode: SectionMode;
  ditch_side?: DitchSide | null;
  /** 측구 형식(일반/L형). L형은 암 지반에서만 허용된다. */
  ditch_type?: DitchType;
  /** 포장 중첩 여부 — 횡단경사·포장층만 포장 그룹 값으로 계산된다. */
  paved?: boolean;
  /** 암 경계선 오프셋(m, 지면선 기준 하향 음수). 암 지반 2단계 절토 무릎 계산용. */
  rock_boundary_offset_m?: number | null;
  /** 암 지반 2단계 경사 적용 여부(기본 true, 토글로 해제). */
  two_stage_slope?: boolean;
  /** 측구 생성 여부. null/미지정=자동 판정, true/false=수동 override. */
  ditch_enabled?: boolean | null;
  /** 설정 패널 편집값. 요청값 → config 기본값 순으로 우선한다. */
  standard_cross_section?: StandardCrossSection;
}

/** 확정 시 측점별 data.design에 병합할 프론트 세션 보관값. */
export interface CrossSectionPatch {
  chainage_m: number;
  rock_boundary_offset_m?: number;
}

/** 공통 fetch 헬퍼: 타임아웃 + 인증 헤더 + 오류 응답 변환. */
async function requestJson<T>(path: string, init: RequestInit): Promise<T> {
  const controller = new AbortController();
  const timeoutId = window.setTimeout(() => controller.abort(), API_TIMEOUT_MS);
  try {
    const response = await fetch(`${API_BASE_URL}${path}`, {
      ...init,
      credentials: "include",
      headers: {
        "Content-Type": "application/json",
        ...(init.headers ?? {}),
      },
      signal: controller.signal,
    });
    const payload = (await response.json()) as T & { message?: string };
    if (!response.ok) {
      throw new Error(payload.message ?? `HTTP ${response.status}`);
    }
    return payload;
  } finally {
    window.clearTimeout(timeoutId);
  }
}

/** 최신 확정 경로와 B04 확정값, config 기반 생성 기본값을 조회한다. */
export async function fetchSectionContext(projectId: string): Promise<SectionContextResponse> {
  return requestJson<SectionContextResponse>(`/projects/${projectId}/sections/context`, {
    method: "GET",
  });
}

/** 경로의 종단면 요약을 조회한다. */
export async function getSections(
  projectId: string,
  routeId: number,
): Promise<SectionSummaryResponse> {
  return requestJson<SectionSummaryResponse>(`/projects/${projectId}/sections/${routeId}`, {
    method: "GET",
  });
}

/** 경로의 SVG 렌더링용 종단·횡단 원시 샘플을 조회한다. */
export async function fetchSectionDetail(
  projectId: string,
  routeId: number,
): Promise<SectionDetailResponse> {
  return requestJson<SectionDetailResponse>(`/projects/${projectId}/sections/${routeId}/detail`, {
    method: "GET",
  });
}

/** 횡단 반폭을 반영해 종횡단을 재생성·저장하고 갱신된 상세를 반환한다. */
export async function regenerateSections(
  projectId: string,
  routeId: number,
  crossHalfWidthM: number,
): Promise<SectionDetailResponse> {
  return requestJson<SectionDetailResponse>(
    `/projects/${projectId}/sections/${routeId}/regenerate`,
    { method: "POST", body: JSON.stringify({ cross_half_width_m: crossHalfWidthM }) },
  );
}

/** 측점 표준횡단 설계(지반유형·단면유형)를 즉시 계산·저장하고 잠정 결과를 반환한다. */
export async function computeCrossDesign(
  projectId: string,
  routeId: number,
  request: CrossDesignRequest,
): Promise<CrossDesignResponse> {
  return requestJson<CrossDesignResponse>(
    `/projects/${projectId}/sections/${routeId}/cross-design`,
    { method: "POST", body: JSON.stringify(request) },
  );
}

/** 경로의 종·횡단면을 확정한다. 표준 횡단면 설정값·측점별 세션 보관값을 함께 저장할 수 있다. */
export async function confirmSections(
  projectId: string,
  routeId: number,
  standardCrossSection?: StandardCrossSection,
  crossPatches?: CrossSectionPatch[],
): Promise<SectionConfirmResponse> {
  const body: Record<string, unknown> = {};
  if (standardCrossSection) body.standard_cross_section = standardCrossSection;
  if (crossPatches?.length) body.cross_patches = crossPatches;
  return requestJson<SectionConfirmResponse>(`/projects/${projectId}/sections/${routeId}/confirm`, {
    method: "POST",
    body: JSON.stringify(body),
  });
}

/** 같은 회사에서 표준횡단 설계값을 불러올 수 있는 프로젝트 항목. */
export interface CompanyStandardProject {
  project_id: string;
  name: string;
}

export interface CompanyStandardListResponse {
  status: string;
  projects: CompanyStandardProject[];
}

export interface CompanyStandardResponse {
  status: string;
  project_id: string;
  standard_cross_section: StandardCrossSection;
}

/** 같은 회사에서 설계값을 불러올 수 있는 프로젝트 목록을 조회한다(회사 스코프). */
export async function listCompanyStandards(
  projectId: string,
): Promise<CompanyStandardListResponse> {
  return requestJson<CompanyStandardListResponse>(
    `/projects/${projectId}/sections/company-standards`,
    { method: "GET" },
  );
}

/** 특정 프로젝트의 표준횡단 설계값을 미리보기용으로 조회한다(적용 전, 현재 값 불변). */
export async function getCompanyStandard(
  projectId: string,
  sourceProjectId: string,
): Promise<CompanyStandardResponse> {
  return requestJson<CompanyStandardResponse>(
    `/projects/${projectId}/sections/company-standards/${sourceProjectId}`,
    { method: "GET" },
  );
}