feat: Implement pagination for companies, investors, and projects endpoints

app/routers/projects.py

@@ -14,14 +14,26 @@ from schemas.project_schemas import (
     ProjectData,
     ProjectUpdate,
 )
+from schemas.router_schemas import PaginatedResponse
 from sqlalchemy.orm import Session, selectinload
 
 router = APIRouter(tags=["Project Routes"])
 
 
-@router.get("/projects", response_model=List[ProjectData])
-def read_projects(db: Session = Depends(get_db)):
-    """Get all projects with their related data"""
+@router.get("/projects", response_model=PaginatedResponse[ProjectData])
+def read_projects(
+    page: int = Query(1, ge=1, description="Page number (starts at 1)"),
+    page_size: int = Query(10, ge=1, le=100, description="Items per page (max 100)"),
+    db: Session = Depends(get_db),
+):
+    """Get all projects with their related data (paginated)"""
+    # Calculate offset
+    offset = (page - 1) * page_size
+
+    # Get total count
+    total_count = db.query(ProjectTable).count()
+
+    # Get paginated results
     projects = (
         db.query(ProjectTable)
         .options(
@@ -29,6 +41,8 @@ def read_projects(db: Session = Depends(get_db)):
             selectinload(ProjectTable.investors),
             selectinload(ProjectTable.companies),
         )
+        .offset(offset)
+        .limit(page_size)
         .all()
     )
 
@@ -43,7 +57,16 @@ def read_projects(db: Session = Depends(get_db)):
         )
         project_data_list.append(project_data)
 
-    return project_data_list
+    # Calculate total pages
+    total_pages = (total_count + page_size - 1) // page_size
+
+    return PaginatedResponse(
+        items=project_data_list,
+        total=total_count,
+        page=page,
+        page_size=page_size,
+        total_pages=total_pages,
+    )
 
 
 @router.get("/projects/{project_id}", response_model=ProjectData)
@@ -151,7 +174,7 @@ def delete_project(project_id: int, db: Session = Depends(get_db)):
     return {"message": "Project deleted successfully"}
 
 
-@router.get("/projects/filter", response_model=List[ProjectData])
+@router.get("/projects/filter", response_model=PaginatedResponse[ProjectData])
 def filter_projects(
     stage: Optional[InvestmentStage] = Query(
         None, description="Filter by project stage"
@@ -166,9 +189,11 @@ def filter_projects(
     company_name: Optional[str] = Query(
         None, description="Company name (partial match)"
     ),
+    page: int = Query(1, ge=1, description="Page number (starts at 1)"),
+    page_size: int = Query(10, ge=1, le=100, description="Items per page (max 100)"),
     db: Session = Depends(get_db),
 ):
-    """Filter projects based on various criteria"""
+    """Filter projects based on various criteria (paginated)"""
 
     # Start with base query
     query = db.query(ProjectTable).options(
@@ -205,7 +230,12 @@ def filter_projects(
             CompanyTable.name.ilike(f"%{company_name}%")
         )
 
-    projects = query.all()
+    # Get total count before pagination
+    total_count = query.count()
+
+    # Calculate offset and apply pagination
+    offset = (page - 1) * page_size
+    projects = query.offset(offset).limit(page_size).all()
 
     # Transform to ProjectData format
     project_data_list = []
@@ -218,7 +248,16 @@ def filter_projects(
         )
         project_data_list.append(project_data)
 
-    return project_data_list
+    # Calculate total pages
+    total_pages = (total_count + page_size - 1) // page_size
+
+    return PaginatedResponse(
+        items=project_data_list,
+        total=total_count,
+        page=page,
+        page_size=page_size,
+        total_pages=total_pages,
+    )
 
 
 # Association management routes