Cloud Dental Office

Modern SaaS Practice Management Platform for Dental Providers

A cloud-native, microservices-based dental practice management system built from the ground up with .NET 8, Blazor Server and deep payer interoperability.

---

Architecture

Cloud Dental Office uses a microservices architecture with each bounded context deployed as an independent service:

┌─────────────────────────────────────────────────────────────┐
│                    Blazor Server Portal                      │
│         (MudBlazor · Dark Theme · Real-time · AI Vision)     │
└──────────────────────────┬──────────────────────────────────┘
                           │
                    ┌──────┴──────┐
                    │ API Gateway │  ← YARP Reverse Proxy
                    │   :5200     │
                    └──────┬──────┘
         ┌─────────┬───────┼───────┬──────────┬──────────┬──────────┐
         │         │       │       │          │          │          │
    ┌────┴───┐ ┌───┴────┐ ┌┴─────┐ ┌┴────────┐ ┌┴──────┐ ┌┴─────┐ ┌┴─────────┐
    │Patient │ │Schedule│ │Claims│ │Eligiblty│ │  ERA  │ │ Auth │ │Rx (EPCS) │
    │Service │ │Service │ │Svc   │ │Service  │ │Service│ │  Svc │ │ :5107    │
    │ :5101  │ │ :5102  │ │:5103 │ │ :5104   │ │ :5105 │ │:5106 │ └─────┬────┘
    └────┬───┘ └───┬────┘ └┬─────┘ └┬────────┘ └┬──────┘ └┬─────┘       │
         │         │       │        │           │         │             │
         │         │       │        │           │     ┌───┴──────┐      │
         │         │       │        │           │     │AI Vision │      │
         │         │       │        │           │     │ Service  │      │
         │         │       │        │           │     │ :5108    │      │
         │         │       │        │           │     └────┬─────┘      │
         │         │       │        │           │          │            │
         └─────────┴───────┴────────┴───────────┴──────────┴────────────┘
                        PostgreSQL (per-service DB)
              ┌──────────────────────┴────────────────────┐
              │  privaseeAI Edge Devices (IP Cameras,     │
              │  Tablets, Raspberry Pi) + Azure AI Vision │
              └───────────────────────────────────────────┘

Services

Service	Port	Description
Portal	5000	Blazor Server UI — dashboard, patient management, claims, scheduling, e-prescribing, AI vision
API Gateway	5200	YARP reverse proxy routing to all backend services
PatientService	5101	Patient demographics, insurance/subscriber info, search
SchedulingService	5102	Appointments, operatory management, provider calendars
ClaimsService	5103	Claim lifecycle (draft → submit → adjudicate), 837D generation
EligibilityService	5104	Real-time 270/271 eligibility verification
EraService	5105	835 ERA file processing, claim matching, auto-posting
AuthService	5106	JWT authentication, OpenID Connect, multi-tenant identity
PrescriptionService	5107	e-Prescribing with DoseSpot integration, EPCS compliance, Surescripts certified
VisionService	5108	AI vision platform — privaseeAI integration, insurance card OCR (Azure AI Vision), narcotics cabinet monitoring, consent recording, clinical note generation

Shared Libraries

• CloudDentalOffice.Contracts — DTOs, integration events, and API contracts shared across services
• CloudDentalOffice.EdiCommon — Clean-room X12 EDI parser and generators (837D, 270/271, 835)

---

Quick Start

Docker Compose (recommended)

git clone https://github.com/aurelianware/clouddentaloffice.git
cd clouddentaloffice
docker-compose up -d

Portal: http://localhost:5000 API Gateway: http://localhost:5200 Swagger (per service): http://localhost:510x/swagger

Local Development

# Prerequisites: .NET 8 SDK, PostgreSQL (or use SQLite default)

git clone https://github.com/aurelianware/clouddentaloffice.git
cd clouddentaloffice

