---
title: SAIF.Application.Services.AudioVideo.32 architecture
summary: Architectural responsibilities, boundaries, and interaction patterns.
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 architecture

`SAIF.Application.Services.AudioVideo.32` is the x86 build variant of the audio/video call-recording import library: it compiles the identical linked source tree as the sibling `SAIF.Application.Services.AudioVideo` project, orchestrating recording import, third-party CallRex integration, and NHibernate-backed persistence of import status and recording metadata for a 32-bit host process.

## Responsibilities
- Import call recordings raised by the third-party **CallRex** call-recording system into the SAIF data model, including validation, local backup, audio-format conversion, and verification (`AudioVideoService.ImportRecording`).
- Track per-recording import status (`InProgress`/`Completed`/`Errored`/`Missing`) via `ImportStatusManager`, backed by the `audio_import_status` table.
- Provide a façade (`CallRecordingSystem`) over two WCF client proxies (`CallRexServiceProxy`, `CallRexStateServiceProxy`) that talk to the third-party CallRex `ClientService` and `AgentStateService` endpoints for recording retrieval, control (start/stop/pause/resume), invalidation/deletion, and real-time agent call-state monitoring.
- Validate import requests against business rules (required claim/case numbers, description length) via `AudioVideoValidator`.
- Expose a lightweight, always-available query (`AudioVideoService.HasMedia`) for checking whether a claim has associated recordings, usable even when the service is constructed without the full dependency set.
- Provide the identical business logic and data-access surface as `SAIF.Application.Services.AudioVideo`, but packaged and compiled specifically to run inside 32-bit (x86) host processes.

## Component boundaries
- **`Core.Contracts.AudioVideo`**: DTOs, event-arg classes, and enums (`CallRecording`, `CallUser`, `ImportAudioRequest`, `RecordingInfo`, `CallMonitorState`, etc.) — no behavior, pure data contracts consumed across all other components.
- **`Core.Services.IAudioVideoService`**: the public service contract implemented by `AudioVideoService`; defines the orchestration boundary consumed by host applications.
- **`Services.Utilities.AudioVideo.AudioVideoService`**: the orchestration/business-logic entry point. Composes `IUnitOfWork` (persistence), `IEnvironmentService` (configuration), `IImportStatusManager` (status tracking), `IRecordingSystem` (third-party recording system abstraction), and `IConsoleLogService` (logging).
- **`Services.Utilities.AudioVideo.AudioVideoValidator`**: a FluentValidation validator invoked synchronously at the start of `ImportRecording`, isolating input-validation rules from orchestration logic.
- **`Services.Utilities.AudioVideo.CallRecordingExtensions`**: centralizes two small pure-function business rules (`IsDiscoverable`, `GetDescription`) shared between the validator and the service, avoiding duplicated rule logic.
- **`Services.Utilities.AudioVideo.ImportStatusManager`**: a small NHibernate-repository-backed implementation of `IImportStatusManager`, isolated from `AudioVideoService` so import-status tracking can be reasoned about independently.
- **`Services.Utilities.AudioVideo.CallRecordingSystem`** (implements `IRecordingSystem`): the sole third-party integration façade; composes `CallRexServiceProxy` and `CallRexStateServiceProxy` and hides WCF proxy/channel details from `AudioVideoService`.
- **`Services.ClientProxies.ThirdParty.CallRexServiceProxy` / `CallRexStateServiceProxy` / `AgentStateCallback`**: thin wrappers around the generated WCF service-reference proxies (`Core.ThirdParty.CallRex`, `Core.ThirdParty.CallRexAgentState`), isolating SOAP/WCF plumbing (custom auth headers, duplex callbacks) from the rest of the library.
- **`Data.Model.AudioVideo` / `Data.NHibernate.Mappings.AudioVideo`**: NHibernate entities (`AudioImportStatus`, `Recording`, both extending `EntityBase<T>` from `SAIF.Framework.Common`) and their FluentNHibernate `ClassMap<T>` mappings, forming the persistence boundary consumed only through `IUnitOfWork`/`IRepository<T>`.

## Interaction model
- A host application (batch job, service, or console process) resolves `IAudioVideoService` and calls `ImportRecording(ImportAudioRequest)`. `AudioVideoService` first delegates validation to `AudioVideoValidator`, then coordinates persistence (`IUnitOfWork`/`IRepository<Recording>`), local file operations (backup copy, MD5 verification, ffmpeg-based conversion via the vendored `MediaToolkit` package), and third-party deletion (`IRecordingSystem.DeleteRecording`) before reporting status through `IImportStatusManager`.
- `CallRecordingSystem` is called by `AudioVideoService` (and other `IRecordingSystem` consumers) and internally routes each call to either `CallRexServiceProxy` (request/response SOAP operations against the CallRex `ClientService`) or `CallRexStateServiceProxy` (duplex/callback-based real-time agent-state monitoring against the CallRex `AgentStateService`).
- `CallRexServiceProxy` authenticates once at construction (`Login`) and re-attaches the same hard-coded credentials as custom SOAP headers on every subsequent state-changing call via `AuthorizeClientServiceCall`.
- `ImportStatusManager` and the entity-mapped repositories (`Recording`, `AudioImportStatus`) are called synchronously and transactionally (`_uow.Begin()`/`_uow.Commit()`) from within `AudioVideoService.ImportRecording`; there is no asynchronous or message-based interaction inside this library.
- No consuming application project was found within this repository's scope that references this library directly; it is packaged as a standalone NuGet library consumed by an as-yet-undetermined 32-bit host application elsewhere in the SAIF application estate.

## Architecture diagram
The following diagram shows the high-level component interactions inside this library and its principal external and framework dependencies.

