Welcome to the HealthMesh documentation! This directory contains comprehensive guides, security documentation, and technical specifications.
Located in security/
- SECURITY.md - Security policy, vulnerability reporting, compliance information
- SECURITY_UPGRADE_REPORT.md - Phase 1 security audit and fixes
- SECURITY_PHASE2_COMPLETE.md - Phase 2 enhancements (RBAC, encryption, validation)
Quick Links:
- Vulnerability Reporting → SECURITY.md
- Security Checklist → SECURITY.md
- Security Scorecard → SECURITY_PHASE2_COMPLETE.md
Located in deployment/
- AZURE_PES_SETUP_GUIDE.md - Azure deployment guide
- Deployment Scripts - Located in
../scripts/
Located in sql/
- Schema Definitions - SQL table creation scripts
- Migration Scripts - Database updates and changes
- Seed Data - Sample data for development
Technical documentation for the multi-agent clinical intelligence system:
- AGENT_PROMPTS.md - AI agent system prompts and configurations
- EARLY_DETERIORATION_AGENT.md - Patient deterioration detection
- LAB_TREND_INTERPRETATION_ENGINE.md - Lab result analysis
- EVALUATION_TEST_CASES.md - Agent testing scenarios
- JUDGE_DEMO_STORYLINE.md - Demo walkthrough
- SQL_FHIR_SCHEMAS.md - FHIR-compliant schemas
- Getting Started → See main README.md
- Security Setup → SECURITY.md
- Deployment → AZURE_PES_SETUP_GUIDE.md
- Security Overview → SECURITY.md
- Security Audit Report → SECURITY_UPGRADE_REPORT.md
- Advanced Features → SECURITY_PHASE2_COMPLETE.md
- Azure Deployment → AZURE_PES_SETUP_GUIDE.md
- Database Setup → sql/
- Scripts → ../scripts/
- Entra ID Setup → SECURITY.md
- RBAC Implementation → SECURITY_PHASE2_COMPLETE.md
- Permission Matrix →
../server/auth/rbac-middleware.ts
- Encryption Standards → SECURITY.md
- Field Encryption → SECURITY_PHASE2_COMPLETE.md
- Implementation →
../server/encryption/field-encryption.ts
- Security Headers → SECURITY_UPGRADE_REPORT.md
- Rate Limiting → SECURITY_PHASE2_COMPLETE.md
- Input Validation →
../server/security/advanced-security.ts
- Agent Architecture → AGENT_PROMPTS.md
- Lab Analysis → LAB_TREND_INTERPRETATION_ENGINE.md
- Patient Monitoring → EARLY_DETERIORATION_AGENT.md
- Azure Setup → AZURE_PES_SETUP_GUIDE.md
- Environment Config → ../.env.example
- Scripts → ../scripts/
👨💻 Developer
- Setup: ../README.md
- API Docs: AGENT_PROMPTS.md
- Security: SECURITY_PHASE2_COMPLETE.md
🔒 Security Engineer
- Policy: SECURITY.md
- Audit: SECURITY_UPGRADE_REPORT.md
- Implementation: SECURITY_PHASE2_COMPLETE.md
☁️ DevOps Engineer
- Deployment: AZURE_PES_SETUP_GUIDE.md
- Scripts: ../scripts/
- Database: sql/
🏥 Healthcare Admin
- Overview: ../README.md
- Compliance: SECURITY.md
- Demo: JUDGE_DEMO_STORYLINE.md
🚀 Deploying to Production
- AZURE_PES_SETUP_GUIDE.md
- SECURITY.md
- Environment setup: ../.env.example
🔐 Security Hardening
- SECURITY_UPGRADE_REPORT.md
- SECURITY_PHASE2_COMPLETE.md
- Run security audit:
npm run security-audit
🤖 Understanding AI Agents
- AGENT_PROMPTS.md - Overview
- LAB_TREND_INTERPRETATION_ENGINE.md - Lab analysis
- EARLY_DETERIORATION_AGENT.md - Patient monitoring
💾 Database Setup
- sql/ - Schema files
- SQL_FHIR_SCHEMAS.md - FHIR schemas
- Database scripts: ../scripts/
| Document | Status | Last Updated | Version |
|---|---|---|---|
| SECURITY.md | ✅ Complete | Feb 2026 | 1.0.0 |
| SECURITY_UPGRADE_REPORT.md | ✅ Complete | Feb 2026 | 1.0.0 |
| SECURITY_PHASE2_COMPLETE.md | ✅ Complete | Feb 2026 | 2.0.0 |
| AZURE_PES_SETUP_GUIDE.md | ✅ Complete | Jan 2026 | 1.0.0 |
| AGENT_PROMPTS.md | ✅ Complete | Jan 2026 | 1.0.0 |
Q: How do I secure my production deployment?
A: Follow the checklist in SECURITY.md
Q: What security features are included?
A: See SECURITY_PHASE2_COMPLETE.md
Q: How do I deploy to Azure?
A: Follow AZURE_PES_SETUP_GUIDE.md
Q: How do the AI agents work?
A: Read AGENT_PROMPTS.md
Q: How do I report a security vulnerability?
A: See SECURITY.md
- Main README: ../README.md
- Source Code: ../server/, ../client/
- Scripts: ../scripts/
- Environment Config: ../.env.example
When adding new documentation:
- Organize by category - Use appropriate subdirectory
- Update this index - Add links to new docs
- Follow markdown standards - Use proper formatting
- Include examples - Show practical usage
- Keep it current - Update version and date
- Use clear, concise language
- Include code examples where applicable
- Add table of contents for long documents
- Use proper markdown formatting
- Include version and date information
HealthMesh Documentation
Version: 2.0.0
Last Updated: February 2026
Maintained by: HealthMesh Team