cosmo/backend/app/api/rocket.py

270 lines
10 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""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(ge=0, description="本级发动机数量;一级的这里是芯级自己的台数,不含助推器")
length_ratio: float = Field(gt=0, le=1)
class RocketAppearance(BaseModel):
"""纯外观特征(可选):只登记无法从参数推导的特征件。
构型(助推器数量、各自的发动机数量与直径)一律在 boosters 里登记,
这里不重复存放,否则同一件事会有两处数值。
"""
grid_fins: bool | None = Field(default=None, description="一级顶部栅格翼(回收构型)")
fairing: bool | None = Field(default=None, description="是否有载荷整流罩;false 表示二级自身带头锥与襟翼(星舰)")
class RocketBoosters(BaseModel):
"""捆绑助推器组(可选):数量、发动机、直径比与推进参数都登记在助推器自己身上。
stage_1 自此只描述芯级,起飞推力 = stage_1.max_thrust_n + boosters.thrust_n,
不再用「一级合计减去助推器」的口径。
推进参数(推力 / 比冲 / 干重 / 推进剂)要么整体登记、要么整体留空:
留空表示该型号的助推器只登记了构型(用于绘制外形),物理仍按一级整段计算。
"""
count: int = Field(ge=1, le=8, description="助推器数量")
engine_count: int = Field(ge=1, le=33, description="每台助推器的发动机数量")
diameter_ratio: float | None = Field(
default=None, gt=0, le=1, description="助推器直径 / 芯级直径,留空按 0.45 绘制"
)
thrust_n: float | None = Field(default=None, gt=0, description="全部助推器合计推力")
specific_impulse_s: float | None = Field(default=None, gt=0, description="助推器比冲")
dry_mass_kg: float | None = Field(default=None, gt=0, description="全部助推器合计干重")
fuel_mass_kg: float | None = Field(default=None, gt=0, description="全部助推器合计推进剂")
@model_validator(mode="after")
def physics_all_or_none(self) -> "RocketBoosters":
given = [name for name in BOOSTER_PHYSICS_FIELDS if getattr(self, name) is not None]
if given and len(given) != len(BOOSTER_PHYSICS_FIELDS):
raise ValueError(
"助推器推进参数必须整体登记或整体留空(留空表示仅登记构型)"
)
return self
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()
class RocketCreate(RocketBase):
pass
BOOSTER_PHYSICS_FIELDS = ("thrust_n", "specific_impulse_s", "dry_mass_kg", "fuel_mass_kg")
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
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()