MS-1312 Reset OCR frame flag on screen rotation

[luhmirin-s]

JIRA ticket
Will be released in: 2026.1.0

Root cause analysis (for bugfixes only)

First known affected version: 2026.1.0 (could be also 2025.4.0, but it is a too low of a priority to check)

• View model tracks a flag to skip extra frames while the current one is processing.
• This flag is reset only after the frame is processed until the end.
• In case of configuration change the frame processing coroutine is cancelled pre-maturely and the flag is not reset correctly, which causes the OCR process to freeze.

Notable changes

• Reset the flag manually when OCR is being stopped.

Testing guidance

• Run workflow up to external credentials step and select document OCR.
• Start document scanning process and, once the progress bar moves, rotate the device to cause the configuration change.
• Proceed with scanning, it should work until the end.

Additional work checklist

• Effect on other features and security has been considered
• Design document marked as "In development" (if applicable)
• External (Gitbook) and internal (Confluence) Documentation is up to date (or ticket created)
• Test cases in Testiny are up to date (or ticket created)
• Other teams notified about the changes (if applicable)

[luhmirin-s]

@alexandr-simprints Pinging you especially, since that is your area of expertise :)

[Copilot]

Pull request overview

This PR fixes a bug where the OCR process would freeze after a screen rotation. The root cause was that a boolean flag (isRunningOcrOnFrame) used to prevent processing multiple frames simultaneously was not being reset when OCR stopped due to a configuration change, causing the scanner to become permanently blocked.

Changes:

• Added ocrStopped() method to reset the frame processing flag when OCR is stopped
• Called the new method in the stopOcr() function to ensure flag is reset during configuration changes
• Added unit test to verify the flag reset behavior

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
ExternalCredentialScanOcrViewModel.kt	Added new ocrStopped() method to reset isRunningOcrOnFrame flag
ExternalCredentialScanOcrFragment.kt	Added call to viewModel.ocrStopped() in stopOcr() method; minor refactoring of when expression
ExternalCredentialScanOcrViewModelTest.kt	Added unit test to verify ocrStopped() correctly resets the flag

[BurningAXE]

First known affected version: 2026.1.0 (could be also 2025.4.0, but it is a too low of a priority to check)

If we are deploying 2025.4.0 in GG2, it's worth fixing it there, too.

[luhmirin-s]

@BurningAXE at this point it would be too much of a hassle with the release pipeline for a rare issue (only when rotating in the specific moment) with a trivial fix (just restart the capture).

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud