信息架构/菜单框架大重构-20260109

2026-01-09 11:19:04 +08:00
parent ba3cf95b8a
commit 9021c7fe2b
188 changed files with 7632 additions and 11658 deletions
@@ -0,0 +1,139 @@
+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_roles
+from app.crud import audit as audit_crud
+from app.crud import knowledge_note as note_crud
+from app.crud import study as study_crud
+from app.schemas.knowledge_note import KnowledgeNoteCreate, KnowledgeNoteRead, KnowledgeNoteUpdate
+
+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="Study not found")
+    return study
+
+
+@router.post(
+    "/notes",
+    response_model=KnowledgeNoteRead,
+    status_code=status.HTTP_201_CREATED,
+    dependencies=[Depends(require_study_roles(["PM", "CRA"]))],
+)
+async def create_note(
+    study_id: uuid.UUID,
+    note_in: KnowledgeNoteCreate,
+    db: AsyncSession = Depends(get_db_session),
+    current_user=Depends(get_current_user),
+) -> KnowledgeNoteRead:
+    await _ensure_study_exists(db, study_id)
+    note = await note_crud.create_note(db, study_id, note_in, created_by=current_user.id)
+    await audit_crud.log_action(
+        db,
+        study_id=study_id,
+        entity_type="knowledge_note",
+        entity_id=note.id,
+        action="CREATE_KNOWLEDGE_NOTE",
+        detail=f"Knowledge note {note.title} created",
+        operator_id=current_user.id,
+        operator_role=current_user.role,
+    )
+    return KnowledgeNoteRead.model_validate(note)
+
+
+@router.get(
+    "/notes",
+    response_model=list[KnowledgeNoteRead],
+    dependencies=[Depends(require_study_member())],
+)
+async def list_notes(
+    study_id: uuid.UUID,
+    site_name: str | None = None,
+    keyword: str | None = None,
+    skip: int = 0,
+    limit: int = 100,
+    db: AsyncSession = Depends(get_db_session),
+) -> list[KnowledgeNoteRead]:
+    await _ensure_study_exists(db, study_id)
+    items = await note_crud.list_notes(db, study_id, site_name=site_name, keyword=keyword, skip=skip, limit=limit)
+    return [KnowledgeNoteRead.model_validate(item) for item in items]
+
+
+@router.get(
+    "/notes/{note_id}",
+    response_model=KnowledgeNoteRead,
+    dependencies=[Depends(require_study_member())],
+)
+async def get_note(
+    study_id: uuid.UUID,
+    note_id: uuid.UUID,
+    db: AsyncSession = Depends(get_db_session),
+) -> KnowledgeNoteRead:
+    await _ensure_study_exists(db, study_id)
+    note = await note_crud.get_note(db, note_id)
+    if not note or note.study_id != study_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Note not found")
+    return KnowledgeNoteRead.model_validate(note)
+
+
+@router.patch(
+    "/notes/{note_id}",
+    response_model=KnowledgeNoteRead,
+    dependencies=[Depends(require_study_roles(["PM", "CRA"]))],
+)
+async def update_note(
+    study_id: uuid.UUID,
+    note_id: uuid.UUID,
+    note_in: KnowledgeNoteUpdate,
+    db: AsyncSession = Depends(get_db_session),
+    current_user=Depends(get_current_user),
+) -> KnowledgeNoteRead:
+    await _ensure_study_exists(db, study_id)
+    note = await note_crud.get_note(db, note_id)
+    if not note or note.study_id != study_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Note not found")
+    note = await note_crud.update_note(db, note, note_in)
+    await audit_crud.log_action(
+        db,
+        study_id=study_id,
+        entity_type="knowledge_note",
+        entity_id=note_id,
+        action="UPDATE_KNOWLEDGE_NOTE",
+        detail=f"Knowledge note {note_id} updated",
+        operator_id=current_user.id,
+        operator_role=current_user.role,
+    )
+    return KnowledgeNoteRead.model_validate(note)
+
+
+@router.delete(
+    "/notes/{note_id}",
+    status_code=status.HTTP_204_NO_CONTENT,
+    dependencies=[Depends(require_study_roles(["PM", "CRA"]))],
+)
+async def delete_note(
+    study_id: uuid.UUID,
+    note_id: uuid.UUID,
+    db: AsyncSession = Depends(get_db_session),
+    current_user=Depends(get_current_user),
+) -> None:
+    await _ensure_study_exists(db, study_id)
+    note = await note_crud.get_note(db, note_id)
+    if not note or note.study_id != study_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Note not found")
+    await note_crud.delete_note(db, note)
+    await audit_crud.log_action(
+        db,
+        study_id=study_id,
+        entity_type="knowledge_note",
+        entity_id=note_id,
+        action="DELETE_KNOWLEDGE_NOTE",
+        detail=f"Knowledge note {note_id} deleted",
+        operator_id=current_user.id,
+        operator_role=current_user.role,
+    )