Quickstart Guide

Get started with DataMed in 5 minutes - from setup to registering your first patient

This guide will walk you through setting up DataMed and registering your first sleep apnea patient.

Prerequisites

Before you begin, ensure you have:

• Python 3.9 or higher installed
• pip (Python package manager)
• Git for cloning the repository

1. Clone the repository

   git clone <your-datamed-repo-url>
   cd datamed
   
2. Install dependencies

   Install all required packages from requirements.txt:

   pip install -r requirements.txt
   

   For development, DataMed uses SQLite by default. No additional database setup is required.

3. Configure environment variables

   Create a .env file in the project root:

   SECRET_KEY=your-secret-key-here
   

   The SECRET_KEY is only required for production. In development mode, a default key is used automatically.

4. Run database migrations

   Set up the database schema:

   python manage.py migrate
   
5. Create a superuser

   Create an admin account to access the system:

   python manage.py createsuperuser
   

   Follow the prompts to set up your username, email, and password.

6. Start the development server

   python manage.py runserver
   

   The application will be available at http://localhost:8000

Register Your First Patient

Once the server is running, you can register your first patient in the sleep apnea program.

1. Log in to the system

   Navigate to http://localhost:8000/users/login/ and enter your superuser credentials.

   After successful login, you’ll be redirected to the dashboard at /dashboard/.

2. Navigate to patient registration

   Go to /patients/create/ or click the patient registration link in the navigation menu.

3. Fill in patient information

   The patient registration form includes the following required fields:

   Personal Information

   nombre = "Juan"                    # First name
   apellido = "Pérez"                 # Last name
   tipo_documento = "CC"              # Document type (CC, TI, CE, PA, PE, RC)
   documento = "1234567890"           # Unique document number
   fecha_nacimiento = "1980-05-15"   # Birth date (YYYY-MM-DD)
   genero = "M"                       # Gender (M, F, O)
   

   The documento field must be unique across all patients. The system will prevent duplicate registrations.

4. Save the patient record

   Click the submit button to create the patient record. Upon successful creation, you’ll be redirected to the patient detail page at /patients/<patient_id>/.

Create a Program Entry

After registering a patient, you need to create an active program entry (ingreso) to track their participation in the sleep apnea program.

The entry system tracks patient status through the 18-month capita program with three states: ACTIVO, SUSPENDIDO, and TERMINADO.

To create an entry, navigate to:

/patients/ingreso/nuevo/<patient_id>/

Provide:

• fecha_inicio: Start date of the program entry
• estado: Status (defaults to ACTIVO)
• motivo: Optional reason/notes for the entry

The system automatically calculates the current month of the capita program (1-18) based on the start date.

View the Dashboard

Navigate to /dashboard/ to see:

• Overview of active patients
• Program statistics
• Patient follow-up information
• Quick access to patient records

Next Steps

Installation Guide

Detailed setup for production environments

Patient Management

Learn about patient model fields and relationships

Exam Management

Manage sleep study exams and results

Dashboard Features

Explore analytics and reporting capabilities

Common Issues

If you see DEBUG = False errors during development, ensure the RENDER environment variable is NOT set. The system automatically enables debug mode when RENDER is absent.

Database Connection Error

In development, DataMed uses SQLite by default. Ensure the project has write permissions for creating db.sqlite3.

Static Files Not Loading

Run python manage.py collectstatic to collect static files. In development mode, Django serves static files automatically.

Login Redirects to Wrong Page

Check your LOGIN_REDIRECT_URL setting in config/settings.py. The default is dashboard.