Help & Documentation
Guides, references, and how-to instructions for all platform features
πŸ“‹ Patient Charts

Opening a Patient Chart

  1. Click Patients in the left sidebar
  2. Search by name, ID, or diagnosis using the search bar
  3. Click any patient row to open their chart
  4. Use the tabs at the top: Overview, Notes, Assessments, Medications, Diagnoses, Billing, Documents

Writing a Clinical Note

  1. Open the patient chart β†’ click Notes tab
  2. Select note type from the dropdown (SOAP, Session, Progress, Crisis, Phone, Group, Discharge, Intake)
  3. Fill in the required fields β€” each note type shows relevant fields automatically
  4. Click Save Note β€” the note appears at the top of the list

Editing Demographics

  1. Open patient chart β†’ Overview tab
  2. Click the Edit Demographics button
  3. Update any of the 15 fields: name, DOB, gender, phone, email, address, emergency contact, insurance, insurance ID, copay, balance, billing status, referral, status, provider
  4. Click Save Changes

Adding a Diagnosis

  1. Open patient chart β†’ Diagnoses tab
  2. Type in the ICD-10 search box (e.g. "anxiety" or "F41")
  3. Select from the autocomplete list
  4. Enter onset date and status β†’ click Add Diagnosis
πŸ“ Clinical Assessments

The platform includes six validated clinical assessments with automatic scoring and severity grading.

PHQ-9
Patient Health Questionnaire β€” Depression screening (9 items)
Scoring: 0-4 None, 5-9 Mild, 10-14 Moderate, 15-19 Mod-Severe, 20-27 Severe
GAD-7
Generalized Anxiety Disorder scale (7 items)
Scoring: 0-4 Minimal, 5-9 Mild, 10-14 Moderate, 15-21 Severe
AUDIT
Alcohol Use Disorders Identification Test (10 items)
Scoring: 0-7 Low risk, 8-15 Hazardous, 16-19 Harmful, 20+ Dependent
PCL-5
PTSD Checklist for DSM-5 (20 items)
Scoring: 31+ provisional PTSD diagnosis
C-SSRS
Columbia Suicide Severity Rating Scale (6 items)
Scoring: Any positive ideation triggers clinical alert
CAGE-AID
Substance use screening (4 items)
Scoring: 2+ answers Yes = clinically significant

Completing an Assessment

  1. Open patient chart β†’ Assessments tab
  2. Click + New Assessment
  3. Select assessment type from dropdown
  4. Answer each question β€” all questions are displayed in full
  5. Score calculates automatically as you answer
  6. Click Submit Assessment
  7. If score exceeds threshold, a Clinical Alert is generated automatically
Clinical Alerts: PHQ-9 β‰₯15 triggers Critical alert. PHQ-9 β‰₯10 triggers Warning. C-SSRS any positive ideation triggers immediate Critical alert. View all alerts in the Alerts section of the sidebar.
πŸ“… Scheduling

Creating an Appointment

  1. Click Schedule in the sidebar
  2. Click + New Appointment or click an empty time slot in Week/Day view
  3. Select patient, provider, date, time, and appointment type
  4. Select room or check Telehealth for virtual sessions
  5. Add CPT code and notes as needed
  6. Click Save Appointment

Calendar Views

  • Week View β€” shows Monday–Friday with time slots
  • Day View β€” detailed view of one day's appointments
  • List View β€” scrollable list of all upcoming appointments

AI Smart Scheduling

Go to AI β†’ Smart Scheduling to use AI to suggest optimal appointment times based on patient history, provider availability, and clinical priority.

πŸ’Š e-Prescribing

Writing a Prescription

  1. Go to e-Prescribe in the sidebar, or open a patient chart β†’ Medications tab
  2. Click + New Prescription
  3. Start typing the medication name β€” autocomplete shows matching medications
  4. Select the medication, then enter dose, sig, quantity, and refills
  5. Select pharmacy and check PDMP if applicable
  6. Click Send Prescription

PDMP Monitoring

For controlled substances (DEA Schedules II-V), the platform flags the prescription for PDMP check. Mark the PDMP checkbox after verifying the patient's prescription history in your state PDMP system.

