/senaite.health

SENAITE extension for Health Care Labs, the evolution of Bika Health

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

senaite.core

SENAITE.HEALTH: SENAITE for healthcare labs, the evolution of Bika Health

https://img.shields.io/pypi/v/senaite.health.svg?style=flat-square https://travis-ci.org/senaite/senaite.health.svg?branch=master https://img.shields.io/scrutinizer/g/senaite/senaite.health/master.svg?style=flat-square https://img.shields.io/github/issues-pr/senaite/senaite.health.svg?style=flat-square https://img.shields.io/github/issues/senaite/senaite.health.svg?style=flat-square https://img.shields.io/github/contributors/senaite/senaite.health.svg?style=flat-square

Introduction

SENAITE.HEALTH is an Open Source Laboratory Information System (LIS) suitable for Health Care Laboratories, focused on patient and clinical cases.

SENAITE.HEALTH is an extension for SENAITE.CORE, an Open Source LIMS for enterprise environments, especially focused to behave with high speed, excellent performance and good stability.

This software is a derivative work of BikaHealth software and comes with the same user interface.

Installation

SENAITE.HEALTH is built on top of Plone CMS, so it must be installed first. Please, follow the installation instructions for Plone 4.x first.

Once Plone 4.x is installed successfully, you can choose any of the two options below:

Ready-to-go installation

With this installation modality, the sources from senaite.health will be downloaded automatically from Python Package Index (Pypi). If you want the latest code from the source code repository, follow the installation instructions for development.

Create a new buildout file senaite.cfg which extends your existing buildout.cfg – this way you can easily keep development stuff separate from your main buildout.cfg which you can also use on the production server:

[buildout]
index = https://pypi.python.org/simple
extends = buildout.cfg

[instance]
eggs +=
    senaite.health

Note that with this approach you do not need to modify the existing buildout.cfg file.

Then build it out with this special config file:

bin/buildout -c senaite.cfg

and buildout will automatically download and install all required dependencies.

For further details about Buildout and how to install add-ons for Plone, please check Installing add-on packages using Buildout from Plone documentation.

Installation for development

This is the recommended approach how to enable senaite.health for your development environment. With this approach, you'll be able to download the latest source code from senaite.health's repository and contribute as well.

Use git to fetch senaite.health source code to your buildout environment:

cd src
git clone git://github.com/senaite/senaite.health.git senaite.health

Create a new buildout file senaite.cfg which extends your existing buildout.cfg – this way you can easily keep development stuff separate from your main buildout.cfg which you can also use on the production server.

senaite.cfg:

[buildout]
index = https://pypi.python.org/simple
extends = buildout.cfg
develop +=
    src/senaite.health

[instance]
eggs +=
    senaite.health

Note that with this approach you do not need to modify the existing buildout.cfg file.

Then build it out with this special config file:

bin/buildout -c senaite.cfg

and buildout will automatically download and install all required dependencies.

Contribute

We want contributing to SENAITE.HEALTH to be fun, enjoyable, and educational for anyone, and everyone. This project adheres to the Contributor Covenant. By participating, you are expected to uphold this code. Please report unacceptable behavior.

Contributions go far beyond pull requests and commits. Although we love giving you the opportunity to put your stamp on SENAITE.HEALTH, we also are thrilled to receive a variety of other contributions. Please, read Contributing to senaite.core document.

Feedback and support

License

SENAITE.HEALTH Copyright (C) 2018 Senaite Foundation

This software, henceforth "SENAITE.HEALTH", an add-on for Plone software, is a derivative work of BikaHealth.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.