```mermaid
flowchart TD
	Host["Host application<br>(32-bit process)"] --> AVS["AudioVideoService<br>(IAudioVideoService)"]
	AVS --> Validator["AudioVideoValidator"]
	AVS --> Ext["CallRecordingExtensions"]
	AVS --> UOW["IUnitOfWork / IRepository&lt;T&gt;<br>(SAIF.Framework.Core)"]
	AVS --> ISM["ImportStatusManager<br>(IImportStatusManager)"]
	AVS --> RS["CallRecordingSystem<br>(IRecordingSystem)"]
	AVS --> MTK["MediaToolkit (ffmpeg)"]
	ISM --> UOW
	RS --> Proxy1["CallRexServiceProxy"]
	RS --> Proxy2["CallRexStateServiceProxy"]
	Proxy1 --> CallRex["CallRex ClientService<br>(third-party WCF)"]
	Proxy2 --> AgentState["CallRex AgentStateService<br>(third-party WCF, duplex)"]
	UOW --> NH32["SAIF.Framework.Data.NHibernate.32<br>(bundles x86 Oracle.DataAccess.dll)"]
	NH32 --> Oracle[("Oracle database")]
```

## Sequence diagram
The following diagram shows the primary import-recording sequence, including the error-handling branch when the CallRex deletion step fails after local processing has already succeeded.

```mermaid
sequenceDiagram
	participant Host as Host application
	participant AVS as AudioVideoService
	participant Val as AudioVideoValidator
	participant UOW as IUnitOfWork/Repository
	participant ISM as ImportStatusManager
	participant RS as CallRecordingSystem (CallRex)
	Host->>AVS: ImportRecording(request)
	AVS->>Val: Validate(request)
	Val-->>AVS: ValidationResult
	AVS->>UOW: Find/create Recording row
	UOW-->>AVS: Recording entity
	AVS->>AVS: Backup copy + MD5 verify + convert (MediaToolkit)
	AVS->>AVS: VerifyImport (file/size checks)
	AVS->>RS: DeleteRecording(callRexId)
	RS-->>AVS: success/failure
	alt CallRex delete fails
		AVS->>ISM: SetErrored
		AVS-->>Host: throws ApplicationException
	else success
		AVS->>ISM: SetCompleted
		AVS-->>Host: RecordingInfo
	end
```

## Design constraints
- **32-bit (x86) build variant, not an independently designed library**: this project's `.csproj` sets `<PlatformTarget>x86</PlatformTarget>` across all configured build configurations (`Debug|AnyCPU`, `Release|AnyCPU`, and the explicit `Debug|x86`/`Release|x86` property groups), and it has **no source of its own** apart from `Properties\AssemblyInfo.cs` and generated WCF proxy files — every `<Compile>` item under `Core\`, `Data\`, and `Services\` is a linked file (`<Link>`) whose physical source lives in the sibling `SAIF.Application.Services.AudioVideo` project. Every behavioral, business-rule, and data-access finding is identical to (and traceable to the same source lines as) that sibling library.
- **32-bit Oracle client dependency drives the build variant**: this project references the 32-bit-specific NuGet package `SAIF.Framework.Data.NHibernate.32` (rather than the sibling's AnyCPU/64-bit-capable package), which bundles the x86 `Oracle.DataAccess.dll` (ODP.NET unmanaged) via a `<Reference Include="Oracle.DataAccess...processorArchitecture=x86">` entry. The unmanaged Oracle client requires bitness-matched hosting, so this variant exists specifically for host processes that only run as x86 (for example, a legacy Windows Service, an IIS application pool running in 32-bit mode, or a batch console executable constrained to x86).
- **No independent runtime dependency on the sibling assembly**: because collaboration with `SAIF.Application.Services.AudioVideo` source is via linked `.cs` files (not a `<ProjectReference>` or assembly reference), the `.32` assembly is self-contained at compile time and carries no runtime dependency on the sibling project's compiled output.
- **Vendored third-party binaries are not NuGet-restored**: `CallRex.Utilities.dll` and `CallrexAPIUtilities.dll` are referenced directly by `HintPath` from `Libs\ThirdParty\CallRex\`, outside the NuGet package-restore pipeline.
- **No consuming application found in this repository's scope**: the library is packaged as a standalone NuGet library (per its `.nuspec`) for consumption by an as-yet-undetermined 32-bit host application elsewhere in the SAIF application estate.

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

## Sources
- `Application\SAIF.Application.Services.AudioVideo.32\SAIF.Application.Services.AudioVideo.32.csproj`
- `Application\SAIF.Application.Services.AudioVideo.32\app.config`
- `Application\SAIF.Application.Services.AudioVideo\Core\Services\IAudioVideoService.cs`
- `Application\SAIF.Application.Services.AudioVideo\Core\Contracts\AudioVideo\IRecordingSystem.cs`
- `Application\SAIF.Application.Services.AudioVideo\Core\Contracts\AudioVideo\IImportStatusManager.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoService.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\AudioVideoValidator.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\CallRecordingExtensions.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\ImportStatusManager.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\Utilities\AudioVideo\RecordingSystem.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\ClientProxies\ThirdParty\CallRexServiceProxy.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\ClientProxies\ThirdParty\CallRexStateServiceProxy.cs`
- `Application\SAIF.Application.Services.AudioVideo\Services\ClientProxies\ThirdParty\AgentStateCallback.cs`
- `Application\SAIF.Application.Services.AudioVideo\Data\Model\AudioImportStatus.cs`
- `Application\SAIF.Application.Services.AudioVideo\Data\Model\Recording.cs`
- `Application\SAIF.Application.Services.AudioVideo\Data\Mappings\AudioImportStatusMap.cs`
- `Application\SAIF.Application.Services.AudioVideo\Data\Mappings\RecordingMap.cs`