PatientOutcome Database

MongoDB database configuration for the PatientOutcome PROM (Patient Reported Outcome Measures) application.

Version

Current Version: 0.2

Overview

This repository contains the Docker Compose configuration for running MongoDB as the database backend for the PatientOutcome application.

Quick Start

Prerequisites

• Docker and Docker Compose installed
• At least 2GB of free disk space

Setup

1. Copy the environment template:

   cp .env.example .env

2. Edit .env and set your database credentials:

   DATABASE_ADMIN=your_admin_user
   DATABASE_ADMIN_PASSWORD=your_secure_password
   DATABASE_NAME=patientoutcome

3. Start the database:

   docker compose up -d

4. Verify it's running:

   docker compose ps

Configuration

Environment Variables

Variable	Description	Default
DATABASE_ADMIN	MongoDB root username	patientmanager
DATABASE_ADMIN_PASSWORD	MongoDB root password	(required)
DATABASE_NAME	Database name	patientoutcome

Docker Compose

The docker-compose.yml file defines:

• MongoDB Service: Official MongoDB image
• Volume: Persistent data storage in ./mongo-data
• Port: 27017 (default MongoDB port)

Data Persistence

MongoDB data is stored in the ./mongo-data directory. This directory is git-ignored to prevent accidental commits of database files.

Backup and Restore

Create Backup

docker exec clinical-patientoutcome-database mongodump \
  --username=your_admin \
  --password=your_password \
  --authenticationDatabase=admin \
  --db=patientoutcome \
  --archive=/data/db/backup.archive

Restore Backup

docker exec clinical-patientoutcome-database mongorestore \
  --username=your_admin \
  --password=your_password \
  --authenticationDatabase=admin \
  --db=patientoutcome \
  --archive=/data/db/backup.archive

Security Notes

• Never commit .env files with real credentials
• Use strong passwords in production
• Consider enabling MongoDB authentication
• Regularly backup your data

Related Repositories

• PatientOutcome Backend
• PatientOutcome Frontend

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Victor Cighir