"""Rocket simulator configuration APIs.""" from datetime import datetime from typing import Annotated from fastapi import APIRouter, Depends, HTTPException, Query, status from pydantic import BaseModel, ConfigDict, Field, StringConstraints, field_validator, model_validator from sqlalchemy import func, or_, select from sqlalchemy.ext.asyncio import AsyncSession from app.database import get_db from app.models.db import RocketConfig, User from app.services.auth_deps import require_admin router = APIRouter(prefix="/rockets", tags=["rockets"]) RocketCode = Annotated[str, StringConstraints(pattern=r"^[a-z0-9][a-z0-9-]*$")] class RocketStage(BaseModel): name: str = Field(min_length=1, max_length=100) dry_mass_kg: float = Field(gt=0) fuel_mass_kg: float = Field(gt=0) max_thrust_n: float = Field(gt=0) specific_impulse_s: float = Field(gt=0) engine_count: int = Field(gt=0) length_ratio: float = Field(gt=0, le=1) class RocketAppearance(BaseModel): """3D 外观构型(可选)。留空的字段由前端按公开资料通用规律推断。""" booster_count: int | None = Field(default=None, ge=0, le=8, description="捆绑助推器/侧芯级数量,0 为单芯级") engines_per_booster: int | None = Field(default=None, ge=1, le=33, description="每个助推器的发动机数量") core_engine_count: int | None = Field( default=None, ge=1, le=33, description="芯级一级发动机数量;stage_1.engine_count 仍是含助推器的总数" ) booster_diameter_ratio: float | None = Field(default=None, gt=0, le=1, description="助推器直径 / 芯级直径") grid_fins: bool | None = Field(default=None, description="一级顶部栅格翼(回收构型)") fairing: bool | None = Field(default=None, description="是否有载荷整流罩;false 表示二级自身带头锥与襟翼(星舰)") class RocketBoosters(BaseModel): """捆绑助推器组合参数(可选)。 口径与一级一致,但只统计助推器这一组:thrust_n / dry_mass_kg / fuel_mass_kg 都是 全部助推器加起来的合计值。芯级 = stage_1 减去本组,因此不会有两套数字互相矛盾; 助推器比冲单独登记,芯级比冲沿用 stage_1.specific_impulse_s。 """ count: int = Field(ge=1, le=8, description="助推器数量") thrust_n: float = Field(gt=0, description="全部助推器合计推力,不含芯级") specific_impulse_s: float = Field(gt=0, description="助推器比冲;芯级比冲取 stage_1") dry_mass_kg: float = Field(gt=0, description="全部助推器合计干重") fuel_mass_kg: float = Field(gt=0, description="全部助推器合计推进剂") class RocketBase(BaseModel): code: RocketCode name: str = Field(min_length=1, max_length=100) name_zh: str | None = Field(default=None, max_length=100) manufacturer: str | None = Field(default=None, max_length=100) country: str | None = Field(default=None, max_length=100) launch_site_name: str = Field(default="Equatorial Launch Site", min_length=1, max_length=120) launch_latitude_deg: float = Field(default=0, ge=-90, le=90) launch_longitude_deg: float = Field(default=0, ge=-180, le=180) description: str | None = None color: str = Field(default="#f8fafc", pattern=r"^#[0-9a-fA-F]{6}$") height_m: float = Field(gt=0) diameter_m: float = Field(gt=0) payload_mass_kg: float = Field(ge=0, default=0) drag_coefficient: float = Field(gt=0, le=2, default=0.4) reference_area_m2: float = Field(gt=0) target_orbit_km: float = Field(gt=0, default=200) target_velocity_mps: float = Field(gt=0, default=7800) separation_delay_seconds: float = Field(ge=0, le=30, default=2) second_stage_ignition_delay_seconds: float = Field(ge=0, le=30, default=1) stage_1: RocketStage stage_2: RocketStage appearance: RocketAppearance | None = None boosters: RocketBoosters | None = None is_active: bool = True sort_order: int = 0 @field_validator("code", mode="before") @classmethod def normalize_code(cls, value: str) -> str: return value.strip().lower() @model_validator(mode="after") def boosters_within_stage1(self) -> "RocketBase": """助推器是一级的子集,否则一级数据自相矛盾(分离时会算出负推力/负质量)。""" check_boosters_within_stage1(self.stage_1, self.boosters) return self class RocketCreate(RocketBase): pass def check_boosters_within_stage1(stage_1: RocketStage | None, boosters: RocketBoosters | None) -> None: if stage_1 is None or boosters is None: return pairs = ( ("boosters.thrust_n", boosters.thrust_n, stage_1.max_thrust_n), ("boosters.dry_mass_kg", boosters.dry_mass_kg, stage_1.dry_mass_kg), ("boosters.fuel_mass_kg", boosters.fuel_mass_kg, stage_1.fuel_mass_kg), ) for name, value, total in pairs: if value > total: raise ValueError(f"{name} 不能大于 stage_1 的对应值({value:g} > {total:g})") class RocketUpdate(BaseModel): code: RocketCode | None = None name: str | None = Field(default=None, min_length=1, max_length=100) name_zh: str | None = Field(default=None, max_length=100) manufacturer: str | None = Field(default=None, max_length=100) country: str | None = Field(default=None, max_length=100) launch_site_name: str | None = Field(default=None, min_length=1, max_length=120) launch_latitude_deg: float | None = Field(default=None, ge=-90, le=90) launch_longitude_deg: float | None = Field(default=None, ge=-180, le=180) description: str | None = None color: str | None = Field(default=None, pattern=r"^#[0-9a-fA-F]{6}$") height_m: float | None = Field(default=None, gt=0) diameter_m: float | None = Field(default=None, gt=0) payload_mass_kg: float | None = Field(default=None, ge=0) drag_coefficient: float | None = Field(default=None, gt=0, le=2) reference_area_m2: float | None = Field(default=None, gt=0) target_orbit_km: float | None = Field(default=None, gt=0) target_velocity_mps: float | None = Field(default=None, gt=0) separation_delay_seconds: float | None = Field(default=None, ge=0, le=30) second_stage_ignition_delay_seconds: float | None = Field(default=None, ge=0, le=30) stage_1: RocketStage | None = None stage_2: RocketStage | None = None appearance: RocketAppearance | None = None boosters: RocketBoosters | None = None is_active: bool | None = None sort_order: int | None = None @field_validator("code", mode="before") @classmethod def normalize_code(cls, value: str | None) -> str | None: return value.strip().lower() if value else value @model_validator(mode="after") def boosters_within_stage1(self) -> "RocketUpdate": # 只改 boosters 不改 stage_1 时无法交叉校验,交给前端与预置保证口径 check_boosters_within_stage1(self.stage_1, self.boosters) return self class RocketResponse(RocketBase): id: int created_at: datetime | None = None updated_at: datetime | None = None model_config = ConfigDict(from_attributes=True) def rocket_values(data: RocketCreate | RocketUpdate, *, exclude_unset: bool = False) -> dict: values = data.model_dump(exclude_unset=exclude_unset) for key in ("stage_1", "stage_2", "appearance", "boosters"): if key in values and values[key] is not None: values[key] = dict(values[key]) return values async def ensure_unique_code(db: AsyncSession, code: str, exclude_id: int | None = None) -> None: query = select(RocketConfig.id).where(RocketConfig.code == code) if exclude_id is not None: query = query.where(RocketConfig.id != exclude_id) if (await db.execute(query)).scalar_one_or_none() is not None: raise HTTPException(status_code=400, detail="Rocket code already exists") @router.get("", response_model=list[RocketResponse]) async def list_active_rockets(db: AsyncSession = Depends(get_db)): result = await db.execute( select(RocketConfig) .where(RocketConfig.is_active.is_(True)) .order_by(RocketConfig.sort_order, RocketConfig.id) ) return result.scalars().all() @router.get("/admin") async def list_rockets_for_admin( skip: int = Query(0, ge=0), limit: int = Query(20, ge=1, le=100), search: str | None = None, db: AsyncSession = Depends(get_db), _: User = Depends(require_admin), ): filters = [] if search: keyword = f"%{search.strip()}%" filters.append(or_( RocketConfig.code.ilike(keyword), RocketConfig.name.ilike(keyword), RocketConfig.name_zh.ilike(keyword), )) total = await db.scalar(select(func.count(RocketConfig.id)).where(*filters)) result = await db.execute( select(RocketConfig) .where(*filters) .order_by(RocketConfig.sort_order, RocketConfig.id) .offset(skip) .limit(limit) ) return { "rockets": [RocketResponse.model_validate(item) for item in result.scalars().all()], "total": total or 0, } @router.get("/{code}", response_model=RocketResponse) async def get_active_rocket(code: str, db: AsyncSession = Depends(get_db)): result = await db.execute( select(RocketConfig).where( RocketConfig.code == code.lower(), RocketConfig.is_active.is_(True), ) ) rocket = result.scalar_one_or_none() if not rocket: raise HTTPException(status_code=404, detail="Rocket not found") return rocket @router.post("/admin", response_model=RocketResponse, status_code=status.HTTP_201_CREATED) async def create_rocket( data: RocketCreate, db: AsyncSession = Depends(get_db), _: User = Depends(require_admin), ): await ensure_unique_code(db, data.code) rocket = RocketConfig(**rocket_values(data)) db.add(rocket) await db.commit() await db.refresh(rocket) return rocket @router.put("/admin/{rocket_id}", response_model=RocketResponse) async def update_rocket( rocket_id: int, data: RocketUpdate, db: AsyncSession = Depends(get_db), _: User = Depends(require_admin), ): rocket = await db.get(RocketConfig, rocket_id) if not rocket: raise HTTPException(status_code=404, detail="Rocket not found") values = rocket_values(data, exclude_unset=True) if not values: raise HTTPException(status_code=400, detail="No fields to update") if "code" in values: await ensure_unique_code(db, values["code"], rocket_id) for key, value in values.items(): setattr(rocket, key, value) await db.commit() await db.refresh(rocket) return rocket @router.delete("/admin/{rocket_id}", status_code=status.HTTP_204_NO_CONTENT) async def delete_rocket( rocket_id: int, db: AsyncSession = Depends(get_db), _: User = Depends(require_admin), ): rocket = await db.get(RocketConfig, rocket_id) if not rocket: raise HTTPException(status_code=404, detail="Rocket not found") await db.delete(rocket) await db.commit()