init: 初始化 dpb 桃育种系统代码库

前后端 + 后端 FastAPI 全量源码、部署脚本与文档。
This commit is contained in:
34047007@qq.com
2026-08-06 00:17:49 +08:00
commit b95053c52c
1469 changed files with 322298 additions and 0 deletions
@@ -0,0 +1,257 @@
import urllib.parse
from typing import Annotated
from fastapi import APIRouter, Body, Depends, File, Path, Query, UploadFile
from fastapi.responses import JSONResponse, StreamingResponse
from sqlalchemy.ext.asyncio import AsyncSession
from app.common.response import ResponseSchema, StreamResponse, SuccessResponse
from app.core.base_schema import AuthSchema, PageResultSchema, PaginationQueryParam, ImportResultSchema
from app.core.dependencies import AuthPermission, db_getter
from app.core.router_class import OperationLogRoute
from app.utils.common_util import bytes2file_response
from .schema import (
BreedingPlotCreateSchema,
BreedingPlotOutSchema,
BreedingPlotQueryParam,
BreedingPlotUpdateSchema,
BreedingSiteCreateSchema,
BreedingSiteOutSchema,
BreedingSiteQueryParam,
BreedingSiteUpdateSchema,
)
from .service import BreedingPlotService, BreedingSiteService
# ── 基地(site) ───────────────────────────────────────────────────────
SiteRouter = APIRouter(route_class=OperationLogRoute, prefix="/site", tags=["基地管理"])
@SiteRouter.get("/detail/{id}", summary="获取基地详情", response_model=ResponseSchema[BreedingSiteOutSchema])
async def get_site_detail_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:detail"]))],
id: Annotated[int, Path(description="基地ID")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
result_dict = await service.detail(id=id)
return SuccessResponse(data=result_dict, msg="获取基地详情成功")
@SiteRouter.get("/list", summary="分页查询基地", response_model=ResponseSchema[PageResultSchema[BreedingSiteOutSchema]])
async def get_site_list_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:query"]))],
page: Annotated[PaginationQueryParam, Depends()],
search: Annotated[BreedingSiteQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
result_dict = await service.page(
page_no=page.page_no,
page_size=page.page_size,
search=search,
order_by=page.order_by,
)
return SuccessResponse(data=result_dict, msg="查询基地列表成功")
@SiteRouter.get("/options", summary="基地下拉选项")
async def get_site_options_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:query"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
options = await service.list_options()
return SuccessResponse(data=options, msg="获取基地选项成功")
@SiteRouter.post("/create", summary="创建基地", response_model=ResponseSchema[BreedingSiteOutSchema])
async def create_site_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:create"]))],
data: Annotated[BreedingSiteCreateSchema, Body(description="创建参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
result_dict = await service.create(data=data)
return SuccessResponse(data=result_dict, msg="创建基地成功")
@SiteRouter.put("/update/{id}", summary="修改基地", response_model=ResponseSchema[BreedingSiteOutSchema])
async def update_site_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:update"]))],
id: Annotated[int, Path(description="基地ID")],
data: Annotated[BreedingSiteUpdateSchema, Body(description="修改参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
result_dict = await service.update(id=id, data=data)
return SuccessResponse(data=result_dict, msg="修改基地成功")
@SiteRouter.delete("/delete", summary="删除基地", response_model=ResponseSchema[None])
async def delete_site_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:delete"]))],
ids: Annotated[list[int], Body(description="ID列表")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
await service.delete(ids=ids)
return SuccessResponse(msg="删除基地成功")
@SiteRouter.post("/export", summary="导出基地")
async def export_site_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:export"]))],
search: Annotated[BreedingSiteQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> StreamingResponse:
service = BreedingSiteService(auth, db)
result_dict_list = await service.get_list(search=search)
export_result = BreedingSiteService.batch_export(obj_list=[item.model_dump() for item in result_dict_list])
return StreamResponse(
data=bytes2file_response(export_result),
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
headers={"Content-Disposition": f"attachment; filename={urllib.parse.quote('基地管理.xlsx')}"},
)
@SiteRouter.post("/import", summary="导入基地", response_model=ResponseSchema[ImportResultSchema])
async def import_site_controller(
file: Annotated[UploadFile, File(description="导入文件")],
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:site:import"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingSiteService(auth, db)
batch_import_result = await service.batch_import(file=file, update_support=True)
return SuccessResponse(data=batch_import_result, msg="导入基地成功")
@SiteRouter.post("/download/template", summary="获取基地导入模板", dependencies=[Depends(AuthPermission(["module_bre:site:download"]))])
async def download_site_template_controller() -> StreamingResponse:
import_template_result = BreedingSiteService.import_template_download()
return StreamResponse(
data=bytes2file_response(import_template_result),
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
headers={
"Content-Disposition": f"attachment; filename={urllib.parse.quote('基地管理导入模板.xlsx')}",
"Access-Control-Expose-Headers": "Content-Disposition",
},
)
# ── 试验地(plot) ──────────────────────────────────────────────────────
PlotRouter = APIRouter(route_class=OperationLogRoute, prefix="/plot", tags=["试验地管理"])
@PlotRouter.get("/detail/{id}", summary="获取试验地详情", response_model=ResponseSchema[BreedingPlotOutSchema])
async def get_plot_detail_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:detail"]))],
id: Annotated[int, Path(description="试验地ID")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
result_dict = await service.detail(id=id)
return SuccessResponse(data=result_dict, msg="获取试验地详情成功")
@PlotRouter.get("/list", summary="分页查询试验地", response_model=ResponseSchema[PageResultSchema[BreedingPlotOutSchema]])
async def get_plot_list_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:query"]))],
page: Annotated[PaginationQueryParam, Depends()],
search: Annotated[BreedingPlotQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
result_dict = await service.page(
page_no=page.page_no,
page_size=page.page_size,
search=search,
order_by=page.order_by,
)
return SuccessResponse(data=result_dict, msg="查询试验地列表成功")
@PlotRouter.post("/create", summary="创建试验地", response_model=ResponseSchema[BreedingPlotOutSchema])
async def create_plot_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:create"]))],
data: Annotated[BreedingPlotCreateSchema, Body(description="创建参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
result_dict = await service.create(data=data)
return SuccessResponse(data=result_dict, msg="创建试验地成功")
@PlotRouter.put("/update/{id}", summary="修改试验地", response_model=ResponseSchema[BreedingPlotOutSchema])
async def update_plot_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:update"]))],
id: Annotated[int, Path(description="试验地ID")],
data: Annotated[BreedingPlotUpdateSchema, Body(description="修改参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
result_dict = await service.update(id=id, data=data)
return SuccessResponse(data=result_dict, msg="修改试验地成功")
@PlotRouter.delete("/delete", summary="删除试验地", response_model=ResponseSchema[None])
async def delete_plot_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:delete"]))],
ids: Annotated[list[int], Body(description="ID列表")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
await service.delete(ids=ids)
return SuccessResponse(msg="删除试验地成功")
@PlotRouter.post("/export", summary="导出试验地")
async def export_plot_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:export"]))],
search: Annotated[BreedingPlotQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> StreamingResponse:
service = BreedingPlotService(auth, db)
result_dict_list = await service.get_list(search=search)
export_result = BreedingPlotService.batch_export(obj_list=[item.model_dump() for item in result_dict_list])
return StreamResponse(
data=bytes2file_response(export_result),
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
headers={"Content-Disposition": f"attachment; filename={urllib.parse.quote('试验地管理.xlsx')}"},
)
@PlotRouter.post("/import", summary="导入试验地", response_model=ResponseSchema[ImportResultSchema])
async def import_plot_controller(
file: Annotated[UploadFile, File(description="导入文件")],
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:import"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
batch_import_result = await service.batch_import(file=file, update_support=True)
return SuccessResponse(data=batch_import_result, msg="导入试验地成功")
@PlotRouter.post("/download/template", summary="获取试验地导入模板", dependencies=[Depends(AuthPermission(["module_bre:plot:download"]))])
async def download_plot_template_controller() -> StreamResponse:
import_template_result = BreedingPlotService.import_template_download()
return StreamResponse(
data=bytes2file_response(import_template_result),
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
headers={
"Content-Disposition": f"attachment; filename={urllib.parse.quote('试验地管理导入模板.xlsx')}",
"Access-Control-Expose-Headers": "Content-Disposition",
},
)
@PlotRouter.get("/options", summary="试验地下拉选项")
async def get_plot_options_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:plot:query"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = BreedingPlotService(auth, db)
options = await service.list_options()
return SuccessResponse(data=options, msg="获取试验地选项成功")
@@ -0,0 +1,26 @@
from typing import Any
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.base_crud import CRUDBase
from app.core.base_schema import AuthSchema
from .model import BreedingPlotModel, BreedingSiteModel
class BreedingSiteCRUD(CRUDBase[BreedingSiteModel, Any, Any]):
"""基地 CRUD —— 直接复用 CRUDBase(已自动注入数据权限过滤)。"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
super().__init__(BreedingSiteModel, auth, db)
class BreedingPlotCRUD(CRUDBase[BreedingPlotModel, Any, Any]):
"""试验地 CRUD —— 直接复用 CRUDBase(已自动注入数据权限过滤)。"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
super().__init__(BreedingPlotModel, auth, db)
site_crud = BreedingSiteCRUD
plot_crud = BreedingPlotCRUD
@@ -0,0 +1,73 @@
"""基地与试验地管理 —— 数据模型
两张无 `status` 列的域表,必须显式覆盖 `__table_args__`
只保留 `created_time` / `is_deleted` 索引(框架基类默认会加
`ix_<表>_status` 索引,但本表无 status 列,不覆盖会建表失败)。
"""
from datetime import datetime
from sqlalchemy import Float, ForeignKey, Index, Integer, String, Text, text
from sqlalchemy.orm import Mapped, mapped_column
from app.core.base_model import MappedBase, ModelMixin, UserMixin
class BreedingSiteModel(ModelMixin, UserMixin, MappedBase):
"""育种基地(试验站)主数据表。"""
__tablename__ = "bre_site"
site_name: Mapped[str] = mapped_column(
String(100), nullable=False, unique=True, comment="基地名称"
)
address: Mapped[str | None] = mapped_column(String(255), nullable=True, comment="详细地址")
area: Mapped[float | None] = mapped_column(Float, nullable=True, comment="基地面积(亩)")
longitude: Mapped[float | None] = mapped_column(Float, nullable=True, comment="经度")
latitude: Mapped[float | None] = mapped_column(Float, nullable=True, comment="纬度")
eco_type: Mapped[str | None] = mapped_column(
String(50), nullable=True, comment="生态区类型(如 华北/西北/华东/西南/东北/华南)"
)
soil_type: Mapped[str | None] = mapped_column(String(50), nullable=True, comment="土壤类型", default=None)
elevation: Mapped[int | None] = mapped_column(Integer, nullable=True, comment="海拔(m)", default=None)
remark: Mapped[str | None] = mapped_column(Text, nullable=True, comment="备注")
# 注:created_time / is_deleted 已由 ModelMixin 的 index=True 自动建索引
# (ix_bre_site_created_time / ix_bre_site_is_deleted),此处仅补一个
# 复合索引用于数据权限过滤,且必须覆盖基类默认会建的 ix_<表>_status_deleted
# (本表无 status 列,不覆盖会引用不存在的列而建表失败)。
__table_args__ = (
Index("ix_bre_site_created_deleted", "created_time", "is_deleted"),
)
class BreedingPlotModel(ModelMixin, UserMixin, MappedBase):
"""试验地块 —— 隶属于某个基地。"""
__tablename__ = "bre_plot"
site_id: Mapped[int] = mapped_column(
Integer,
ForeignKey("bre_site.id", ondelete="CASCADE"),
nullable=False,
index=True,
comment="所属基地ID",
)
plot_code: Mapped[str] = mapped_column(
String(50), nullable=False, comment="地块编号/名称"
)
row_orientation: Mapped[str | None] = mapped_column(
String(20), nullable=True, comment="行向(南北行/东西行)"
)
row_count: Mapped[int | None] = mapped_column(Integer, nullable=True, comment="行数")
col_count: Mapped[int | None] = mapped_column(Integer, nullable=True, comment="每行株数")
grid_note: Mapped[str | None] = mapped_column(Text, nullable=True, comment="株行距/网格说明")
area: Mapped[float | None] = mapped_column(Float, nullable=True, comment="地块面积(亩)")
__table_args__ = (
Index("ix_bre_plot_created_deleted", "created_time", "is_deleted"),
# 基地内地块编号唯一(仅约束未软删记录,与 service 层查重语义一致)
Index(
"uniq_bre_plot_site_code", "site_id", "plot_code",
unique=True, postgresql_where=text("is_deleted = false"),
),
)
@@ -0,0 +1,99 @@
from app.core.base_schema import CommonSchema
"""基地与试验地管理 —— Pydantic 校验/序列化模型。"""
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
# ── 基地(site) ───────────────────────────────────────────────────────
class BreedingSiteBaseSchema(BaseModel):
model_config = ConfigDict(from_attributes=True)
site_name: str = Field(..., description="基地名称")
address: str | None = Field(default=None, description="详细地址")
area: float | None = Field(default=None, description="基地面积(亩)")
longitude: float | None = Field(default=None, description="经度")
latitude: float | None = Field(default=None, description="纬度")
eco_type: str | None = Field(default=None, description="生态区类型")
soil_type: str | None = Field(default=None, description="土壤类型")
elevation: int | None = Field(default=None, description="海拔(m)")
remark: str | None = Field(default=None, description="备注")
class BreedingSiteCreateSchema(BreedingSiteBaseSchema):
pass
class BreedingSiteUpdateSchema(BreedingSiteBaseSchema):
site_name: str | None = Field(default=None, description="基地名称")
address: str | None = Field(default=None, description="详细地址")
area: float | None = Field(default=None, description="基地面积(亩)")
longitude: float | None = Field(default=None, description="经度")
latitude: float | None = Field(default=None, description="纬度")
eco_type: str | None = Field(default=None, description="生态区类型")
soil_type: str | None = Field(default=None, description="土壤类型")
elevation: int | None = Field(default=None, description="海拔(m)")
remark: str | None = Field(default=None, description="备注")
class BreedingSiteOutSchema(BreedingSiteBaseSchema):
id: int
uuid: str
created_time: datetime | None = None
updated_time: datetime | None = None
created_by: CommonSchema | None = None
updated_by: CommonSchema | None = None
class BreedingSiteQueryParam(BaseModel):
site_name: str | None = Field(default=None, description="基地名称(模糊查询)", json_schema_extra={"q": "like"})
eco_type: str | None = Field(default=None, description="生态区类型", json_schema_extra={"q": "eq"})
soil_type: str | None = Field(default=None, description="土壤类型", json_schema_extra={"q": "eq"})
# ── 试验地(plot) ──────────────────────────────────────────────────────
class BreedingPlotBaseSchema(BaseModel):
model_config = ConfigDict(from_attributes=True)
site_id: int = Field(..., description="所属基地ID")
plot_code: str = Field(..., description="地块编号/名称")
row_orientation: str | None = Field(default=None, description="行向(南北行/东西行)")
row_count: int | None = Field(default=None, description="行数")
col_count: int | None = Field(default=None, description="每行株数")
grid_note: str | None = Field(default=None, description="株行距/网格说明")
area: float | None = Field(default=None, description="地块面积(亩)")
class BreedingPlotCreateSchema(BreedingPlotBaseSchema):
pass
class BreedingPlotUpdateSchema(BreedingPlotBaseSchema):
site_id: int | None = Field(default=None, description="所属基地ID")
plot_code: str | None = Field(default=None, description="地块编号/名称")
row_orientation: str | None = Field(default=None, description="行向(南北行/东西行)")
row_count: int | None = Field(default=None, description="行数")
col_count: int | None = Field(default=None, description="每行株数")
grid_note: str | None = Field(default=None, description="株行距/网格说明")
area: float | None = Field(default=None, description="地块面积(亩)")
class BreedingPlotOutSchema(BreedingPlotBaseSchema):
id: int
uuid: str
site_name: str | None = None # 由 Service 层联表填充
created_time: datetime | None = None
updated_time: datetime | None = None
created_by: CommonSchema | None = None
updated_by: CommonSchema | None = None
class BreedingPlotQueryParam(BaseModel):
site_id: int | None = Field(default=None, description="所属基地ID", json_schema_extra={"q": "eq"})
plot_code: str | None = Field(default=None, description="地块编号(模糊查询)", json_schema_extra={"q": "like"})
row_orientation: str | None = Field(default=None, description="行向", json_schema_extra={"q": "eq"})
@@ -0,0 +1,556 @@
from typing import Any
from fastapi import UploadFile
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.base_schema import AuthSchema, PageResultSchema, ImportResultSchema
from app.core.exceptions import CustomException
from app.core.logger import logger
from app.utils.common_util import search_to_dict
from app.utils.excel_util import ExcelUtil
from app.utils.dict_util import DictLabelResolver, dict_value_to_label
from app.core.base_crud import assert_dict_values, assert_no_children
from app.api.v1.module_bre.planting.model import PlantingModel
from app.api.v1.module_bre.pollination.model import PollinationModel
from app.api.v1.module_bre.tree.model import TreeModel
from app.api.v1.module_bre.trial_study.model import TrialStudyModel
from .crud import BreedingPlotCRUD, BreedingSiteCRUD
from .schema import (
BreedingPlotCreateSchema,
BreedingPlotOutSchema,
BreedingPlotQueryParam,
BreedingPlotUpdateSchema,
BreedingSiteCreateSchema,
BreedingSiteOutSchema,
BreedingSiteQueryParam,
BreedingSiteUpdateSchema,
)
def _is_blank(v: Any) -> bool:
return v is None or (isinstance(v, str) and v.strip() == "")
def _none_if_blank(v: Any) -> Any:
if _is_blank(v):
return None
return str(v).strip() if isinstance(v, str) else v
def _to_float(v: Any) -> float | None:
if _is_blank(v):
return None
try:
return float(v)
except (TypeError, ValueError):
return None
# ── 基地(site) ───────────────────────────────────────────────────────
class BreedingSiteService:
"""基地管理模块服务层"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
self.auth = auth
self.db = db
async def detail(self, id: int) -> BreedingSiteOutSchema:
obj = await BreedingSiteCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="该基地不存在")
return BreedingSiteOutSchema.model_validate(obj)
async def get_list(
self,
search: BreedingSiteQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> list[BreedingSiteOutSchema]:
obj_list = await BreedingSiteCRUD(self.auth, self.db).get_list(
search=search_to_dict(search), order_by=order_by
)
return [BreedingSiteOutSchema.model_validate(obj) for obj in obj_list]
async def page(
self,
page_no: int,
page_size: int,
search: BreedingSiteQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> PageResultSchema[BreedingSiteOutSchema]:
offset = (page_no - 1) * page_size
return await BreedingSiteCRUD(self.auth, self.db).page(
offset=offset,
limit=page_size,
order_by=order_by or [{"id": "asc"}],
search=search_to_dict(search, {}),
out_schema=BreedingSiteOutSchema,
)
async def create(self, data: BreedingSiteCreateSchema) -> BreedingSiteOutSchema:
exist_obj = await BreedingSiteCRUD(self.auth, self.db).get(site_name=data.site_name)
if exist_obj:
raise CustomException(msg="创建失败,基地名称已存在")
await assert_dict_values(
self.db,
[
('eco_type', data.eco_type, '生态区类型'),
],
)
obj = await BreedingSiteCRUD(self.auth, self.db).create(data=data)
return BreedingSiteOutSchema.model_validate(obj)
async def update(self, id: int, data: BreedingSiteUpdateSchema) -> BreedingSiteOutSchema:
obj = await BreedingSiteCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="更新失败,该基地不存在")
if data.site_name is not None:
exist_obj = await BreedingSiteCRUD(self.auth, self.db).get(site_name=data.site_name)
if exist_obj and exist_obj.id != id:
raise CustomException(msg="更新失败,基地名称重复")
await assert_dict_values(
self.db,
[
('eco_type', data.eco_type, '生态区类型'),
],
)
obj = await BreedingSiteCRUD(self.auth, self.db).update(id=id, data=data)
return BreedingSiteOutSchema.model_validate(obj)
async def delete(self, ids: list[int]) -> None:
if not ids:
raise CustomException(msg="删除失败,删除对象不能为空")
objs = await BreedingSiteCRUD(self.auth, self.db).get_list(search={"id": ("in", ids)})
obj_map = {o.id: o for o in objs}
for id_ in ids:
if id_ not in obj_map:
raise CustomException(msg="删除失败,该基地不存在")
# 软删除基地前,先校验是否存在关联地块,避免产生孤儿数据
for id_ in ids:
plot = await BreedingPlotCRUD(self.auth, self.db).get(site_id=id_)
if plot:
raise CustomException(msg="删除失败,请先删除该基地下的所有试验地块")
await assert_no_children(
self.db,
ids,
[(TrialStudyModel, "site_id", "试验执行")],
)
await BreedingSiteCRUD(self.auth, self.db).delete(ids=ids)
async def list_options(self) -> list[dict[str, Any]]:
"""供前端下拉选择使用:返回 [{value, label}]。"""
obj_list = await BreedingSiteCRUD(self.auth, self.db).get_list(
order_by=[{"id": "asc"}]
)
return [{"value": o.id, "label": o.site_name} for o in obj_list]
@staticmethod
def batch_export(obj_list: list[dict[str, Any]]) -> bytes:
mapping_dict = {
"id": "编号",
"site_name": "基地名称",
"address": "详细地址",
"area": "基地面积(亩)",
"longitude": "经度",
"latitude": "纬度",
"eco_type": "生态区类型",
"soil_type": "土壤类型",
"elevation": "海拔(m)",
"remark": "备注",
"created_time": "创建时间",
"created_by": "创建者",
}
data = [dict(item) for item in obj_list]
for item in data:
creator = item.get("created_by")
item["created_by"] = creator.get("name", "未知") if isinstance(creator, dict) else "未知"
item["eco_type"] = dict_value_to_label("eco_type", item.get("eco_type"))
return ExcelUtil.export_list2excel(list_data=data, mapping_dict=mapping_dict)
async def batch_import(self, file: UploadFile, update_support: bool = False) -> ImportResultSchema:
header_dict = {
"基地名称": "site_name",
"详细地址": "address",
"基地面积(亩)": "area",
"经度": "longitude",
"纬度": "latitude",
"生态区类型": "eco_type",
"土壤类型": "soil_type",
"海拔(m)": "elevation",
"备注": "remark",
}
try:
contents = await file.read()
rows = ExcelUtil.read_excel_to_dicts(contents)
await file.close()
if not rows:
raise CustomException(msg="导入文件为空")
missing_headers = [h for h in header_dict if h not in rows[0]]
if missing_headers:
raise CustomException(msg=f"导入文件缺少必要的列: {', '.join(missing_headers)}")
mapped_rows = []
for row in rows:
mapped_rows.append({en: row.get(ch) for ch, en in header_dict.items()})
required_fields = ["site_name"]
errors = []
for field in required_fields:
missing_indices = [i + 1 for i, r in enumerate(mapped_rows) if _is_blank(r.get(field))]
if missing_indices:
field_name = next(k for k, v in header_dict.items() if v == field)
rows_str = "".join(str(i) for i in missing_indices)
errors.append(f"{field_name}不能为空,第{rows_str}")
if errors:
raise CustomException(msg=f"导入失败,以下行缺少必要字段:\n{'; '.join(errors)}")
error_msgs: list[str] = []
success_count = 0
crud = BreedingSiteCRUD(self.auth, self.db)
resolver = DictLabelResolver(self.auth, self.db, ["eco_type"])
for i, row in enumerate(mapped_rows, start=1):
try:
fields = {
"site_name": str(row["site_name"]).strip(),
"address": _none_if_blank(row.get("address")),
"area": _to_float(row.get("area")),
"longitude": _to_float(row.get("longitude")),
"latitude": _to_float(row.get("latitude")),
"eco_type": await resolver.resolve("eco_type", row.get("eco_type")),
"soil_type": _none_if_blank(row.get("soil_type")),
"elevation": _to_int(row.get("elevation")),
"remark": _none_if_blank(row.get("remark")),
}
create_data = BreedingSiteCreateSchema(**fields)
exist_obj = await crud.get(site_name=create_data.site_name)
if exist_obj:
if update_support:
await crud.update(id=exist_obj.id, data=BreedingSiteUpdateSchema(**fields))
success_count += 1
else:
error_msgs.append(f"{i}行: 基地名称 {create_data.site_name} 已存在")
else:
await crud.create(data=create_data)
success_count += 1
except Exception as e:
error_msgs.append(f"{i}行: {e!s}")
continue
return ImportResultSchema(
valid_count=success_count,
invalid_count=len(error_msgs),
message_list=error_msgs,
)
except Exception as e:
logger.error(f"批量导入基地失败: {e!s}")
raise CustomException(msg=f"导入失败: {e!s}")
@staticmethod
def import_template_download() -> bytes:
header_list = [
"基地名称",
"详细地址",
"基地面积(亩)",
"经度",
"纬度",
"生态区类型",
"土壤类型",
"海拔(m)",
"备注",
]
selector_header_list: list[str] = []
option_list: list[dict[str, list[str]]] = []
return ExcelUtil.get_excel_template(
header_list=header_list,
selector_header_list=selector_header_list,
option_list=option_list,
)
# ── 试验地(plot) ──────────────────────────────────────────────────────
class BreedingPlotService:
"""试验地管理模块服务层"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
self.auth = auth
self.db = db
async def _attach_site_name(self, items: list[BreedingPlotOutSchema]) -> None:
"""批量填充 site_name(按 site_id 关联基地名称)。"""
site_ids = {item.site_id for item in items if item.site_id}
if not site_ids:
return
sites = await BreedingSiteCRUD(self.auth, self.db).get_list(
search={"id": ("in", list(site_ids))}
)
site_map = {s.id: s.site_name for s in sites}
for item in items:
item.site_name = site_map.get(item.site_id)
async def detail(self, id: int) -> BreedingPlotOutSchema:
obj = await BreedingPlotCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="该试验地块不存在")
out = BreedingPlotOutSchema.model_validate(obj)
await self._attach_site_name([out])
return out
async def get_list(
self,
search: BreedingPlotQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> list[BreedingPlotOutSchema]:
obj_list = await BreedingPlotCRUD(self.auth, self.db).get_list(
search=search_to_dict(search), order_by=order_by
)
outs = [BreedingPlotOutSchema.model_validate(obj) for obj in obj_list]
await self._attach_site_name(outs)
return outs
async def page(
self,
page_no: int,
page_size: int,
search: BreedingPlotQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> PageResultSchema[BreedingPlotOutSchema]:
offset = (page_no - 1) * page_size
result = await BreedingPlotCRUD(self.auth, self.db).page(
offset=offset,
limit=page_size,
order_by=order_by or [{"id": "asc"}],
search=search_to_dict(search, {}),
out_schema=BreedingPlotOutSchema,
)
await self._attach_site_name(result.items)
return result
async def create(self, data: BreedingPlotCreateSchema) -> BreedingPlotOutSchema:
site = await BreedingSiteCRUD(self.auth, self.db).get(id=data.site_id)
if not site:
raise CustomException(msg="创建失败,所属基地不存在")
exist_obj = await BreedingPlotCRUD(self.auth, self.db).get(
site_id=data.site_id, plot_code=data.plot_code
)
if exist_obj:
raise CustomException(msg="创建失败,该基地下地块编号已存在")
await assert_dict_values(
self.db,
[
('row_orientation', data.row_orientation, '行向'),
],
)
obj = await BreedingPlotCRUD(self.auth, self.db).create(data=data)
out = BreedingPlotOutSchema.model_validate(obj)
out.site_name = site.site_name
return out
async def update(self, id: int, data: BreedingPlotUpdateSchema) -> BreedingPlotOutSchema:
obj = await BreedingPlotCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="更新失败,该试验地块不存在")
site_id = data.site_id if data.site_id is not None else obj.site_id
# 跨基地迁移:目标基地必须存在,且地块已有业务数据(单株/授粉/定植)时禁止迁移
if site_id != obj.site_id:
site = await BreedingSiteCRUD(self.auth, self.db).get(id=site_id)
if not site:
raise CustomException(msg="更新失败,目标基地不存在")
await assert_no_children(
self.db,
[id],
[
(TreeModel, "plot_id", "单株"),
(PollinationModel, "plot_id", "授粉"),
(PlantingModel, "plot_id", "定植"),
],
)
# (目标基地, 地块编号) 唯一校验:只改基地不改编号时同样要查重
effective_plot_code = data.plot_code if data.plot_code is not None else obj.plot_code
exist_obj = await BreedingPlotCRUD(self.auth, self.db).get(
site_id=site_id, plot_code=effective_plot_code
)
if exist_obj and exist_obj.id != id:
raise CustomException(msg="更新失败,该基地下地块编号重复")
await assert_dict_values(
self.db,
[
('row_orientation', data.row_orientation, '行向'),
],
)
obj = await BreedingPlotCRUD(self.auth, self.db).update(id=id, data=data)
out = BreedingPlotOutSchema.model_validate(obj)
site = await BreedingSiteCRUD(self.auth, self.db).get(id=out.site_id)
out.site_name = site.site_name if site else None
return out
async def delete(self, ids: list[int]) -> None:
if not ids:
raise CustomException(msg="删除失败,删除对象不能为空")
objs = await BreedingPlotCRUD(self.auth, self.db).get_list(search={"id": ("in", ids)})
obj_map = {o.id: o for o in objs}
for id_ in ids:
if id_ not in obj_map:
raise CustomException(msg="删除失败,该试验地块不存在")
await assert_no_children(
self.db,
ids,
[
(TreeModel, "plot_id", "单株"),
(PollinationModel, "plot_id", "授粉"),
(PlantingModel, "plot_id", "定植"),
],
)
await BreedingPlotCRUD(self.auth, self.db).delete(ids=ids)
async def list_options(self) -> list[dict[str, Any]]:
"""供前端下拉选择使用:返回 [{value, label}]。"""
obj_list = await BreedingPlotCRUD(self.auth, self.db).get_list(
order_by=[{"id": "asc"}]
)
outs = [BreedingPlotOutSchema.model_validate(o) for o in obj_list]
await self._attach_site_name(outs)
return [{"value": o.id, "label": f"{o.site_name or ''}-{o.plot_code}"} for o in outs]
@staticmethod
def batch_export(obj_list: list[dict[str, Any]]) -> bytes:
mapping_dict = {
"id": "编号",
"site_name": "所属基地",
"plot_code": "地块编号/名称",
"row_orientation": "行向",
"row_count": "行数",
"col_count": "每行株数",
"grid_note": "株行距/网格说明",
"area": "地块面积(亩)",
"created_time": "创建时间",
"created_by": "创建者",
}
data = [dict(item) for item in obj_list]
for item in data:
creator = item.get("created_by")
item["created_by"] = creator.get("name", "未知") if isinstance(creator, dict) else "未知"
item["row_orientation"] = dict_value_to_label("row_orientation", item.get("row_orientation"))
return ExcelUtil.export_list2excel(list_data=data, mapping_dict=mapping_dict)
async def batch_import(self, file: UploadFile, update_support: bool = False) -> ImportResultSchema:
header_dict = {
"所属基地": "site_name",
"地块编号/名称": "plot_code",
"行向": "row_orientation",
"行数": "row_count",
"每行株数": "col_count",
"株行距/网格说明": "grid_note",
"地块面积(亩)": "area",
}
try:
contents = await file.read()
rows = ExcelUtil.read_excel_to_dicts(contents)
await file.close()
if not rows:
raise CustomException(msg="导入文件为空")
missing_headers = [h for h in header_dict if h not in rows[0]]
if missing_headers:
raise CustomException(msg=f"导入文件缺少必要的列: {', '.join(missing_headers)}")
# 预加载基地名称→ID映射,供导入转换 site_name → site_id
sites = await BreedingSiteCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
site_name_to_id = {s.site_name: s.id for s in sites}
mapped_rows = []
for row in rows:
mapped_rows.append({en: row.get(ch) for ch, en in header_dict.items()})
required_fields = ["site_name", "plot_code"]
errors = []
for field in required_fields:
missing_indices = [i + 1 for i, r in enumerate(mapped_rows) if _is_blank(r.get(field))]
if missing_indices:
field_name = next(k for k, v in header_dict.items() if v == field)
rows_str = "".join(str(i) for i in missing_indices)
errors.append(f"{field_name}不能为空,第{rows_str}")
if errors:
raise CustomException(msg=f"导入失败,以下行缺少必要字段:\n{'; '.join(errors)}")
error_msgs: list[str] = []
success_count = 0
crud = BreedingPlotCRUD(self.auth, self.db)
resolver = DictLabelResolver(self.auth, self.db, ["row_orientation"])
for i, row in enumerate(mapped_rows, start=1):
try:
site_name = str(row["site_name"]).strip()
if site_name not in site_name_to_id:
error_msgs.append(f"{i}行: 基地名称 {site_name} 不存在")
continue
fields = {
"site_id": site_name_to_id[site_name],
"plot_code": str(row["plot_code"]).strip(),
"row_orientation": await resolver.resolve("row_orientation", row.get("row_orientation")),
"row_count": _to_int(row.get("row_count")),
"col_count": _to_int(row.get("col_count")),
"grid_note": _none_if_blank(row.get("grid_note")),
"area": _to_float(row.get("area")),
}
create_data = BreedingPlotCreateSchema(**fields)
exist_obj = await crud.get(site_id=create_data.site_id, plot_code=create_data.plot_code)
if exist_obj:
if update_support:
await crud.update(id=exist_obj.id, data=BreedingPlotUpdateSchema(**fields))
success_count += 1
else:
error_msgs.append(f"{i}行: 基地 {site_name} 下地块 {create_data.plot_code} 已存在")
else:
await crud.create(data=create_data)
success_count += 1
except Exception as e:
error_msgs.append(f"{i}行: {e!s}")
continue
return ImportResultSchema(
valid_count=success_count,
invalid_count=len(error_msgs),
message_list=error_msgs,
)
except Exception as e:
logger.error(f"批量导入试验地块失败: {e!s}")
raise CustomException(msg=f"导入失败: {e!s}")
@staticmethod
def import_template_download() -> bytes:
header_list = [
"所属基地",
"地块编号/名称",
"行向",
"行数",
"每行株数",
"株行距/网格说明",
"地块面积(亩)",
]
selector_header_list = ["行向"]
option_list = [{"行向": ["南北行", "东西行"]}]
return ExcelUtil.get_excel_template(
header_list=header_list,
selector_header_list=selector_header_list,
option_list=option_list,
)
def _to_int(v: Any) -> int | None:
if _is_blank(v):
return None
try:
return int(float(v))
except (TypeError, ValueError):
return None