# Audit Logs API

Comprehensive audit trail for all data changes.

## Model

```json
{
  "id": "uuid",
  "module": "Student",
  "entity_id": "student-uuid",
  "action": "update",
  "user_id": "user-uuid",
  "user_email": "admin@school.edu",
  "ip_address": "192.168.1.1",
  "user_agent": "Mozilla/5.0...",
  "before_data": {...},
  "after_data": {...},
  "changes": ["status", "current_class_id"],
  "created_at": "2024-01-15T10:30:00Z"
}
```

## Actions

| Action | Description |
|--------|-------------|
| `create` | New record created |
| `update` | Record modified |
| `delete` | Record deleted |

## Endpoints

!!! warning "Admin Only"
    Audit log access requires admin role.

### List Logs

`POST /api/audit_logs/list`

### Get by Entity

`GET /api/audit_logs/entity/:module/:entityId`

Get all changes for a specific record.

### Get by User

`GET /api/audit_logs/user/:userId`

Get all changes by a specific user.

### Get by Date Range

`GET /api/audit_logs/date-range?start=2024-01-01&end=2024-01-31`

### Get Statistics

`GET /api/audit_logs/statistics`

## Export

`POST /api/audit_logs/export`

Export audit logs to Excel.