auto_awesome AI Features & Integration Hub
This document lists all interactive AI features integrated into Cliniva. Each feature uses a unified AI engine that connects to OpenAI or Gemini models when an API key is configured, and falls back to Demo Mode (mock responses) when no key is set.
settings AI Configuration Settings
Before using live AI models, configure your API key:
location_on Location: Admin → Settings → AI Settings /admin/settings/ai-settings
How to Configure:
- Navigate to the page from the sidebar (Admin section).
- Select your AI Provider (Google Gemini or OpenAI).
- Choose the Model (e.g.,
gpt-4o,gemini-1.5-flash). - Enter your API Key and click Save Configuration.
- Click Test Connection to verify.
public Global AI Features
1. AI Chat Assistant
Floating Widgetlocation_on Every page (bottom-right corner)
A persistent, draggable chat bubble (like Intercom/Drift) that lets users ask any clinic-related question.
How to Use:
- Click the floating chat bubble icon.
- Type a question or select a quick-action button.
- The AI responds in real-time with contextual answers.
2. AI Smart Insights
Dashboard Cardlocation_on
Admin Dashboard (/admin/dashboard/main)
Displays 3 AI-generated predictive insights based on current hospital metrics (patient count, bed occupancy, emergency cases).
How to Use:
- Open the Admin Dashboard.
- Find the AI Smart Insights card.
- Insights auto-load and animate in with a staggered reveal.
admin_panel_settings Admin Features
3. AI Triage Advisory
In-page buttonlocation_on Admin → Emergency → Patient Triage Form
Analyzes vitals, chief complaint, and symptoms to determine the Emergency Severity Index (ESI) Level (1-5).
How to Use:
- Fill in patient vitals and complaint details.
- Click AI Triage Analysis.
- The AI returns: ESI level with justification, primary risks, recommended diagnostics, and immediate precautions.
4. AI ICU Resource Forecaster
In-page buttonlocation_on Admin → ICU Dashboard
Predicts ICU inflow risk, recommended staffing ratios, capacity alerts, and peak admission hours.
How to Use:
- Open the ICU Dashboard.
- Click AI Resource Forecast.
- Review the predictive analysis card with risk level, staffing recommendations, and actionable insights.
5. AI Diet Plan Generator
In-page buttonlocation_on Admin → Diet & Nutrition → Assessment
Generates a detailed 7-day clinical diet meal plan based on patient parameters and conditions.
How to Use:
- Enter patient details (age, weight, height, target calories, conditions).
- Click Generate Diet Plan.
- AI returns a structured 7-day plan with daily meals and snacks.
6. AI Clinical Notes Scribe
Dialog buttonlocation_on Admin → EMR → Clinical Notes
Transforms raw doctor observations into a professionally structured clinical note.
How to Use:
- Open the Add/Edit Clinical Notes dialog.
- Enter raw observations in the description field.
- Click AI Auto-Write.
- The AI structures the note into Symptoms, Diagnosis, and Plan.
7. AI Discharge Summary Writer
Dialog buttonlocation_on Admin → Discharge → Summary Creation
Auto-generates a complete discharge summary from the primary diagnosis.
How to Use:
- Click Add Summary or edit an existing one.
- Enter the Primary Diagnosis.
- Click AI Auto-Write.
- The AI drafts the full medical summary and instructions.
health_and_safety Doctor Features
8. AI Patient Health Summary
Dialog buttonlocation_on Doctor → Patients → Patient Records
Parses patient diagnostic history and generates a structured clinical summary with a chronological timeline.
How to Use:
- Open a patient record's edit dialog.
- View the AI Clinical Summary panel.
- Click Generate AI Summary.
- The AI displays a structured summary with timeline.
9. AI Prescription Scribe & Safety
Dialog buttonslocation_on Doctor → Prescriptions
Auto-fills dosage from raw notes and analyzes for drug interactions, warnings, and contraindications.
How to Use:
- Click Add Prescription.
- AI Scribe: Enter raw medication notes → click AI Scribe.
- Drug Safety Check: Enter details → click AI Safety Check.
- Review the color-coded alert panel.
personal_injury Patient Features
10. AI Vitals Anomaly Detector
In-page buttonlocation_on Patient → Health Monitoring
Scans all logged vital signs (BP, HR, glucose, SpO2) for critical anomalies and trends.
How to Use:
- Open the Health Monitoring page.
- Click Run AI Vitals Analysis.
- The AI displays an alert card with overall status and wellness recommendations.
11. AI Lab Report Interpreter
Dialog buttonlocation_on Patient → Lab Reports
Interprets lab result text, parses biomarkers, flags High/Low/Normal status, and provides simple explanations.
How to Use:
- Open the Add/Edit Lab Report dialog.
- Enter test name and results summary.
- Click AI Interpret Report.
- The AI returns a per-metric breakdown with badges.
12. AI Doctor-Speak Explainer
In-page buttonlocation_on Patient → Documents
Translates complex medical jargon from clinical notes into plain English.
How to Use:
- Open a document from the list.
- Scroll to the AI Doctor-Speak Explainer section.
- Click Translate Medical Terms.
- The AI identifies terms and provides a simple summary.
13. AI Diet & Habits Planner
Dialog buttonlocation_on Patient → Lifestyle
Generates a personalized daily nutrition plan with meal breakdown, habits checklist, and grocery list.
How to Use:
- Click the Diet Plans card on the Lifestyle page.
- Select Wellness Goal and Dietary Preference.
- Input target daily calories and click Generate Plan.
- The AI returns a full plan, saved to local storage.
table_chart Summary of All AI Features
Developer Tip
You can
easily extend these features or build new ones by using the
postPrompt() method inside the AiService. Just inject
the service into any component and start building intelligent workflows!
code Architecture
- Demo Mode: All features work without an API key using mock responses.
- AI Service: Powered by
AiService.postPrompt()from@core/service/ai.service. - Configuration: Keys are stored in
localStorageundercliniva_ai_config. - Components: All AI-enabled components use
ChangeDetectionStrategy.OnPushfor high performance.
security Security & Compliance
- API Key Proxy Pattern: Do not use
localStoragefor API keys in production. Implement a backend proxy. - HIPAA Compliance: Anonymize patient PII (Names, IDs) before sending data to models.
- Transition: Simply update the
baseUrlin yourAiServiceto point to your secure API gateway.