Refactor code for improved readability and consistency

- Reformatted function signatures in `organization_service.py` and `task_service.py` for better alignment.
- Updated import statements across multiple files for consistency and organization.
- Enhanced test files by improving formatting and ensuring consistent use of async session factories.
- Added type hints and improved type safety in various service and test files.
- Adjusted `pyproject.toml` to include configuration for isort, mypy, and ruff for better code quality checks.
- Cleaned up unused imports and organized existing ones in several test files.

tests/api/v1/test_contacts.py

@@ -1,21 +1,21 @@
 """API tests for contact endpoints."""
+
 from __future__ import annotations
 
 import pytest
-from httpx import AsyncClient
-from sqlalchemy import select
-from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
-
 from app.models.contact import Contact
 from app.models.organization_member import OrganizationMember, OrganizationRole
 from app.models.user import User
-
+from httpx import AsyncClient
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
 from tests.api.v1.task_activity_shared import auth_headers, make_token, prepare_scenario
 
 
 @pytest.mark.asyncio
 async def test_list_contacts_supports_search_and_pagination(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -37,7 +37,7 @@ async def test_list_contacts_supports_search_and_pagination(
                     email="beta@example.com",
                     phone=None,
                 ),
-            ]
+            ],
         )
         await session.commit()
 
@@ -54,7 +54,8 @@ async def test_list_contacts_supports_search_and_pagination(
 
 @pytest.mark.asyncio
 async def test_create_contact_returns_created_payload(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -78,7 +79,8 @@ async def test_create_contact_returns_created_payload(
 
 @pytest.mark.asyncio
 async def test_member_cannot_assign_foreign_owner(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -88,7 +90,7 @@ async def test_member_cannot_assign_foreign_owner(
             select(OrganizationMember).where(
                 OrganizationMember.organization_id == scenario.organization_id,
                 OrganizationMember.user_id == scenario.user_id,
-            )
+            ),
         )
         assert membership is not None
         membership.role = OrganizationRole.MEMBER
@@ -107,7 +109,7 @@ async def test_member_cannot_assign_foreign_owner(
                 organization_id=scenario.organization_id,
                 user_id=other_user.id,
                 role=OrganizationRole.ADMIN,
-            )
+            ),
         )
         await session.commit()
 
@@ -126,7 +128,8 @@ async def test_member_cannot_assign_foreign_owner(
 
 @pytest.mark.asyncio
 async def test_member_can_view_foreign_contacts(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -136,7 +139,7 @@ async def test_member_can_view_foreign_contacts(
             select(OrganizationMember).where(
                 OrganizationMember.organization_id == scenario.organization_id,
                 OrganizationMember.user_id == scenario.user_id,
-            )
+            ),
         )
         assert membership is not None
         membership.role = OrganizationRole.MEMBER
@@ -155,7 +158,7 @@ async def test_member_can_view_foreign_contacts(
                 organization_id=scenario.organization_id,
                 user_id=other_user.id,
                 role=OrganizationRole.MANAGER,
-            )
+            ),
         )
 
         session.add(
@@ -165,7 +168,7 @@ async def test_member_can_view_foreign_contacts(
                 name="Foreign Owner",
                 email="foreign@example.com",
                 phone=None,
-            )
+            ),
         )
         await session.commit()
 
@@ -181,7 +184,8 @@ async def test_member_can_view_foreign_contacts(
 
 @pytest.mark.asyncio
 async def test_member_patch_foreign_contact_forbidden(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -191,7 +195,7 @@ async def test_member_patch_foreign_contact_forbidden(
             select(OrganizationMember).where(
                 OrganizationMember.organization_id == scenario.organization_id,
                 OrganizationMember.user_id == scenario.user_id,
-            )
+            ),
         )
         assert membership is not None
         membership.role = OrganizationRole.MEMBER
@@ -210,7 +214,7 @@ async def test_member_patch_foreign_contact_forbidden(
                 organization_id=scenario.organization_id,
                 user_id=other_user.id,
                 role=OrganizationRole.MANAGER,
-            )
+            ),
         )
 
         contact = Contact(
@@ -235,7 +239,8 @@ async def test_member_patch_foreign_contact_forbidden(
 
 @pytest.mark.asyncio
 async def test_patch_contact_updates_fields(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)
@@ -266,7 +271,8 @@ async def test_patch_contact_updates_fields(
 
 @pytest.mark.asyncio
 async def test_delete_contact_with_deals_returns_conflict(
-    session_factory: async_sessionmaker[AsyncSession], client: AsyncClient
+    session_factory: async_sessionmaker[AsyncSession],
+    client: AsyncClient,
 ) -> None:
     scenario = await prepare_scenario(session_factory)
     token = make_token(scenario.user_id, scenario.user_email)