Scribe Playground Page - User Actions Guide
File Path:console/src/app/[tenant]/(console)/scribe/playground/[id]/page.tsx
Route: /[tenant]/scribe/playground/[noteId]
Overview
The Scribe Playground is the main note editing interface supporting three creation methods: AI-generated from audio transcription, manual text entry, or upload from documents/images. Includes rich text editing, AI chat for modifications, medical code assignment, and version history.Note Types
AI Note (Recording)
Record audio, get transcription, generate AI note.Manual Note
Write note content directly in editor.Upload Note
Generate note from uploaded images/PDFs.Available Actions - AI Note
1. Start/Resume Recording
Purpose: Capture audio for transcription. Step-by-Step Instructions:-
Navigate to AI Note
- Or create new AI note from list
-
Check microphone permission
- Warning shown if not granted
-
Recording starts automatically
- Or use PiP controls
- Audio transcribed in real-time
2. Generate AI Note
Purpose: Create structured note from transcript. Step-by-Step Instructions:- Complete or pause recording
-
Click “Generate AI Note” button
- Large purple/blue gradient button
-
Select template (if not chosen)
- Modal prompts for template
-
Wait for generation
- “Generating Note…” displayed
- Can leave page and return
-
Review generated content
- Switches to Note tab
3. Select Note Template
Purpose: Choose format for generated note. Step-by-Step Instructions:-
Locate template dropdown
- “Select a Note Template”
- Click dropdown
- Search for template
-
Select template
- Will be used for generation
4. View Transcript
Purpose: See transcribed audio text. Step-by-Step Instructions:- Click “Transcript” tab
-
View transcribed content
- Read-only display
-
Copy or reference
- Using action bar
5. Chat with AI to Modify Note
Purpose: Ask AI to change generated note. Step-by-Step Instructions:- After note is generated
-
Locate chat input
- Bottom of note editor
-
Type modification request:
- “Make this more concise”
- “Add more detail about symptoms”
- “Format as bullet points”
- Press Enter or click send
-
New version created
- Navigated to new revision
6. Save Note Changes
Purpose: Save manual edits to content. Step-by-Step Instructions:- Edit note in text editor
-
“Save” button activates
- In action bar
- Click Save
-
New version created
- Previous version preserved
7. Sign Off Note
Purpose: Finalize and lock note. Step-by-Step Instructions:- With generated note content
-
Click “Sign off” button
- If you have permission
-
Note marked as signed off
- Cannot be edited further
8. View Note Versions
Purpose: See edit history. Step-by-Step Instructions:- Note shows version number
-
Navigate between versions
- Via version selector
- Previous versions read-only
- Alert shown when viewing old version
Available Actions - Manual Note
9. Write Note Content
Purpose: Enter note manually. Step-by-Step Instructions:- Navigate to Manual Note
- Click in editor
-
Type note content
- Rich text formatting available
- Use ”/” for templates/suggestions
- Save when complete
10. Apply Template to Note
Purpose: Start from template content. Step-by-Step Instructions:-
Click “Start from a Template”
- In action bar
- Select template from modal
-
Template content inserted
- Replaces current content
- Edit as needed
Available Actions - Upload Note
11. Upload Documents/Images
Purpose: Generate note from files. Step-by-Step Instructions:- Navigate to Upload Note
-
Drag and drop files
- Or click “Select File”
-
Supported formats:
- JPEG, PNG, HEIC images
- PDF documents
- Word documents (DOCX)
-
Files up to 10MB
- Large images auto-compressed
12. Add Multiple Files
Purpose: Upload several documents. Step-by-Step Instructions:- After initial upload
- Click “Add More Files”
- Select additional files
- All files processed together
13. Skip AI Processing
Purpose: Attach files without analysis. Step-by-Step Instructions:- After selecting files
- Check “Skip AI processing”
-
Files attached as-is
- No content extraction
14. Generate Note from Upload
Purpose: AI analyzes and creates note. Step-by-Step Instructions:- Select files
- Select template (required)
- Ensure “Skip AI processing” unchecked
- Click “Generate Note”
-
AI extracts:
- Medications
- Vital signs
- Clinical notes
Common Actions - All Note Types
15. View/Add Attachments
Purpose: Manage note files. Step-by-Step Instructions:- Click “Attachments” tab
- View existing attachments
-
Upload new files
- If note owner
16. Manage Medical Codes
Purpose: Assign ICD-10 and CPT codes. Step-by-Step Instructions:-
Click “Codes” tab
- If SCRIBE_MEDICAL_CODES enabled
-
Search and add ICD-10 codes
- Diagnosis codes
-
Search and add CPT codes
- Procedure codes
- Save with note
17. View Source Documents
Purpose: See documents note was generated from. Step-by-Step Instructions:- If note has source documents
- View list above note content
- Click to view original
18. Copy Note Content
Purpose: Copy text to clipboard. Step-by-Step Instructions:-
Use action bar
- Copy button
- Content copied
Tabs Available
| Tab | Shows | When Available |
|---|---|---|
| Clinician’s Note | Generated/written content | After content exists |
| Transcript | Audio transcription | AI notes with recording |
| Note Template | Template structure | All notes |
| Attachments | Files and images | All notes |
| Codes | ICD-10/CPT codes | If module enabled |
Note States
| State | Meaning |
|---|---|
| Recording | Audio being captured |
| Processing | Audio being saved |
| Paused | Recording paused, can resume |
| Complete | Note generated/saved |
| Signed Off | Finalized, no edits |
Version History
- Each save creates new version
- Previous versions preserved
- Can view but not edit old versions
- Latest version is editable
Weight Loss Clinic Features
For weight loss clinics:- Weight detection from notes
- Progress charts displayed
- Medication tracking
Permissions
| Action | Admin | Manager | Staff |
|---|---|---|---|
| Create notes | ✓ | ✓ | ✓ |
| Edit own notes | ✓ | ✓ | ✓ |
| Sign off notes | ✓ | ✓ | ✗ |
| Assign codes | ✓ | ✓ | ✓ |
| View others’ notes | ✓ | ✓ | ✓ |
| Edit others’ notes | ✗ | ✗ | ✗ |
Troubleshooting
| Issue | Solution |
|---|---|
| Can’t edit note | Check if you’re the owner |
| Generation failed | Check transcript exists |
| Template not applying | Select template first |
| Mic not working | Check browser permissions |
| Upload too large | File exceeds 10MB limit |
| Chat not responding | Wait for previous request |
| Viewing old version | Switch to latest version |
