"""全项目参数中心：题面常量、协议限制、会话策略与搜索规划参数。

任何魔法数字只允许在这里出现一次。各模块通过 :class:`ProblemConfig` 读取；
命令行需要覆盖时用 ``dataclasses.replace`` 派生新配置，不散落字面量。

来源标注约定：
- ``[题面]`` 出自 issue/B题.pdf、附件1《模拟器使用说明》、附件2《通信接口说明》原文；
- ``[工程]`` 本队工程参数，可依演练实测调整，不代表官方规定。
"""

from __future__ import annotations

from dataclasses import dataclass

Vec2 = tuple[float, float]


@dataclass(frozen=True)
class FieldConfig:
    """题目物理世界与协议硬限制。[题面]"""

    omega_radius_m: float = 1800.0        # 目标区域半径，圆心为原点
    channel_min: int = 1                  # 有效频道范围
    channel_max: int = 20
    source_count_min: int = 10            # 一局源总数范围（接口不直接告知）
    source_count_max: int = 16
    r_eff_min_m: float = 1000.0           # 有效接收半径下界：no_signal 只能排除该圆盘
    r_eff_max_m: float = 1500.0           # 有效接收半径上界：direction 隐含距离上界
    near_radius_m: float = 5.0            # "距离过近"阈值，不返回示向度
    clear_radius_m: float = 20.0          # 清除半径；与定向朝向无关
    bearing_error_half_deg: float = 1.0   # 示向度误差幅度（题设模型）
    bearing_decimals: int = 2             # 返回示向度小数位
    coord_abs_limit_m: float = 2_000_000.0   # 提交坐标的绝对值上限（超出返回 HTTP 400）
    directional_half_angle_deg: float = 90.0  # 定向源朝向两侧各90度覆盖（含边界）
    max_virtual_duration_s: float = 360_000.0  # 虚拟世界限时（100小时）
    max_real_duration_s: float = 1200.0   # /enter 成功后程序运行上限（20分钟）
    test_window_s: float = 1500.0         # 确认开始后的测试窗口（25分钟）


@dataclass(frozen=True)
class CostConfig:
    """虚拟世界动作耗时模型。[题面] 附件1表1、附件2第4节。"""

    speed_mps: float = 5.0       # 移动速度；耗时=直线距离/speed
    measure_s: float = 5.0       # 每次检测动作耗时（无论结果）
    switch_s: float = 1.0        # 任意两频道间切换耗时，仅由合法 /measure 触发
    clear_success_s: float = 5.0  # 清除成功耗时 = 光学定位3s + 激光清除2s
    clear_fail_s: float = 3.0    # 未发现可清除目标 = 仅光学定位3s


@dataclass(frozen=True)
class SessionConfig:
    """会话与网络策略。arena/robot/request 规则为 [题面]，其余为 [工程]。"""

    arena_id: str = "default"                  # [题面] 固定值
    base_url: str = "http://127.0.0.1:2026"    # [题面] 模拟器默认接口地址
    robot_id_max_bytes: int = 64               # [题面] UTF-8 长度 1..64
    request_id_max_bytes: int = 128            # [题面] UTF-8 长度 1..128
    request_body_max_bytes: int = 65_536       # [题面] 超出返回 HTTP 413
    connect_timeout_s: float = 5.0             # [工程] 连接超时
    read_timeout_s: float = 15.0               # [工程] 读超时；覆盖"服务器已处理但响应丢失"
    max_attempts: int = 3                      # [工程] 单动作最多尝试次数（含首次）
    retry_backoff_s: float = 0.25              # [工程] 重试退避基数，按 2^n 放大
    reserve_exit_s: float = 60.0               # [工程] 预留退出与故障恢复的现实秒数
    real_rtt_p95_s: float = 1.0                # [工程] 现实单请求高分位估计，预算核算用


@dataclass(frozen=True)
class SearchConfig:
    """搜索与覆盖规划参数。[工程] 推导依据见 docs/B题建模分析与实施计划.md。"""

    grid_step_m: float = 700.0        # P4 覆盖网格步长；单元对角 700*sqrt(2)≈989.95<=1000
    grid_half_cells: int = 3          # i,j ∈ [-3,3]，49 点覆盖 [-2100,2100]^2 ⊇ Ω
    fallback_clear_grid_m: float = 20.0  # P5 后备清除网格；10*sqrt(2)<=20
    bearing_rounding_margin_deg: float = 0.0  # 默认不加舍入裕量；敏感性分析时显式设 0.005


@dataclass(frozen=True)
class ProblemConfig:
    """聚合配置。各模块函数的第一个默认参数，便于单测替换。"""

    field: FieldConfig = FieldConfig()
    cost: CostConfig = CostConfig()
    session: SessionConfig = SessionConfig()
    search: SearchConfig = SearchConfig()


DEFAULT_CONFIG = ProblemConfig()