🏥 VA Telehealth Room Booking Solution

Last Updated: 2026-04-21

🚀 VIEW LIVE INTERACTIVE OVERVIEW →

Comprehensive Project Documentation – Interactive HTML overview with collapsible architecture sections, technical metrics, screenshot gallery, roadmap, and accessibility features (high contrast mode, keyboard shortcuts). Best viewed in browser for full functionality.

💡 Note: Interactive overview is being actively updated alongside the changelog; see the Provider User Guide for the latest end-user booking walkthrough.

🎯 Executive Summary

Ready-to-Deploy VA Solution Package – Transform manual Excel telehealth room scheduling into an enterprise-grade automated system. This Microsoft Power Platform solution eliminates double-booking conflicts, reduces administrative overhead by 15+ hours per week, and delivers real-time analytics for operational optimization.

Core Application Components

📱 PowerApps Canvas Application: 18 user-friendly screens with mobile-responsive design
⚡ Power Automate Workflows: 3+ automated flows including approval routing, user access management, and reservation expiration handling
- Reservation Request Flow (v0.3.2): Multi-branch approval workflow with Teams/email notifications
- App User List Flow (v0.3.1): Automated access provisioning with adaptive card notifications
- Reservation Expirations Flow (v0.4.1): Automated expiration management with timezone-aware delay calculations
📊 SharePoint Data Platform: Secure, auditable data storage with 3+ production lists replacing Excel files
📈 Power BI Analytics: Executive dashboards and ROI tracking
🔧 Migration Tools: Automated PowerShell scripts for seamless Excel-to-SharePoint conversion

Business Impact & ROI

✅ 15+ hours/week administrative time savings
✅ 100% elimination of double-booking conflicts
✅ Real-time visibility into room utilization and availability

Built by VA Staff, for VA Hospitals – Developed and validated at Edward Hines Jr. VA Hospital to address VA-specific workflows, compliance, and multi-building coordination. Deploy with minimal customization using the curated source + automation toolkit.

Security & Compliance

✅ VA Government Cloud: FedRAMP High authorized infrastructure
✅ HIPAA Compliance: Healthcare data protection and audit trails
✅ Single Sign-On: Seamless integration with VA Active Directory
✅ Role-Based Access: Granular permissions for staff, coordinators, managers
✅ Audit Logging: Complete tracking of all scheduling activities

Current Release (v0.8.1 – April 28, 2026) – Adds an embedded Power BI Gov analytics screen (Charts_1) and a full 26-step in-app User Guide (UserGuide) for end-user onboarding. Upgrades chart and container control packages; updates connector runtime endpoints for VA GovCloud compatibility.

What's New in v0.8.1

New Analytics Screen (Charts_1): Embedded Power BI Gov dashboard tile (A4 landscape layout, powerbi_2.4.0 control) — src/powerApps/.unpacked/Src/Charts_1.fx.yaml
New In-App User Guide Screen (UserGuide): 26-step interactive tutorial covering full reservation lifecycle with GitHub-hosted screenshots — src/powerApps/.unpacked/Src/UserGuide.fx.yaml
Control Package Upgrades: barChart 2.3→2.4, groupContainer 1.4→1.5, pieChart 2.2→2.3
New Controls: modernText_1.0.0, powerbi_2.4.0
Connector Runtime Updates: SharePoint and Office365Users connectors updated to latest VA GovCloud endpoints
Manifest Quality Improvements: BindingErrorCount 4→1, ParserErrorCount 6→3

For full release history and technical details, see CHANGELOG.md.

🔗 Quick Navigation

Area	Purpose	Link
Architecture	High-level system stack	Solution Architecture
Gallery	Visual tour of app & flows	Screenshot Gallery
Provider Guide	Step-by-step booking guide	docs/providerUserGuide/v0.8.0/providerUserGuide.html
Implementation	Deployment steps & timeline	Quick Implementation Guide
Technical Metrics	Component counts & maturity	Technical Inventory
Release Status	Roadmap & phases	Current Technical Status
Features	Core scheduling capabilities	Hospital-Specific Application Features
Compliance	Security & governance	Security & Compliance
Source Code	PowerApps / Flows / Lists	`src/`
Data & Assets	Images, Excel, BI	`assets/`
Automation Scripts	Tooling & migration	`scripts/` / `src/pwsh/`

🖼️ Screenshot Gallery

Overview of key system views (PowerApp baseline: v0.3.3, captured Oct 2025).

