ModelCrudMetadata class

Immutable audit metadata associated with a single record.

This model centralizes who created/updated/deleted a record and when, plus an optional logical version used for optimistic locking or history.

JSON contract:

• Required fields:
  • recordId (string)
  • createdBy (string)
  • createdAt (string; parsed by DateUtils.dateTimeFromDynamic)
  • updatedBy (string)
  • updatedAt (string; parsed by DateUtils.dateTimeFromDynamic)
• Optional fields (only included when non-null):
  • deleted (bool)
  • deletedBy (string)
  • deletedAt (string; parsed by DateUtils.dateTimeFromDynamic)
  • version (int)

Timestamps are represented as DateTime and converted using DateUtils.dateTimeFromDynamic and DateUtils.dateTimeToString.

Minimal runnable example:

void main() {
  final ModelCrudMetadata created = ModelCrudMetadata(
    recordId: 'group-001',
    createdBy: 'system@domain.com',
    createdAt: DateTime.utc(2025, 1, 1, 10, 0, 0),
    updatedBy: 'system@domain.com',
    updatedAt: DateTime.utc(2025, 1, 1, 10, 0, 0),
    version: 1,
  );

  final Map<String, dynamic> json = created.toJson();
  final ModelCrudMetadata roundtrip = ModelCrudMetadata.fromJson(json);

  print(roundtrip.recordId); // group-001
  print(roundtrip.createdAt); // DateTime instance
}