View source for COAR Notify: PCI

==Introduction==
The COAR Notify PCI implementation integrates EPrints repositories with Peer Community In (PCI). PCI presents a new approach for reviewing and endorsing preprints, and the implementation supports the workflow allowing users to submit preprints to their chosen PCI and be informed of any updates. Preprints which are endorsed are updated to show links to endorsements on the repository summary page.

More information about PCI can be found at their website: https://peercommunityin.org/

==Overview==
The EPrints PCI implementation supports the entire PCI request for endorsement workflow and potential outcomes. The below flow chart shows the potential routes.

[[File:PCI Endorsement Workflow.png|600px|thumb|PCI Request Endorsement Flow Chart - Ant Leaf, https://coar-notify.net/catalogue/workflows/repository-pci/|none]]

An overview of the steps involved in requesting an endorsement and how this is represented in the repository is shown below. 

===Preprint Item Type===
A new "preprint" item type is introduced and can be selected from the deposit workflow. 

Preprint item summary pages will display a message stating that the item not been peer reviewed.

[[File:Preprint Summary Page.png|600px|thumb|none]]

Preprint items also have an extra action in the Actions tab for an EPrint to manage the items interactions with a PCI community.

[[File:PCI- EPrint Actions Screen.png|600px|thumb|The "Submit to PCI" button appears in the EPrints Actions tab for Preprint items that are in the live archive and have a document attached.|none]]

===PCI Manager===
====Step 1: Request Endorsement====
The first step is to choose a PCI community to request an endorsement from.

[[File:PCI Manager- Choose a Community.png|600px|thumb|none]]

Once a community has been selected the screen will display a message stating the request has been sent.

[[File:PCI Manager- Request Pending.png|600px|thumb|none]]

At this stage there are no further actions to be taken by the user whilst a response from the PCI community is pending.

====Step 2: First Response====
=====Rejection or Tentative Rejection=====
If the PCI community rejects the request a message is displayed on the PCI Manager screen to inform the user.

If the response was only a Tentative Rejection, the user may submit the item for another request for an endorsement. A reference to the initial (rejected) request is included in the new request submission.

Rejections are not displayed on public facing summary pages and PCI does not publish negative reviews.

=====Tentative Accept=====
The PCI community has tentatively accepted the item for review.

At this stage there is still no action for the user to take. 

The PCI Manager screen displays the payload of the COAR Notify linked data notifications so that the content of the messages can be reviewed if necessary.

[[File:PCI Manager- Tenatively Accept.png|600px|thumb|none]]

====Step 3: Second Response====
=====Rejection=====
The submission has been rejected, marking the end of the workflow. The PCI Manager screen is updated to display the rejected status. 

Negative reviews are not published by PCI and the summary page of the record in the repository is not updated to reflect the rejection.

[[File:PCI Manager- Rejection.png|600px|thumb|none]]

=====Tentative Reject=====
A Tentative Reject response may be sent, indicating the Reviewer recommends some changes. 

The user is once again free to submit to a PCI community again, with a reference to this rejection now included in the initial request.

[[File:PCI Manager- Tentative Reject.png|600px|thumb|none]]

=====Announce Reviews and Announce Endorsement=====
If the request has been accepted, PCI will send notifications for both the successful reviews and the overall endorsement. This marks the end of the PCI workflow and the item cannot be submitted for further review processes.

[[File:PCI Manager- Announce Endorsement.png|600px|thumb|none]]

Once the repository has received these, the preprint record's summary page is updated to indicate the item has been reviewed and a link to the PCI endorsement is displayed.

[[File:Preprint Summary Page with Endorsement.png|600px|thumb|none]]

==Download and Install==

'''Prerequisites: [[Signposting]]; [[COAR Notify]] ingredient/plugin.'''

===Ingredient (for EPrints v3.4+)===

Available at: https://github.com/eprintsug/pci_review

Including the ingredient in the repository flavour's inc file should be sufficient for installation, no further customisations required.

===Bazaar Plugin (for EPrints v3)===

Available at: https://github.com/eprintsug/pci_review/tree/epm

The EPM can be installed either via the Bazaar or by inclusion as a submodule in your repository's lib/epm directory.

==Version History==
===Version 1.0 (29th July 2025)===
* Initial release with support for complete PCI workflow