|pypi| |actions| |codecov| |downloads|
edc-pharmacy
------------
EDC pharmacy is a simple pharmacy module for randomized control trials that can be integrated into clinicedc/edc projects.
The module includes stock management to enable a research project team to track chain-of-custody of investigational product from a central site to each research site and finally to each patient.
Stock items are physically labeled using the integrated labelling functionality. Generated labels use a randomly generated stock code and code128 barcodes. Label formats are fully customizable.
When integrated with an clinicedc/edc project, study site requests for stock can be generated using the subject's randomization assignment, followup schedule, and prescription.
Installation
============
.. code-block:: bash
pip install edc_pharmacy
More likely, ``edc_pharmacy`` is installed as a requirement of a ``clinicedc/edc`` project.
Overview
========
Concepts
++++++++
Task at Central
* order (central)
* receive, label as bulk stock, confirm
* repack/decant, label as stock, confirm
* with site stock request, allocate to subject, label for subject
* transfer stock to site
Tasks at Site
* generate stock request PRN (site)
* receive physical stock at site, confirm transfered stock at site
* dispense to clinic/patient
* confirm dispense to patient on CRF
Also:
* medication
* formulation
* prescription
Features
++++++++
* Tracks lot# with randomization assignment
* prints code128 label sheets (py_labels2, django_pylabel, edc_pylabel)
* generates a stock request based on subjects with valid prescriptions (Rx) using the next scheduled visit (see edc_appointment, edc_visit_tracking, edc_visit_schedule)
* stock are created in data but only available if confirmed by scanning barcode into system.
Details
=======
Qty vs Unit QTY
+++++++++++++++
* QTY is the container count, e.g. 5 bottles of 128 tablets.
* UNIT_QTY is the total number of items in the container. A bottle of 128 has ``unit_qty`` of 128 and a ``qty`` of 1.
* All stock items start with a ``qty_in`` =1 and ``qty_out`` =0 while the ``unit_qty`` = ``qty_in`` * ``container.qty`` or as in the example above, ``unit_qty`` = 1 * 128 = 128.
* If the ``unit_qty_out`` equals the initial ``unit_qty_in``, e.g 128==128, the ``qty_out`` is set to 1. A stock item with ``qty_in`` =1 and ``qty_out`` =1 is not available / in stock.
Orders
++++++
Track orders of IMP by recording the LOT # and expiration date.
Repack/Decant
+++++++++++++
Create new stock from an existing stock item. The container of the new stock item cannot be the same as the source container.
For example, create bottles of 128 tabs from a single bulk barrel of tablets.
User Testing
============
Watermarks
++++++++++
Print a watermark on labels during UAT deployments
.. code-block:: python
EDC_PHARMACY_LABEL_WATERMARK_WORD = "DO NOT USE"
See also `pylabels2 <https://github.com/erikvw/pylabels2>`__.
Print watermark on reports during UAT deployments
.. code-block:: python
EDC_PDF_REPORTS_WATERMARK_WORD = "SAMPLE"
EDC_PDF_REPORTS_WATERMARK_FONT = ("Helvetica", 100)
See also `edc-pdf-reports <https://github.com/clinicedc/edc-pdf-reports>`__.
.. |pypi| image:: https://img.shields.io/pypi/v/edc-pharmacy.svg
:target: https://pypi.python.org/pypi/edc-pharmacy
.. |actions| image:: https://github.com/clinicedc/edc-pharmacy/actions/workflows/build.yml/badge.svg
:target: https://github.com/clinicedc/edc-pharmacy/actions/workflows/build.yml
.. |codecov| image:: https://codecov.io/gh/clinicedc/edc-pharmacy/branch/develop/graph/badge.svg
:target: https://codecov.io/gh/clinicedc/edc-pharmacy
.. |downloads| image:: https://pepy.tech/badge/edc-pharmacy
:target: https://pepy.tech/project/edc-pharmacy
Raw data
{
"_id": null,
"home_page": "https://github.com/clinicedc/edc-pharmacy",
"name": "edc-pharmacy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "django Edc pharmacy, clinicedc, clinical trials",
"author": "Erik van Widenfelt",
"author_email": "ew2789@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/97/06/f5e5b09f709b28415af2376d9e43532bb0787194161e87a2cd4cd2fbd3d8/edc_pharmacy-0.3.13.tar.gz",
"platform": null,
"description": "|pypi| |actions| |codecov| |downloads|\n\nedc-pharmacy\n------------\nEDC pharmacy is a simple pharmacy module for randomized control trials that can be integrated into clinicedc/edc projects.\n\nThe module includes stock management to enable a research project team to track chain-of-custody of investigational product from a central site to each research site and finally to each patient.\nStock items are physically labeled using the integrated labelling functionality. Generated labels use a randomly generated stock code and code128 barcodes. Label formats are fully customizable.\n\nWhen integrated with an clinicedc/edc project, study site requests for stock can be generated using the subject's randomization assignment, followup schedule, and prescription.\n\nInstallation\n============\n\n.. code-block:: bash\n\n pip install edc_pharmacy\n\nMore likely, ``edc_pharmacy`` is installed as a requirement of a ``clinicedc/edc`` project.\n\n\nOverview\n========\nConcepts\n++++++++\n\nTask at Central\n\n* order (central)\n* receive, label as bulk stock, confirm\n* repack/decant, label as stock, confirm\n* with site stock request, allocate to subject, label for subject\n* transfer stock to site\n\nTasks at Site\n\n* generate stock request PRN (site)\n* receive physical stock at site, confirm transfered stock at site\n* dispense to clinic/patient\n* confirm dispense to patient on CRF\n\nAlso:\n\n* medication\n* formulation\n* prescription\n\nFeatures\n++++++++\n\n* Tracks lot# with randomization assignment\n* prints code128 label sheets (py_labels2, django_pylabel, edc_pylabel)\n* generates a stock request based on subjects with valid prescriptions (Rx) using the next scheduled visit (see edc_appointment, edc_visit_tracking, edc_visit_schedule)\n* stock are created in data but only available if confirmed by scanning barcode into system.\n\n\nDetails\n=======\n\nQty vs Unit QTY\n+++++++++++++++\n\n* QTY is the container count, e.g. 5 bottles of 128 tablets.\n* UNIT_QTY is the total number of items in the container. A bottle of 128 has ``unit_qty`` of 128 and a ``qty`` of 1.\n* All stock items start with a ``qty_in`` =1 and ``qty_out`` =0 while the ``unit_qty`` = ``qty_in`` * ``container.qty`` or as in the example above, ``unit_qty`` = 1 * 128 = 128.\n* If the ``unit_qty_out`` equals the initial ``unit_qty_in``, e.g 128==128, the ``qty_out`` is set to 1. A stock item with ``qty_in`` =1 and ``qty_out`` =1 is not available / in stock.\n\nOrders\n++++++\nTrack orders of IMP by recording the LOT # and expiration date.\n\nRepack/Decant\n+++++++++++++\n\nCreate new stock from an existing stock item. The container of the new stock item cannot be the same as the source container.\nFor example, create bottles of 128 tabs from a single bulk barrel of tablets.\n\n\nUser Testing\n============\n\nWatermarks\n++++++++++\n\nPrint a watermark on labels during UAT deployments\n\n.. code-block:: python\n\n EDC_PHARMACY_LABEL_WATERMARK_WORD = \"DO NOT USE\"\n\nSee also `pylabels2 <https://github.com/erikvw/pylabels2>`__.\n\nPrint watermark on reports during UAT deployments\n\n.. code-block:: python\n\n EDC_PDF_REPORTS_WATERMARK_WORD = \"SAMPLE\"\n EDC_PDF_REPORTS_WATERMARK_FONT = (\"Helvetica\", 100)\n\nSee also `edc-pdf-reports <https://github.com/clinicedc/edc-pdf-reports>`__.\n\n\n.. |pypi| image:: https://img.shields.io/pypi/v/edc-pharmacy.svg\n :target: https://pypi.python.org/pypi/edc-pharmacy\n\n.. |actions| image:: https://github.com/clinicedc/edc-pharmacy/actions/workflows/build.yml/badge.svg\n :target: https://github.com/clinicedc/edc-pharmacy/actions/workflows/build.yml\n\n.. |codecov| image:: https://codecov.io/gh/clinicedc/edc-pharmacy/branch/develop/graph/badge.svg\n :target: https://codecov.io/gh/clinicedc/edc-pharmacy\n\n.. |downloads| image:: https://pepy.tech/badge/edc-pharmacy\n :target: https://pepy.tech/project/edc-pharmacy\n",
"bugtrack_url": null,
"license": "GPL license, see LICENSE",
"summary": "Pharmacy models and classes for clinicedc/edc projects",
"version": "0.3.13",
"project_urls": {
"Homepage": "https://github.com/clinicedc/edc-pharmacy"
},
"split_keywords": [
"django edc pharmacy",
" clinicedc",
" clinical trials"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "49cf2ff8628e1976edbb8defc94779b33180913347f28a6347aa04329fc3b2ac",
"md5": "54d7d0f808589d1eab0de0dd758989cf",
"sha256": "e32013f7a21c1e790ce0313111f81ed29deab34d3403255289278be48bd28260"
},
"downloads": -1,
"filename": "edc_pharmacy-0.3.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "54d7d0f808589d1eab0de0dd758989cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 295559,
"upload_time": "2024-11-23T04:25:16",
"upload_time_iso_8601": "2024-11-23T04:25:16.957644Z",
"url": "https://files.pythonhosted.org/packages/49/cf/2ff8628e1976edbb8defc94779b33180913347f28a6347aa04329fc3b2ac/edc_pharmacy-0.3.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9706f5e5b09f709b28415af2376d9e43532bb0787194161e87a2cd4cd2fbd3d8",
"md5": "133c641e5de7417137ccfbde5e6e973c",
"sha256": "2b034c4979b80798a8f81a8886444f7c6033e38439b8d25f4e8982bc47d26be6"
},
"downloads": -1,
"filename": "edc_pharmacy-0.3.13.tar.gz",
"has_sig": false,
"md5_digest": "133c641e5de7417137ccfbde5e6e973c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 232858,
"upload_time": "2024-11-23T04:25:19",
"upload_time_iso_8601": "2024-11-23T04:25:19.401958Z",
"url": "https://files.pythonhosted.org/packages/97/06/f5e5b09f709b28415af2376d9e43532bb0787194161e87a2cd4cd2fbd3d8/edc_pharmacy-0.3.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-23 04:25:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "clinicedc",
"github_project": "edc-pharmacy",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "edc-pharmacy"
}