feat: add step thumbs feedback and /ratings alias routes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/app/api/endpoints/ratings.py

@@ -1,12 +1,13 @@
 from uuid import UUID
 from fastapi import APIRouter, Depends, HTTPException, status
-from sqlalchemy import select
+from sqlalchemy import select, func
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.core.database import get_db
 from app.api.deps import get_current_active_user
 from app.models import User, Session, SessionRating
-from app.schemas.analytics import SessionRatingCreate, SessionRatingResponse
+from app.models.step_library import StepLibrary, StepRating
+from app.schemas.analytics import SessionRatingCreate, SessionRatingResponse, StepFeedbackCreate
 
 router = APIRouter(tags=["ratings"])
 
@@ -55,3 +56,69 @@ async def rate_session(
         comment=rating.comment,
         created_at=rating.created_at,
     )
+
+
+@router.post("/steps/{step_id}/feedback", status_code=status.HTTP_201_CREATED)
+async def submit_step_feedback(
+    step_id: UUID,
+    data: StepFeedbackCreate,
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_active_user),
+):
+    """Submit thumbs up/down feedback for a step used in a session."""
+    # Verify step exists
+    result = await db.execute(select(StepLibrary).where(StepLibrary.id == step_id))
+    step = result.scalar_one_or_none()
+    if not step:
+        raise HTTPException(status_code=404, detail="Step not found")
+
+    session_uuid = UUID(data.session_id)
+
+    # Check for existing feedback for this step+user+session
+    existing_result = await db.execute(
+        select(StepRating).where(
+            StepRating.step_id == step_id,
+            StepRating.user_id == current_user.id,
+            StepRating.session_id == session_uuid,
+        )
+    )
+    existing = existing_result.scalar_one_or_none()
+
+    if existing:
+        existing.was_helpful = data.was_helpful
+        resp_status = "updated"
+    else:
+        new_rating = StepRating(
+            step_id=step_id,
+            user_id=current_user.id,
+            session_id=session_uuid,
+            was_helpful=data.was_helpful,
+            # rating is nullable now — thumbs-only mode
+        )
+        db.add(new_rating)
+        resp_status = "created"
+
+    # Update aggregates on step_library
+    await _update_step_helpful_counts(db, step_id)
+    await db.commit()
+
+    return {"step_id": str(step_id), "was_helpful": data.was_helpful, "status": resp_status}
+
+
+async def _update_step_helpful_counts(db: AsyncSession, step_id: UUID):
+    """Recalculate helpful_yes and helpful_no on step_library."""
+    yes_q = await db.execute(
+        select(func.count()).select_from(StepRating).where(
+            StepRating.step_id == step_id, StepRating.was_helpful == True
+        )
+    )
+    no_q = await db.execute(
+        select(func.count()).select_from(StepRating).where(
+            StepRating.step_id == step_id, StepRating.was_helpful == False
+        )
+    )
+    await db.execute(
+        StepLibrary.__table__.update()
+        .where(StepLibrary.id == step_id)
+        .values(helpful_yes=yes_q.scalar() or 0, helpful_no=no_q.scalar() or 0)
+    )

backend/app/api/endpoints/steps.py

@@ -554,6 +554,42 @@ async def delete_rating(
     return None
 
 
+# Backward-compatible /ratings alias routes
+@router.post("/{step_id}/ratings", response_model=StepRatingResponse, status_code=201,
+             include_in_schema=False)
+async def rate_step_alias(
+    step_id: UUID,
+    rating_data: StepRatingCreate,
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_active_user)
+):
+    """Alias for POST /{step_id}/rate."""
+    return await rate_step(step_id, rating_data, db, current_user)
+
+
+@router.put("/{step_id}/ratings", response_model=StepRatingResponse,
+            include_in_schema=False)
+async def update_rating_alias(
+    step_id: UUID,
+    rating_data: StepRatingUpdate,
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_active_user)
+):
+    """Alias for PUT /{step_id}/rate."""
+    return await update_rating(step_id, rating_data, db, current_user)
+
+
+@router.delete("/{step_id}/ratings", status_code=204,
+               include_in_schema=False)
+async def delete_rating_alias(
+    step_id: UUID,
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_active_user)
+):
+    """Alias for DELETE /{step_id}/rate."""
+    return await delete_rating(step_id, db, current_user)
+
+
 @router.get("/{step_id}/reviews", response_model=list[StepRatingResponse])
 async def get_reviews(
     step_id: UUID,