---
title: SAIF.Application.Services.AudioVideo.32 business rules
summary: Enumerated business rules with per-rule trigger, enforcement, and outcomes.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-15
library: SAIF.Application.Services.AudioVideo.32
reference_type: package
---

# SAIF.Application.Services.AudioVideo.32 business rules

This page captures business rules enforced by this library. No rule here originates from an inherited base class or service in a dependency package — `EntityBase<T>` (from `SAIF.Framework.Common`) contributes only structural/identity behavior; no business rule was traced to it in the scanned source.

## BR-AV-01 Required current user ID

| Field | Value |
| --- | --- |
| **Statement** | `CurrentUserId` is required on an import request. |
| **Trigger** | `AudioVideoValidator.Validate` |
| **Enforcement** | `AudioVideoValidator` constructor, `RuleFor(x => x.CurrentUserId).NotEmpty()` |
| **Outcome** | Validation failure surfaces as `SaifValidationException` from `AudioVideoService.ImportRecording`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs` |

---

## BR-AV-02 Required call recording

| Field | Value |
| --- | --- |
| **Statement** | `CallRecording` is required on an import request. |
| **Trigger** | `AudioVideoValidator.Validate` |
| **Enforcement** | Same file, `RuleFor(x => x.CallRecording).NotEmpty()` |
| **Outcome** | Validation failure surfaces as `SaifValidationException` from `AudioVideoService.ImportRecording`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs` |

---

## BR-AV-03 Required claim number

| Field | Value |
| --- | --- |
| **Statement** | A claim number (`ClaimId`) is required to import a recording. |
| **Trigger** | `AudioVideoValidator.Validate` |
| **Enforcement** | Same file, `RuleFor(x => x.ClaimId).NotEmpty()` |
| **Outcome** | Validation failure, message "Error: A claim number is required." |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs` |

---

## BR-AV-04 Required investigation number for fraud recordings

| Field | Value |
| --- | --- |
| **Statement** | An investigation/case number (`InvestigationId`) is required when the recording system is `Fraud`. |
| **Trigger** | `AudioVideoValidator.Validate` when `RecordingSystem == RecordingSystemTypes.Fraud` |
| **Enforcement** | Same file, `.When(x => x.RecordingSystem == RecordingSystemTypes.Fraud)` |
| **Outcome** | Validation failure, message "Error: A case number is required." |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs` |

---

## BR-AV-05 Description length limit

| Field | Value |
| --- | --- |
| **Statement** | The combined description+notes text (`CallRecordingExtensions.GetDescription(CallRecording)`) must be ≤ 100 characters. The validation message itself states "less than 80 characters" — a documented inconsistency between the enforced limit of 100 and the stated limit of 80. |
| **Trigger** | `AudioVideoValidator.Validate` |
| **Enforcement** | Same file, `Must(x => CallRecordingExtensions.GetDescription(x).Length <= 100)` |
| **Outcome** | Validation failure, message text states an (inconsistent) "less than 80 characters" limit. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs` |

---

## BR-AV-06 Default purge horizon and recording system code

| Field | Value |
| --- | --- |
| **Statement** | Recordings default to `RecordingSystemCode = "BRD"` (board minutes) with a 90-year purge horizon unless overridden by [BR-AV-07](#br-av-07-claim-recording-purge-horizon) or [BR-AV-08](#br-av-08-fraud-recording-purge-horizon). |
| **Trigger** | `AudioVideoService.CreateRecording` |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs`, `CreateRecording` `switch` default case |
| **Outcome** | New `Recording` row persisted with `PurgeDate = createDate.AddYears(90)`, `RecordingSystemCode = "BRD"`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-07 Claim recording purge horizon

| Field | Value |
| --- | --- |
| **Statement** | Claim recordings (`RecordingSystemTypes.Claim`) get a 75-year purge horizon and `RecordingSystemCode = "CLM"`. |
| **Trigger** | `request.RecordingSystem == RecordingSystemTypes.Claim` |
| **Enforcement** | Same file/method, `case RecordingSystemTypes.Claim` |
| **Outcome** | `PurgeDate = createDate.AddYears(75)`, `RecordingSystemCode = "CLM"`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-08 Fraud recording purge horizon

| Field | Value |
| --- | --- |
| **Statement** | Fraud recordings (`RecordingSystemTypes.Fraud`) get a 5-year purge horizon and `RecordingSystemCode = "FRD"`. |
| **Trigger** | `request.RecordingSystem == RecordingSystemTypes.Fraud` |
| **Enforcement** | Same file/method, `case RecordingSystemTypes.Fraud` |
| **Outcome** | `PurgeDate = createDate.AddYears(5)`, `RecordingSystemCode = "FRD"`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-09 Recording discoverability

