337 lines
22 KiB
HTML
337 lines
22 KiB
HTML
<div class="module-header">
|
|
<h2><i class="fas fa-circle-question"></i> Frequently Asked Questions</h2>
|
|
<p>Learn how Pediatric Clinical Tools works and get the most out of it</p>
|
|
</div>
|
|
|
|
<div class="faq-container">
|
|
|
|
<!-- Getting Started -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-rocket"></i> Getting Started</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What is Pediatric Clinical Tools?</button>
|
|
<div class="faq-answer">
|
|
<p>Pediatric Clinical Tools is an AI-powered clinical documentation tool designed specifically for pediatric medicine. It helps physicians generate structured clinical notes from voice recordings or typed text, saving time on documentation so you can focus on patient care.</p>
|
|
<p>It supports HPIs, SOAP notes, hospital courses, chart reviews, well visits, sick visits, developmental milestone assessments, and more.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I create my first note?</button>
|
|
<div class="faq-answer">
|
|
<p>The easiest way to start is with <strong>Live Encounter</strong>:</p>
|
|
<ol>
|
|
<li>Go to the <strong>Encounter</strong> tab</li>
|
|
<li>Enter the patient's age and gender</li>
|
|
<li>Click <strong>Start Recording</strong> and speak naturally during your patient encounter</li>
|
|
<li>Click <strong>Stop</strong> when done — the audio is transcribed automatically</li>
|
|
<li>Click <strong>Generate HPI</strong> to create a structured note</li>
|
|
<li>Edit the note as needed, then <strong>Copy</strong> to paste into your EHR</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Can I type or paste notes instead of recording?</button>
|
|
<div class="faq-answer">
|
|
<p>Yes. Every transcript box is editable. You can type directly, paste from another source, or combine typed text with a recording. The AI works with whatever text is in the transcript area when you click Generate.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What types of notes can I generate?</button>
|
|
<div class="faq-answer">
|
|
<ul>
|
|
<li><strong>HPI</strong> — from live encounters or dictation, with OLDCARTS structure</li>
|
|
<li><strong>SOAP Notes</strong> — full SOAP or subjective-only from dictation</li>
|
|
<li><strong>Hospital Course</strong> — from progress notes, in prose, day-by-day, or organ-system format</li>
|
|
<li><strong>Chart Review</strong> — summarize outpatient, subspecialty, or ED visits for precharting</li>
|
|
<li><strong>Well Visit</strong> — complete preventive care notes with SSHADESS, milestones, and vaccines</li>
|
|
<li><strong>Sick Visit</strong> — quick documentation with auto-suggested ROS and PE</li>
|
|
<li><strong>Milestone Assessment</strong> — developmental narrative from selected milestones</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- AI & Models -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-robot"></i> AI & Models</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What AI model should I use?</button>
|
|
<div class="faq-answer">
|
|
<p>Each tab has a model selector dropdown. All available models have been tested and configured by your administrator for clinical documentation quality. They are routed through HIPAA-compliant providers with signed Business Associate Agreements (BAAs).</p>
|
|
<p>All models are capable of generating accurate clinical notes. If you are unsure which to pick, start with the default. You can experiment with different models and see which output style you prefer — some may be faster, some more detailed, some more concise. You can choose a different model per tab depending on the task.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Can I customize the AI's prompts?</button>
|
|
<div class="faq-answer">
|
|
<p>Administrators can edit all AI prompts from the <strong>Admin Panel > Settings > Prompts</strong> section. This lets you adjust the instructions the AI follows for each note type without changing any code. Changes take effect immediately.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What does the "Refine" button do?</button>
|
|
<div class="faq-answer">
|
|
<p>After generating a note, you can give the AI plain-language instructions to modify it. For example:</p>
|
|
<ul>
|
|
<li>"Make it shorter"</li>
|
|
<li>"Add that the patient has a history of asthma"</li>
|
|
<li>"Summarize the labs"</li>
|
|
<li>"Change the assessment to include bronchiolitis"</li>
|
|
</ul>
|
|
<p>The AI references both its current output and your original source material (transcript, pasted notes, labs) when refining, so it can look up details from the original input.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Voice & Transcription -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-microphone"></i> Voice & Transcription</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How does voice transcription work?</button>
|
|
<div class="faq-answer">
|
|
<p>When you stop recording, the audio is sent to a speech-to-text service that converts it to text. The app supports multiple transcription providers including Whisper, Deepgram, and Google Gemini. Your administrator configures which provider is used.</p>
|
|
<p>You will see a blue status bar at the top while transcription is in progress. You can continue working on the page while it processes.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Can I use the app on my phone?</button>
|
|
<div class="faq-answer">
|
|
<p>Yes. The app is a Progressive Web App (PWA) that works in any modern browser. On mobile:</p>
|
|
<ul>
|
|
<li>Open the app in Chrome or Safari</li>
|
|
<li>Tap "Add to Home Screen" to install it as a standalone app</li>
|
|
<li>Recording works in the foreground, but <strong>audio stops if you lock the screen or switch apps</strong> on iOS and most Android devices — this is a browser limitation, not specific to this app</li>
|
|
</ul>
|
|
<p>On desktop, recording continues normally when the browser is minimized or in the background.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What happens if transcription fails?</button>
|
|
<div class="faq-answer">
|
|
<p>If transcription fails, your audio is automatically backed up to the server for 24 hours. You can retry transcription from <strong>Settings > Audio Backups</strong>. If browser speech recognition was active during recording, the live transcript is preserved as a fallback.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Can the AI read my notes aloud?</button>
|
|
<div class="faq-answer">
|
|
<p>Yes. Click the <strong>Read</strong> button on any generated note to hear it spoken aloud. This uses text-to-speech (TTS) powered by Google, OpenAI, or ElevenLabs depending on your setup. You can choose your preferred voice in <strong>Settings > Voice Preferences</strong>.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Saving & Export -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-floppy-disk"></i> Saving & Export</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Are my encounters saved?</button>
|
|
<div class="faq-answer">
|
|
<p>You can save encounters using the <strong>Save</strong> button at the top of each tab. Saved encounters include the transcript, generated note, and patient label. You can reload them later using the <strong>Load</strong> button.</p>
|
|
<p>Saved encounters are automatically deleted after 7 days (configurable by your administrator). This is intentional — the app is a documentation tool, not a medical record system. Copy your final notes to your EHR for permanent storage.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I export notes?</button>
|
|
<div class="faq-answer">
|
|
<ul>
|
|
<li><strong>Copy</strong> — one-click copy to clipboard, ready to paste into any EHR</li>
|
|
<li><strong>Nextcloud</strong> — export directly to your Nextcloud instance (configure in Settings)</li>
|
|
<li><strong>Documents</strong> — upload files to S3-compatible storage from Settings</li>
|
|
</ul>
|
|
<p>All generated text is plain text with no markdown formatting, designed to paste cleanly into any EHR system.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Privacy & Security -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-shield-halved"></i> Privacy & Security</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Is my patient data safe?</button>
|
|
<div class="faq-answer">
|
|
<p>The app is designed with clinical privacy in mind:</p>
|
|
<ul>
|
|
<li>All connections use HTTPS/TLS encryption</li>
|
|
<li>Audio and encounter data are temporary — auto-deleted within hours or days</li>
|
|
<li>No patient data is stored long-term on the server</li>
|
|
<li>Every action is audit-logged (who accessed what, when)</li>
|
|
<li>Two-factor authentication (2FA) and session management are available</li>
|
|
<li>Server transcription can be configured with HIPAA-eligible providers</li>
|
|
</ul>
|
|
<p>For HIPAA compliance, ensure your administrator has configured a BAA-covered AI provider (such as AWS Bedrock, Google Vertex AI, or Azure OpenAI).</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What is two-factor authentication (2FA)?</button>
|
|
<div class="faq-answer">
|
|
<p>2FA adds an extra layer of security to your account. After entering your password, you also enter a 6-digit code from an authenticator app (like Google Authenticator or Authy). Enable it in <strong>Settings > Two-Factor Authentication</strong>.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I manage my active sessions?</button>
|
|
<div class="faq-answer">
|
|
<p>Go to <strong>Settings > Active Sessions</strong> to see all devices where you are logged in. You can revoke any session individually or click <strong>Revoke All Other Sessions</strong> to log out every other device. Your current session is highlighted and cannot be revoked from this screen — use the Logout button instead.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What happens when I change my password?</button>
|
|
<div class="faq-answer">
|
|
<p>When you change your password in <strong>Settings > Change Password</strong>, all other active sessions are automatically logged out for security. Only your current session remains active. The app also checks if your new password has appeared in known data breaches and warns you (but does not prevent you from using it).</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Well Visit & Sick Visit -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-baby"></i> Well Visit & Sick Visit</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How does the Well Visit tab work?</button>
|
|
<div class="faq-answer">
|
|
<p>The Well Visit tab follows the AAP Bright Futures periodicity schedule. It includes:</p>
|
|
<ul>
|
|
<li><strong>Visit by Age</strong> — recommended screenings, vaccines, and anticipatory guidance for each visit age</li>
|
|
<li><strong>Milestones</strong> — developmental milestone tracker from birth through 11 years across multiple domains</li>
|
|
<li><strong>SSHADESS</strong> — adolescent psychosocial assessment (Strengths, School, Home, Activities, Drugs, Emotions, Sexuality, Safety) for ages 12+</li>
|
|
<li><strong>Visit Note</strong> — generates a complete well visit note combining ROS, PE, milestones, and SSHADESS data</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What do the WNL / Abnormal / Not Reviewed buttons do?</button>
|
|
<div class="faq-answer">
|
|
<p>In the ROS and Physical Exam sections, each system has three options:</p>
|
|
<ul>
|
|
<li><strong>WNL / Normal</strong> — within normal limits, no concerns</li>
|
|
<li><strong>Abnormal</strong> — a text box appears so you can describe the finding</li>
|
|
<li><strong>Not Reviewed / Not Examined</strong> — explicitly not assessed</li>
|
|
</ul>
|
|
<p>Use <strong>All WNL</strong> to quickly mark everything normal, then click individual systems to change specific ones. Use <strong>Clear</strong> to reset all selections.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Learning Hub -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-graduation-cap"></i> Learning Hub</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What is the Learning Hub?</button>
|
|
<div class="faq-answer">
|
|
<p>The Learning Hub is an educational platform integrated into the app. It contains articles, clinical pearls, quizzes, and slide presentations created by moderators and administrators. You can browse by category, search content, and take quizzes to test your knowledge.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do quizzes work?</button>
|
|
<div class="faq-answer">
|
|
<p>Quizzes include multiple-choice, multi-select, and true/false questions. After submitting your answers, you see your score along with explanations for each question. Your past attempts and scores are tracked so you can monitor your progress over time.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Can I create Learning Hub content?</button>
|
|
<div class="faq-answer">
|
|
<p>Moderators and administrators can create content using the <strong>CMS</strong> tab. You can write articles manually, or use AI to generate content from a topic description, uploaded PDFs, or files from Nextcloud. The CMS also supports Marp-based slide presentations with PPTX export.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Calculators -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-calculator"></i> Pediatric Calculators</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What calculators are available?</button>
|
|
<div class="faq-answer">
|
|
<p>The <strong>Calculators</strong> tab includes clinical tools commonly used in pediatric practice:</p>
|
|
<ul>
|
|
<li><strong>Blood Pressure Percentile</strong> — AAP 2017 guidelines using the Rosner quantile spline regression method. Requires age, sex, height, and BP. Provides exact systolic and diastolic percentiles adjusted for height, with AAP classification (Normal, Elevated, Stage 1, Stage 2). Includes definitions of hypertension and hypotension.</li>
|
|
<li><strong>BMI Percentile</strong> — CDC 2000 growth reference with extended obesity classification (Class 1, 2, 3 using % of 95th percentile). Shows BMI chart with percentile curves.</li>
|
|
<li><strong>Growth Charts</strong> — Visual percentile curves (3rd through 97th) with your patient plotted. Includes Weight-for-Age, Length/Height-for-Age (with mid-parental height), Head Circumference, Weight-for-Length, and Fenton preterm charts.</li>
|
|
<li><strong>Bilirubin</strong> — AAP 2022 phototherapy threshold calculator and Bhutani hour-specific nomogram with risk zone classification. Includes Nelson Table 137.1 risk factors.</li>
|
|
<li><strong>Vital Signs by Age</strong> — Harriet Lane reference table for HR, RR, BP, and weight by age from preterm through 18 years. Includes quick formulas for estimated weight, minimum SBP, ETT size, and maintenance fluids.</li>
|
|
<li><strong>Body Surface Area</strong> — Mosteller formula for BSA calculation.</li>
|
|
<li><strong>Weight-Based Dosing</strong> — Dose per kg with frequency, max dose cap, and volume calculation from concentration.</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How accurate is the BP calculator?</button>
|
|
<div class="faq-answer">
|
|
<p>The BP calculator uses the same Rosner quantile spline regression method as the Baylor College of Medicine reference calculator. It computes exact percentiles (1st-99th) based on your patient's age, sex, and height using published regression coefficients. This is the same methodology underlying the AAP 2017 normative tables. Results are height-adjusted and clinically accurate.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What are the growth chart curves?</button>
|
|
<div class="faq-answer">
|
|
<p>The growth charts display WHO/CDC percentile curves (3rd, 5th, 10th, 25th, 50th, 75th, 90th, 95th, 97th percentiles) with your patient's measurement plotted as a blue dot. The 50th percentile is shown as a bold green line. Shaded bands show the normal range between symmetric percentiles.</p>
|
|
<p>For <strong>Length/Height-for-Age</strong>, you can optionally enter both parents' heights to see the mid-parental target height range plotted on the chart.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Troubleshooting -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-wrench"></i> Troubleshooting</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">The AI generated an incorrect note. What should I do?</button>
|
|
<div class="faq-answer">
|
|
<p>AI-generated notes should always be reviewed before use. If the output is incorrect:</p>
|
|
<ol>
|
|
<li>Edit the note directly in the output area — it is fully editable</li>
|
|
<li>Use the <strong>Refine</strong> button with specific instructions (e.g., "remove the fever mention" or "change the diagnosis")</li>
|
|
<li>Try a different AI model using the model selector — Premium models may produce more accurate results</li>
|
|
<li><strong>Save</strong> your corrected version — the app learns from your edits and will improve over time</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">My recording did not transcribe. What happened?</button>
|
|
<div class="faq-answer">
|
|
<p>Common causes:</p>
|
|
<ul>
|
|
<li><strong>Microphone permission denied</strong> — check your browser's site permissions</li>
|
|
<li><strong>Recording too short</strong> — very short recordings (under 1 second) may not contain enough audio</li>
|
|
<li><strong>Screen was locked (mobile)</strong> — iOS and Android stop recording when the screen locks. Keep the screen on while recording.</li>
|
|
<li><strong>Network issue</strong> — cloud transcription requires an internet connection</li>
|
|
</ul>
|
|
<p>If transcription fails, your audio is automatically backed up. Check <strong>Settings > Audio Backups</strong> to retry.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">I cannot see all the features. Why?</button>
|
|
<div class="faq-answer">
|
|
<p>Some features are role-restricted:</p>
|
|
<ul>
|
|
<li><strong>Admin Panel</strong> — visible only to administrators</li>
|
|
<li><strong>CMS (Content Management)</strong> — visible to moderators and administrators</li>
|
|
<li><strong>Registration</strong> — may be disabled by your administrator</li>
|
|
</ul>
|
|
<p>Contact your administrator if you need access to a restricted feature.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|