Patient Intake/Output (I/O) Recorder

---

Install · Configure · Docs

This project is a simple tool for recording and tracking essential health parameters of patients. It provides a user-friendly interface for healthcare professionals to log various health metrics, including food intake, water consumption, urine volume, defecation frequency, and weight, along with corresponding timestamps for each entry. This information can be valuable for healthcare professionals to monitor and analyze the health status of patients over time.

Uses Poetry for dependency management and includes, ruff and pre-commit for linting and formatting.

Importance for Kidney Disease Management

In particular, it plays a crucial role in managing conditions such as kidney disease, where strict control over water intake is essential for maintaining health and preventing complications.

Getting Started

Installation

Patient Intake Output Recorder can be set up with either Poetry (recommended) or pip. Open a terminal in the project directory and install the dependencies:

Using Poetry

poetry install

Using pip

pip install -r requirements.txt

Configuration:

• Backend: Navigate to the config.json file located in the backend directory. Update the file by replacing {your_token_here} and {your_api_url_here} with your actual token and API URl in the following format:

  Example backend/config.json content:

  {
    "token": "{your_token_here}",
    "api_url": "{your_api_url_here}"
  }

• Frontend (Patient): Navigate to the config.json file located in the patient/ directory. Update the file by replacing {your_api_url_here} with your actual API URL in the following format:

  Example patient/config.json content:

  {
    "apiUrl": "{your_api_url_here}"
  }

• Frontend (Monitor): Navigate to the config.json file located in the monitor/ directory. Update the file by replacing {your_api_url_here} and {your_web_url_here} with your actual API URL and web URL in the following format:

  Example monitor/config.json content:

  {
    "apiUrl": "{your_api_url_here}",
    "webUrl": "{your_web_url_here}"
  }

Run the backend server

Once installed and configured, you can start the server with Uvicorn. Open your terminal and execute the following commands:

• Using Poetry

  poetry run uvicorn main:app --reload

• Using Python

  python -m uvicorn main:app --reload

This will install the necessary dependencies using Poetry and start your server using Uvicorn with automatic reloading enabled. With these steps completed, your server should be up and running, ready to handle requests.

Supported Languages

Patient Side

The patient interface currently supports the following languages:

• 繁體中文 (Traditional Chinese)
• 简体中文 (Simplified Chinese)
• Tiếng Việt (Vietnamese)
• Bahasa Indonesia
• English

You can switch languages based on the dropdown at the end of the app.

Monitor Side

The monitor interface currently supports:

• 繁體中文 (Traditional Chinese)

Additional languages may be added in the future based on demand.

Want to Contribute?

Refer to CONTRIBUTING.md

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE for more information.