fa5ed6c2b4
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Dv6sqaY6Vq3ChZHMem3cnU
361 lines
25 KiB
HTML
361 lines
25 KiB
HTML
<div class="module-header">
|
|
<h2><i class="fas fa-circle-question"></i> Frequently Asked Questions</h2>
|
|
<p>Learn how PedsHub 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">How do I sign in?</button>
|
|
<div class="faq-answer">
|
|
<p>Press <strong>Sign in with PedsHub</strong>. You are taken to the PedsHub sign-in page, type your email, and a 6-digit code is emailed to you; type it and you are in. There is no password to remember. Tick <em>Remember me on this device</em> and the code is asked for once a month rather than every time.</p>
|
|
<p>The same account signs into the quiz app at <strong>pedshub.com</strong>. New accounts are created from an invitation link an administrator sends; there is no sign-up form here.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What is PedsHub Clinical Tools?</button>
|
|
<div class="faq-answer">
|
|
<p>PedsHub 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">How does the Clinical Assistant cite its sources?</button>
|
|
<div class="faq-answer">
|
|
<p>Every answer is grounded in the clinical library: the assistant searches it first and writes from what it finds. Numbered chips <strong>[1]</strong>, <strong>[2]</strong>… link to the source cards beside the answer, numbered in the order they first appear; a source cited again keeps its number. Hover or tap a chip to see the source; the same numbers appear in the PDF export's reference list.</p>
|
|
<p>An administrator can switch the chips off; the answer is still grounded in the same sources, it just does not show the markers.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">Where do the suggested questions on the empty screen come from?</button>
|
|
<div class="faq-answer">
|
|
<p>They are written by the AI from the clinical library itself and refreshed periodically, so they reflect what the library can actually answer. Each is a short case with a decision to make; tap one to ask it, or type your own.</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 or assistant answer to hear it spoken aloud. Your administrator adds one or more speech models; each brings its own voices. Choose the voice you like in <strong>Settings > Voice Preferences</strong> — the list shows every voice of every model, grouped by model — and press <strong>Preview</strong> to hear it before saving. Leave it on <em>Server default</em> to use whatever the administrator chose.</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 class="faq-item">
|
|
<button class="faq-question">Can I export a Clinical Assistant conversation?</button>
|
|
<div class="faq-answer">
|
|
<p>Yes. The export button on an answer produces a PDF of the conversation with its reference list; on a phone it opens as a sheet you can print or save. Tables and citations are kept.</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">Where is my password? What about two-factor authentication?</button>
|
|
<div class="faq-answer">
|
|
<p>There is no password for this app. Signing in is done at the PedsHub sign-in page with a code sent to your email, which already proves you hold the mailbox; that is the second factor. If you cannot receive email, contact an administrator.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I sign out everywhere?</button>
|
|
<div class="faq-answer">
|
|
<p>Press <strong>Sign out</strong>. It ends your session in this app and your PedsHub sign-in itself, so the quiz app is signed out too and the next person at the computer cannot get back in with one click. Signing in again is one press of <strong>Sign in with PedsHub</strong>.</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>
|
|
|
|
<!-- My Resources -->
|
|
<div class="faq-section">
|
|
<h3 class="faq-section-title"><i class="fas fa-chalkboard-user"></i> My Resources (teaching decks & documents)</h3>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">What is My Resources?</button>
|
|
<div class="faq-answer">
|
|
<p>A place to make teaching material: give it a topic, choose <strong>Presentation</strong> or <strong>Article</strong>, and the AI writes it — grounded in the clinical library, and optionally in PubMed and the web when your administrator has enabled those. Presentations are built as real slide decks with comparisons, tables, callouts and, if you ask, illustrations. Everything you make is private to you.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I change how a deck looks?</button>
|
|
<div class="faq-answer">
|
|
<p>Open the deck and pick a <strong>theme</strong>; every theme has a downloadable sample deck showing each slide layout, so you can see it before choosing. The theme applies to every presentation, including ones written before themes existed. <strong>Modify</strong> takes plain-language instructions ("add a table comparing…", "shorten the introduction") and keeps your theme.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<button class="faq-question">How do I download or share a resource?</button>
|
|
<div class="faq-answer">
|
|
<p><strong>Preview</strong> shows every page in place, on a phone too. Download as <strong>PowerPoint</strong>, <strong>Word</strong> or <strong>PDF</strong>, or send the rendered file straight to your Nextcloud; articles download as Word or PDF.</p>
|
|
<p><strong>Share</strong> makes a link you can send however you like; whoever follows it, signed in, is asked whether to add the resource to their own library, and can then open, preview and download it — not change it. Sharing is by link only: nothing of yours appears in anyone else's library unless they followed your link. What others share with you appears marked "Shared by …".</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>
|