feat(faq): refine category icons and project faq flows

backend/app/api/v1/faq_categories.py

@@ -42,6 +42,10 @@ async def create_category(
     existing = await category_crud.get_category_by_name(db, payload.study_id, payload.name)
     if existing:
         raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="分类名称已存在")
+    if payload.icon:
+        dup = await category_crud.get_category_by_icon(db, payload.study_id, payload.icon)
+        if dup:
+            raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="该图标已被其他分类使用")
     category = await category_crud.create_category(db, payload)
     await audit_crud.log_action(
         db,
@@ -65,13 +69,12 @@ async def create_category(
 )
 async def list_categories(
     study_id: uuid.UUID | None = None,
-    is_active: bool | None = True,
     db: AsyncSession = Depends(get_db_session),
     current_user=Depends(get_current_user),
 ) -> list[CategoryRead]:
     if not study_id:
         raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="必须提供项目 ID")
-    categories = await category_crud.list_categories(db, study_id, include_global=False, is_active=is_active)
+    categories = await category_crud.list_categories(db, study_id, include_global=False)
     return paginate([CategoryRead.model_validate(c) for c in categories], total=len(categories))
 
 
@@ -102,6 +105,10 @@ async def update_category(
     existing = await category_crud.get_category_by_name(db, target_study_id, target_name)
     if existing and existing.id != category.id:
         raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="分类名称已存在")
+    if payload.icon:
+        dup = await category_crud.get_category_by_icon(db, target_study_id, payload.icon)
+        if dup and dup.id != category.id:
+            raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="该图标已被其他分类使用")
     if not target_study_id:
         raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="必须提供项目 ID")
     updated = await category_crud.update_category(db, category, payload)

backend/app/api/v1/faqs.py

@@ -90,7 +90,6 @@ async def list_faqs(
     study_id: uuid.UUID | None = None,
     category_id: uuid.UUID | None = None,
     keyword: str | None = None,
-    is_active: bool | None = None,
     db: AsyncSession = Depends(get_db_session),
     current_user=Depends(get_current_user),
 ) -> list[FaqRead]:
@@ -111,17 +110,12 @@ async def list_faqs(
         member = await member_crud.get_member(db, study_id, current_user.id)
         if not member or not member.is_active:
             raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="不是项目成员")
-        if is_active is False:
-            allowed = await role_has_api_permission(db, study_id, member.role_in_study, "faq:update", check_prerequisites=False)
-            if not allowed:
-                raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="权限不足")
 
     items = await faq_crud.list_items(
         db,
         study_id=study_id,
         category_id=category_id,
         keyword=keyword,
-        is_active=is_active,
         study_scope="project",
     )
 
@@ -131,10 +125,6 @@ async def list_faqs(
             role = await _get_member_role(it.study_id)
             if not role:
                 continue
-        if not it.is_active and not _is_system_admin(current_user):
-            allowed = await role_has_api_permission(db, it.study_id, role, "faq:update", check_prerequisites=False)
-            if not allowed:
-                continue
         visible.append(FaqRead.model_validate(it))
     return paginate(visible, total=len(visible))
 
@@ -156,13 +146,6 @@ async def get_faq(
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="FAQ 不存在")
     if not item.study_id:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="FAQ 不存在")
-    if not item.is_active and not is_system_admin(current_user):
-        member = await member_crud.get_member(db, item.study_id, current_user.id)
-        if not member or not member.is_active:
-            raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="不是项目成员")
-        allowed = await role_has_api_permission(db, item.study_id, member.role_in_study, "faq:update", check_prerequisites=False)
-        if not allowed:
-            raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="权限不足")
     return FaqRead.model_validate(item)
 
 
@@ -185,13 +168,9 @@ async def update_faq(
     item = await faq_crud.get_item(db, item_id)
     if not item:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="FAQ 不存在")
-    old_active = item.is_active
     updated = await faq_crud.update_item(db, item, payload)
     action = "UPDATE_FAQ_ITEM"
     detail = "FAQ updated"
-    if payload.is_active is not None and payload.is_active != old_active:
-        action = "FAQ_STATUS_CHANGE"
-        detail = "FAQ disabled" if not payload.is_active else "FAQ enabled"
     await audit_crud.log_action(
         db,
         study_id=item.study_id,