Overview
The Odontogram is an interactive dental chart that allows dentists to visually document the status of each tooth, including cavities, restorations, extractions, and treatments. It follows the FDI World Dental Federation notation system for tooth numbering.Tooth Numbering System
FDI Two-Digit Notation
The system uses the internationally recognized FDI notation:Upper Teeth
Right: 18, 17, 16, 15, 14, 13, 12, 11Left: 21, 22, 23, 24, 25, 26, 27, 28
Lower Teeth
Right: 48, 47, 46, 45, 44, 43, 42, 41Left: 31, 32, 33, 34, 35, 36, 37, 38
Tooth Number Breakdown
Database Schema
The
state field now stores JSON strings for complex tooth status including surface-specific treatments.Component Architecture
Odontogram Component
The main component is located at:ToothSVG Component
Individual teeth are rendered using:- Renders SVG representation of tooth anatomy
- Supports clickable surfaces (mesial, distal, occlusal, vestibular, lingual)
- Color-codes surfaces based on status
- Handles both general tooth state and surface-specific conditions
Tooth Status Options
General Tooth Status
Normal
Normal
Value:
"" (empty string)Tooth is healthy with no treatments or conditions.Extracted
Extracted
Value:
"extracted"Tooth has been removed. Displayed with X mark.Crown
Crown
Value:
"crown"Tooth has a crown or cap.In Treatment
In Treatment
Value:
"treatment"Tooth is currently undergoing treatment (e.g., root canal in progress).Endodontics
Endodontics
Value:
"endodontics"Root canal treatment completed.Surface-Specific Status
Caries
Value:
"caries"Cavity or decay on this surface.Restored
Value:
"restored"Surface has been filled or restored.Sealant
Value:
"sealant"Preventive sealant applied.Fracture
Value:
"fracture"Crack or fracture on this surface.Tooth Surfaces
Each tooth can have conditions marked on specific surfaces:- Mesial: Surface facing toward the front/midline
- Distal: Surface facing toward the back
- Occlusal: Biting/chewing surface (top)
- Vestibular (Buccal): Surface facing the cheek/lips
- Lingual (Palatal): Surface facing the tongue/palate

Interactive Features
Clicking on Teeth
Whole Tooth Click:Treatment Modal
When a tooth or surface is clicked, a modal opens with:- General State Dropdown: Select overall tooth status (normal, extracted, crown, etc.)
- Surface Status Selectors: Mark individual surfaces as caries, restored, sealant, or fracture
- Notes Field: Add clinical observations or treatment details
- Save Button: Persist changes to database
State Management
JSON State Format
Tooth states are stored as JSON strings:Parsing State
Saving State
API Integration
Fetching Odontogram
Updating Tooth Status
Visual Representation
Color Coding
Surfaces are color-coded for quick visual assessment:General Status Indicators
- Extracted: Large X drawn across tooth
- Crown: Crown icon or border highlight
- Treatment: Yellow/amber border
- Endodontics: Root canal symbol in tooth center
Read-Only Mode
View-Only Access
Users with onlyVIEW_ODONTOGRAM permission see a non-interactive odontogram:
- Tooth clicks are disabled
- Surface clicks are disabled
- Color coding still visible for status review
- No treatment modal appears
Odontogram Tab
The patient profile includes a dedicated Odontogram tab:- Full odontogram display
- Legend explaining colors and symbols
- History of odontogram changes
- Print/export functionality

Permissions
VIEW_ODONTOGRAM
VIEW_ODONTOGRAM
Module: ClínicoView the patient’s odontogram and tooth status history.
EDIT_ODONTOGRAM
EDIT_ODONTOGRAM
Module: ClínicoMark and modify tooth conditions on the odontogram. Typically restricted to dentists.
Treatment Planning
Using Odontogram for Planning
The odontogram helps with:- Treatment prioritization: Identify urgent cases (caries) vs. preventive care
- Cost estimation: Count restorations, crowns, and extractions needed
- Progress tracking: Compare odontograms over time to see treatment completion
- Patient education: Visual aid to explain needed treatments
Treatment Plan Workflow
Best Practices
- Documentation
- Accuracy
- Communication
- Update odontogram after every clinical visit
- Add detailed notes for complex treatments
- Use surface-specific marking for precision
- Document extractions and missing teeth
Mobile Responsiveness
Integration with Medical Records
Odontogram updates can be linked to medical records:- When creating a medical record about tooth extraction, update odontogram
- Reference specific teeth in treatment notes using FDI notation
- Generate treatment plans based on odontogram analysis
- Track treatment completion by comparing odontogram versions
The
notes field in the odontograms table can reference the medical record ID for full traceability.