Admin features (audit, log, settings)

app/api/v1/admin/audit.py

@@ -0,0 +1,116 @@
+# app/api/v1/admin/audit.py
+"""
+Admin audit log endpoints.
+
+Provides endpoints for:
+- Viewing audit logs with filtering
+- Tracking admin actions
+- Generating audit reports
+"""
+
+import logging
+from typing import Optional
+from datetime import datetime
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.orm import Session
+
+from app.api.deps import get_current_admin_user
+from app.core.database import get_db
+from app.services.admin_audit_service import admin_audit_service
+from models.schema.admin import (
+    AdminAuditLogResponse,
+    AdminAuditLogFilters,
+    AdminAuditLogListResponse
+)
+from models.database.user import User
+
+router = APIRouter(prefix="/audit")
+logger = logging.getLogger(__name__)
+
+
+@router.get("/logs", response_model=AdminAuditLogListResponse)
+def get_audit_logs(
+        admin_user_id: Optional[int] = Query(None, description="Filter by admin user"),
+        action: Optional[str] = Query(None, description="Filter by action type"),
+        target_type: Optional[str] = Query(None, description="Filter by target type"),
+        date_from: Optional[datetime] = Query(None, description="Filter from date"),
+        date_to: Optional[datetime] = Query(None, description="Filter to date"),
+        skip: int = Query(0, ge=0, description="Number of records to skip"),
+        limit: int = Query(100, ge=1, le=1000, description="Maximum records to return"),
+        db: Session = Depends(get_db),
+        current_admin: User = Depends(get_current_admin_user),
+):
+    """
+    Get filtered admin audit logs.
+
+    Returns paginated list of all admin actions with filtering options.
+    Useful for compliance, security audits, and tracking admin activities.
+    """
+    filters = AdminAuditLogFilters(
+        admin_user_id=admin_user_id,
+        action=action,
+        target_type=target_type,
+        date_from=date_from,
+        date_to=date_to,
+        skip=skip,
+        limit=limit
+    )
+
+    logs = admin_audit_service.get_audit_logs(db, filters)
+    total = admin_audit_service.get_audit_logs_count(db, filters)
+
+    logger.info(f"Admin {current_admin.username} retrieved {len(logs)} audit logs")
+
+    return AdminAuditLogListResponse(
+        logs=logs,
+        total=total,
+        skip=skip,
+        limit=limit
+    )
+
+
+@router.get("/logs/recent", response_model=list[AdminAuditLogResponse])
+def get_recent_audit_logs(
+        limit: int = Query(20, ge=1, le=100),
+        db: Session = Depends(get_db),
+        current_admin: User = Depends(get_current_admin_user),
+):
+    """Get recent audit logs (last 20 by default)."""
+    filters = AdminAuditLogFilters(limit=limit)
+    return admin_audit_service.get_audit_logs(db, filters)
+
+
+@router.get("/logs/my-actions", response_model=list[AdminAuditLogResponse])
+def get_my_actions(
+        limit: int = Query(50, ge=1, le=100),
+        db: Session = Depends(get_db),
+        current_admin: User = Depends(get_current_admin_user),
+):
+    """Get audit logs for current admin's actions."""
+    return admin_audit_service.get_recent_actions_by_admin(
+        db=db,
+        admin_user_id=current_admin.id,
+        limit=limit
+    )
+
+
+@router.get("/logs/target/{target_type}/{target_id}")
+def get_actions_by_target(
+        target_type: str,
+        target_id: str,
+        limit: int = Query(50, ge=1, le=100),
+        db: Session = Depends(get_db),
+        current_admin: User = Depends(get_current_admin_user),
+):
+    """
+    Get all actions performed on a specific target.
+
+    Useful for tracking the history of a specific vendor, user, or entity.
+    """
+    return admin_audit_service.get_actions_by_target(
+        db=db,
+        target_type=target_type,
+        target_id=target_id,
+        limit=limit
+    )