endpoint setup

app/api/v1/endpoints/map.py

@@ -0,0 +1,40 @@
+from fastapi import APIRouter, Depends, HTTPException, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.db.session import get_async_session
+from app.services.location_service import LocationService
+from app.schemas.map_schema import MapQueryResponse
+
+router = APIRouter(prefix="/map", tags=["Map"])
+
+
+@router.get("/query", response_model=MapQueryResponse)
+async def query_nearby_locations(
+    lat: float = Query(..., ge=-90, le=90),
+    lon: float = Query(..., ge=-180, le=180),
+    radius: int = Query(2000, gt=0, le=50000),
+    session: AsyncSession = Depends(get_async_session),
+):
+    """
+        Returns all locations within a given radius from a lat/lon point.
+        Uses PostGIS ST_DWithin (geography).
+    """
+
+    try:
+        locations = await LocationService.get_nearby_locations(
+            session=session,
+            lat=lat,
+            lon=lon,
+            radius= radius
+        )
+
+        return MapQueryResponse(
+            total=len(locations),
+            locations=locations
+        )
+
+    except Exception as e:
+        raise HTTPException(
+            status_code=500,
+            detail="Failed to fetch nearby locations"
+        )

app/api/v1/endpoints/property.py

@@ -0,0 +1,93 @@
+from fastapi import APIRouter, Depends, HTTPException, Path
+from sqlalchemy.ext.asyncio import AsyncSession
+
+
+from app.db.session import get_async_session
+from app.services.property_service import PropertyService
+from app.schemas.property_schema import PropertyResponse
+from app.schemas.full_entry_schema import FullEntryCreateRequest
+from app.schemas.property_update_request import PropertyOwnerUpdateRequest
+
+router = APIRouter(prefix="/property", tags=["Property"])
+
+
+@router.get("/by-location/{location_id}", response_model=PropertyResponse)
+async def get_property_by_location(
+    location_id: int,
+    session: AsyncSession = Depends(get_async_session),
+):
+    """
+        Fetch property + owner using location_id.
+        Called when agent clicks map box.
+    """
+
+    property_obj = await PropertyService.get_property_by_location_id(
+        session=session,
+        location_id=location_id
+    )
+
+    if not property_obj:
+        raise HTTPException(
+            status_code=404,
+            detail="Property not found for given location"
+        )
+
+    return property_obj
+
+@router.post("/create-full", response_model=PropertyResponse)
+async def create_full_entry(
+    payload: FullEntryCreateRequest,
+    session: AsyncSession = Depends(get_async_session),
+):
+    """
+    Creates Location + Owner + Property in a single transaction.
+    Frontend cannot send IDs.
+    """
+
+    try:
+        property_obj = await PropertyService.create_full_entry(
+            session=session,
+            location_data=payload.location,
+            owner_data=payload.owner,
+            property_data=payload.property,
+        )
+
+        return property_obj
+
+    except Exception as e:
+        raise HTTPException(
+            status_code=500,
+            detail="Failed to create property entry"
+        )
+    
+@router.put("/{property_id}", response_model=PropertyResponse)
+async def update_property_and_owner(
+    property_id: int = Path(..., gt=0),
+    payload: PropertyOwnerUpdateRequest = ...,
+    session: AsyncSession = Depends(get_async_session),
+):
+    """
+    Update Property + Owner details.
+    Partial updates supported.
+    """
+
+    if not payload.owner and not payload.property:
+        raise HTTPException(
+            status_code=400,
+            detail="No update data provided"
+        )
+
+    property_obj = await PropertyService.update_property_and_owner(
+        session=session,
+        property_id=property_id,
+        owner_data=payload.owner.dict(exclude_unset=True) if payload.owner else None,
+        property_data=payload.property.dict(exclude_unset=True) if payload.property else None,
+    )
+
+    if not property_obj:
+        raise HTTPException(
+            status_code=404,
+            detail="Property not found"
+        )
+
+    return property_obj

app/api/v1/property_routes.py

@@ -1,35 +0,0 @@
-import logging
-from fastapi import APIRouter, HTTPException
-from app.core.neo4j import get_driver
-from app.services.property_service import get_nearest_asset
-from app.schemas.location_request import NearestAssetRequest
-from app.schemas.property_owner_response import NearestAssetResponse
-
-logger = logging.getLogger(__name__)
-
-router = APIRouter(prefix="/properties", tags=["Geo Search"])
-
-@router.post("/nearest", response_model=NearestAssetResponse)
-def nearest_property(payload: NearestAssetRequest):
-
-    logger.info(f"Incoming geo request lat={payload.lat}, lng={payload.lng}")
-
-    try:
-        driver = get_driver()
-
-        result = get_nearest_asset(driver, payload.lat, payload.lng)
-
-        logger.info("Nearest asset query successful")
-
-        return result
-
-    except ValueError as e:
-        logger.warning(f"No asset found: {str(e)}")
-        raise HTTPException(status_code=404, detail=str(e))
-
-    except Exception as e:
-        logger.exception("Unexpected server error")
-        raise HTTPException(
-            status_code=500,
-            detail="Internal Server Error"
-        )

app/api/v1/router.py

@@ -1,5 +1,7 @@
 from fastapi import APIRouter
-from app.api.v1.property_routes import router as property_routes
+from app.api.v1.endpoints.map import router as map_routes
+from app.api.v1.endpoints.property import router as property_routes
 
 api_router = APIRouter()
+api_router.include_router(map_routes)
 api_router.include_router(property_routes)