Prescription Statuses

  • Pending β€” created but not yet sent
  • Sent β€” transmitted to pharmacy
  • Filled β€” pharmacy has dispensed
  • Discontinued β€” no longer active
πŸ€– AI Clinical Features

AI Clinical Summary

  1. Go to AI β†’ Clinical Summaries
  2. Select a patient from the dropdown
  3. Choose summary type: Clinical Overview, Progress Note, Discharge Summary, or Referral Letter
  4. Click Generate Summary
  5. The summary populates with patient-specific data from the chart
  6. Click Copy to Clipboard to paste into your documentation

AI Chatbot

Go to AI β†’ Chatbot for an interactive clinical assistant. Ask questions about ICD-10 codes, medication interactions, assessment scoring, crisis protocols, or documentation best practices.

Summary Types Explained

Clinical Overview
Full patient summary including demographics, diagnoses, medications, assessments, and latest note. Use for care coordination and handoffs.
Progress Note
Formatted SOAP note using data from the most recent clinical note. Use as a documentation starting point.
Discharge Summary
Formal discharge document including diagnoses at discharge, medications, treatment summary, and follow-up plan.
Referral Letter
Professional referral letter formatted for sending to outside providers. Includes clinical data and contact information.
🎀 Dragon Copilot Voice Documentation

Starting an Ambient Session

  1. Open a patient chart
  2. Click the Dragon Copilot button (microphone icon) in the chart header
  3. In the Dragon panel β€” click Get Token to authenticate
  4. Click Initialize SDK to connect
  5. Click Start Session β€” Dragon begins listening
  6. Conduct your session normally β€” Dragon transcribes in real time
  7. Click Stop Session when done β€” the note is generated
  8. Review and save the generated note to the chart

Dragon Copilot Page

For full testing and configuration, go to Dragon Copilot in the sidebar. This page provides:

  • Auth method selector (Alt-IdP or Entra)
  • Live SDK console with detailed logging
  • Token generation and verification
  • Full ambient session controls
EhrContextInvalid error? This is a Microsoft backend provisioning issue. Contact your Dragon partner rep with your Org ID and DAX Product ID. Your code is working correctly.
πŸ“Š Reports

Running a Report

  1. Click Reports in the sidebar
  2. Select a report type from the left panel
  3. Optionally filter by patient or provider
  4. Click Run Report β€” results appear in the table
  5. Click Export CSV to download the data

Available Reports

Patient CensusAll active patients with demographics and status
Assessment OutcomesPHQ-9, GAD-7, and other assessment scores over time
Prescription ReportAll prescriptions with status and PDMP flags
Billing SummaryClaims, payments, and outstanding balances
Appointment SummaryAppointments by provider, status, and type
Clinical AlertsAll active clinical alerts by severity
Diagnosis BreakdownICD-10 code frequency across patient population
At-Risk PatientsPatients flagged as At Risk status

Saved Reports (Admin)

In Admin β†’ Custom Reports, you can save frequently used reports and schedule them for automatic delivery:

  1. Run a report using the builder
  2. Click Save Report and give it a name
  3. Click Schedule to set up automatic delivery (daily, weekly, or monthly)
  4. Enter recipient email addresses for delivery
  5. Click Run Now at any time to regenerate a saved report
βš™ Administrator Guide

Inviting a New User

  1. Go to Admin β†’ User Management
  2. Click Invite User
  3. Enter name, email, role (Admin/Provider/Nurse/Billing/Patient), and title
  4. Click Send Invitation
  5. The user receives an email with their temporary password and a link to the platform
  6. They must change their password on first login
Email not sending? Configure SMTP in Azure App Service environment variables: SMTP_HOST, SMTP_USER, SMTP_PASS, SMTP_FROM, PLATFORM_URL.

Managing Permissions

The permissions matrix in User Management shows which features each role can access. Check or uncheck boxes and click Save All Permissions.

Feature Flags

Admin β†’ Feature Flags lets you enable or disable platform features without code changes:

