DentalNote AI - Project Documentation

Project Overview

DentalNote AI is a full-stack, AI-assisted dental practice management and clinical documentation platform. It enables dentists and clinics to create accurate, compliant clinical notes with minimal effort by combining:

AI-powered note generation
Multi-tenant clinic support
Patient management
PDF creation and secure email workflows

The system is built on a Django REST API backend and a React + Vite + Tailwind CSS frontend. This document is designed as a high-level onboarding guide for new developers to quickly understand the platform architecture, workflows, and code structure.

Key Features

AI-Powered Note Generation

Intelligent, template-driven documentation:

Custom Template DSL with sections, conditions, triggers, and placeholders.
spaCy-powered NLP classification for dictation or typed text.
Trigger system based on procedure type, tooth/surface, findings, etc.
Dynamic note generation.

Multi-Tenant Architecture

Multi-workplace and multi-tenant support using django-tenants.
Separate schemas per tenant.
Scoped templates and data.

Patient & Workflow Management

CRUD operations for patients.
Treatment note history with audit logs.
Workplace preferences.

Post-Op & Care Call Scripts

Script-based or PDF-based instructions.
Auto-linked to templates.
Included in PDFs and email workflows.

Secure PDF & Email Delivery

Professional PDFs for notes and instructions.
Password protection optional.
SMTP.com email with MIME structure.
Full audit logging.

Authentication & Security

JWT login and OTP-based verification.
Role-based permissions.
Tenant-aware CORS/CSRF.

Template & Product Management

Trigger-based NoteTemplate models.
Versioning and sync.

Primary User Flows

Dentist Workflow

Login, select patient, dictation/manual note entry.
Template Wizard.
Post-op and care call selection.
PDF and email generation.

Admin Workflow

Template management.
Post-op and care call management.
Product and placeholder configuration.

Tenant Provisioning

WordPress + PMPro triggers tenant creation via webhook.

System Architecture

Backend (Django & DRF)

Apps: tenants, authentication, core, notes.
PostgreSQL multi-tenancy (django-tenants).
Deepgram (Speech-to-Text) + SMTP.com.

Frontend (React & Vite)

React Router for navigation.
Tailwind CSS for styling.
Axios with JWT interceptors.

Infrastructure

Docker for containerization.
Nginx for reverse proxy.
Whitenoise for static files.

Technology Stack

React Vite Tailwind CSS Axios Django DRF django-tenants SimpleJWT spaCy Deepgram ReportLab WeasyPrint PostgreSQL Docker Nginx

Project Screenshots

Preview

Preview

Preview

Preview

Preview

Preview

Preview

Preview

Live Demo

Role & Responsibilities

As a core developer on the DentalNote AI platform, I was responsible for the following key areas:

Designed and implemented the multi-tenant architecture using django-tenants, ensuring secure data isolation across clinics.
Developed the AI-powered note generation engine, integrating spaCy NLP and custom template DSL for dynamic clinical documentation.
Built patient management workflows with CRUD operations, treatment history, and audit logging.
Integrated secure PDF generation and email delivery with ReportLab, WeasyPrint, and SMTP.com, including password protection and audit trails.
Implemented authentication flows with JWT login, OTP verification, and role-based permissions, ensuring compliance and security.
Developed responsive frontend components in React + Vite + Tailwind CSS, with Axios interceptors for secure API communication.
Optimized deployment using Docker, Nginx, and Whitenoise, ensuring scalability and performance.

Technical Challenges & Solutions

Multi-Tenant Data Isolation

Challenge: Supporting multiple clinics with separate data schemas while maintaining performance and security.

Solution: Implemented django-tenants with schema-based separation, ensuring tenant-aware queries, scoped templates, and secure role-based access.

AI-Powered Note Generation

Challenge: Automating clinical documentation with accurate context from dictation and typed input.

Solution: Built a custom template DSL integrated with spaCy NLP classification and trigger-based logic, enabling dynamic note generation tailored to procedure type, findings, and demographics.

Secure Document & Communication Workflows

Challenge: Generating professional PDFs and delivering them securely via email while maintaining compliance.

Solution: Integrated ReportLab and WeasyPrint for PDF creation, added optional password protection, and configured SMTP.com with MIME structures and audit logging for reliable, secure communication.

Project Impact

DentalNote AI streamlined dental practice workflows by automating clinical note generation, patient management, and secure documentation delivery. The platform reduced manual effort, improved compliance, and enhanced accuracy in clinical records. With multi-tenant support and responsive design, it provided scalability for clinics of all sizes, enabling dentists to focus more on patient care while maintaining efficient, reliable operations.