# Restore and build all projects
dotnet restore CloudDentalOffice.sln
dotnet build CloudDentalOffice.sln

# Run individual services
dotnet run --project src/Services/PatientService
dotnet run --project src/Services/ClaimsService
dotnet run --project src/Services/ApiGateway
dotnet run --project src/CloudDentalOffice.Portal

Each service defaults to SQLite for local dev — no database setup required.

---

EDI / Payer Interoperability

Cloud Dental Office provides native support for dental EDI transactions:

Transaction	Standard	Status
837D Claims	ASC X12 005010X224A2	✅ Generator implemented
270/271 Eligibility	ASC X12 005010X279A1	🔧 In progress
835 ERA	ASC X12 005010X221A1	🔧 In progress
276/277 Claim Status	ASC X12 005010X212	📋 Planned
278 Prior Auth	ASC X12 005010X217	📋 Planned

Designed to pair with Cloud Health Office for end-to-end provider ↔ payer automation.

---

AI Vision Platform

Cloud Dental Office integrates with privaseeAI edge devices to provide intelligent vision capabilities for dental practices:

Features

Feature	Description	Status
Insurance Card OCR	Automatic extraction of member ID, payer info, group numbers from insurance cards using Azure AI Vision	✅ Implemented
Narcotics Cabinet Monitoring	Real-time detection and compliance tracking for controlled substance access with badge verification	✅ Implemented
Patient Consent Recording	Video-verified consent capture with detection of patient, provider, and consent forms	✅ Implemented
Clinical Note Generation	AI-assisted procedure documentation from instrument detection and procedure observations	✅ Implemented
Real-time Detection	SignalR hub for live camera feeds and event streaming	✅ Implemented
Device Management	Multi-device registration and monitoring (IP cameras, tablets, Raspberry Pi, mobile devices)	✅ Implemented

Detection Classes

The VisionService supports detection of:

• Generic objects: Person, Document, Cell Phone, Backpack, Handbag (COCO-SSD)
• Dental instruments: Handpiece, Mirror, Explorer, Forceps, Elevator, Scaler/Curette, Syringes, Suture Kit, Cotton Roll, Gauze, Impression Tray, Crown/Bridge, Dental Dam
• Documents: Insurance cards, consent forms, ID documents, prescription pads
• Security: Cabinet door status, badge scanning, medication vials, narcotics safe monitoring

Architecture

┌───────────────────────────────────────────────────────────────┐
│                     privaseeAI Edge Devices                    │
│  (IP Cameras, Tablets, Raspberry Pi, Mobile Devices)          │
│                  ↓ Detection Events (HTTPS)                   │
└───────────────────────────────────────────────────────────────┘
                              ↓
┌───────────────────────────────────────────────────────────────┐
│                      VisionService (:5108)                     │
│  ┌─────────────────┐  ┌────────────────┐  ┌────────────────┐ │
│  │ Ingest Detections│→│Context Correlate│→│ Event Storage │ │
│  │  (REST API)      │  │   (Appt/Pt)     │  │  (PostgreSQL) │ │
│  └─────────────────┘  └────────────────┘  └────────────────┘ │
│                              ↓                                 │
│  ┌─────────────────┐  ┌────────────────┐  ┌────────────────┐ │
│  │ SignalR Hub      │  │  Azure AI      │  │ Alert Engine  │ │
│  │ (Real-time)      │  │  Vision OCR    │  │ (Compliance)  │ │
│  └─────────────────┘  └────────────────┘  └────────────────┘ │
└───────────────────────────────────────────────────────────────┘
                              ↓
┌───────────────────────────────────────────────────────────────┐
│                   Portal UI — AI Vision Pages                  │
│  • Vision Dashboard  • Device Management  • Events & Alerts    │
│  • Insurance Scans   • Consent Recording  • Cabinet Access     │
│  • Clinical Notes                                              │
└───────────────────────────────────────────────────────────────┘

Configuration

The VisionService supports two modes:

