mnemo_cards/mnemo_cards_backend/lib/database/tables/audit.dart

import 'package:drift/drift.dart';
import 'package:drift_postgres/drift_postgres.dart';
import '../converters.dart' show generateUuid;

/// Таблица AuditLogs - audit trail для отслеживания изменений
/// 
/// ⚠️ ВАЖНО: Инфраструктура создается, но пока НЕ используется в коде.
/// Вызовы auditDao.log() будут добавлены позже, когда определим
/// какие операции нужно логировать.
/// 
/// Планируемые операции для логирования:
/// - Критичные: платежи, удаления пользователей, изменения подписок
/// - Retention policy: автоматическая очистка записей старше 90 дней
class AuditLogs extends Table {
  // ID как String, но фактически UUID (генерируется PostgreSQL на стороне БД)
  TextColumn get id => text()
      .withDefault(const CustomExpression('gen_random_uuid()::text'))();
  
  // Какая таблица и запись изменена
  // например: 'Users', 'Payments'
  TextColumn get table => text()();
  // ID записи, которая изменилась
  TextColumn get recordId => text()();
  
  // Тип операции: 'INSERT', 'UPDATE', 'DELETE', 'SOFT_DELETE', 'RESTORE'
  TextColumn get action => text()();
  
  // Кто сделал изменение
  // ID пользователя (null для системных операций)
  TextColumn get userId => text().nullable()();
  
  // Данные до и после (JSON as TEXT)
  // JSON данные до изменения
  TextColumn get oldData => text().nullable()();
  // JSON данные после изменения
  TextColumn get newData => text().nullable()();
  
  // Дополнительная информация
  TextColumn get ipAddress => text().nullable()();
  TextColumn get userAgent => text().nullable()();
  
  // Audit
  Column<PgDateTime> get createdAt => customType(PgTypes.timestampWithTimezone)
      .withDefault(now())();
  
  @override
  Set<Column> get primaryKey => {id};
}