280 lines
11 KiB
Python
280 lines
11 KiB
Python
"""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()
|