Screenshot	Description
Landing Screen	Personalized snapshot of current reservations, quick navigation tiles, and building selector for multi-location context.
Dynamic Schedule Grid	Interactive week matrix displaying real-time availability and conflict-prevention indicators for rapid booking decisions.
SharePoint Master Schedule	Centralized list of cross-building reservations with audit-friendly metadata and export options for reporting.
Power Automate Flow Architecture	Multi-flow ecosystem including reservation requests, user access provisioning, and automated expiration management with comprehensive Teams notifications.

📸 Full gallery with screenshots: View the interactive documentation page for embedded images and detailed architecture diagrams.

🚀 Quick Implementation Guide

👉 View Interactive Project Overview – Comprehensive v0.3.3 documentation with executive summary, architecture deep-dive, ROI analytics, and roadmap

👩‍💻 Ready-to-Deploy Package Includes:

Complete PowerApps application source code (v0.3.3)
Automated deployment scripts and migration tools
SharePoint list templates and configuration guides
Power Automate workflow definitions
Comprehensive documentation and training materials
Power BI analytics dashboards and reports

🔧 Technical Architecture

Application Stack

🏥 VA Hospital Infrastructure
├── 🔐 Azure Active Directory (Authentication)
├── ☁️ Microsoft Government Cloud (Hosting)
├── 📱 PowerApps Canvas App (User Interface)
│   ├── 📋 Room Booking Screens (8 screens)
│   ├── 👥 User Management Interface (4 screens)
│   ├── 📊 Reporting & Analytics (3 screens)
│   └── ⚙️ Administration Panel (3 screens)
├── 📊 SharePoint Lists (Data Layer)
│   ├── 🏢 Room Master Data
│   ├── 📅 Booking Requests & Reservations
│   ├── 👤 User Roles & Permissions
│   └── 📈 Analytics & Audit Logs
├── ⚡ Power Automate (Business Logic)
│   ├── 📧 Reservation Request Flow (v0.3.2)
│   │   ├── Multi-branch approval routing
│   │   ├── Parallel Teams/email notifications
│   │   └── Manager escalation logic
│   ├── 👥 App User List Flow (v0.3.1)
│   │   ├── Automated access provisioning
│   │   ├── Adaptive card notifications
│   │   └── Role-based email templates
│   ├── ⏰ Reservation Expirations Flow (v0.4.1)
│   │   ├── Timezone-aware delay calculations
│   │   ├── Status validation & retry loops
│   │   ├── Day-specific schedule reversion
│   │   └── Comprehensive Teams diagnostics
│   └── 🛡️ Conflict Detection & Prevention
└── 📈 Power BI Dashboards (Executive Analytics)
    ├── 💰 ROI & Cost Savings Tracking
    ├── 📊 Room Utilization Metrics
    ├── ⏱️ Efficiency & Performance KPIs
    └── 📋 Operational Reports

📁 Solution Package Contents

📦 VA-Telehealth-Room-Booking-Solution/
├── 📱 src/powerApps/                 # PowerApps Canvas Application
│   ├── v0.8.1_README.md              # Comprehensive v0.8.1 release documentation
│   ├── v0.8.1_ReleaseMessage.md      # v0.7.4→v0.8.1 release notes and change analysis
│   ├── v0.8.1_diffAnalysis.md        # Technical diff v0.7.4→v0.8.1
│   ├── app-config.json               # Application configuration parameters
│   ├── .msapp/                       # Packaged application binary
│   ├── .unpacked/                    # Full source code (YAML format)
│   └── .zip/                         # Original Power Apps export
├── ⚡ src/power-automate/            # Power Automate Cloud Flows
│   ├── ReservationRequest/v0.3.2/    # Approval workflow with notifications
│   ├── AppUserList/v0.3.1/           # User access provisioning
│   └── ReservationExpirations/v0.4.1/ # Automated expiration management
│       ├── .unpacked/                # Flow definition & manifest
│       └── README.md                 # Comprehensive flow documentation
├── 📊 src/sharepoint/                # SharePoint List Schemas
│   ├── App_ReservationLog/           # Reservation requests & audit trail
│   ├── TelehealthMasterSched_CombiTable/ # Master schedule state
│   └── App_UserList/                 # User roles & permissions
├── 🔧 scripts/pwsh/                  # PowerShell Automation Tools
│   ├── intake-create-issue.ps1       # GitHub issue automation
│   ├── test-github-connectivity.ps1  # API validation utility
│   └── [migration scripts]/          # Excel-to-SharePoint conversion
├── 📚 docs/                          # Technical Documentation
│   ├── IMPLEMENTATION-SUMMARY.md     # Deployment roadmap
│   ├── ENVIRONMENT-CONFIG-VA-GovCloud.md # VA cloud setup
│   └── [technical analysis files]/   # Architecture & analysis docs
├── 🎨 assets/                        # Media & Data Resources
│   ├── images/                       # Screenshots & diagrams
│   ├── excel/                        # Sample schedules & templates
│   └── pbi/                          # Power BI dashboard files
├── 🔧 .github/                       # GitHub Configuration
│   ├── workflows/                    # CI/CD automation
│   ├── ISSUE_TEMPLATE/               # Issue templates
│   └── copilot-instructions.md       # AI coding assistant guidance
└── 📋 [Root Documentation]/          # README, CHANGELOG, LICENSE