• Development/Mock: Uses mock OCR and correlation providers for testing without external dependencies
• Production: Integrates with Azure AI Vision API and live correlation engine

Configure via appsettings.json:

{
  "OcrProvider": "AzureAiVision",  // or "Mock"
  "CorrelationProvider": "Live",    // or "Mock"
  "AzureAiVision": {
    "Endpoint": "https://yourresource.cognitiveservices.azure.com/",
    "ApiKey": "your-api-key"
  }
}

---

Project Structure

clouddentaloffice/
├── CloudDentalOffice.sln          # Solution file
├── Directory.Build.props          # Shared build settings
├── docker-compose.yml             # Full stack orchestration
├── src/
│   ├── CloudDentalOffice.Portal/  # Blazor Server UI (your existing Portal)
│   ├── CloudDentalOffice.Portal.Tests/
│   ├── Services/
│   │   ├── ApiGateway/            # YARP reverse proxy
│   │   ├── PatientService/        # Patient bounded context
│   │   ├── SchedulingService/     # Scheduling bounded context
│   │   ├── ClaimsService/         # Claims bounded context
│   │   ├── EligibilityService/    # 270/271 bounded context
│   │   ├── EraService/            # 835 bounded context
│   │   ├── AuthService/           # Identity bounded context
│   │   ├── PrescriptionService/   # e-Prescribing (DoseSpot, EPCS)
│   │   └── VisionService/         # AI Vision (privaseeAI, Azure AI)
│   └── Shared/
│       ├── CloudDentalOffice.Contracts/   # Shared DTOs & events
│       └── CloudDentalOffice.EdiCommon/   # X12 parser & generators
├── infrastructure/
│   ├── docker/                    # Per-service Dockerfiles
│   ├── k8s/                       # Kubernetes manifests
│   └── azure/                     # Azure Bicep/ARM templates
├── scripts/
│   └── seeds/                     # Database init & seed data
└── docs/                          # Architecture & API documentation

---

Technology Stack

• .NET 8 — All services and portal
• Blazor Server with MudBlazor — Responsive UI with dark theme
• Entity Framework Core — Multi-provider (PostgreSQL, SQL Server, SQLite)
• YARP — API Gateway / reverse proxy
• Docker + Kubernetes — Container orchestration
• Azure — Cloud deployment (Bicep IaC templates)
• JWT / OpenID Connect — Authentication and multi-tenant identity
• SSH.NET — SFTP for clearinghouse file exchange
• DoseSpot — Electronic prescription (eRx) and EPCS integration

---

Roadmap

• Microservices architecture with per-service databases
• API Gateway with YARP
• Patient, Scheduling, Claims, Eligibility, ERA, Auth services
• e-Prescribing service with DoseSpot integration (EPCS, Surescripts)
• AI Vision service — privaseeAI integration for dental practice automation
• Insurance card OCR with Azure AI Vision
• Narcotics cabinet monitoring and compliance tracking
• Video consent recording and verification
• Clinical note generation from procedure observations
• Clean-room X12 837D claim generator
• Docker Compose full-stack deployment
• Blazor Portal integration with microservices via API Gateway
• Kubernetes deployment manifests (DOKS)
• CI/CD with GitHub Actions
• Send 837D Claim transactions to payer SFTP
• Full 270/271 real-time eligibility checks
• 835 ERA auto-posting & reconciliation
• 276/277 claim status polling
• 278 prior authorization
• Multi-location / DSO support
• Azure AD B2C / OpenID Connect auth
• Kubernetes Helm charts
• Availity Integration
• Change Healthcare Integration

---

Related Projects

• Cloud Health Office — Payer-side EDI platform (X12, FHIR R4, CMS-0057-F compliance)
• Together, Cloud Dental Office + Cloud Health Office provide complete provider ↔ payer interoperability

---

License

Apache License 2.0 — Copyright 2025 Aurelianware, Inc.