init: 初始化 dpb 桃育种系统代码库
前后端 + 后端 FastAPI 全量源码、部署脚本与文档。
This commit is contained in:
34047007@qq.com
@@ -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 (
|
||||
GroupCreateSchema,
|
||||
GroupOutSchema,
|
||||
GroupQueryParam,
|
||||
GroupUpdateSchema,
|
||||
)
|
||||
from .service import GroupService
|
||||
|
||||
GroupRouter = APIRouter(route_class=OperationLogRoute, prefix="/group", tags=["分组管理"])
|
||||
|
||||
|
||||
@GroupRouter.get("/detail/{id}", summary="获取分组管理详情", response_model=ResponseSchema[GroupOutSchema])
|
||||
async def get_group__detail_controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:detail"]))],
|
||||
id: Annotated[int, Path(description="分组管理ID")],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
result_dict = await service.detail(id=id)
|
||||
return SuccessResponse(data=result_dict, msg="获取分组详情成功")
|
||||
|
||||
|
||||
@GroupRouter.get("/list", summary="分页查询分组管理", response_model=ResponseSchema[PageResultSchema[GroupOutSchema]])
|
||||
async def get_group__list_controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:query"]))],
|
||||
page: Annotated[PaginationQueryParam, Depends()],
|
||||
search: Annotated[GroupQueryParam, Query()],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(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="查询分组列表成功")
|
||||
|
||||
|
||||
@GroupRouter.get("/options", summary="分组管理下拉选项")
|
||||
async def get_group__options_controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:query"]))],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
options = await service.list_options()
|
||||
return SuccessResponse(data=options, msg="获取分组选项成功")
|
||||
|
||||
|
||||
@GroupRouter.post("/create", summary="创建分组管理", response_model=ResponseSchema[GroupOutSchema])
|
||||
async def create_group__controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:create"]))],
|
||||
data: Annotated[GroupCreateSchema, Body(description="创建参数")],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
result_dict = await service.create(data=data)
|
||||
return SuccessResponse(data=result_dict, msg="创建分组成功")
|
||||
|
||||
|
||||
@GroupRouter.put("/update/{id}", summary="修改分组管理", response_model=ResponseSchema[GroupOutSchema])
|
||||
async def update_group__controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:update"]))],
|
||||
id: Annotated[int, Path(description="分组管理ID")],
|
||||
data: Annotated[GroupUpdateSchema, Body(description="修改参数")],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
result_dict = await service.update(id=id, data=data)
|
||||
return SuccessResponse(data=result_dict, msg="修改分组成功")
|
||||
|
||||
|
||||
@GroupRouter.delete("/delete", summary="删除分组管理", response_model=ResponseSchema[None])
|
||||
async def delete_group__controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:delete"]))],
|
||||
ids: Annotated[list[int], Body(description="ID列表")],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
await service.delete(ids=ids)
|
||||
return SuccessResponse(msg="删除分组成功")
|
||||
|
||||
|
||||
@GroupRouter.post("/export", summary="导出分组管理")
|
||||
async def export_group__controller(
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:export"]))],
|
||||
search: Annotated[GroupQueryParam, Query()],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> StreamingResponse:
|
||||
service = GroupService(auth, db)
|
||||
result_dict_list = await service.get_list(search=search)
|
||||
export_result = GroupService.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')}"},
|
||||
)
|
||||
|
||||
|
||||
@GroupRouter.post("/import", summary="导入分组管理", response_model=ResponseSchema[ImportResultSchema])
|
||||
async def import_group__controller(
|
||||
file: Annotated[UploadFile, File(description="导入文件")],
|
||||
auth: Annotated[AuthSchema, Depends(AuthPermission(["module_bre:group:import"]))],
|
||||
db: Annotated[AsyncSession, Depends(db_getter)],
|
||||
) -> JSONResponse:
|
||||
service = GroupService(auth, db)
|
||||
batch_import_result = await service.batch_import(file=file, update_support=True)
|
||||
return SuccessResponse(data=batch_import_result, msg="导入分组成功")
|
||||
|
||||
|
||||
@GroupRouter.post("/download/template", summary="获取分组管理导入模板", dependencies=[Depends(AuthPermission(["module_bre:group:download"]))])
|
||||
async def download_group__template_controller() -> StreamingResponse:
|
||||
import_template_result = GroupService.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 GroupModel
|
||||
|
||||
|
||||
class BreedingGroupCRUD(CRUDBase[GroupModel, Any, Any]):
|
||||
"""分组管理 CRUD —— 直接复用 CRUDBase（已自动注入数据权限过滤）。"""
|
||||
|
||||
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
|
||||
super().__init__(GroupModel, auth, db)
|
||||
|
||||
|
||||
group_crud = BreedingGroupCRUD
|
||||
@@ -0,0 +1,25 @@
|
||||
"""分组管理 数据模型"""
|
||||
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 GroupModel(ModelMixin, UserMixin, MappedBase):
|
||||
"""分组管理 主数据表。"""
|
||||
|
||||
__tablename__ = "bre_group"
|
||||
|
||||
group_name: Mapped[str] = mapped_column(String(128), nullable=False, comment="分组名称")
|
||||
|
||||
group_type: Mapped[str | None] = mapped_column(String(32), 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_group_created_deleted", "created_time", "is_deleted"),
|
||||
)
|
||||
@@ -0,0 +1,41 @@
|
||||
from app.core.base_schema import CommonSchema
|
||||
"""分组管理 —— Pydantic 校验/序列化模型。"""
|
||||
from datetime import datetime
|
||||
|
||||
from pydantic import BaseModel, ConfigDict, Field
|
||||
|
||||
|
||||
class GroupBaseSchema(BaseModel):
|
||||
model_config = ConfigDict(from_attributes=True)
|
||||
|
||||
group_name: str = Field(..., description="分组名称")
|
||||
group_type: str | None = Field(default=None, description="分组类型")
|
||||
remark: str | None = Field(default=None, description="备注")
|
||||
|
||||
|
||||
class GroupCreateSchema(GroupBaseSchema):
|
||||
pass
|
||||
|
||||
|
||||
class GroupUpdateSchema(GroupBaseSchema):
|
||||
group_name: str | None = Field(default=None, description="分组名称")
|
||||
group_type: str | None = Field(default=None, description="分组类型")
|
||||
remark: str | None = Field(default=None, description="备注")
|
||||
|
||||
|
||||
class GroupOutSchema(GroupBaseSchema):
|
||||
id: int
|
||||
uuid: str
|
||||
group_name: str | None = None
|
||||
group_type: 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 GroupQueryParam(BaseModel):
|
||||
group_name: str | None = Field(default=None, description="分组名称", json_schema_extra={"q": "like"})
|
||||
group_type: str | None = Field(default=None, description="分组类型", json_schema_extra={"q": "eq"})
|
||||
|
||||
@@ -0,0 +1,213 @@
|
||||
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.dict_util import DictLabelResolver, dict_value_to_label
|
||||
from app.utils.excel_util import ExcelUtil
|
||||
|
||||
from .crud import BreedingGroupCRUD
|
||||
from .schema import (
|
||||
GroupCreateSchema,
|
||||
GroupOutSchema,
|
||||
GroupQueryParam,
|
||||
GroupUpdateSchema,
|
||||
)
|
||||
|
||||
|
||||
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 GroupService:
|
||||
"""分组管理 模块服务层"""
|
||||
|
||||
def __init__(self, auth: AuthSchema, db: AsyncSession) -> None:
|
||||
self.auth = auth
|
||||
self.db = db
|
||||
|
||||
async def _attach_fk_labels(self, items: list[GroupOutSchema]) -> None:
|
||||
if not items:
|
||||
return
|
||||
crud = BreedingGroupCRUD(self.auth, self.db)
|
||||
|
||||
async def detail(self, id: int) -> GroupOutSchema:
|
||||
obj = await BreedingGroupCRUD(self.auth, self.db).get(id=id)
|
||||
if not obj:
|
||||
raise CustomException(msg="该分组不存在")
|
||||
out = GroupOutSchema.model_validate(obj)
|
||||
await self._attach_fk_labels([out])
|
||||
return out
|
||||
|
||||
async def get_list(
|
||||
self,
|
||||
search: GroupQueryParam | None = None,
|
||||
order_by: list[dict[str, str]] | None = None,
|
||||
) -> list[GroupOutSchema]:
|
||||
obj_list = await BreedingGroupCRUD(self.auth, self.db).get_list(
|
||||
search=search_to_dict(search), order_by=order_by
|
||||
)
|
||||
outs = [GroupOutSchema.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: GroupQueryParam | None = None,
|
||||
order_by: list[dict[str, str]] | None = None,
|
||||
) -> PageResultSchema[GroupOutSchema]:
|
||||
offset = (page_no - 1) * page_size
|
||||
result = await BreedingGroupCRUD(self.auth, self.db).page(
|
||||
offset=offset,
|
||||
limit=page_size,
|
||||
order_by=order_by or [{"id": "asc"}],
|
||||
search=search_to_dict(search, {}),
|
||||
out_schema=GroupOutSchema,
|
||||
)
|
||||
await self._attach_fk_labels(result.items)
|
||||
return result
|
||||
|
||||
async def create(self, data: GroupCreateSchema) -> GroupOutSchema:
|
||||
obj = await BreedingGroupCRUD(self.auth, self.db).create(data=data)
|
||||
out = GroupOutSchema.model_validate(obj)
|
||||
return out
|
||||
|
||||
async def update(self, id: int, data: GroupUpdateSchema) -> GroupOutSchema:
|
||||
obj = await BreedingGroupCRUD(self.auth, self.db).get(id=id)
|
||||
if not obj:
|
||||
raise CustomException(msg="更新失败，该分组不存在")
|
||||
obj = await BreedingGroupCRUD(self.auth, self.db).update(id=id, data=data)
|
||||
out = GroupOutSchema.model_validate(obj)
|
||||
return out
|
||||
|
||||
async def delete(self, ids: list[int]) -> None:
|
||||
if not ids:
|
||||
raise CustomException(msg="删除失败，删除对象不能为空")
|
||||
objs = await BreedingGroupCRUD(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 BreedingGroupCRUD(self.auth, self.db).delete(ids=ids)
|
||||
|
||||
async def list_options(self) -> list[dict[str, Any]]:
|
||||
"""供前端下拉选择使用：返回 [{value, label}]。"""
|
||||
obj_list = await BreedingGroupCRUD(self.auth, self.db).get_list(order_by=[{"id": "asc"}])
|
||||
return [{"value": o.id, "label": o.group_name} for o in obj_list]
|
||||
|
||||
@staticmethod
|
||||
def batch_export(obj_list: list[dict[str, Any]]) -> bytes:
|
||||
mapping_dict = {
|
||||
"group_name": "分组名称",
|
||||
"group_type": "分组类型",
|
||||
"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["group_type"] = dict_value_to_label("breeding_group_type", item.get("group_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 = {
|
||||
"分组名称": "group_name",
|
||||
"分组类型": "group_type",
|
||||
"备注": "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 = ["group_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 = BreedingGroupCRUD(self.auth, self.db)
|
||||
resolver = DictLabelResolver(self.auth, self.db, ["breeding_group_type"])
|
||||
for i, row in enumerate(mapped_rows, start=1):
|
||||
try:
|
||||
fields = {
|
||||
"group_name": _none_if_blank(row.get("group_name")),
|
||||
"group_type": await resolver.resolve("breeding_group_type", row.get("group_type")),
|
||||
"remark": _none_if_blank(row.get("remark")),
|
||||
}
|
||||
create_data = GroupCreateSchema(**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 = [
|
||||
"分组名称",
|
||||
"分组类型",
|
||||
"备注",
|
||||
]
|
||||
selector_header_list = ["分组类型"]
|
||||
option_list = [
|
||||
{"分组类型": ["project", "family", "category", "temporary_set", "custom"]},
|
||||
]
|
||||
return ExcelUtil.get_excel_template(
|
||||
header_list=header_list,
|
||||
selector_header_list=selector_header_list,
|
||||
option_list=option_list,
|
||||
)
|
||||
Reference in New Issue
Block a user