| Field | Value |
| --- | --- |
| **Statement** | A recording is discoverable only for the `Claim` recording system and when the "Other Party" call-flag is absent or equals `"Injured Worker"`. |
| **Trigger** | `CallRecordingExtensions.IsDiscoverable`, called from `AudioVideoService.CreateRecording` |
| **Enforcement** | `Services\Utilities\AudioVideo\CallRecordingExtensions.cs`, `IsDiscoverable` |
| **Outcome** | `Recording.IsDiscoverable` flag set accordingly. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\CallRecordingExtensions.cs` |

---

## BR-AV-10 Recording description default

| Field | Value |
| --- | --- |
| **Statement** | Recording description defaults to the "Other Party" value (or `"Injured Worker"` if absent), with call `Notes` appended only if any `KeyValues` flags exist. |
| **Trigger** | `CallRecordingExtensions.GetDescription`, called from the validator ([BR-AV-05](#br-av-05-description-length-limit)) and `CreateRecording` |
| **Enforcement** | `Services\Utilities\AudioVideo\CallRecordingExtensions.cs`, `GetDescription` |
| **Outcome** | `Recording.Description` value / validation input. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\CallRecordingExtensions.cs` |

---

## BR-AV-11 Backup file integrity check

| Field | Value |
| --- | --- |
| **Statement** | An imported recording's local backup copy is only accepted if its MD5 hash matches the source file; a mismatched backup file is deleted. |
| **Trigger** | `AudioVideoService.CopyOriginalRecordingFileToBackup` |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs`, MD5 comparison via the `SAIF.HashUtil`-backed `GetMD5Hash` extension |
| **Outcome** | Returns `false` (treated as a "conversion skip" upstream) and deletes the mismatched backup file. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-12 Audio conversion format

| Field | Value |
| --- | --- |
| **Statement** | Audio conversion re-encodes the recording to mono, 32kbps WMA via a fixed ffmpeg command line. |
| **Trigger** | `AudioVideoService.ConvertAudioRecording` |
| **Enforcement** | Same file, `engine.CustomCommand($"-i ... -ac 1 -ab 32000 ...")` (`MediaToolkit.Engine`) |
| **Outcome** | Produces a `.wma` output file; if conversion fails, the original file is copied through unconverted with no error raised. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-13 Import verification null recording check

| Field | Value |
| --- | --- |
| **Statement** | Import verification fails if the `Recording` row is null. |
| **Trigger** | `AudioVideoService.VerifyImport` |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs`, `VerifyImport` |
| **Outcome** | Throws `ApplicationException`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-14 Import verification missing converted file check

| Field | Value |
| --- | --- |
| **Statement** | Import verification fails if the converted `.wma` file does not exist at the expected path. |
| **Trigger** | `AudioVideoService.VerifyImport` |
| **Enforcement** | Same file, `VerifyImport` |
| **Outcome** | Throws `ApplicationException`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-15 Import verification zero-length file check

| Field | Value |
| --- | --- |
| **Statement** | Import verification fails if the converted file exists but has zero length. |
| **Trigger** | `AudioVideoService.VerifyImport` |
| **Enforcement** | Same file, `VerifyImport` |
| **Outcome** | Throws `ApplicationException`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-16 Import failure cleanup

| Field | Value |
| --- | --- |
| **Statement** | On any import failure after a `Recording` row was created or found, the row is deleted and import status is set to `Errored` before re-throwing. |
| **Trigger** | `AudioVideoService.ImportRecording` catch block |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs` |
| **Outcome** | `Recording` row removed; `AudioImportStatus.Status = "Errored"`; original exception propagated. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-17 CallRex deletion required for import completion

| Field | Value |
| --- | --- |
| **Statement** | Import is not considered complete unless the source recording is successfully deleted from the CallRex system. |
| **Trigger** | `AudioVideoService.ImportRecording`, post-verification |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs` |
| **Outcome** | If CallRex deletion fails: `AudioImportStatus.Status = "Errored"`, throws `ApplicationException` — even though the local recording already exists. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## BR-AV-18 Missing import status default

| Field | Value |
| --- | --- |
| **Statement** | A recording with no import-status row is reported with a synthetic `"Missing"` status rather than an error. |
| **Trigger** | `ImportStatusManager.GetStatus` |
| **Enforcement** | `Services\Utilities\AudioVideo\ImportStatusManager.cs` |
| **Outcome** | Returns `AudioImportStatusInfo { Status = "Missing" }`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\ImportStatusManager.cs` |

---

## BR-AV-19 Reduced constructor operation restriction

| Field | Value |
| --- | --- |
| **Statement** | All `AudioVideoService` operations except `HasMedia` throw `NotImplementedException` when the service was constructed via the reduced (`IUnitOfWork`-only) constructor. |
| **Trigger** | Any call to `MarkImportStatusErrored`, `ImportRecording`, `InvalidateRecording`, `CancelImport`, or `GetRecordingInfo(Guid)` when `_enableServicesFlag == false` |
| **Enforcement** | `Services\Utilities\AudioVideo\AudioVideoService.cs`, `_enableServicesFlag` checks throughout |
| **Outcome** | Throws `NotImplementedException("Function not valid in this instance")`. |
| **Source** | `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs` |

---

## Notes
- Mark inferred statements with `*` and unknown statements with `**`. No inferred or unknown business-rule statements were identified in this library — all 19 rules above are directly traceable to source.

## Related documentation
- [Index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Configuration](configuration.md)
- [Operations and processes](operations-processes.md)
- [API reference](api/index.md)

## Sources
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\CallRecordingExtensions.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\ImportStatusManager.cs`