dragonDragon Copilot voice documentation
ai_featuresAll AI features (chatbot, summaries, scheduling)
eprescribeElectronic prescribing module
patient_portalPatient self-service portal
integrationsThird-party integrations hub
demo_modeDemo mode with sample data

Audit Log

Admin β†’ Audit Log shows every user action: logins, patient views, note saves, prescription sends, and admin changes. Filter by user, action type, or date. Export to CSV for compliance reporting.

πŸ”§ Troubleshooting
AI Summary shows an error or blank output
The AI summary is generated from patient chart data. Ensure the patient has at least one diagnosis, medication, or assessment on file. If the error persists, check Admin β†’ Error Log for details.
Dragon Copilot shows EhrContextInvalid
This is a Microsoft backend provisioning issue, not a code bug. Contact your Dragon Copilot partner representative with your Org ID (09c091f2...) and DAX Product ID (4f939ade...). Your authentication is working correctly.
Invitation email not received by user
Check Admin β†’ Error Log for SMTP errors. Verify the SMTP_HOST, SMTP_USER, SMTP_PASS environment variables are set in Azure App Service Configuration. Also check the recipient's spam folder.
Patient data disappears after restart
The platform uses in-memory storage by default. Data resets on App Service restart. Connect Azure SQL Database by setting AZURE_SQL_SERVER, AZURE_SQL_DATABASE, AZURE_SQL_USERNAME, AZURE_SQL_PASSWORD in App Service settings.
Reports show no data
Ensure there are patients in the system. In production mode (ENVIRONMENT=production), sample data is not shown. Add at least one real patient to see report data.
Login fails with correct credentials
In production, credentials are stored in Azure SQL. In demo/dev mode, use the built-in accounts (admin@renewal-bhc.com / admin2026). Check the user exists in Admin β†’ User Management.
Integrations sandbox links not working
Sandbox links open external vendor sites. An internet connection is required. Some vendors require prior registration for sandbox access (Epic, Surescripts, Availity).
New Claim button not working
Open a patient chart β†’ Billing tab β†’ click + New Claim. Fill in CPT code, amount, and insurance details. If the button appears greyed out, check that the patient has an active insurance record in their demographics.
πŸ“§ Email Configuration (SMTP Setup)

To enable invitation emails and notifications, add these environment variables in Azure App Service β†’ Configuration β†’ Application Settings:

SMTP_HOST smtp.office365.com Your email server (Office365, Gmail: smtp.gmail.com, SendGrid: smtp.sendgrid.net)
SMTP_PORT 587 Usually 587 for TLS, 465 for SSL
SMTP_USER noreply@renewal-bhc.com SMTP login username / email address
SMTP_PASS your-app-password SMTP password or app-specific password
SMTP_FROM noreply@renewal-bhc.com From address shown in emails
PLATFORM_URL https://your-app.azurewebsites.net Your platform URL included in invite emails
🌐 Three Environments, One PlatformFor administrators and implementation partners

The same code package deploys to all three environments. Only one Azure App Service environment variable changes behavior:

DEV
Dev
Active development & testing. All feature flags enabled. Sample data visible.
ENVIRONMENT=dev
Full sample data, 6 users, demo auto-login
DEMO
Demo
Client evaluations & sales demos. Curated realistic behavioral health data.
ENVIRONMENT=demo
7 patients, 8 appts, demo auto-login
PROD
Production
Live client use. Clean system. No sample data. Admin login only.
ENVIRONMENT=production
0 patients, 0 appts, 1 admin user

Deploy to Azure App Service

Set this in: Azure Portal β†’ App Service β†’ Configuration β†’ Application Settings

ENVIRONMENT=dev  Β·  AZURE_SQL_DATABASE=rbhc-dev  Β·  SECRET_KEY=any-random-string
ENVIRONMENT=demo  Β·  AZURE_SQL_DATABASE=rbhc-demo  Β·  SECRET_KEY=any-random-string
ENVIRONMENT=production  Β·  AZURE_SQL_DATABASE=rbhc-prod  Β·  SECRET_KEY=generate: python -c "import secrets; print(secrets.token_hex(32))"