🏥 Application Features (v0.3.3)

Core Scheduling Functions

🗓️ Dynamic Schedule Grid: Interactive time-slot matrix with direct cell selection auto-populating booking forms
⚡ Real-Time Availability Counters: Per-room and per-building availability summaries calculated on-demand
🚫 Conflict Prevention: Automated pre-check validation before approval submission
📧 Layered Approval Workflows: Multi-branch Power Automate flows with parallel notification and escalation routing
📊 Usage Analytics: Real-time utilization metrics & trend analysis via Power BI dashboards
🔍 Advanced Search: Filter by room type, equipment, availability, and location

📊 Technical Inventory

PowerApps Architecture (v0.7.4): 18 screens | 5 components | 14,205 lines of code | 2,785 formulas | 77 assets (3.6 MB)
Power Automate Flows: 3 production flows (Reservation Request v0.3.0, App User List v0.3.1, Reservation Expirations v0.4.1)
Technical Metrics: Complexity Score 505.55 (Very High) | 30 avg formula length | Max nesting 3 | 7 delegation warnings
Code Quality: 54.69% accessibility | 33 security findings | 18 duplicate formulas | 30 magic numbers
Documentation: 4,000+ lines technical docs | Complete deployment guide | Troubleshooting FAQ | Migration notes
Analysis Tools: 10 PowerShell scripts | Automated metrics collection | Excel consolidation (12 worksheets)
Data Connectors: SharePoint (3 production lists), Office 365 Users, Outlook, Teams, Excel Online
Development Infrastructure: 12 JavaScript scripts, 8+ PowerShell scripts, 20+ markdown documentation files
Business Logic: Room/desk booking, staff management, calendar integration, multi-stage approval workflows, automated expiration management

🔧 Current Technical Status

✅ Analysis & Planning Complete – Technical Foundation: 98% achieved

Ready-to-Deploy Package Benefits

🚀 Rapid Implementation: 2–3 week deployment vs. 6+ months custom development
⚙️ Developer Daily Workflow Start: Use VS Code task "🚀 Daily Workflow Start" to initialize environment
📋 Implementation Planning Guide – Full deployment strategy & resource requirements

Technical Implementation Guides

📘 Microsoft Power Platform Documentation - Official platform documentation and best practices
🚀 PowerApps Canvas App Guide - Application development and customization resources
☁️ VA Government Cloud Standards - Federal compliance and security requirements
🔒 FedRAMP Authorized Services - Government cloud security authorizations

🛠️ Development Tools

VS Code Tasks: Use Ctrl+Shift+P → Tasks: Run Task for common operations
PowerShell Profile: Enhanced commands loaded automatically (see powershell-profile.ps1)
HTML Previewer: Legacy development toolchain in /src/power-apps/v0.1.x/ (archived)
Project Validation: Automated structure and quality checks

🗂️ Issue Intake Automation (v0.3.3)

Streamlined verbal/email report → GitHub issue workflow now available without GitHub CLI dependency. The automation uses native PowerShell and the GitHub REST API for environments with restricted tooling.

Component	Path	Purpose
Connectivity Test Script	`scripts/pwsh/test-github-connectivity.ps1`	Validates Personal Access Token (PAT) and repo reachability before creating issues.
Intake Creation Script	`scripts/pwsh/intake-create-issue.ps1`	Converts intake details into a markdown body, applies labels (`intake`, `bug`, `verbal`), assigns maintainer, persists diagnostics.
Archive Output	`archive/issue-intake/`	Stores generated markdown, JSON payload(s), error responses, transcripts, and consolidated debug dumps.

Key Parameters (Intake Script)

