feat(users): Enhance /users/ endpoint with search, filtering, and pagination

.gitignore

@@ -171,8 +171,9 @@ jeff.py
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+.idea/
 
 alembic/versions
 
-**/.DS_Store
+**/.DS_Store.idea/
+create_superadmin.py

api/utils/settings.py

@@ -34,8 +34,8 @@ class Settings(BaseSettings):
     TWILIO_AUTH_TOKEN: str = config("TWILIO_AUTH_TOKEN")
     TWILIO_PHONE_NUMBER: str = config("TWILIO_PHONE_NUMBER")
 
-    APP_NAME: str = config("APP_NAME")
-
+    APP_NAME: str = config("APP_NAME", default="HNG Boilerplate")
+    
     # Base URLs
     ANCHOR_PYTHON_BASE_URL: str = config(
         "ANCHOR_PYTHON_BASE_URL", default="https://anchor-python.teams.hng.tech"

api/v1/routes/user.py

@@ -117,33 +117,24 @@ def delete_user(
 async def get_users(
     current_user: Annotated[User, Depends(user_service.get_current_super_admin)],
     db: Annotated[Session, Depends(get_db)],
-    page: int = 1, per_page: int = 10,
-    is_active: Optional[bool] = Query(None),
-    is_deleted: Optional[bool] = Query(None),
-    is_verified: Optional[bool] = Query(None),
-    is_superadmin: Optional[bool] = Query(None)
+    page: int = Query(1, ge=1, description="Page number, starting from 1"),
+    limit: int = Query(20, ge=1, le=50, description="Users per page, max 50"),
+    search: Optional[str] = Query(None, description="Search term for first_name, last_name, or email"),
+    is_active: Optional[bool] = Query(None, description="Filter by active status"),
 ):
     """
-    Retrieves all users.
+    Retrieves all users with search, filtering, and pagination.
     Args:
-        current_user: The current user(admin) making the request
+        current_user: The current superadmin making the request
         db: database Session object
-        page: the page number
-        per_page: the maximum size of users for each page
-        is_active: boolean to filter active users
-        is_deleted: boolean to filter deleted users
-        is_verified: boolean to filter verified users
-        is_superadmin: boolean to filter users that are super admin
+        page: page number (default: 1)
+        limit: maximum users per page (default: 20, max: 50)
+        search: term to search in first_name, last_name, or email
+        is_active: filter by active status
     Returns:
-        UserData
+        AllUsersResponse
     """
-    query_params = {
-        'is_active': is_active,
-        'is_deleted': is_deleted,
-        'is_verified': is_verified,
-        'is_superadmin': is_superadmin,
-    }
-    return user_service.fetch_all(db, page, per_page, **query_params)
+    return user_service.fetch_all(db, page, limit, search, is_active)
 
 @user_router.post("", status_code=status.HTTP_201_CREATED, response_model=AdminCreateUserResponse)
 def admin_registers_user(