Allow parsers to declare uses remote, and remote ocr_mode (#13634)

* uses_remote_service + allow_remote to allow opt-in / out of remote OCR

* Add to parser dev docs

* remote_ocr_mode config setting

* Checks for remote_ocr_mode and fix import

* Update config.component.spec.ts

* More tests for remote_ocr_mode

* Docs for remote_ocr_mode

* Ok, wire up the remote_ocr_mode with allow_remote for consumer

* Update consumer.py

* Format remote OCR mode check tests

* Use get_choice_from_env

src-ui/src/app/components/admin/config/config.component.spec.ts

@@ -179,6 +179,7 @@ describe('ConfigComponent', () => {
       'remote_ocr_engine',
       'remote_ocr_api_key',
       'remote_ocr_endpoint',
+      'remote_ocr_mode',
     ])
   })
 })

src-ui/src/app/data/paperless-config.ts

@@ -73,6 +73,11 @@ export const RemoteOCREngineConfig = {
   AZURE_AI: 'azureai',
 }
 
+export const RemoteOCRModeConfig = {
+  ALWAYS: 'always',
+  WORKFLOW_ONLY: 'workflow_only',
+}
+
 export interface ConfigOption {
   key: string
   title: string
@@ -217,6 +222,16 @@ export const PaperlessConfigOptions: ConfigOption[] = [
     section: ConfigSection.RemoteOCR,
     note: $localize`Required when using the Azure AI engine.`,
   },
+  {
+    key: 'remote_ocr_mode',
+    title: $localize`Remote OCR Mode`,
+    type: ConfigOptionType.Select,
+    choices: mapToItems(RemoteOCRModeConfig),
+    config_key: 'PAPERLESS_REMOTE_OCR_MODE',
+    category: ConfigCategory.OCR,
+    section: ConfigSection.RemoteOCR,
+    note: $localize`Which documents are sent to the remote engine. Use 'workflow_only' to keep remote OCR off unless a workflow enables it for a document.`,
+  },
   {
     key: 'app_logo',
     title: $localize`Application Logo`,
@@ -437,6 +452,7 @@ export interface PaperlessConfig extends ObjectWithId {
   remote_ocr_engine: string
   remote_ocr_api_key: string
   remote_ocr_endpoint: string
+  remote_ocr_mode: string
   ai_enabled: boolean
   llm_embedding_backend: string
   llm_embedding_model: string