Parameter	Description
`-Employee`	Name of reporting staff member (required).
`-Title`	Short summary; automatically prefixed with `intake:` in GitHub issue.
`-Description`	Quoted complaint or problem context.
`-Steps`	Reproduction or observation steps.
`-Severity`	One of: low, moderate, high, critical. Default: moderate.
`-Token`	PAT (falls back to `$env:GITHUB_TOKEN` when omitted).
`-Screenshot`	Optional path archived for reference.
`-DebugPayload`	Prints (or truncates) payload JSON to console unless suppressed.
`-MaxConsolePayloadLines`	Limits payload lines in console (default 300).
`-NoConsolePayload`	Suppresses console payload entirely (file artifacts still saved).
`-SaveRawPayload`	Saves minified raw JSON alongside pretty version.
`-PrettyPrintPayload`	Forces pretty formatting for console output (default behavior).
`-DumpAll`	Creates consolidated debug dump (parameters + markdown + payload).
`-CaptureLog`	Starts transcript capturing entire session output.

Generated Artifacts (per run)

issue-intake-<timestamp>.md – Issue body (markdown saved locally)
issue-intake-payload-<timestamp>.json – Pretty JSON sent to API
issue-intake-payload-raw-<timestamp>.json – Minified JSON (when -SaveRawPayload)
issue-intake-error-<timestamp>.txt – Raw server response body on failure
issue-intake-runlog-<timestamp>.log – Full transcript (when -CaptureLog)
issue-intake-debugdump-<timestamp>.txt – Consolidated diagnostic report (when -DumpAll)

Example (Full Diagnostics)

pwsh -File .\scripts\pwsh\intake-create-issue.ps1 `
    -Token $env:GITHUB_TOKEN `
    -Employee "Doe, Jane" `
    -Title "Schedule overlap in Aurora 120" `
    -Description "User reports double-booked 10:00 slot" `
    -Steps "1. Open grid; 2. Select 10:00; 3. Observe mismatch" `
    -Severity moderate `
    -DebugPayload -MaxConsolePayloadLines 80 -SaveRawPayload -DumpAll -CaptureLog

If a token is not supplied, the script opens a pre-filled browser issue page for manual submission (ensuring continuity even in locked-down environments).

ℹ️ Token Scope Guidance: Create a PAT with minimum scopes (repo → Issues & Metadata). Store it in $env:GITHUB_TOKEN for non-interactive runs.

This automation reduces intake handling overhead and provides auditable, reproducible diagnostics improving turnaround on reported issues.

📚 Documentation & Support

Available Documentation

GitHub PR Deletion FAQ - Understanding GitHub pull request limitations and why PRs cannot be fully deleted
Project Overview - See the live interactive documentation at GitHub Pages
Technical Analysis - See docs/technical-analysis-v0.1.2.md for architecture details
Change History - See CHANGELOG.md for version history and updates

Common Questions

Q: Can I delete a pull request from GitHub? A: No, GitHub does not allow pull requests to be permanently deleted. This is by design to maintain audit trails and git history integrity. See GitHub PR Deletion FAQ for detailed explanation.

Q: How do I report issues or bugs? A: Use the automated issue intake script (scripts/pwsh/intake-create-issue.ps1) or manually create a GitHub issue with the appropriate labels.

Contributors

Repository: GitHub - Telehealth Scheduling App
Lead Developer: Hospital Informatics Team
Stakeholders: Telehealth Managers (VA Hospital)

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Last Updated: October 21, 2025

Name		Name	Last commit message	Last commit date
Latest commit History 70 Commits
.github		.github
.vscode		.vscode
assets		assets
docs		docs
scripts		scripts
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
Telehealth Resources Project.code-workspace		Telehealth Resources Project.code-workspace
index.html		index.html

Folders and files

Latest commit

History

Repository files navigation

🏥 VA Telehealth Room Booking Solution

🚀 VIEW LIVE INTERACTIVE OVERVIEW →

🎯 Executive Summary

Core Application Components

Business Impact & ROI

Security & Compliance

What's New in v0.8.1

🔗 Quick Navigation

🖼️ Screenshot Gallery

🚀 Quick Implementation Guide

🔧 Technical Architecture

Application Stack

📁 Solution Package Contents

🏥 Application Features (v0.3.3)

Core Scheduling Functions

📊 Technical Inventory

🔧 Current Technical Status

Ready-to-Deploy Package Benefits

Technical Implementation Guides

🛠️ Development Tools

🗂️ Issue Intake Automation (v0.3.3)

Key Parameters (Intake Script)

Generated Artifacts (per run)

Example (Full Diagnostics)

📚 Documentation & Support

Available Documentation

Common Questions

Contributors

License

About

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages