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,135 @@
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 (
TreePhotoCreateSchema,
TreePhotoOutSchema,
TreePhotoQueryParam,
TreePhotoUpdateSchema,
)
from .service import TreePhotoService
TreePhotoRouter = APIRouter(route_class=OperationLogRoute, prefix="/tree_photo", tags=["单株照片"])
@TreePhotoRouter.get("/detail/{id}", summary="获取单株照片详情", response_model=ResponseSchema[TreePhotoOutSchema])
async def get_tree_photo__detail_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:detail"]))],
id: Annotated[int, Path(description="单株照片ID")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
result_dict = await service.detail(id=id)
return SuccessResponse(data=result_dict, msg="获取单株照片详情成功")
@TreePhotoRouter.get("/list", summary="分页查询单株照片", response_model=ResponseSchema[PageResultSchema[TreePhotoOutSchema]])
async def get_tree_photo__list_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:query"]))],
page: Annotated[PaginationQueryParam, Depends()],
search: Annotated[TreePhotoQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(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="查询单株照片列表成功")
@TreePhotoRouter.get("/options", summary="单株照片下拉选项")
async def get_tree_photo__options_controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:query"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
options = await service.list_options()
return SuccessResponse(data=options, msg="获取单株照片选项成功")
@TreePhotoRouter.post("/create", summary="创建单株照片", response_model=ResponseSchema[TreePhotoOutSchema])
async def create_tree_photo__controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:create"]))],
data: Annotated[TreePhotoCreateSchema, Body(description="创建参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
result_dict = await service.create(data=data)
return SuccessResponse(data=result_dict, msg="创建单株照片成功")
@TreePhotoRouter.put("/update/{id}", summary="修改单株照片", response_model=ResponseSchema[TreePhotoOutSchema])
async def update_tree_photo__controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:update"]))],
id: Annotated[int, Path(description="单株照片ID")],
data: Annotated[TreePhotoUpdateSchema, Body(description="修改参数")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
result_dict = await service.update(id=id, data=data)
return SuccessResponse(data=result_dict, msg="修改单株照片成功")
@TreePhotoRouter.delete("/delete", summary="删除单株照片", response_model=ResponseSchema[None])
async def delete_tree_photo__controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:delete"]))],
ids: Annotated[list[int], Body(description="ID列表")],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
await service.delete(ids=ids)
return SuccessResponse(msg="删除单株照片成功")
@TreePhotoRouter.post("/export", summary="导出单株照片")
async def export_tree_photo__controller(
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:export"]))],
search: Annotated[TreePhotoQueryParam, Query()],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> StreamingResponse:
service = TreePhotoService(auth, db)
result_dict_list = await service.get_list(search=search)
export_result = TreePhotoService.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')}"},
)
@TreePhotoRouter.post("/import", summary="导入单株照片", response_model=ResponseSchema[ImportResultSchema])
async def import_tree_photo__controller(
file: Annotated[UploadFile, File(description="导入文件")],
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:tree_photo:import"]))],
db: Annotated[AsyncSession, Depends(db_getter)],
) -> JSONResponse:
service = TreePhotoService(auth, db)
batch_import_result = await service.batch_import(file=file, update_support=True)
return SuccessResponse(data=batch_import_result, msg="导入单株照片成功")
@TreePhotoRouter.post("/download/template", summary="获取单株照片导入模板", dependencies=[Depends(AuthPermission(["module_bre:tree_photo:download"]))])
async def download_tree_photo__template_controller() -> StreamingResponse:
import_template_result = TreePhotoService.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",
},
)
@@ -0,0 +1,18 @@
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 TreePhotoModel
class BreedingTreePhotoCRUD(CRUDBase[TreePhotoModel, Any, Any]):
"""单株照片 CRUD —— 直接复用 CRUDBase(已自动注入数据权限过滤)。"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
super().__init__(TreePhotoModel, auth, db)
tree_photo_crud = BreedingTreePhotoCRUD
@@ -0,0 +1,44 @@
"""单株照片 数据模型"""
from datetime import datetime
from sqlalchemy import Float, ForeignKey, Index, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column
from app.core.base_model import MappedBase, ModelMixin, UserMixin
class TreePhotoModel(ModelMixin, UserMixin, MappedBase):
"""单株照片 主数据表。"""
__tablename__ = "bre_tree_photo"
combination_id: Mapped[int] = mapped_column(
Integer, ForeignKey("bre_cross_combination.id", ondelete="CASCADE"),
index=True, nullable=False, comment="杂交组合"
)
tree_id: Mapped[int] = mapped_column(
Integer, ForeignKey("bre_tree.id", ondelete="CASCADE"),
index=True, nullable=True, comment="单株"
)
evaluation_id: Mapped[int] = mapped_column(
Integer, ForeignKey("bre_tree_evaluation.id", ondelete="CASCADE"),
index=True, nullable=True, comment="所属鉴定"
)
category: Mapped[str | None] = mapped_column(String(50), nullable=True, comment="所属标签页", default=None)
photo_type: Mapped[str | None] = mapped_column(String(50), nullable=True, comment="照片类型", default=None)
photo_url: Mapped[str | None] = mapped_column(String(100), nullable=True, comment="照片路径/URL", default=None)
capture_date: Mapped[str | None] = mapped_column(String(20), nullable=True, comment="拍摄日期", default=None)
remark: Mapped[str | None] = mapped_column(Text, nullable=True, comment="备注", default=None)
# 无 status 列:覆盖基类默认 ix_<表>_status_deleted 索引,
# 仅保留 (created_time, is_deleted) 复合索引用于数据权限过滤。
__table_args__ = (
Index("ix_bre_tree_photo_created_deleted", "created_time", "is_deleted"),
)
@@ -0,0 +1,59 @@
from app.core.base_schema import CommonSchema
"""单株照片 —— Pydantic 校验/序列化模型。"""
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
class TreePhotoBaseSchema(BaseModel):
model_config = ConfigDict(from_attributes=True)
combination_id: int = Field(..., description="杂交组合")
tree_id: int | None = Field(default=None, description="单株")
evaluation_id: int | None = Field(default=None, description="所属鉴定")
category: str | None = Field(default=None, description="所属标签页")
photo_type: str | None = Field(default=None, description="照片类型")
photo_url: str | None = Field(default=None, description="照片路径/URL")
capture_date: str | None = Field(default=None, description="拍摄日期")
remark: str | None = Field(default=None, description="备注")
class TreePhotoCreateSchema(TreePhotoBaseSchema):
pass
class TreePhotoUpdateSchema(TreePhotoBaseSchema):
combination_id: int | None = Field(default=None, description="杂交组合")
tree_id: int | None = Field(default=None, description="单株")
evaluation_id: int | None = Field(default=None, description="所属鉴定")
category: str | None = Field(default=None, description="所属标签页")
photo_type: str | None = Field(default=None, description="照片类型")
photo_url: str | None = Field(default=None, description="照片路径/URL")
capture_date: str | None = Field(default=None, description="拍摄日期")
remark: str | None = Field(default=None, description="备注")
class TreePhotoOutSchema(TreePhotoBaseSchema):
id: int
uuid: str
combination_name: str | None = None # 由 Service 层联表填充
tree_name: str | None = None # 由 Service 层联表填充
evaluation_name: str | None = None # 由 Service 层联表填充
category: str | None = None
photo_type: str | None = None
photo_url: str | None = None
capture_date: str | None = None
remark: str | None = None
created_time: datetime | None = None
updated_time: datetime | None = None
created_by: CommonSchema | None = None
updated_by: CommonSchema | None = None
class TreePhotoQueryParam(BaseModel):
combination_id: int | None = Field(default=None, description="杂交组合", json_schema_extra={"q": "eq"})
tree_id: int | None = Field(default=None, description="单株", json_schema_extra={"q": "eq"})
evaluation_id: int | None = Field(default=None, description="所属鉴定", json_schema_extra={"q": "eq"})
category: str | None = Field(default=None, description="所属标签页", json_schema_extra={"q": "eq"})
photo_type: str | None = Field(default=None, description="照片类型", json_schema_extra={"q": "eq"})
@@ -0,0 +1,302 @@
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 .crud import BreedingTreePhotoCRUD
from .schema import (
TreePhotoCreateSchema,
TreePhotoOutSchema,
TreePhotoQueryParam,
TreePhotoUpdateSchema,
)
from app.api.v1.module_bre.cross_combination.crud import BreedingCrossCombinationCRUD
from app.api.v1.module_bre.tree.crud import BreedingTreeCRUD
from app.api.v1.module_bre.tree_evaluation.crud import BreedingTreeEvaluationCRUD
from app.core.base_crud import assert_dict_values, assert_no_children, assert_parents_exist
from app.api.v1.module_bre.cross_combination.model import CrossCombinationModel
from app.api.v1.module_bre.tree_evaluation.model import TreeEvaluationModel
from app.api.v1.module_bre.tree.model import TreeModel
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
def _to_int(v: Any) -> int | None:
if _is_blank(v):
return None
try:
return int(float(v))
except (TypeError, ValueError):
return None
class TreePhotoService:
"""单株照片 模块服务层"""
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
self.auth = auth
self.db = db
async def _attach_fk_labels(self, items: list[TreePhotoOutSchema]) -> None:
if not items:
return
crud = BreedingTreePhotoCRUD(self.auth, self.db)
combination_id_ids = {getattr(it, "combination_id") for it in items if getattr(it, "combination_id")}
if combination_id_ids:
refs = await BreedingCrossCombinationCRUD(self.auth, self.db).get_list(search={"id": ("in", list(combination_id_ids))})
ref_map = {r.id: getattr(r, "combination_code") for r in refs}
for it in items:
it.combination_name = ref_map.get(getattr(it, "combination_id"))
tree_id_ids = {getattr(it, "tree_id") for it in items if getattr(it, "tree_id")}
if tree_id_ids:
refs = await BreedingTreeCRUD(self.auth, self.db).get_list(search={"id": ("in", list(tree_id_ids))})
ref_map = {r.id: getattr(r, "tree_no") for r in refs}
for it in items:
it.tree_name = ref_map.get(getattr(it, "tree_id"))
evaluation_id_ids = {getattr(it, "evaluation_id") for it in items if getattr(it, "evaluation_id")}
if evaluation_id_ids:
refs = await BreedingTreeEvaluationCRUD(self.auth, self.db).get_list(search={"id": ("in", list(evaluation_id_ids))})
ref_map = {r.id: getattr(r, "evaluate_date") for r in refs}
for it in items:
it.evaluation_name = ref_map.get(getattr(it, "evaluation_id"))
async def detail(self, id: int) -> TreePhotoOutSchema:
obj = await BreedingTreePhotoCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="该单株照片不存在")
out = TreePhotoOutSchema.model_validate(obj)
await self._attach_fk_labels([out])
return out
async def get_list(
self,
search: TreePhotoQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> list[TreePhotoOutSchema]:
obj_list = await BreedingTreePhotoCRUD(self.auth, self.db).get_list(
search=search_to_dict(search), order_by=order_by
)
outs = [TreePhotoOutSchema.model_validate(obj) for obj in obj_list]
await self._attach_fk_labels(outs)
return outs
async def page(
self,
page_no: int,
page_size: int,
search: TreePhotoQueryParam | None = None,
order_by: list[dict[str, str]] | None = None,
) -> PageResultSchema[TreePhotoOutSchema]:
offset = (page_no - 1) * page_size
result = await BreedingTreePhotoCRUD(self.auth, self.db).page(
offset=offset,
limit=page_size,
order_by=order_by or [{"id": "asc"}],
search=search_to_dict(search, {}),
out_schema=TreePhotoOutSchema,
)
await self._attach_fk_labels(result.items)
return result
async def create(self, data: TreePhotoCreateSchema) -> TreePhotoOutSchema:
await assert_parents_exist(
self.db,
[
(CrossCombinationModel, data.combination_id, '杂交组合'),
(TreeModel, data.tree_id, '单株'),
(TreeEvaluationModel, data.evaluation_id, '单株评价'),
],
)
await assert_dict_values(
self.db,
[
('photo_type', data.photo_type, '照片类型'),
],
)
obj = await BreedingTreePhotoCRUD(self.auth, self.db).create(data=data)
out = TreePhotoOutSchema.model_validate(obj)
await self._attach_fk_labels([out])
return out
async def update(self, id: int, data: TreePhotoUpdateSchema) -> TreePhotoOutSchema:
obj = await BreedingTreePhotoCRUD(self.auth, self.db).get(id=id)
if not obj:
raise CustomException(msg="更新失败,该单株照片不存在")
await assert_parents_exist(
self.db,
[
(CrossCombinationModel, data.combination_id, '杂交组合'),
(TreeModel, data.tree_id, '单株'),
(TreeEvaluationModel, data.evaluation_id, '单株评价'),
],
)
await assert_dict_values(
self.db,
[
('photo_type', data.photo_type, '照片类型'),
],
)
obj = await BreedingTreePhotoCRUD(self.auth, self.db).update(id=id, data=data)
out = TreePhotoOutSchema.model_validate(obj)
await self._attach_fk_labels([out])
return out
async def delete(self, ids: list[int]) -> None:
if not ids:
raise CustomException(msg="删除失败,删除对象不能为空")
objs = await BreedingTreePhotoCRUD(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 BreedingTreePhotoCRUD(self.auth, self.db).delete(ids=ids)
async def list_options(self) -> list[dict[str, Any]]:
"""供前端下拉选择使用:返回 [{value, label}]。"""
obj_list = await BreedingTreePhotoCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
return [{"value": o.id, "label": o.category} for o in obj_list]
@staticmethod
def batch_export(obj_list: list[dict[str, Any]]) -> bytes:
mapping_dict = {
"combination_name": "杂交组合",
"tree_name": "单株",
"evaluation_name": "所属鉴定",
"category": "所属标签页",
"photo_type": "照片类型",
"photo_url": "照片路径/URL",
"capture_date": "拍摄日期",
"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["photo_type"] = dict_value_to_label("photo_type", item.get("photo_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 = {
"杂交组合": "combination_id",
"单株": "tree_id",
"所属鉴定": "evaluation_id",
"所属标签页": "category",
"照片类型": "photo_type",
"照片路径/URL": "photo_url",
"拍摄日期": "capture_date",
"备注": "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)}")
combination_id_refs = await BreedingCrossCombinationCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
combination_id_map = {getattr(r, "combination_code"): r.id for r in combination_id_refs}
tree_id_refs = await BreedingTreeCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
tree_id_map = {getattr(r, "tree_no"): r.id for r in tree_id_refs}
evaluation_id_refs = await BreedingTreeEvaluationCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
evaluation_id_map = {getattr(r, "evaluate_date"): r.id for r in evaluation_id_refs}
mapped_rows = []
for row in rows:
mapped_rows.append({en: row.get(ch) for ch, en in header_dict.items()})
required_fields = ["combination_id"]
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 = BreedingTreePhotoCRUD(self.auth, self.db)
resolver = DictLabelResolver(self.auth, self.db, ["photo_type"])
for i, row in enumerate(mapped_rows, start=1):
try:
combination_id_val = combination_id_map.get(str(row.get("combination_id")).strip()) if not _is_blank(row.get("combination_id")) else None
tree_id_val = tree_id_map.get(str(row.get("tree_id")).strip()) if not _is_blank(row.get("tree_id")) else None
evaluation_id_val = evaluation_id_map.get(str(row.get("evaluation_id")).strip()) if not _is_blank(row.get("evaluation_id")) else None
fields = {
"combination_id": combination_id_val,
"tree_id": tree_id_val,
"evaluation_id": evaluation_id_val,
"category": _none_if_blank(row.get("category")),
"photo_type": await resolver.resolve("photo_type", row.get("photo_type")),
"photo_url": _none_if_blank(row.get("photo_url")),
"capture_date": _none_if_blank(row.get("capture_date")),
"remark": _none_if_blank(row.get("remark")),
}
create_data = TreePhotoCreateSchema(**fields)
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 = [
"杂交组合",
"单株",
"所属鉴定",
"所属标签页",
"照片类型",
"照片路径/URL",
"拍摄日期",
"备注",
]
selector_header_list = ["所属标签页", "照片类型"]
option_list = [
{"所属标签页": ["基本信息", "基本鉴定", "果实外观", "果皮", "果实大小", "果肉", "果核", "其它"]},
{"照片类型": ["全株", "果实", "枝干"]},
]
return ExcelUtil.get_excel_template(
header_list=header_list,
selector_header_list=selector_header_list,
option_list=option_list,
)