参与者管理- PD模块内容补充

This commit is contained in:
Cheng Zhou
2026-02-28 14:33:57 +08:00
parent af0c1b4b7d
commit 9b36a42e6f
14 changed files with 855 additions and 35 deletions
@@ -0,0 +1,75 @@
"""add subject_pds table
Revision ID: 20260228_01
Revises: 20260227_06
Create Date: 2026-02-28 10:30:00.000000
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
from sqlalchemy.dialects import postgresql
# revision identifiers, used by Alembic.
revision: str = "20260228_01"
down_revision: Union[str, None] = "20260227_06"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
bind = op.get_bind()
inspector = sa.inspect(bind)
table_names = set(inspector.get_table_names())
if "subject_pds" not in table_names:
op.create_table(
"subject_pds",
sa.Column("id", postgresql.UUID(as_uuid=True), nullable=False),
sa.Column("study_id", postgresql.UUID(as_uuid=True), nullable=False),
sa.Column("subject_id", postgresql.UUID(as_uuid=True), nullable=False),
sa.Column("pd_no", sa.String(length=64), nullable=False),
sa.Column("pd_type", sa.String(length=100), nullable=False),
sa.Column("pd_level", sa.String(length=20), nullable=False, server_default=sa.text("'GENERAL'")),
sa.Column("approval_status", sa.String(length=20), nullable=False, server_default=sa.text("'DRAFT'")),
sa.Column("description", sa.Text(), nullable=True),
sa.Column("status", sa.String(length=20), nullable=False, server_default=sa.text("'OPEN'")),
sa.Column("created_by", postgresql.UUID(as_uuid=True), nullable=True),
sa.Column("created_at", sa.DateTime(timezone=True), nullable=False, server_default=sa.text("now()")),
sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False, server_default=sa.text("now()")),
sa.ForeignKeyConstraint(["study_id"], ["studies.id"]),
sa.ForeignKeyConstraint(["subject_id"], ["subjects.id"]),
sa.ForeignKeyConstraint(["created_by"], ["users.id"]),
sa.PrimaryKeyConstraint("id"),
sa.UniqueConstraint("study_id", "pd_no", name="uq_subject_pds_study_pd_no"),
)
table_names.add("subject_pds")
indexes = {idx["name"] for idx in inspector.get_indexes("subject_pds")} if "subject_pds" in table_names else set()
study_index_name = op.f("ix_subject_pds_study_id")
if study_index_name not in indexes:
op.create_index(study_index_name, "subject_pds", ["study_id"], unique=False)
subject_index_name = op.f("ix_subject_pds_subject_id")
if subject_index_name not in indexes:
op.create_index(subject_index_name, "subject_pds", ["subject_id"], unique=False)
def downgrade() -> None:
bind = op.get_bind()
inspector = sa.inspect(bind)
table_names = set(inspector.get_table_names())
if "subject_pds" in table_names:
indexes = {idx["name"] for idx in inspector.get_indexes("subject_pds")}
study_index_name = op.f("ix_subject_pds_study_id")
if study_index_name in indexes:
op.drop_index(study_index_name, table_name="subject_pds")
subject_index_name = op.f("ix_subject_pds_subject_id")
if subject_index_name in indexes:
op.drop_index(subject_index_name, table_name="subject_pds")
op.drop_table("subject_pds")
+3 -1
View File
@@ -1,6 +1,6 @@
from fastapi import APIRouter
from app.api.v1 import auth, users, admin_users, studies, sites, members, attachments, audit_logs, dashboard, subjects, visits, aes, finance_dashboard, finance_contracts, finance_specials, fees_contracts, fees_specials, fees_attachments, drug_shipments, material_equipments, project_milestones, startup, knowledge_notes, subject_histories, faq_categories, faqs, documents, overview, notifications, monitoring_visit_issues
from app.api.v1 import auth, users, admin_users, studies, sites, members, attachments, audit_logs, dashboard, subjects, visits, aes, finance_dashboard, finance_contracts, finance_specials, fees_contracts, fees_specials, fees_attachments, drug_shipments, material_equipments, project_milestones, startup, knowledge_notes, subject_histories, subject_pds, study_subject_pds, faq_categories, faqs, documents, overview, notifications, monitoring_visit_issues
api_router = APIRouter()
@@ -32,6 +32,8 @@ api_router.include_router(startup.router, prefix="/studies/{study_id}/startup",
api_router.include_router(knowledge_notes.router, prefix="/studies/{study_id}/knowledge", tags=["knowledge"])
api_router.include_router(monitoring_visit_issues.router, prefix="/studies/{study_id}/monitoring", tags=["monitoring-visit-issues"])
api_router.include_router(subject_histories.router, prefix="/studies/{study_id}/subjects/{subject_id}", tags=["subject-histories"])
api_router.include_router(subject_pds.router, prefix="/studies/{study_id}/subjects/{subject_id}", tags=["subject-pds"])
api_router.include_router(study_subject_pds.router, prefix="/studies/{study_id}", tags=["subject-pds"])
api_router.include_router(faq_categories.router, prefix="/faqs/categories", tags=["faq-categories"])
api_router.include_router(faqs.router, prefix="/faqs/items", tags=["faqs"])
api_router.include_router(documents.router, prefix="", tags=["documents"])
+50
View File
@@ -0,0 +1,50 @@
import uuid
from fastapi import APIRouter, Depends, HTTPException, status
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.deps import get_cra_site_scope, get_current_user, get_db_session, require_study_member
from app.crud import study as study_crud
from app.crud import subject_pd as subject_pd_crud
from app.schemas.subject_pd import SubjectPdSummaryRead
router = APIRouter()
async def _ensure_study_exists(db: AsyncSession, study_id: uuid.UUID):
study = await study_crud.get(db, study_id)
if not study:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="项目不存在")
return study
@router.get(
"/subject-pds",
response_model=list[SubjectPdSummaryRead],
dependencies=[Depends(require_study_member())],
)
async def list_study_subject_pds(
study_id: uuid.UUID,
skip: int = 0,
limit: int = 500,
db: AsyncSession = Depends(get_db_session),
current_user=Depends(get_current_user),
) -> list[SubjectPdSummaryRead]:
await _ensure_study_exists(db, study_id)
cra_scope = await get_cra_site_scope(db, study_id, current_user)
site_ids = cra_scope[0] if cra_scope else None
rows = await subject_pd_crud.list_study_subject_pds(db, study_id, skip=skip, limit=limit, site_ids=site_ids)
return [
SubjectPdSummaryRead(
id=item.id,
study_id=item.study_id,
subject_id=item.subject_id,
subject_no=subject_no,
site_id=site_id,
pd_no=item.pd_no,
status=item.status,
description=item.description,
updated_at=item.updated_at,
)
for item, subject_no, site_id in rows
]
+206
View File
@@ -0,0 +1,206 @@
import uuid
from fastapi import APIRouter, Depends, HTTPException, status
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.deps import (
get_current_user,
get_db_session,
require_study_member,
require_study_not_locked,
require_study_roles,
)
from app.crud import audit as audit_crud
from app.crud import site as site_crud
from app.crud import study as study_crud
from app.crud import subject as subject_crud
from app.crud import subject_pd as subject_pd_crud
from app.schemas.subject_pd import SubjectPdCreate, SubjectPdRead, SubjectPdUpdate
router = APIRouter()
ALLOWED_PD_LEVELS = {"GENERAL", "MAJOR", "CRITICAL"}
ALLOWED_APPROVAL_STATUS = {"DRAFT", "SUBMITTED", "APPROVED", "REJECTED"}
ALLOWED_PD_STATUS = {"OPEN", "CLOSED"}
async def _ensure_study_exists(db: AsyncSession, study_id: uuid.UUID):
study = await study_crud.get(db, study_id)
if not study:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="项目不存在")
return study
async def _ensure_subject(db: AsyncSession, study_id: uuid.UUID, subject_id: uuid.UUID):
subject = await subject_crud.get_subject(db, subject_id)
if not subject or subject.study_id != study_id:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="参与者不存在")
return subject
async def _ensure_subject_active(db: AsyncSession, subject) -> None:
if not subject or not subject.site_id:
return
site = await site_crud.get_site(db, subject.site_id)
if not site or not site.is_active:
raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="中心已停用")
def _normalize_pd_type(value: str) -> str:
normalized = str(value or "").strip()
if not normalized:
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="PD类型不能为空")
return normalized
def _normalize_choice(value: str | None, allowed: set[str], field_name: str) -> str:
if value is None:
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=f"{field_name}不能为空")
normalized = str(value).strip().upper()
if normalized not in allowed:
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=f"{field_name}取值无效")
return normalized
@router.get(
"/pds",
response_model=list[SubjectPdRead],
dependencies=[Depends(require_study_member())],
)
async def list_subject_pds(
study_id: uuid.UUID,
subject_id: uuid.UUID,
skip: int = 0,
limit: int = 200,
db: AsyncSession = Depends(get_db_session),
) -> list[SubjectPdRead]:
await _ensure_study_exists(db, study_id)
await _ensure_subject(db, study_id, subject_id)
items = await subject_pd_crud.list_subject_pds(db, study_id, subject_id, skip=skip, limit=limit)
return [SubjectPdRead.model_validate(item) for item in items]
@router.post(
"/pds",
response_model=SubjectPdRead,
status_code=status.HTTP_201_CREATED,
dependencies=[Depends(require_study_roles(["PM", "CRA"])), Depends(require_study_not_locked())],
)
async def create_subject_pd(
study_id: uuid.UUID,
subject_id: uuid.UUID,
pd_in: SubjectPdCreate,
db: AsyncSession = Depends(get_db_session),
current_user=Depends(get_current_user),
) -> SubjectPdRead:
await _ensure_study_exists(db, study_id)
subject = await _ensure_subject(db, study_id, subject_id)
await _ensure_subject_active(db, subject)
if pd_in.subject_id != subject_id:
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="参与者不匹配")
payload = pd_in.model_dump()
payload["pd_type"] = _normalize_pd_type(payload.get("pd_type") or "")
payload["pd_level"] = _normalize_choice(payload.get("pd_level") or "GENERAL", ALLOWED_PD_LEVELS, "PD分级")
payload["approval_status"] = _normalize_choice(
payload.get("approval_status") or "DRAFT", ALLOWED_APPROVAL_STATUS, "审批状态"
)
payload["status"] = _normalize_choice(payload.get("status") or "OPEN", ALLOWED_PD_STATUS, "状态")
item = await subject_pd_crud.create_subject_pd(
db,
study_id,
SubjectPdCreate(**payload),
created_by=current_user.id,
)
await audit_crud.log_action(
db,
study_id=study_id,
entity_type="subject_pd",
entity_id=item.id,
action="CREATE_SUBJECT_PD",
detail=f"PD记录 {item.pd_no} 已创建",
operator_id=current_user.id,
operator_role=current_user.role,
)
return SubjectPdRead.model_validate(item)
@router.patch(
"/pds/{pd_id}",
response_model=SubjectPdRead,
dependencies=[Depends(require_study_roles(["PM", "CRA"])), Depends(require_study_not_locked())],
)
async def update_subject_pd(
study_id: uuid.UUID,
subject_id: uuid.UUID,
pd_id: uuid.UUID,
pd_in: SubjectPdUpdate,
db: AsyncSession = Depends(get_db_session),
current_user=Depends(get_current_user),
) -> SubjectPdRead:
await _ensure_study_exists(db, study_id)
subject = await _ensure_subject(db, study_id, subject_id)
await _ensure_subject_active(db, subject)
item = await subject_pd_crud.get_subject_pd(db, pd_id)
if not item or item.study_id != study_id or item.subject_id != subject_id:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="PD记录不存在")
update_payload = pd_in.model_dump(exclude_unset=True)
if "pd_type" in update_payload:
update_payload["pd_type"] = _normalize_pd_type(update_payload["pd_type"])
if "pd_level" in update_payload:
update_payload["pd_level"] = _normalize_choice(update_payload["pd_level"], ALLOWED_PD_LEVELS, "PD分级")
if "approval_status" in update_payload:
update_payload["approval_status"] = _normalize_choice(
update_payload["approval_status"], ALLOWED_APPROVAL_STATUS, "审批状态"
)
if "status" in update_payload:
update_payload["status"] = _normalize_choice(update_payload["status"], ALLOWED_PD_STATUS, "状态")
updated = await subject_pd_crud.update_subject_pd(db, item, SubjectPdUpdate(**update_payload))
await audit_crud.log_action(
db,
study_id=study_id,
entity_type="subject_pd",
entity_id=pd_id,
action="UPDATE_SUBJECT_PD",
detail=f"PD记录 {updated.pd_no} 已更新",
operator_id=current_user.id,
operator_role=current_user.role,
)
return SubjectPdRead.model_validate(updated)
@router.delete(
"/pds/{pd_id}",
status_code=status.HTTP_204_NO_CONTENT,
dependencies=[Depends(require_study_roles(["PM", "CRA"])), Depends(require_study_not_locked())],
)
async def delete_subject_pd(
study_id: uuid.UUID,
subject_id: uuid.UUID,
pd_id: uuid.UUID,
db: AsyncSession = Depends(get_db_session),
current_user=Depends(get_current_user),
) -> None:
await _ensure_study_exists(db, study_id)
subject = await _ensure_subject(db, study_id, subject_id)
await _ensure_subject_active(db, subject)
item = await subject_pd_crud.get_subject_pd(db, pd_id)
if not item or item.study_id != study_id or item.subject_id != subject_id:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="PD记录不存在")
await subject_pd_crud.delete_subject_pd(db, item)
await audit_crud.log_action(
db,
study_id=study_id,
entity_type="subject_pd",
entity_id=pd_id,
action="DELETE_SUBJECT_PD",
detail=f"PD记录 {item.pd_no} 已删除",
operator_id=current_user.id,
operator_role=current_user.role,
)
+120
View File
@@ -0,0 +1,120 @@
import re
import uuid
from typing import Sequence
from sqlalchemy import select, update as sa_update
from sqlalchemy.ext.asyncio import AsyncSession
from app.models.subject import Subject
from app.models.subject_pd import SubjectPd
from app.schemas.subject_pd import SubjectPdCreate, SubjectPdUpdate
_PD_NO_PATTERN = re.compile(r"PD(\d+)$", re.IGNORECASE)
def _extract_pd_sequence(pd_no: str | None) -> int:
if not pd_no:
return 0
matched = _PD_NO_PATTERN.search(str(pd_no).strip())
if not matched:
return 0
try:
return int(matched.group(1))
except ValueError:
return 0
async def _next_pd_no(db: AsyncSession, study_id: uuid.UUID) -> str:
rows = await db.execute(select(SubjectPd.pd_no).where(SubjectPd.study_id == study_id))
max_seq = 0
for (pd_no,) in rows.all():
max_seq = max(max_seq, _extract_pd_sequence(pd_no))
return f"PD{max_seq + 1:04d}"
async def list_subject_pds(
db: AsyncSession,
study_id: uuid.UUID,
subject_id: uuid.UUID,
*,
skip: int = 0,
limit: int = 200,
) -> Sequence[SubjectPd]:
stmt = (
select(SubjectPd)
.where(SubjectPd.study_id == study_id, SubjectPd.subject_id == subject_id)
.order_by(SubjectPd.pd_no.asc(), SubjectPd.created_at.asc())
.offset(skip)
.limit(limit)
)
rows = await db.execute(stmt)
return rows.scalars().all()
async def list_study_subject_pds(
db: AsyncSession,
study_id: uuid.UUID,
*,
skip: int = 0,
limit: int = 500,
site_ids: set[uuid.UUID] | None = None,
) -> list[tuple[SubjectPd, str, uuid.UUID]]:
if site_ids is not None and not site_ids:
return []
stmt = (
select(SubjectPd, Subject.subject_no, Subject.site_id)
.join(Subject, Subject.id == SubjectPd.subject_id)
.where(
SubjectPd.study_id == study_id,
Subject.study_id == study_id,
)
.order_by(SubjectPd.pd_no.asc(), SubjectPd.created_at.asc())
.offset(skip)
.limit(limit)
)
if site_ids is not None:
stmt = stmt.where(Subject.site_id.in_(site_ids))
rows = await db.execute(stmt)
return [(row[0], row[1], row[2]) for row in rows.all()]
async def get_subject_pd(db: AsyncSession, pd_id: uuid.UUID) -> SubjectPd | None:
row = await db.execute(select(SubjectPd).where(SubjectPd.id == pd_id))
return row.scalar_one_or_none()
async def create_subject_pd(
db: AsyncSession,
study_id: uuid.UUID,
pd_in: SubjectPdCreate,
*,
created_by: uuid.UUID | None = None,
) -> SubjectPd:
payload = pd_in.model_dump(exclude_unset=True)
# PD编号统一由后端按项目全局顺序生成,避免被外部覆盖。
payload.pop("pd_no", None)
pd_no = await _next_pd_no(db, study_id)
item = SubjectPd(study_id=study_id, pd_no=pd_no, created_by=created_by, **payload)
db.add(item)
await db.commit()
await db.refresh(item)
return item
async def update_subject_pd(db: AsyncSession, item: SubjectPd, pd_in: SubjectPdUpdate) -> SubjectPd:
update_data = pd_in.model_dump(exclude_unset=True)
if update_data:
await db.execute(
sa_update(SubjectPd)
.where(SubjectPd.id == item.id)
.values(**update_data)
)
await db.commit()
await db.refresh(item)
return item
async def delete_subject_pd(db: AsyncSession, item: SubjectPd) -> None:
await db.delete(item)
await db.commit()
+1
View File
@@ -13,6 +13,7 @@ from app.models.distribution import Distribution # noqa: F401
from app.models.acknowledgement import Acknowledgement # noqa: F401
from app.models.milestone import Milestone # noqa: F401
from app.models.subject import Subject # noqa: F401
from app.models.subject_pd import SubjectPd # noqa: F401
from app.models.visit import Visit # noqa: F401
from app.models.ae import AdverseEvent # noqa: F401
from app.models.finance import FinanceItem # noqa: F401
+28
View File
@@ -0,0 +1,28 @@
import uuid
from datetime import datetime
from sqlalchemy import DateTime, ForeignKey, String, Text, UniqueConstraint, func
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base_class import Base
class SubjectPd(Base):
__tablename__ = "subject_pds"
__table_args__ = (UniqueConstraint("study_id", "pd_no", name="uq_subject_pds_study_pd_no"),)
id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
study_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("studies.id"), index=True, nullable=False)
subject_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("subjects.id"), index=True, nullable=False)
pd_no: Mapped[str] = mapped_column(String(64), nullable=False)
pd_type: Mapped[str] = mapped_column(String(100), nullable=False)
pd_level: Mapped[str] = mapped_column(String(20), nullable=False, server_default="GENERAL")
approval_status: Mapped[str] = mapped_column(String(20), nullable=False, server_default="DRAFT")
description: Mapped[str | None] = mapped_column(Text, nullable=True)
status: Mapped[str] = mapped_column(String(20), nullable=False, server_default="OPEN")
created_by: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True), ForeignKey("users.id"), nullable=True)
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False, server_default=func.now())
updated_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True), nullable=False, server_default=func.now(), onupdate=func.now()
)
+52
View File
@@ -0,0 +1,52 @@
import uuid
from datetime import datetime
from typing import Optional
from pydantic import BaseModel, ConfigDict
class SubjectPdCreate(BaseModel):
subject_id: uuid.UUID
pd_no: Optional[str] = None
pd_type: str
pd_level: Optional[str] = "GENERAL"
approval_status: Optional[str] = "DRAFT"
description: Optional[str] = None
status: Optional[str] = "OPEN"
class SubjectPdUpdate(BaseModel):
pd_type: Optional[str] = None
pd_level: Optional[str] = None
approval_status: Optional[str] = None
description: Optional[str] = None
status: Optional[str] = None
class SubjectPdRead(BaseModel):
id: uuid.UUID
study_id: uuid.UUID
subject_id: uuid.UUID
pd_no: str
pd_type: str
pd_level: str
approval_status: str
description: Optional[str]
status: str
created_by: Optional[uuid.UUID]
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class SubjectPdSummaryRead(BaseModel):
id: uuid.UUID
study_id: uuid.UUID
subject_id: uuid.UUID
subject_no: str
site_id: uuid.UUID
pd_no: str
status: str
description: Optional[str]
updated_at: datetime