Initial commit - production deployment

services/pos/app/api/transactions.py

@@ -0,0 +1,148 @@
+"""
+POS Transactions API Endpoints
+ATOMIC layer - Basic CRUD operations for POS transactions
+"""
+
+from fastapi import APIRouter, Depends, HTTPException, Path, Query
+from typing import Optional
+from uuid import UUID
+from datetime import datetime
+from decimal import Decimal
+import structlog
+
+from app.core.database import get_db
+from shared.auth.decorators import get_current_user_dep
+from shared.auth.access_control import require_user_role
+from shared.routing import RouteBuilder
+from app.services.pos_transaction_service import POSTransactionService
+from app.schemas.pos_transaction import (
+    POSTransactionResponse,
+    POSTransactionListResponse,
+    POSTransactionDashboardSummary
+)
+
+router = APIRouter()
+logger = structlog.get_logger()
+route_builder = RouteBuilder('pos')
+
+
+@router.get(
+    route_builder.build_base_route("transactions"),
+    response_model=POSTransactionListResponse
+)
+@require_user_role(['viewer', 'member', 'admin', 'owner'])
+async def list_pos_transactions(
+    tenant_id: UUID = Path(...),
+    pos_system: Optional[str] = Query(None),
+    start_date: Optional[datetime] = Query(None),
+    end_date: Optional[datetime] = Query(None),
+    status: Optional[str] = Query(None),
+    is_synced: Optional[bool] = Query(None),
+    limit: int = Query(50, ge=1, le=200),
+    offset: int = Query(0, ge=0),
+    current_user: dict = Depends(get_current_user_dep),
+    db=Depends(get_db)
+):
+    """List POS transactions for a tenant"""
+    try:
+        service = POSTransactionService()
+
+        transactions = await service.get_transactions_by_tenant(
+            tenant_id=tenant_id,
+            pos_system=pos_system,
+            start_date=start_date,
+            end_date=end_date,
+            status=status,
+            is_synced=is_synced,
+            skip=offset,
+            limit=limit
+        )
+
+        total = await service.count_transactions_by_tenant(
+            tenant_id=tenant_id,
+            pos_system=pos_system,
+            start_date=start_date,
+            end_date=end_date,
+            status=status,
+            is_synced=is_synced
+        )
+
+        # Get sync metrics for summary
+        sync_metrics = await service.get_sync_metrics(tenant_id)
+
+        # Calculate summary
+        total_amount = sum(float(t.total_amount) for t in transactions if t.status == "completed")
+
+        has_more = (offset + limit) < total
+
+        return POSTransactionListResponse(
+            transactions=transactions,
+            total=total,
+            has_more=has_more,
+            summary={
+                "total_amount": total_amount,
+                "transaction_count": len(transactions),
+                "sync_status": sync_metrics["sync_status"]
+            }
+        )
+    except Exception as e:
+        logger.error("Failed to list POS transactions", error=str(e), tenant_id=tenant_id)
+        raise HTTPException(status_code=500, detail=f"Failed to list transactions: {str(e)}")
+
+
+@router.get(
+    route_builder.build_resource_detail_route("transactions", "transaction_id"),
+    response_model=POSTransactionResponse
+)
+@require_user_role(['viewer', 'member', 'admin', 'owner'])
+async def get_pos_transaction(
+    tenant_id: UUID = Path(...),
+    transaction_id: UUID = Path(...),
+    current_user: dict = Depends(get_current_user_dep),
+    db=Depends(get_db)
+):
+    """Get a specific POS transaction"""
+    try:
+        service = POSTransactionService()
+
+        transaction = await service.get_transaction_with_items(
+            transaction_id=transaction_id,
+            tenant_id=tenant_id
+        )
+
+        if not transaction:
+            raise HTTPException(status_code=404, detail="Transaction not found")
+
+        return transaction
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error("Failed to get POS transaction", error=str(e),
+                    tenant_id=tenant_id, transaction_id=transaction_id)
+        raise HTTPException(status_code=500, detail=f"Failed to get transaction: {str(e)}")
+
+
+@router.get(
+    route_builder.build_operations_route("transactions-dashboard"),
+    response_model=POSTransactionDashboardSummary
+)
+@require_user_role(['viewer', 'member', 'admin', 'owner'])
+async def get_transactions_dashboard(
+    tenant_id: UUID = Path(...),
+    current_user: dict = Depends(get_current_user_dep),
+    db=Depends(get_db)
+):
+    """Get dashboard summary for POS transactions"""
+    try:
+        service = POSTransactionService()
+
+        summary = await service.get_dashboard_summary(tenant_id)
+
+        logger.info("Transactions dashboard retrieved",
+                   tenant_id=str(tenant_id),
+                   total_today=summary.total_transactions_today)
+
+        return summary
+    except Exception as e:
+        logger.error("Failed to get transactions dashboard", error=str(e), tenant_id=tenant_id)
+        raise HTTPException(status_code=500, detail=f"Failed to get dashboard: {str(e)}")