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.

app/api/v1/__init__.py

@@ -1,20 +1,21 @@
 """Version 1 API routers."""
+
 from . import (
-	activities,
-	analytics,
-	auth,
-	contacts,
-	deals,
-	organizations,
-	tasks,
+    activities,
+    analytics,
+    auth,
+    contacts,
+    deals,
+    organizations,
+    tasks,
 )
 
 __all__ = [
-	"activities",
-	"analytics",
-	"auth",
-	"contacts",
-	"deals",
-	"organizations",
-	"tasks",
+    "activities",
+    "analytics",
+    "auth",
+    "contacts",
+    "deals",
+    "organizations",
+    "tasks",
 ]

app/api/v1/activities.py

@@ -1,4 +1,5 @@
 """Activity timeline endpoints and payload schemas."""
+
 from __future__ import annotations
 
 from typing import Literal

app/api/v1/analytics.py

@@ -1,4 +1,5 @@
 """Analytics API endpoints for summaries and funnels."""
+
 from __future__ import annotations
 
 from decimal import Decimal
@@ -16,6 +17,7 @@ def _decimal_to_str(value: Decimal) -> str:
     normalized = value.normalize()
     return format(normalized, "f")
 
+
 router = APIRouter(prefix="/analytics", tags=["analytics"])
 
 
@@ -92,4 +94,6 @@ async def deals_funnel(
     """Return funnel breakdown by stages and statuses."""
 
     breakdowns: list[StageBreakdown] = await service.get_deal_funnel(context.organization_id)
-    return DealFunnelResponse(stages=[StageBreakdownModel.model_validate(item) for item in breakdowns])
+    return DealFunnelResponse(
+        stages=[StageBreakdownModel.model_validate(item) for item in breakdowns]
+    )

app/api/v1/auth.py

@@ -1,8 +1,9 @@
 """Authentication API endpoints and payloads."""
+
 from __future__ import annotations
 
-from pydantic import BaseModel, EmailStr
 from fastapi import APIRouter, Depends, HTTPException, status
+from pydantic import BaseModel, EmailStr
 from sqlalchemy import select
 from sqlalchemy.exc import IntegrityError
 
@@ -41,7 +42,7 @@ async def register_user(
     organization: Organization | None = None
     if payload.organization_name:
         existing_org = await repo.session.scalar(
-            select(Organization).where(Organization.name == payload.organization_name)
+            select(Organization).where(Organization.name == payload.organization_name),
         )
         if existing_org is not None:
             raise HTTPException(

app/api/v1/contacts.py

@@ -1,4 +1,5 @@
 """Contact API endpoints."""
+
 from __future__ import annotations
 
 from fastapi import APIRouter, Depends, HTTPException, Query, status
@@ -81,7 +82,9 @@ async def create_contact(
     context: OrganizationContext = Depends(get_organization_context),
     service: ContactService = Depends(get_contact_service),
 ) -> ContactRead:
-    data = payload.to_domain(organization_id=context.organization_id, fallback_owner=context.user_id)
+    data = payload.to_domain(
+        organization_id=context.organization_id, fallback_owner=context.user_id
+    )
     try:
         contact = await service.create_contact(data, context=context)
     except ContactForbiddenError as exc:

app/api/v1/deals.py

@@ -1,4 +1,5 @@
 """Deal API endpoints backed by DealService with inline payload schemas."""
+
 from __future__ import annotations
 
 from decimal import Decimal
@@ -8,7 +9,7 @@ from pydantic import BaseModel
 
 from app.api.deps import get_deal_repository, get_deal_service, get_organization_context
 from app.models.deal import DealCreate, DealRead, DealStage, DealStatus
-from app.repositories.deal_repo import DealRepository, DealAccessError, DealQueryParams
+from app.repositories.deal_repo import DealAccessError, DealQueryParams, DealRepository
 from app.services.deal_service import (
     DealService,
     DealStageTransitionError,
@@ -66,7 +67,9 @@ async def list_deals(
         statuses_value = [DealStatus(value) for value in status_filter] if status_filter else None
         stage_value = DealStage(stage) if stage else None
     except ValueError as exc:
-        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Invalid deal filter") from exc
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST, detail="Invalid deal filter"
+        ) from exc
 
     params = DealQueryParams(
         organization_id=context.organization_id,
@@ -96,7 +99,9 @@ async def create_deal(
 ) -> DealRead:
     """Create a new deal within the current organization."""
 
-    data = payload.to_domain(organization_id=context.organization_id, fallback_owner=context.user_id)
+    data = payload.to_domain(
+        organization_id=context.organization_id, fallback_owner=context.user_id
+    )
     try:
         deal = await service.create_deal(data, context=context)
     except DealAccessError as exc:

app/api/v1/organizations.py

@@ -1,4 +1,5 @@
 """Organization-related API endpoints."""
+
 from __future__ import annotations
 
 from fastapi import APIRouter, Depends, HTTPException, status

app/api/v1/tasks.py

@@ -1,4 +1,5 @@
 """Task API endpoints with inline schemas."""
+
 from __future__ import annotations
 
 from datetime import date, datetime, time, timezone