🏆 Global Smile

AI-Powered Patient Acquisition & Trust Engine for Prosthodontic Clinics

1st Prize Winner — Codegnan Elevate X Hackathon (12-hour sprint across 3 live evaluation phases)

---

🚀 Overview

Global Smile is a patient acquisition and trust-building engine designed for prosthodontic clinics to attract international/interstate patients and retain them through transparency. Built from scratch in a 12-hour hackathon sprint, it secured 1st Place among competing teams and immediate internship offers.

✨ Key Features

• 🦷 AI Smile Visualizer: Direct interactive 3D model visualization using @react-three/fiber and Three.js allowing patients to preview treatment and prosthodontic outcomes before scheduling.
• 🌍 Dental Tourism Calculator: Detailed pricing comparisons showing treatment and travel cost optimization for patients visiting from other regions/countries.
• 🔐 Transparency Dashboard: An interactive roadmap showing clinical steps, sterilization standards, and milestones to demystify complex treatments.
• 📲 AI Follow-up Engine: Autonomous check-ins and smart post-treatment advice driven by Gemini AI integration, coupled with Twilio SMS integration.

---

🛠️ Technology Stack

Layer	Technology
Frontend	React, Vite, TypeScript, Tailwind CSS, Radix UI, Recharts
3D Rendering	@react-three/fiber (Three.js react wrapper), @react-three/drei
Backend	Node.js, Express.js, nodemon
Database & ORM	PostgreSQL (Neon serverless), Prisma ORM
AI & Telephony	Google Gemini (OpenAI SDK wrapper), Twilio API (SMS communication)
Build & Tooling	Vite, TypeScript compiler (tsc), ESLint

---

⚡ Quick Start

Installation

1. Clone the repository

   git clone https://github.com/surendravarikallu/Global-Smile.git
   cd Global-Smile

2. Install dependencies

   npm install

3. Set up database schemas

   npx prisma db push

4. Start the development servers (Client + Server concurrently)

   npm run dev

---

🧪 Testing

Global Smile uses Jest with jest-environment-jsdom to test React helpers and custom hooks.

To run tests:

# Run Jest tests
npm run test

# Run tests with code coverage maps
npm run test:coverage

For configuration details, refer to the Testing Documentation (docs/TESTING.md).

---

📁 Project Structure

Global-Smile/
├── docs/
│   └── TESTING.md         # Testing architecture & configurations
├── prisma/
│   └── schema.prisma      # PostgreSQL database model schema
├── server/
│   ├── index.cjs          # Express app entry & API routes
│   └── prisma.cjs         # Prisma database connection
├── src/
│   ├── components/        # UI components (dashboard, visualizer, calculator)
│   ├── context/           # React authentication and theme contexts
│   ├── lib/
│   │   ├── utils.ts       # Class merging utilities
│   │   └── utils.test.ts  # Class merging unit tests
│   ├── App.tsx            # Main routes
│   └── main.tsx           # React bootstrap entry point
├── jest.config.cjs        # Jest test configuration
├── tailwind.config.js     # Tailwind setup configuration
└── tsconfig.json          # TypeScript compilation configuration

---

Developed by Surendra Varikallu