.. /*
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _app-proxyprint-scenarios-personal:

|PERSONALPRINT| Scenarios
-------------------------

.. contents:: |RST_TABLE_OF_CONTENTS|
   :depth: 1
   :local:

.. _app-proxyprint-scenarios-personal-non-secure:

|PERSONALPRINT| - Non-Secure Scenarios
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

See :ref:`Proxy Print <ch-webapp-admin-options-proxy-print>`.

.. _app-proxyprint-scenarios-personal-secure:

|PERSONALPRINT| - Secure Scenarios
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. contents::
   :depth: 1
   :local:

See :ref:`Proxy Print Authentication <ch-webapp-admin-devices-card-reader-proxy-print-auth>`.

Direct Print Scenario
^^^^^^^^^^^^^^^^^^^^^

See :ref:`Direct Print Mode <ch-webapp-admin-devices-card-reader-proxy-print-direct>`.

Hold Print Scenario
^^^^^^^^^^^^^^^^^^^

See :ref:`Hold Print Mode <ch-webapp-admin-devices-card-reader-proxy-print-hold>`.

Fast Print Scenario
^^^^^^^^^^^^^^^^^^^

See :ref:`Fast Print Mode <ch-webapp-admin-devices-card-reader-proxy-print-fast>`.

Automatic Print Scenario
^^^^^^^^^^^^^^^^^^^^^^^^

See :ref:`IPP Routing <ch-webapp-admin-queue-ipp-routing>`.

.. _app-proxyprint-scenario-personal-papercut:

|PERSONALPRINT| - PaperCut Scenario
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table:: |PERSONALPRINT| - |PROD_PAPERCUT| Scenario
   :width: 100%
   :header-rows: 0
   
   * - **User Story**
     -  - As a **Print Job Creator** , I can create a |PERSONALPRINT|, 
          so that PaperCut printing costs are charged to my personal account 
          in |PRODUCT_NAME|. |br|
          |br| 
        - As an **Operator** , I can release or cancel a pending Print Job 
          in PaperCut or CUPS.
   * -  |
     -  - As a **Job Ticket Creator** , I can create a |PERSONALPRINT|. |br|
          |br|  
          This User Story is identical to the |PERSONALPRINT| track as described 
          in :ref:`Delegated Print - Job Ticket - PaperCut - Scenario <app-proxyprint-scenario-delegated-jobticket-papercut>`,
          and is not discussed here.
          
   * - **Preconditions**
     - -  :ref:`PaperCut Integration <ch-webapp-admin-options-integration-papercut>`
          is *enabled*.
       - :ref:`Delegated Print <ch-webapp-admin-options-proxy-print-delegation>`
         is *disabled*.
       - :ref:`Personal Print with PaperCut <ch-webapp-admin-options-proxy-print-papercut-integration>`
         is *enabled*.
       - |PROXYPRINTER| used for printing is managed by |PROD_PAPERCUT|.

   * - **Process**
     - 1. **Print Job Creator** creates |PERSONALPRINT| Job. |br|
          |br|
       2. **Print Job Creator** prints job to |PROD_PAPERCUT| Managed printer. |br|
          |br|
       3. Print-out document for Print Job Creator is created with status **Pending (external)** |br|
          |br|
          A Shadow SavaPage Personal Account Transaction  is created and linked. |br|
          
          - Transactions are displayed as Printer Usage with zero amount and status **Pending (external)**.
          - Transactions Summary without cost data is displayed with the Print-out document.
          
          |br|
       4. PaperCut print status is **monitored** till end state is reached. |br| 
          |br|
          Status is monitored for a maximum number of minutes, after which the Print-out document gets
          status **Error**. See :ref:`PaperCut Print Log Monitoring <app-papercut-config-printlog-monitoring>`.

   * - **Scenario 1**
     - Print **Completed**\ *.*  |br|
       |br|
       *Given* the printer is a PaperCut Hold/Release queue 
       *And* the **Operator** or **Print Job Creator** Released the job (in PaperCut), 
       *Or* the job was printed directly, *Then*: |br|
       |br|

       - Print-out document gets status **Completed**. |br|
       - *PaperCut Printing Cost* is used for the Shadow SavaPage Personal Account Transaction. |br|

         - The transactions are displayed as Printer Usage with the PaperCut amount and status  **Completed**.
         - A Transaction Summary *with* cost data is now displayed with the Print-out document.
            
   * - **Scenario 2**
     - Print is **Canceled** or **Timed out**. |br|
       |br|
       *Given* the printer is a PaperCut Hold/Release queue 
       *And* the **Operator** or **Print Job Creator** Canceled
       the job (in PaperCut or CUPS) *Or* the job Expired (in
       PaperCut) , *Then*:|br|
       |br|

       - Print-out document gets status **Canceled**. |br| |br|

         - The Shadow Transaction *continues* to be displayed
           as Printer Usage with zero amount, but now has status **Canceled**.
         - A Transaction Summary without cost data *continues* 
           to be displayed at the Print-in document.

   * - References
     - :ref:`Personal Print to PaperCut <app-papercut-personal-print>`