chore: update docs

This commit is contained in:
Eric Gullickson
2026-02-05 21:49:35 -06:00
parent b812282d69
commit 87ee498af7
37 changed files with 437 additions and 210 deletions

View File

@@ -1,12 +1,11 @@
# audit-log/
Centralized audit logging system for tracking all user and system actions.
## Files
| File | What | When to read |
| ---- | ---- | ------------ |
| `README.md` | Architecture and API documentation | Understanding audit log system |
| `README.md` | Architecture, usage patterns, categories | Understanding audit log system |
| `audit-log.instance.ts` | Singleton service instance | Cross-feature logging integration |
## Subdirectories
@@ -18,38 +17,3 @@ Centralized audit logging system for tracking all user and system actions.
| `jobs/` | Scheduled cleanup job | Retention policy |
| `migrations/` | Database schema | Schema changes |
| `__tests__/` | Integration tests | Adding or modifying tests |
## Key Files
| File | What | When to read |
| ---- | ---- | ------------ |
| `audit-log.instance.ts` | Singleton service instance | Cross-feature logging |
| `domain/audit-log.types.ts` | Types, categories, severities | Type definitions |
| `domain/audit-log.service.ts` | Core logging operations | Creating/searching logs |
| `data/audit-log.repository.ts` | Database queries | Data access patterns |
| `jobs/cleanup.job.ts` | 90-day retention cleanup | Retention enforcement |
## Usage
Import the singleton for cross-feature logging:
```typescript
import { auditLogService } from '../../audit-log';
// Log with convenience methods
await auditLogService.info('vehicle', userId, 'Vehicle created', 'vehicle', vehicleId);
await auditLogService.warning('auth', userId, 'Password reset requested');
await auditLogService.error('system', null, 'Backup failed', 'backup', backupId);
```
## Categories
- `auth`: Login, logout, password changes
- `vehicle`: Vehicle CRUD operations
- `user`: User management actions
- `system`: Backups, imports/exports
- `admin`: Admin-specific actions
## Retention
Logs older than 90 days are automatically deleted by a daily cleanup job (3 AM).